工具

cc-switch:把 Claude Code、Codex 等多个 AI CLI 配置塞进同一个 GUI

Rust 桌面端,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 万 star,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 进程 reload。常见做法是 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,把不同 schema 的配置统一抽象成 Provider 对象 —— 这就是它能塞多个 CLI 进同一个 GUI 的关键。

它哪里好 / 哪里不好

好的地方:
- 跨平台,macOS / Windows / Linux 都覆盖
- Rust 写的,启动快、内存占用低
- GUI 门槛低,不懂 shell 的也能用
- 支持多个主流 AI CLI,还在加新的
- 仓库 farion1231/cc-switch 活跃维护

不好的地方:
- 对习惯 dotfiles / shell alias 的硬核用户来说,GUI 多此一举
- 每个 CLI 的配置 schema 变化时 adapter 要跟进维护,CLI 升级快了容易出 bug
- 闭源 desktop binary —— 代码逻辑看不到,安全审计只能信作者

和同类对比:

vs aider 的 --model 切换 —— 命令行直接换模型名,简单直接,但只解决模型切换,不解决 Key / Base URL 切换。

vs 自己写 shell function 切 env var —— 灵活但要自己维护,适合一个 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