ターミナルでClaude Codeを走らせながら、別のウィンドウでCodexを立ち上げる——今年はそんなAI開発者が増えた。二つのCLI、二つの設定ディレクトリ、二つのAPI Key。Providerを切り替えるには設定ファイルを手で書き換えるか、最悪セッションを再起動する羽目になる。cc-switchがやりたいことは単純で、この一連の面倒事をひとつのGUIウィンドウに詰め込み、クリック一発で切り替えられるようにすること。
GitHubで12.8万スター、AI開発者ツールの中でも上位に入る。
何の問題を解決するか
Claude Code、Codex、OpenCodeなどのCLIを併用すると、設定が ~/.claude/ や ~/.codex/ に散らばり、API Keyもそれぞれ別管理になる。Providerを切り替えるたびに、手作業でファイルを書き換えるかセッションを落とすしかない。
cc-switchはこれらをGUIウィンドウひとつにまとめる。
日本の開発者にとってもこれは切実な話で、ClaudeやGPTといった海外サービスには中継プロキシを使うことになる。公式アカウント、中継プロキシ、別プランのKeyを何種類も抱えていて、切り替えるたびに毎回 settings.json の ANTHROPIC_BASE_URL を書き換えている——そんな人が一ヶ月もこの作業を続ければ、そりゃうんざりする。
使い方
公式サイトからパッケージをダウンロードしてインストールする。macOS / Windows / Linuxの三平台に対応している(リンク https://ccswitch.io は原資料で未確認のため、公開前にチェック推奨)。
起動すると、左側にサポート対象のCLIが並ぶ(リポジトリのREADME準拠):
- Claude Code
- Codex
- OpenCode
- その他(随時追加中)
Claude Codeを開くと、現在有効なProvider、API Key、Base URLが表示される。「Providerを追加」から名前・Key・Base URLを入力して保存する。次回Claude Code CLIを起動すれば、新しい設定で動く。~/.claude/settings.json をいじる必要はない。
コードは一切書かずに、GUIだけで完結する。
仕組み(推測)
Rust製のデスクトップアプリで、インストーラの容量(約200MB)から察するにTauri(フロントエンドはWebview、バックエンドはRust)だろう。Electroidではない——Electronだと最低でも400MB前後はある。以下のアーキテクチャ推測は同種ツールの一般的な設計に基づくもので、実装はソースコードを参照してほしい。
設計上のポイント:
- Adapter抽象レイヤー:各CLIツールに対応するadapterが、自分の設定ディレクトリの読み書きを担当する。ClaudeAdapterは
~/.claude/settings.jsonの形式を知っているし、CodexAdapterは~/.codex/config.tomlのスキーマを把握している。 - Providerモデル:ユーザーが作成する「Provider」は設定テンプレートで、Key + Base URL + モデル名からなる。切り替えとは、このテンプレートを各CLIの設定ファイル形式にレンダリングすること。
- ホット切り替え:設定を書き換えた後、起動中のCLIプロセスにリロードを通知する。一般的にはSIGUSR1シグナルを送るか、inotifyでファイル変更を検知する方式が使われる。
疑似コード例(推測):
// 疑似コード:Provider切り替えのコアフロー
fn switch_provider(cli: CliType, provider: Provider) -> Result<()> {
// 1. 現在の設定をバックアップ
let config_path = cli.config_path(); // e.g. ~/.claude/settings.json
backup(config_path)?;
// 2. Providerテンプレートを対象CLIの設定に書き出す
let adapter = cli.adapter(); // ClaudeAdapter / CodexAdapter / ...
let target_config = adapter.render(provider)?;
fs::write(config_path, target_config)?;
// 3. 起動中のCLIプロセスにreloadを通知
notify_process(cli.process_name(), Signal::Reload)?;
Ok(())
}CLIごとにadapterを割り当てることで、スキーマの異なる設定をProviderオブジェクトとして統一的に扱える。これが複数CLIを同じGUIに詰め込めるカラクリ。
良いところ・悪いところ
良いところ:
- クロスプラットフォーム対応(macOS / Windows / Linux)
- Rust製で起動が速く、メモリ消費も少ない
- GUIで完結するので、シェルに不慣れな人でも使える
- 主要なAI CLIを複数サポートしており、対応範囲は拡大中
- リポジトリ farion1231/cc-switch は活発にメンテナンスされている
悪いところ:
- dotfilesやshell aliasに慣れたパワーユーザーには、GUIはむしろ冗長
- 各CLIの設定スキーマが変わるとadapterも追従が必要で、CLIのアップグレード頻度が高いとバグが出やすい
- デスクトップバイナリがクローズドソース——ロジックが外から見えないため、セキュリティ監査は作者を信じるしかない
同種ツールとの比較:
aider の --model 切り替えと比較すると、コマンドラインでモデル名を直接差し替えるだけなので簡単。ただしモデル切り替えしかカバーせず、KeyやBase URLの切り替えには対応していない。
自前でshell functionを書いて環境変数を切り替える方法と比較すると、自由度は高いが自分でメンテナンスする必要がある。CLIがひとつだけならこれで十分だが、CLIとKeyの数が増えてくると収拾がつかなくなる。
cc-switchの立ち位置は「複数Key × 複数アカウント × 複数CLIの一元管理」。コマンドラインよりは重いけど、dotfilesを山ほど手で管理するよりはずっと楽。
誰が使うべきか
向いている人:
- AI CLIを2つ以上併用している開発者
- 複数のAPI Keyや中継プロキシを管理している人
settings.jsonを手で書き換えるのが面倒だと感じている人- チーム内にコマンドライン苦手なメンバーがいてGUIが必要な環境
向いていない人:
- Claude Codeひとつしか使わない人
- シェル愛好家でshell aliasで十分という人
- クローズドソースのバイナリに抵抗がある人(完全なオープンソース代替が出るのを待つ手も)
- Keyがひとつだけで切り替えの必要がない人——牛刀で鶏を割くことになる
雑感
cc-switchのようなツールが存在すること自体が、AIプログラミングツールがいまだ「設定地獄」段階にある事実を映している。各CLIがそれぞれ独自の設定体系を持ち、スキーマはバラバラで、切り替え体験は悪い。ツールの数が5〜6個に増えてくると、設定管理そのものが独立した問題になる。
短期的には、こうした「設定アグリゲーター」は需要がある。長期的には、二つのシナリオが考えられる。CLIツール側が設定フォーマットを標準化するか(例えば ~/.config/ai/ 以下に何らかの統一仕様)、あるいはIDE・エディタが設定レイヤーを飲み込むか(CursorやWindsurfのように)。そうなればcc-switchのような中間レイヤーは徐々に不要になっていく。
ただ、それは先の話。今この瞬間——Claude CodeとCodexを同時に走らせているなら、一度ダウンロードしてみる価値はある。リポジトリは farion1231/cc-switch、まずはREADMEを確認してから入れよう。