别再手改一堆 AI CLI 配置了
最近 AI 编程工具越用越多,真正麻烦的反而不是模型本身,而是配置。
Claude Code 有自己的配置,Codex 有自己的配置,Gemini CLI、OpenCode、OpenClaw 又各有一套。供应商、API Key、MCP、Skills、Prompt 模板散在不同地方,刚开始还能靠记忆,工具一多就容易乱。
farion1231/cc-switch 做的就是这件事:把这些入口收进一个桌面工具里。它不只是换供应商,而是想把 AI CLI 的日常配置集中起来。

它解决的不是切换按钮
CC Switch 的名字容易让人以为它只是切换供应商。看完项目说明后,更准确的理解应该是“AI CLI 配置总控”。
它支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw。核心能力包括供应商管理、MCP 服务器管理、Skills 和 Prompt 管理、本地代理、故障转移、配置备份,以及跨设备同步。
这些东西单独看都不新。但放在一起,刚好对应 AI 编程工具最容易烦人的几个地方。
改配置本身不难。麻烦的是每个工具都要改一遍,还要记住哪个工具用 JSON,哪个工具用 TOML,哪个工具靠环境变量,哪个工具重启终端才生效。人很容易在这种小事上消耗耐心。
重点看三件事
第一是供应商配置。
现在很多人不会只用一个模型入口。官方 API、第三方中转、本地模型、不同地区的服务,经常要来回切。CC Switch 提到有 50+ 预设供应商,也支持自定义 OpenAI-compatible API。这个方向是对的,因为手填 base URL 和 key 本身没难度,难的是长期维护。
第二是 MCP。
MCP 越来越像 AI 工具的插件层,但它也带来了新问题:同一个 MCP 服务,可能希望 Claude Code 能用,Codex 也能用,OpenCode 也能用。如果每个工具都单独维护一份配置,迟早会出现“这个工具能连,那个工具忘了同步”的情况。
CC Switch 把 MCP 放进统一管理面板,并支持 stdio、http、sse,这点比单纯切模型更有价值。
第三是备份和回滚。
项目文档里提到会保留最近 10 个配置版本,也会做原子写入和权限处理。这个细节很关键。配置管理工具最怕自己把配置写坏,尤其里面还可能有 API Key。工具越接近底层配置,越应该先保证别添乱。
试用时别一步到位
试 CC Switch 时,不建议一上来把所有工具都交给它。
可以先拿一个最常用的工具做测试,比如 Claude Code。先添加两个供应商,一个官方入口,一个备用入口。确认切换后能正常工作,再去看 Codex 或 OpenCode。
安装上,macOS 可以走 Homebrew:
1 | |
如果不想加 tap,也可以去 GitHub Releases 下载安装包。Windows 有 MSI 和便携版,Linux 也提供 deb、rpm、AppImage,以及 Arch 的 AUR 包。
更值得关注的不是安装过程,而是试用后的几个结果:
- 切换供应商后,CLI 是否真的按预期生效。
- MCP 同步后,各工具是否能保持一致。
- 配置文件改动是否清晰,出了问题能不能回滚。
- API Key 存放和文件权限是否让人放心。
- 多设备同步是否会制造新的冲突。
如果这些点都稳定,它才算真正省心。
它适合谁
如果你只用一个 AI 编程工具,而且长期只连一个官方模型,那 CC Switch 可能没必要。手动配置一次就够了。
但如果你已经同时用 Claude Code、Codex、Gemini CLI、OpenCode 或 OpenClaw,情况就不一样了。多个工具、多套供应商、多份 MCP 配置,很容易把简单问题变成日常维护负担。
CC Switch 适合的不是“想尝鲜的人”,而是已经被配置分散折腾过的人。
也要留一点谨慎
这类工具有一个天然风险:它越方便,就越容易变成新的单点依赖。
原本每个 CLI 的配置虽然分散,但至少是透明的。现在把它们交给一个桌面应用管理,就要看它写配置是否稳、备份是否可靠、跨版本升级是否干净。
所以不能只看界面舒服不舒服,更要看它有没有把底层配置处理得足够稳。
它的方向是有价值的。AI 编程工具会越来越多,配置也只会越来越碎。未来真正省时间的工具,可能不是再多一个聊天窗口,而是把这些散乱入口整理好。
CC Switch 做的就是这件事。