乐于分享
好东西不私藏

CC Switch:一个工具管七个 AI CLI 的配置

CC Switch:一个工具管七个 AI CLI 的配置

同时用 Claude Code、Codex、Gemini CLI 切 provider 切到疯?这个开源工具帮你一键搞定。


为什么我需要这个工具

上个月有天快凌晨两点,我还在改配置文件。

原因很蠢。我要把 Codex 临时切到一个便宜的 relay 跑个测试,结果改了半小时愣是没弄好,最后才发现是 wire_api 字段的问题——这玩意儿从 0.137.0 开始把 "chat" 废掉了,只认 "responses",但 Codex 不会给你一个好好的报错,就这么静静地挂着让你猜。

我当时同时装着 Claude Code、Codex 和 Gemini CLI,每个都有自己的配置文件,格式还各不一样:

  • ~/.claude/settings.json
     是 JSON
  • ~/.codex/config.toml
     是 TOML
  • ~/.gemini/.env
     是环境变量

切 provider 的时候三个全要改,那晚上我改 Codex 那边写错了一个字段,但以为是 Claude Code 的问题,查了二十分钟才找到。

那以后我就开始找有没有工具能统一管这些东西。

CCSwitch 是什么

找到 CCSwitch 是在一个 GitHub trending 邮件里,farion1231/cc-switch,当时 Star 数大概九万多,我截图发给同事,他说"这玩意儿这么多 Star 是不是刷的"。现在已经超过 11 万了,还在涨。

这个项目做的事说起来不复杂:把 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 这七个工具的配置管理,统一塞进一个桌面 App 里。

技术栈:
Rust + Tauri 2 + React
支持平台:
Windows / macOS / Linux
最新版本:
v3.16.3(六月中旬发布)
其他数据:
⭐ 110k+  |  🔀 6.9k Fork  |  📄 MIT 开源

我实际在用的几个功能

用了两个多星期,说说我实际在用的几块。

1. Provider 一键切换

provider 切换这块是最直接的改变。内置了 50 多个预设,DeepSeek、OpenRouter、NVIDIA NIM、AWS Bedrock、Kimi,还有一堆国内的 relay 服务,基本你能用到的都在里面。

以前我接一个新 provider 要去翻文档找字段名,有没有 base_url,auth 头怎么写,搞一遍起码半小时。

现在就三步:下拉菜单选 → 粘 API Key → 点添加

Universal Provider:一套配置可以同步到 Claude Code、Codex 和 Gemini CLI 三个工具,不用分别加三次。我接 OpenRouter 的时候用了这个,一次配置,三个工具都走同一个 key。

2. 托盘快切

托盘快切我每天都在用。不需要打开主界面,右键托盘图标,选工具,选 provider,点一下,配置文件就已经改好了。

Claude Code 支持热重载,不用重启终端,下一条命令直接走新的 provider。其他工具要重开终端,但整个过程也就十来秒。

我掐过表,以前手动改文件平均要四五分钟,现在十几秒,差距挺大。

3. MCP 统一管理

MCP 管理那个面板也让我省了不少重复劳动。

以前装一个新的 MCP 工具,要分别去 Claude Code、Codex、Gemini CLI 各自的配置文件里加一遍,三个地方三种格式。

现在在 CCSwitch 里加一次,勾一下要同步的工具,它帮你写进去,而且是双向同步的,你直接在配置文件里改的东西它也会回填,不会被覆盖。

怎么安装

各平台都有对应的包:

macOS(Homebrew)

brew install --cask cc-switch

Windows

去 GitHub Releases 页面下 .msi 包,双击装完就能用。

Linux

有 .deb、.rpm、AppImage 三种格式。

Arch Linux

paru -S cc-switch-bin

注意:CCSwitch 只管配置文件,不帮你装那些 CLI。Claude Code 之类的还是要自己装好:

npm install -g @anthropic-ai/claude-code

这步不能省。装完打开 App,左上角切换器里七个工具,没装的显示灰色,不影响其他工具正常用。

两个容易被忽略的好用功能

还有两个功能,我估计很多人装了也没发现。

费用看板

可以按 provider 拆分看 token 消耗和花费,支持自己填每个模型的单价。我同时接了官方 API 和几个 relay,以前完全不知道各自花了多少,靠账单月底才能算出来。现在这个面板实时给我看,心里有数了。v3.16.3 加了从 models.dev 导入定价数据的功能,不用手动填了。

云同步

配置可以同步到 Dropbox、OneDrive、iCloud 或者 WebDAV 服务器,多台设备共用一套配置。我台式机和笔记本以前两边老是对不上,用了这个好多了。

总结一下

优点:

  • 七个 AI 工具配置统一管理
  • 50+ provider 预设,开箱即用
  • 托盘快切,十几秒搞定
  • MCP 一次添加,多工具同步
  • 费用看板 + 云同步,实用

局限:

配置是每台机器独立的,没有把配置一键推给整个团队的功能。如果你们团队需要共享一套统一的 relay 配置,还得另想办法。

但对个人用户来说够用,值得装。

你现在本地装了几个 AI 编程工具?

评论区说说,我好奇大多数人到底在同时用几个。


如果觉得有用,欢迎转发分享