ワンクリックで Deep Code CLI の AI プロバイダーを切り替えるメニューバー / Dock ユーティリティ。 設定ファイルを開く必要なし。再起動も不要。秒単位で切り替え。
最新安定版: v0.1.1
macOS の推奨インストール方法（Gatekeeper の警告なし、brew upgrade で更新可能）:
brew install --cask skyedolyn-sys/deep-switch/deep-switch| プラットフォーム | ダウンロード | サイズ |
|---|---|---|
| macOS (Apple Silicon) | deep-switch_0.1.1_aarch64.dmg |
~5 MB |
| macOS (Apple Silicon) | deep-switch_0.1.1_aarch64.zip |
~5 MB |
| Linux (deb) | deep-switch_0.1.1_amd64.deb |
~6 MB |
| Linux (AppImage) | deep-switch_0.1.1_amd64.AppImage |
~80 MB |
| Windows (MSI) | deep-switch_0.1.1_x64_en-US.msi |
~5 MB |
| Windows (NSIS .exe) | deep-switch_0.1.1_x64-setup.exe |
~5 MB |
⚠️ macOS 版の手動インストール（dmg/zip）：ビルドはアドホック署名で公証されていないため、 初回起動時に「壊れているため開けません」と誤表示されることがあります。削除しないでください — ファイルは正常です。どちらかで解除できます：
- dmg / 解凍フォルダ内の【安装说明 Installation Guide.txt】を開いて 3 ステップをコピペするだけ（コマンド知識不要）、または
- ターミナルで一度
xattr -cr /Applications/deep-switch.appを実行してから再度起動。Homebrew cask はこの手順を自動で行います — そのため推奨インストール方法です。検証済みの Apple Developer ID が取得でき次第、公証済みリリースに切り替えます。
Linux: AppImage はインストール不要のポータブル形式、
.debは Debian/Ubuntu 用。Windows: MSI はシステム全体へのインストール、NSIS.exeはユーザー単位のポータブル形式です。
██████╗ ███████╗███████╗██████╗ ███████╗██╗ ██╗██╗████████╗ ██████╗██╗ ██╗
██╔══██╗██╔════╝██╔════╝██╔══██╗ ██╔════╝██║ ██║██║╚══██╔══╝██╔════╝██║ ██║
██║ ██║█████╗ █████╗ ██████╔╝ ███████╗██║ █╗ ██║██║ ██║ ██║ ███████║
██║ ██║██╔══╝ ██╔══╝ ██╔═══╝ ╚════██║██║███╗██║██║ ██║ ██║ ██╔══██║
██████╔╝███████╗███████╗██║ ███████║╚███╔███╔╝██║ ██║ ╚██████╗██║ ██║
╚═════╝ ╚══════╝╚══════╝╚═╝ ╚══════╝ ╚══╝╚══╝ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝
Deep Code CLI のプロバイダー切り替えツール —— 実際の業務フローに合わせて設計。
Deep Switch は ~/.deepcode/settings.json を編集するだけの小さなメニューバー / Dock ユーティリティです(macOS 向け。Linux / Windows ではシステムトレイユーティリティ)。Deep Code CLI が今どの AI プロバイダーと会話しているかを、ワンクリックで切り替えられるようにします。一度プロバイダーを登録すれば、JSON ファイルを開くことなく切り替えできます。
Deep Code の代替品ではなく、Deep Code のための ミラー / 互換ツールです:Deep Code 本体には触れず、CLI が次回読み取る設定ファイルだけを書き換えます。
複数のプロバイダーを渡り歩くのに、こんなに苦労するべきではありません。
- 🧩 プロバイダーが多すぎ、鍵が多すぎ — DeepSeek、Moonshot、Zhipu GLM、MiniMax、ByteDance Doubao、SiliconFlow、OpenRouter、OpenAI、Groq、SenseTime SenseNova、Tsinghua DeepSeek-R1……それぞれに独自の Base URL、モデル名、癖があります。
- 📝
settings.jsonの手作業編集 — 1 文字打ち間違えたり、カンマを忘れただけで JSON が壊れます。 - 🐢 切り替えが遅い — CLI を終了して、ファイルを編集して、再起動して、待って、の繰り返し。
- 💾 バックアップが消える — 上書きしてしまえば、前の設定はもう戻せません。
- 🔁 繰り返し作業 — 新しいプロジェクトごとに同じことをやり直す。
Deep Switch はこれをすべてワンクリックに集約します。
- ⚡ ワンクリック有効化 — プロバイダーを選んで 有効化 を押すだけ。
- 📦 プリセット網羅 — DeepSeek · Moonshot/Kimi · Zhipu GLM · MiniMax · ByteDance Doubao · SiliconFlow · OpenRouter · OpenAI · Groq · SenseTime SenseNova · Tsinghua DeepSeek-R1(671B フル + 32B 蒸留、どちらもプリセットカードで選択可能)、そして完全にカスタマイズ可能な Custom スロット。
- 🔄 リアルタイム反映 —
~/.deepcode/settings.jsonを直接書き換えます。次に CLI を呼ぶ時点で既に新しいプロバイダーに切り替わっています。再起動不要。 - 🌐 OpenCode 同期 — 同等のプロバイダー設定を
~/.config/opencode/opencode.jsonにも書き込み、opencode-ai CLI が@ai-sdk/openai-compatibleアダプター経由で利用できるようにします。同じプロバイダーを 2 つのクライアントで。 - 🧠 モデルピッカー — プロバイダーの
/v1/modelsエンドポイントからリアルタイムにモデル一覧を取得し、実際に利用可能なものだけ選べます。 - 🤔 思考モード切替 — Chain-of-thought を有効化し、推論の深さ
high/maxを選べます。 - 🛰️ キャンパス/WAF 耐性プロキシ — 厳格な WAF の背後にあるプロバイダー(例:清華大学の madmodel.cs.tsinghua.edu.cn)に対して、Deep Switch は組み込みの Node.js ヘルパー(
scripts/tsinghua-proxy.mjs)を起動し、一過性の 404 を自動リトライし、<think>推論を別個のreasoning_contentデルタに分離し、警告チャンクをクライアントにストリームで返すため、リトライ中も CLI がハングしているように見えません。 - 🪟 閉じる時にトレイへ最小化 — ウィンドウを閉じてもアプリはメニューバーに常駐。トレイアイコンを右クリックで終了できます。
- 🌐 バイリンガル UI — 日本語と英語、システムロケール自動検出 + 手動オーバーライド。
- 📌 トレイメニューからのクイック切替 — トレイアイコンを右クリックでメインウィンドウを開かずに切替。メニュー表記は UI 言語に追従。状態は
active-provider-changedイベントでメインウィンドウへ同期されます。 - 🪄 初回「現在の設定を検出」インポート — Deep Code が今何を指しているかを読み取り、ワンクリックで保存可能なプロバイダーに。
- 🔒 認証情報はローカル保存 —
~/.deep-switch/config.jsonに0600の権限で保存。アップロードも同期もログ保存もなし。 - 🎯 ヘルスチェック — 任意の軽量 Base URL チェック。CLI がエラーを出す前に分かります。
- 🪶 軽量 — 単一トレイアイコン、システム WebView、ディスク約 12 MB。Chromium 同梱なし、バックグラウンド常駐なし。
┌──────────────────┐ ┌────────────────────────┐ ┌──────────────────────┐
│ プリセット/ │ ───▶ │ メインウィンドウか │ ───▶ │ ~/.deepcode/ │
│ カスタム入力 │ │ トレイメニューで │ │ settings.json │
│ (DeepSeek, │ │ 「有効化」をクリック │ │ が Rust メイン │
│ Moonshot, …) │ │ │ │ プロセスから書き換え │
└──────────────────┘ └────────────────────────┘ └──────────┬───────────┘
│
▼
┌──────────────────────────┐
│ 次の Deep Code CLI 呼び出しが │
│ 新しい settings を読み、 │
│ 切り替わったプロバイダーと │
│ 通信する。 │
└──────────────────────────┘
4 ステップ:
- プロバイダーを 追加 (プリセットを選ぶか Base URL + Key を貼る)
- メインウィンドウかトレイメニューから 有効化 をクリック
- Deep Switch が Tauri Rust メインプロセス経由で
settings.jsonを書き換え - 次に Deep Code CLI を呼ぶと、書き換えた設定が読まれる
これで完了です。
Homebrew(1 コマンド、Gatekeeper の隔離も自動処理):
brew install --cask skyedolyn-sys/deep-switch/deep-switchまたは手動インストール: Releases ページから最新の .dmg をダウンロードし、Deep Switch を Applications フォルダにドラッグします。
ビルドが未署名のため、DMG から初回起動時に Gatekeeper の警告が出ます。右クリック → 開く で許可してください。Homebrew cask で入れると
xattr -crが自動で走るため、この手順は不要です。
公式インストーラーが利用可能になりました — 先頭の ダウンロード 表をご覧ください。
Linux — どのファイル?
.deb(Debian / Ubuntu):約 4 MB、システム全体へのインストール、sudoが必要。システムの WebKitGTK をapt経由で利用します。sudo dpkg -i deep-switch_0.1.1_amd64.debでインストール(多くのデスクトップファイルマネージャーからダブルクリックでも可)。.AppImage(任意のディストロ、root 不要):約 80 MB、完全に自己完結 — WebKitGTK も同梱しているため、Arch / Fedora / openSUSE で追加のシステムライブラリなしに動作します。chmod +x deep-switch_0.1.1_amd64.AppImage && ./deep-switch_0.1.1_amd64.AppImageで実行、またはダブルクリック。サイズが大きいのはポータビリティの代償で、すべての依存関係がファイル内に入っています。
ソースから動かしたい場合は:
git clone https://github.com/skyedolyn-sys/deep-switch.git
cd deep-switch
npm install
npm run tauri dev要件:Node.js 20+ および Rust 1.77+(Tauri 2 ツールチェーン)。
# クローン
git clone https://github.com/skyedolyn-sys/deep-switch.git
cd deep-switch
# 依存インストール(リポジトリの lockfile を使用)
npm install
# 開発モード — Vite + Tauri + HMR
npm run tauri dev
# レンダラーのみ(ブラウザプレビュー、Tauri なし):
npm run dev:renderer
# レンダラーの型チェック
npx tsc --noEmit
# 現在プラットフォームの本番ビルド
npm run tauri build
# Lint
npm run lintnpm run tauri dev は Vite を http://localhost:5173 で起動し、Tauri WebView ウィンドウから開きます。レンダラーは HMR、src-tauri/src/** 変更時は Rust が自動再コンパイル。
| レイヤー | ツール |
|---|---|
| シェル | Tauri 2(システム WebView を使用) |
| レンダラー | React 18 + TypeScript 5 + Vite 5 |
| ネイティブ | Rust 1.77+(serde, reqwest, tauri-plugin-log) |
| WAF ヘルパー | 組み込み Node.js サブプロセス(scripts/tsinghua-proxy.mjs)— WAF で保護されたプロバイダーに切替時のみ起動、透明なリトライ + SSE ストリーミング |
| i18n | i18next + i18next-browser-languagedetector |
| ベンダーアイコン | @lobehub/icons(オープンソース SVG ブランドパック) |
| ローカル保存 | ~/.deep-switch/config.json(JSON、アトミック書き込み) |
| 永続化 | ~/.deep-switch/config.json + ~/.deepcode/settings.json + ~/.config/opencode/opencode.json |
deep-switch/
├── src/
│ └── renderer/ # React UI
│ ├── App.tsx
│ ├── components/ # ProviderCard、PresetSelector、ProviderDetail など
│ ├── lib/ # vendor-icons.tsx(共有モジュール)
│ ├── locales/ # en.json、zh.json
│ ├── i18n.ts
│ └── global.css
├── src-tauri/ # Tauri Rust バックエンド
│ ├── src/
│ │ ├── main.rs # Tauri エントリ
│ │ └── lib.rs # 15 個の #[tauri::command] IPC + トレイ + DB
│ ├── icons/ # アプリアイコンセット
│ ├── capabilities/ # Tauri セキュリティポリシー
│ ├── tauri.conf.json # ウィンドウ設定、identifier、bundle 設定
│ └── Cargo.toml
├── public/ # 静的アセット(トレイアイコンなど)
├── docs/ # 多言語ドキュメント
├── .github/workflows/ # CI + リリース
│ ├── ci.yml
│ └── release.yml
├── tsconfig.json # レンダラー TS 設定
└── vite.config.mts
PR 大歓迎 — テーマを絞ってください。
- リポジトリをフォークしてトピックブランチを作成(
feat/<short-name>、fix/<short-name>)。 - プッシュ前に
npm run lintとnpx tsc --noEmitを実行。 - PR は 何を 変えたかだけでなく、なぜ 変えたかを説明する。
プロバイダープリセットを追加 する場合、src-tauri/src/lib.rs の get_builtin_presets を編集 — description / descriptionEn(および platform、hint、homepageUrl)は両言語で同期させてください。
翻訳を追加 する場合、src/renderer/locales/en.json と src/renderer/locales/zh.json を同期して編集し、キーが完全に一致するようにしてください。
- 🔐 API キーは
~/.deep-switch/config.jsonにローカル保存 — あなたのマシンから一切出ません。Deep Switch にはバックエンドがなく「私たち」も存在しません。 - 🚫 分析・テレメトリ・クラッシュレポートなし — サードパーティスクリプトなし、リモート設定フェッチなし。
- 🌐 Deep Switch 自身が発生するネットワークトラフィック は、モデルピッカーを開いたときの任意の
/v1/models取得と任意のヘルスチェックのみ — どちらもあなたのマシンから直接選んだプロバイダーへ。 - 🧪 オープンソース — あなたのマシンで動く全バイトがこのリポジトリにあります。自由に監査してください。
セキュリティ問題を見つけた場合は、公開 issue ではなく非公開セキュリティレポートで報告してください。
MIT © 2026 Deep Switch contributors。
Tauri、React、Vite、Rust、i18next のメンテナたちに感謝。皆さんの仕事があってこそ、このアプリは簡単に作れます。