CC Switch在GitHub上已经51K星标，让Claude Code、OpenClaw、Hermes等Agent一键切换所有模型，热切换+用量追踪+故障转移，彻底告别手动改配置文件的烦恼。

为什么需要CC Switch

给Claude Code、OpenClaw这类Agent产品换模型，对非程序员来说有点麻烦——你得懂配置文件，知道啥是settings.json，还得手动填写base_url、auth_token、model name各种字段。

手动改过一次Claude Code的settings.json，你就知道这事有多烦。

CC Switch就是来解决这个问题的。它是一个桌面App，全平台Windows、Mac、Linux都能用。

支持的Agent工具

目前支持6个主流Agent工具：

• Claude Code
• Codex
• Gemini CLI
• OpenCode
• OpenClaw
• Hermes（最新版加入）

核心功能

1. 一键切换模型

三步搞定：

1. 选供应商（内置40+家预设：智谱GLM、DeepSeek、千问、Kimi、MiniMax、DouBaoSeed、阶跃等）
2. 填API Key
3. 选模型

剩下的格式兼容、配置写入，你都不用管。

2. 热切换

不需要重启终端，不需要关掉Claude Code当前会话。

正跑着任务觉得这个模型不太聪明？等它回复后，在菜单栏点CC Switch小图标，选个别的模型，切完立刻生效，下一轮对话直接就是新模型在回你。

用来做成本管理，贼爽。

日常任务挂个性价比高的模型，又快又便宜，切操作成本几乎为零。

3. 用量追踪

快速看到API key接入的余额，和coding plan的额度。

支持按时间段查看成本消耗，帮你掌握每个时间段的用量情况。

4. 故障转移（本地代理）

CC Switch可以在本地起一个代理服务，帮你做：

• API格式转换
• 故障转移
• 熔断保护

举例： 你给Claude Code配了GLM、MiMo、DeepSeek三家供应商，某天某一家宕机了或额度用完了，CC Switch会自动切到下一家继续跑，无痛迁移。

安装使用

安装

去GitHub下载对应系统的版本： https://github.com/farion1231/cc-switch/releases

基本操作

1. 打开CC Switch，点击Claude图标下的加号
2. 选择供应商（如Zhipu GLM）
3. 填入API Key
4. 选择想要的模型版本（可点击"获取模型列表"查看所有可用模型）
5. 点击保存
6. 首页列表启用

故障转移配置

1. 打开设置 → 路由服务 → 开启本地路由
2. 在应用路由区域启用Claude路由
3. 打开自动故障转移 → 添加备用供应商
4. 拖拽排序优先级
5. 关闭时在主页把开关关闭即可

⚠️ 注意：如果用的是Claude官方模型，建议别开路由，问题会比较多。

数据安全

所有数据存在本地SQLite数据库：~/.cc-switch/cc-switch.db

包括供应商配置、全局配置、模型定价等，纯本地存储，信息安全。

总结

CC Switch装上之后，Agent切换模型变成了一件零门槛的事：

• 三步配置 — 选供应商、填Key、选模型
• 热切换 — 不关会话、不重启终端
• 成本管理 — 实时追踪用量
• 故障转移 — 自动切备用供应商

GitHub：https://github.com/farion1231/cc-switch

官方用户手册：https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md