如果你用 Claude Code、OpenClaw 这类 Agent 工具,肯定遇到过手动改配置文件切换模型的痛苦 – 找 settings.json、填 base_url、写 auth_token、改 model name,稍有不慎就报错。CC Switch 就是来终结这件事的。
CC Switch 是一个 GitHub 上拥有 50K 星标的开源桌面应用,支持 Windows、Mac、Linux 全平台。它的核心能力很简单:帮你一键切换 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等 6 个 Agent 工具背后的模型,全程不用碰一行配置代码。
- 所需工具:CC Switch 桌面客户端(开源免费)
- 技术要求:无,纯图形界面操作
- 准备材料:至少一个模型供应商的 API Key(智谱、MiMo、DeepSeek、千问、Kimi 等均可)
打开 GitHub Release 页面,根据你的操作系统下载对应的安装包:
https://github.com/farion1231/cc-switch/releases
Windows 下载 .exe,macOS 下载 .dmg,Linux 下载对应的包。双击安装即可,首次打开你会看到一个风格与 Claude 相似但颜色不同的桌面应用。
- 在主界面点击对应 Agent(如 Claude Code)图标下方的加号
- 从内置的 40+ 家供应商中选择一家(智谱、MiMo、DeepSeek、千问、Kimi、MiniMax、豆包等均有预设)
- 选好供应商后,除 API Key 外的所有字段都会自动预填
- 填入你的 API Key,下拉查看 CC Switch 自动配置的模型版本(不满意可手动改)
如果不清楚模型名称,点击右上角「获取模型列表」即可查看该供应商支持的所有可调用模型。
点击右下角「保存」,然后在首页模型列表中点击「启用」。你不需要重启终端或关闭当前 Claude Code 会话,切换立即生效。
整个过程就三步:选供应商 -> 填 API Key -> 选模型,格式兼容、配置文件路径这些全部由 CC Switch 自动处理。
CC Switch 内置了用量追踪功能,可以实时查看 API 余额和 Coding Plan 的额度消耗。
- 在模型列表点击「配置用量查询」
- 打开「启用用量查询」
- 如果走 API 通道选「官方」,如果走 Token Plan 选对应的模型供应商
- 保存后在首页即可看到实时消耗和余额
这个功能非常适合做成本管理。日常小任务挂个性价比高的模型,大活再上旗舰模型,切换成本几乎为零。
如果你睡前给 Agent 派了大任务,担心半夜额度用完或网络中断导致任务中断,CC Switch 的本地代理服务可以解决。
- 进入「设置」->「路由服务」,打开本地路由开关
- 启用对应 Agent 的路由(如 Claude 路由)
- 打开「自动故障转移」,添加备用供应商进队列
- 在首页拖拽排序,CC Switch 会优先使用列表上方的供应商,故障时自动切到下一家
注意:如果你用的是 Claude 官方模型,建议不要开路由,目前兼容性还有问题。国产模型之间的故障转移是稳定的。
安装完成后,你可以通过以下方式验证是否生效:
- 在桌面右上角点击 CC Switch 图标,确认当前启用的模型
- 在 Claude Code 中发一条消息,观察回复是否来自你选定的模型
- 尝试在 CC Switch 中热切换到另一个模型,下一轮对话应立即使用新模型
- Q: 热切换时报错怎么办? A: 不要在模型正在生成回复时切换,等当前回复完成后再切。
- Q: 数据安全吗? A: CC Switch 是纯开源项目,所有数据(API Key、配置、用量等)都存储在本地 SQLite 数据库
~/.cc-switch/cc-switch.db中,不上传任何信息。 - Q: 支持哪些供应商? A: 内置 40+ 家供应商预设,涵盖智谱、MiMo、DeepSeek、千问、Kimi、MiniMax、豆包、阶跃等国内主流厂商。
- Q: 官方用户手册在哪? A: https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/282611.html