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 起。以下架构推测基于同类工具的常见设计,具体实现请翻源码。
核心设计点:
- Adapter 抽象层:每种 CLI 工具对应一个 adapter,负责读写它自己的配置目录。ClaudeAdapter 知道
~/.claude/settings.json长啥样,CodexAdapter 知道~/.codex/config.toml的 schema。 - Provider 模型:用户新建的「Provider」是一份配置模板 —— Key + Base URL + 模型名。切换 = 把模板渲染成目标 CLI 的配置文件格式。
- 热切换:改完配置后通过信号通知正在运行的 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 再下。