CC Switchとは何ですか?
GitHubのREADMEは、CC SwitchをAIコーディングツールの「All-in-One Manager」と呼び、JSON・TOML・YAMLの設定ファイルを手で編集せずにワンクリックでプロバイダーを切り替えられると説明しています。別途インストールしたツールの設定を編集し、任意でプロキシとして中継するデスクトップアプリケーションです。
- 現行バージョン:プロジェクトはバージョン4で、最新のGitHubリリースはv4.0.35です。直近の3つのリリースは連日公開されています
- ドキュメント:プロバイダー、ルーティング、MCP、Skills、セッションのガイドは公式ドキュメントにあります
- 作者:LICENSEにはJason Youngの名前があり、リポジトリのファイルにも公式サイトにも企業名は記載されていません
- そうではないもの:AIモデルでも、ホスト型APIでも、チーム向けゲートウェイでもありません
CC Switchでできること
READMEによると、機能はプロバイダー、ルーティング、共有リソース、利用状況、セッション、同期に及びます。
- プロバイダー — AWS Bedrock、NVIDIA NIM、コミュニティ中継サービスを含む90以上のプリセット、またはカスタム設定。Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Buildはシステムトレイから切り替えられます
- ルーティング — Anthropic Messages、OpenAI Chat Completions、OpenAI Responses、Gemini Nativeの各形式を相互に変換し、Claude CodeでGPTを、CodexでClaudeを使えます。リクエストが失敗するとサーキットブレーカー付きのフェイルオーバーキューが次のプロバイダーに移ります
- アグリゲーション — Claude CodeとCodexで複数プロバイダーのモデルを1つの一覧に表示し、選んだモデルのプロバイダーにリクエストを送ります。READMEによると、このモードにフェイルオーバーはありません
- 共有リソース — 選んだツールに同期するMCPサーバー、skills.shやGitHubからインストールするSkills、ツールごとのプロンプトファイル(CLAUDE.md、AGENTS.md、GEMINI.md)、構成全体を一度に切り替えられる保存済みプロジェクト
- 利用状況とセッション — ルーティングなしでもローカルのセッションログからトークン、コスト、キャッシュヒットの統計を読み取り、プロバイダーカードに残り枠を表示し、検索とMarkdownエクスポート付きのセッション履歴閲覧ビューを備えます
- 同期とリンク — 任意のWebDAVまたはS3同期、プロバイダーをインポートする
ccswitch://ディープリンク、8言語のインターフェース
CC Switchを入手する
最も簡単な方法は、GitHub Releasesページから自分のOS用インストーラーを入手するか、macOSではHomebrewを使うことです。 公式サイトも同じリリースにリンクしています。
選択肢 | 入手方法 |
|---|---|
| Windows(最も簡単) | ReleasesのCC-Switch-v4.0.35-Windows.msi、またはポータブル版ZIP |
| macOS | Releasesの.dmg、またはbrew install --cask cc-switch |
| Linux | .deb、.rpm、.AppImage(x86_64とARM64)。Arch:paru -S cc-switch-bin |
| ウェブサイト | ccswitch.io |
| ドキュメント | ccswitch.io/en/docs |
| ソースコード(GitHub) | farion1231/cc-switch |
現在のバージョンは4.0.35で、2026年11月18日にリリースされました。最後のアップストリーム更新は2026年11月19日の最新コミットです(GitHub、2026年11月19日確認)。READMEの動作要件はWindows 10以降、macOS 12以降、glibc 2.35以上とWebKitGTK 4.1を備えたLinuxです(RHEL、Rocky、Alma 8~9は未対応)。macOS版はコード署名・公証済みと記載されていますが、PromptQuorumは確認していません。インストーラーは実行していません。
インストールと最初の手順
これらの手順はREADMEのQuick Startに従っており、2026年11月19日に確認しました。PromptQuorumは実行していません。
- 1アプリをインストールする
Why it matters: 自分のOS用インストーラーを実行するか、macOSでは`brew install --cask cc-switch`を実行します。 - 2既存の設定を取り込ませる
Why it matters: READMEによると、初回起動時にCC SwitchはClaude Code、Codex、Gemini CLI、Grok Buildの既存設定を`default`というプロバイダーとして取り込み、各ツールに公式プロバイダーを追加します。 - 3プロバイダーを追加する
Why it matters: サイドバーでツールを選び、「+」をクリックしてプリセットまたはカスタム設定を選び、キーを入力します。 - 4切り替えて再起動する
Why it matters: プロバイダーの「Enable」をクリックします。Claude Codeは再起動不要で、Codex、Gemini CLI、Grok Buildは新しいターミナルまたはCLIセッションが必要です。
価格・ライセンス・プライバシー
CC Switchは無料のオープンソースです。READMEと公式サイトに有料プランの記載はなく、利用料は追加したプロバイダーが請求します。
- ライセンス:リポジトリによるとMIT、著作権表示は2025年Jason Youngです
- データの流れ:SECURITY.mdは、CC Switchをプロジェクトが運営するクラウドバックエンドのないローカルのデスクトップアプリケーションと説明しています。ルーティングしたリクエストは、選んだプロバイダーまたは中継サービスに送られ、そちらから内容が見えます
- ローカルプロキシ:同ファイルによると、待ち受けアドレスとポートは設定可能で、ループバック以外のインターフェースに割り当てられる場合があります。公開する前にこの設定を確認してください
- 外部データの取得:SECURITY.mdによると、アプリはモデル料金のJSONとプロバイダーのアバターを取得します(同ファイルではv3.18.0で確認)
- 同期:WebDAVまたはS3の同期は任意で、READMEによると自分で選んだストレージに書き込みます
- サブスクリプション:READMEは、ChatGPT、Copilot、Grokのサブスクリプションを公式クライアント以外で使うとベンダーの利用規約に違反する可能性があると警告し、リスクは自分で判断するよう求めています
- スポンサー:READMEにはサードパーティの中継サービスのバナーと割引コードが載っています。PromptQuorumはそれらを評価していません
CC Switchはどんな人に向いていますか?
CC Switchは、すでにAIコーディングCLIを使っていて、自分のAPIキーを追加できる開発者に向いています。
CC Switchを使うべき場合
- 複数のAIコーディングツールやAPIプロバイダーを使い分け、設定ファイルを手で編集している
- Claude CodeでGPT、CodexでClaude、またはプロバイダー間の自動フェイルオーバーを使いたい
- MCPサーバーとSkillsを1か所で管理したい
他を検討すべき場合
- プライバシーポリシーを公開している企業をデータ処理者として必要とする
- チームで共有するゲートウェイサーバーが必要(SECURITY.mdにマルチユーザーモデルの記載はありません)
- READMEが未対応としているRHEL、Rocky、Alma 8~9を使っている
CC Switchと他のルーター・ゲートウェイの比較
CC Switchは1台のマシン上のコーディングツールの設定を管理しますが、以下のツールはゲートウェイサーバーです。全体のカタログはローカルAIディレクトリをご覧ください。
- LiteLLM — 100以上のプロバイダーAPIをルーティングとコスト追跡付きでまとめる、OpenAI互換の単一ゲートウェイ。アプリケーションやチーム向けに運用するサーバーです。LiteLLMレビューをご覧ください。
- ClawRouter — どのモデルを呼ぶかをローカルで判断する、自律エージェント向けのセルフホスト型ルーター。当サイトのレビューでは、GUIのデスクトップアプリではなくローカルのNode.jsプロキシ兼CLIとして紹介しています。ClawRouterレビューをご覧ください。
- AIClient2API — Gemini CLI、Codex、Grok、Kiro、Antigravityのクライアントプロトコルを1つのOpenAI互換APIに変換するセルフホスト型プロキシ。サブスクリプションをこの方法で使う前に、「価格・ライセンス・プライバシー」のベンダー規約に関する警告をご確認ください。AIClient2APIレビューをご覧ください。
よくある質問
CC SwitchにはAIモデルが含まれますか?
いいえ。他のツールの設定を編集して中継するだけで、モデルと課金は、公式API、AWS Bedrockのようなクラウドプラットフォーム、中継サービスなど、追加したプロバイダーから提供されます。
プロバイダーを切り替えるとプラグインやフックは上書きされますか?
READMEによると、置き換わるのはエンドポイント、キー、モデル名、プロトコルなどの主要項目のみで、プラグイン、フック、権限、MCP、コメントは残ります。最初に書き換える前に、各設定ファイルを~/.cc-switch/backups/live-first-write/にバックアップします。
アグリゲーションのモデルがCodexに表示されないのはなぜですか?
Codexはモデル一覧を起動時にしか読み込まないため、アグリゲーションを変更した後はCodexを完全に再起動する必要があります。READMEによると、1つのバックグラウンドデーモンが共有されているため、ターミナルを閉じるだけでは不十分です。
公式サイトはどれですか?
READMEと公式のllms.txtは、ccswitch.ioを唯一の公式サイトとし、同名の他ドメインはプロジェクトと無関係としています。
