工具

cc-switch:把 Claude Code、Codex 等 AI CLI 整合進同一個 GUI

Rust 打造的桌面工具,GitHub 上累積 12.8 萬星,能統一管理多款 AI 程式設計 CLI 的 Provider、API Key 與 Base URL,點一下就能切換,不用重啟 CLI 進程。

字級

cc-switch:把 Claude Code、Codex 等多個 AI CLI 設定塞進同一個 GUI

開一個終端機跑 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 後端),而非 Electron —— Electron 打包出來至少 400MB 起。以下架構推測基於同類工具的常見設計,實際實作請參考原始碼。

核心設計重點:

  1. Adapter 抽象層:每一種 CLI 工具對應一個 adapter,負責讀寫它自己的設定目錄。ClaudeAdapter 知道 ~/.claude/settings.json 長什麼樣子,CodexAdapter 則清楚 ~/.codex/config.toml 的 schema。
  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 進程重新載入
    notify_process(cli.process_name(), Signal::Reload)?;
    
    Ok(())
}

每一種 CLI 配一個 adapter,把不同 schema 的設定統一抽象成 Provider 物件 — 這就是它能把多個 CLI 塞進同一個 GUI 的關鍵。

優點與缺點

優點:

  • 跨平台,macOS / Windows / Linux 全部支援
  • Rust 撰寫,啟動速度快、記憶體佔用低
  • GUI 門檻低,不熟悉 shell 的人也能輕鬆上手
  • 支援多款主流 AI CLI,且持續新增中
  • 倉庫 farion1231/cc-switch 維護活躍

缺點:

  • 對習慣 dotfiles / shell alias 的重度使用者來說,GUI 反而是多此一舉
  • 每個 CLI 的設定 schema 變動時,adapter 得跟著維護更新;CLI 升級太快時容易踩到 bug
  • 桌面 binary 是閉源的 — 程式邏輯看不到,安全審查只能信任作者

與同類工具比較:

vs aider 的 --model 切換 — 命令列直接換模型名稱,簡單直覺,但只解決模型切換,沒處理 Key / Base URL 切換。

vs 自己寫 shell function 切換環境變數 — 靈活但得自己維護,適合單一 CLI 場景;一旦 CLI 與 Key 數量變多就會一團亂。

cc-switch 的定位是「多 Key 多帳號 + 多 CLI 的集中管理」,比命令列繁重,但比手動維護一堆 dotfiles 來得省心。

誰適合使用

適合:

  • 同時跑 2 個以上 AI CLI 的開發者
  • 需要管理多組 API Key / 中轉代理的人
  • 嫌手動改 settings.json 太煩的人
  • 團隊中有人不熟命令列、需要 GUI 操作的人

不適合:

  • 只使用 Claude Code 一種工具的人
  • 純 CLI 派,自己寫 shell alias 就夠用的人
  • 對閉源二進位有疑慮的(可等社群推出完全開源的替代品)
  • 手上只有一把 Key 不必切來切去的人 — 殺雞用牛刀

一點觀察

cc-switch 這類工具的存在,反映了一個現實:AI 程式設計工具仍處於「設定地獄」階段。每個 CLI 都有自己的設定體系,schema 各異,切換體驗不佳。當工具數量累積到 5 到 6 個時,設定管理本身就成了一道獨立難題。

短期來看,這種「設定聚合器」仍有市場。長期來看,要麼 CLI 工具自行統一設定格式(例如統一採用 ~/.config/ai/ 下的某項規範),要麼 IDE / 編輯器接管設定層(例如 Cursor、Windsurf 這類工具),cc-switch 這樣的中間層遲早會被邊緣化。

不過那都是以後的事,眼前 — 如果你同時在跑 Claude Code 與 Codex,不妨下載來試試。倉庫在 farion1231/cc-switch,先看 README 再決定安裝。

來源: https://github.com/farion1231/cc-switch