ツール

cc-switch:Claude CodeもCodexも、全部まとめてGUIで切り替え

Rust製のデスクトップアプリで、Claude CodeやCodexなど複数のAI CLIのProvider・API Key・Base URLを一括管理。CLIプロセスを再起動せずにワンクリックで切り替えられる。

文字サイズ

ターミナルで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前後はある。以下のアーキテクチャ推測は同種ツールの一般的な設計に基づくもので、実装はソースコードを参照してほしい。

設計上のポイント:

  1. Adapter抽象レイヤー:各CLIツールに対応するadapterが、自分の設定ディレクトリの読み書きを担当する。ClaudeAdapterは ~/.claude/settings.json の形式を知っているし、CodexAdapterは ~/.codex/config.toml のスキーマを把握している。
  2. Providerモデル:ユーザーが作成する「Provider」は設定テンプレートで、Key + Base URL + モデル名からなる。切り替えとは、このテンプレートを各CLIの設定ファイル形式にレンダリングすること。
  3. ホット切り替え:設定を書き換えた後、起動中の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を確認してから入れよう。

出典: https://github.com/farion1231/cc-switch