1. プロジェクト概要
CC Switchは、Claude Code、Claude Desktop、Codexなど8つの人気AIコーディングツールのプロバイダー、MCP、プロンプト、スキル設定を一元管理するクロスプラットフォームのデスクトップアプリケーションです。散在する設定ファイルへの手動編集やエラーが発生しやすい作業を、単一のビジュアルインターフェースに置き換えます。
2. 背景と位置づけ
Claude Code、Codex、Gemini CLIなどのAIコーディングアシスタントは、それぞれ独自の設定ファイルと形式でAPIキー、モデルエンドポイント、プロバイダー設定を保存します。これらのツールを併用する開発者や、コスト・レイテンシー・可用性の理由で複数のAPIプロバイダーを切り替える開発者は、プロバイダーを変更するだけでもJSON/TOMLファイルを手動編集し、ターミナルを再起動する必要がありました。CC Switchはその摩擦を取り除くために作られました。プロバイダープリセット、MCPサーバー、プロンプト、スキルをSQLiteベースの単一ストアに集約し、各ツールに適切な形式を自動的に配信します。
環境変数や単一の設定ファイルを入れ替えるだけの単純なシェルスクリプトの「プロファイル切り替えツール」と比較して、CC Switchは8つのツールを同時にカバーし、50以上の組み込みプロバイダープリセットを備え、システムトレイからのクイック切り替えを備えたネイティブGUIを提供し、自動フェイルオーバーとサーキットブレーカーを備えたローカルプロキシ層を追加し、クロスデバイス同期(Dropbox/OneDrive/iCloud/WebDAV)を提供するため、プロバイダー設定が開発者に追従して複数のマシンで利用できます。
3. 機能カテゴリ
- 🔌 プロバイダー管理 — 「8つの対応ツール、50以上のプリセット」にわたる50以上のプリセット。Claude Code、Codex、Gemini CLIなどに対し、インポート、ドラッグ&ドロップでの並べ替え、ワンクリックでのプロバイダー切り替えが可能。目的: 各ツールのプロバイダー設定の手動編集を不要にします。
- 🔄 統一設定同期 — 保存した1つの設定をClaude Code、Codex、Gemini CLIに同時に同期できます。目的: 複数のCLIツールの一貫性を保ち、設定のずれを防ぎます。
- 🛡️ プロキシとフェイルオーバー — リクエスト形式変換、自動フェイルオーバー、サーキットブレーカー、プロバイダーのヘルスチェックを備えたローカルプロキシ。目的: プロバイダーが劣化または停止した場合でもコーディングセッションを継続します。
- 🧩 MCP / プロンプト / スキル管理 — Model Context Protocolサーバー、プロンプトライブラリ、スキル専用のパネルを備え、アプリ間同期とディープリンクインポートに対応。目的: ツールごとではなく一度で拡張機能を管理します。
- 🕘 セッションと履歴の閲覧 — 対応するセッションソース全体の会話履歴を閲覧、検索、復元できます。目的: ツールやマシン間を移動する際の連続性を維持します。
- 📊 使用状況トラッキング — 支出、トークン消費、リクエスト数のダッシュボードと、トレンドチャートおよび詳細ログを提供。目的: APIコストと使用パターンを可視化します。
- ☁️ クラウド同期 — Dropbox、OneDrive、iCloud、またはカスタムWebDAVサーバーを介した設定同期。目的: 複数のデバイスで同じプロバイダー/ツール設定を利用できます。
4. 主なハイライト
- 8つのツール、1つのインターフェース — Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermesを、8つの個別設定ファイルではなく、同じアプリからすべて設定できます。
- システムトレイでのクイック切り替え — フルウィンドウを開かずにトレイメニューからプロバイダーを切り替えられ、Claude Codeは再起動なしのホットスイッチに対応。
- フェイルオーバー対応のローカルプロキシ — 組み込みプロキシがプロバイダー間の形式変換を行い、プロバイダーが異常になった場合はサーキットブレーカー保護付きで自動フェイルオーバーします。
- SQLiteによる単一の真実源 — プロバイダー、MCP設定、プロンプト、スキルは1つのデータベース(
~/.cc-switch/cc-switch.db)に保存され、アトミック書き込みとミューテックス保護による並行アクセスで、設定の破損を防ぎます。 - 自動バックアップ — アプリは最新10件のデータベースバックアップと、アンインストール前の最大20件のスキルスナップショットを保持するため、設定ミスから復旧できます。
- ネイティブでコード署名済みビルド — Tauri 2 + Rustにより、小型でネイティブなバイナリを生成。macOSビルドはAppleによるコード署名と公証が行われています。
5. 役割別のユースケース
- 一般開発者 — 複数のAIコーディングアシスタント(例: Claude CodeとCodexやGemini CLI)を使用する人は、ツールごとに設定ファイルを編集する代わりに、1つのプロバイダーリストを維持して即座に切り替えられます。
- DevOps / インフラ志向のエンジニア — プロキシのフェイルオーバーとサーキットブレーカー機能により、プロバイダーの停止やレート制限が発生した場合でも、AI支援ワークフローの回復力を維持できます。
- 複数のLLMプロバイダーを評価するチーム — 50以上のプリセットとワンクリック切り替えにより、各CLIツールを手動で再設定することなく、コスト、レイテンシー、出力品質のA/Bテストを簡単に行えます。
- 複数のマシンで作業する開発者 — クラウド同期(Dropbox/OneDrive/iCloud/WebDAV)により、ノートパソコンとデスクトップ間でプロバイダーとMCP設定の一貫性を維持できます。
6. はじめに
必要なものを見つける — アプリ内の組み込みプリセットと機能パネル(プロバイダー、MCP、プロンプト、スキル、セッション、使用状況)を参照するか、リポジトリ内のユーザーマニュアルとREADMEで機能の詳細を確認してください。
インストール / 統合:
# macOS (Homebrew)
brew install --cask cc-switch
# Linux (Arch、AURヘルパー経由)
paru -S cc-switch-bin
Windowsユーザーおよびその他のLinuxディストリビューションは、リリースページからMSI、ポータブルZIP、DEB、RPMパッケージをダウンロードできます。
貢献:
pnpm install
pnpm dev # ホットリロード付き開発モードを開始
pnpm typecheck # TypeScript検証
pnpm format:check # フォーマットチェック
pnpm test:unit # フロントエンド単体テスト
cargo fmt && cargo clippy && cargo test # Rustバックエンドチェック
機能提案はまずGitHub Issuesで議論してください。プルリクエストは、提出前に型チェック、フォーマット、単体テストに合格する必要があります。
7. プロジェクト構造
cc-switch/
├── src/ # React + TypeScriptフロントエンド(UI、パネル、状態)
├── src-tauri/ # Rust + Tauriバックエンド(IPCコマンド、プロキシ、SQLiteアクセス)
├── package.json # フロントエンド依存関係とpnpmスクリプト
└── README.md # 機能概要とセットアップ手順
フロントエンド(React 18、Vite、TailwindCSS、shadcn/ui)はIPCを介してRust/Tauriバックエンドと通信します。バックエンドは~/.cc-switch/cc-switch.dbにあるSQLiteデータベースを所有し、プロバイダー、MCPサーバー、プロンプト、スキルの単一の真実源として機能します。
8. 関連エコシステム
CC Switchは、管理対象であるAIコーディングツール(Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes)および外部ツールサーバー向けのModel Context Protocol(MCP)エコシステムと統合し、共存します。ネイティブデスクトップパッケージングにはTauriフレームワークに依存し、クロスデバイス同期にはクラウドストレージプロバイダー(Dropbox、OneDrive、iCloud、WebDAV)に依存しています。
9. ライセンス
- ✅ ソフトウェアを商用または私用で使用、変更、配布できます(MITライセンス)
- ✅ 独自コードをオープンソース化せずにプロプライエタリプロジェクトに含めることができます
- ❌ ソフトウェアの使用から生じる損害について著者に責任を負わせることはできません
- ℹ️ ソフトウェアのコピーまたは実質的な部分には、元の著作権表示とライセンス文を保持する必要があります
10. よくある質問
Q: CC SwitchはどのAIコーディングツールをサポートしていますか?
A: Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermesです。
Q: プロバイダーを切り替えた後、ターミナルを再起動する必要がありますか?
A: ほとんどのツールは新しい設定を反映するためにCLIの再起動が必要ですが、Claude Codeは再起動なしのホットスイッチに対応しています。
Q: 設定データはどこに保存されますか?
A: ~/.cc-switch/ 配下のローカルSQLiteデータベースとJSON設定ファイルに保存され、自動バックアップローテーションが行われます。
Q: サードパーティのプロバイダーではなく、公式のClaude/Codexログインを引き続き使用できますか?
A: はい — 「公式ログイン」プリセットを追加すると、ツールのデフォルト認証に戻ります。
Q: パッケージマネージャーがないWindowsまたはLinuxディストリビューションにCC Switchをインストールするにはどうすればよいですか?
A: リリースページからMSI、ポータブルZIP、DEB、RPM、またはAppImageビルドをダウンロードしてください。
11. クイックリンク
- リポジトリ: https://github.com/farion1231/cc-switch
- 公式ウェブサイト: https://ccswitch.io
- リリース: https://github.com/farion1231/cc-switch/releases
- イシュー(バグ報告と機能議論): https://github.com/farion1231/cc-switch/issues
12. まとめ
CC Switchは、複数のAIコーディングアシスタントを扱う開発者にとっての実際の痛点を解決します。8つの異なるツールの設定ファイルを手動編集する代わりに、プロバイダー、MCPサーバー、プロンプト、スキル、使用状況トラッキングのための単一のネイティブでクロスプラットフォームなインターフェースを提供し、回復力のあるローカルプロキシとクロスデバイス同期で支えられています。AIプロバイダーを定期的に切り替える、または複数のコーディングアシスタントを使用する開発者やチームにとって、どこでも信頼性が高く、バックアップされ、一貫性のある設定を実現する上で最も価値があります。