如果你用 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 等均可）

第一步：下载安装 CC Switch

打开 GitHub Release 页面，根据你的操作系统下载对应的安装包：

https://github.com/farion1231/cc-switch/releases

Windows 下载 .exe，macOS 下载 .dmg，Linux 下载对应的包。双击安装即可，首次打开你会看到一个风格与 Claude 相似但颜色不同的桌面应用。

第二步：添加模型供应商

1. 在主界面点击对应 Agent（如 Claude Code）图标下方的加号
2. 从内置的 40+ 家供应商中选择一家（智谱、MiMo、DeepSeek、千问、Kimi、MiniMax、豆包等均有预设）

3. 选好供应商后，除 API Key 外的所有字段都会自动预填
4. 填入你的 API Key，下拉查看 CC Switch 自动配置的模型版本（不满意可手动改）

如果不清楚模型名称，点击右上角「获取模型列表」即可查看该供应商支持的所有可调用模型。

第三步：保存并启用

点击右下角「保存」，然后在首页模型列表中点击「启用」。你不需要重启终端或关闭当前 Claude Code 会话，切换立即生效。

整个过程就三步：选供应商 -> 填 API Key -> 选模型，格式兼容、配置文件路径这些全部由 CC Switch 自动处理。

进阶功能：用量追踪与成本管理

CC Switch 内置了用量追踪功能，可以实时查看 API 余额和 Coding Plan 的额度消耗。

1. 在模型列表点击「配置用量查询」
2. 打开「启用用量查询」
3. 如果走 API 通道选「官方」，如果走 Token Plan 选对应的模型供应商
4. 保存后在首页即可看到实时消耗和余额

这个功能非常适合做成本管理。日常小任务挂个性价比高的模型，大活再上旗舰模型，切换成本几乎为零。

进阶功能：本地代理故障转移

如果你睡前给 Agent 派了大任务，担心半夜额度用完或网络中断导致任务中断，CC Switch 的本地代理服务可以解决。

1. 进入「设置」->「路由服务」，打开本地路由开关
2. 启用对应 Agent 的路由（如 Claude 路由）
3. 打开「自动故障转移」，添加备用供应商进队列
4. 在首页拖拽排序，CC Switch 会优先使用列表上方的供应商，故障时自动切到下一家

注意：如果你用的是 Claude 官方模型，建议不要开路由，目前兼容性还有问题。国产模型之间的故障转移是稳定的。

验证结果

安装完成后，你可以通过以下方式验证是否生效：

1. 在桌面右上角点击 CC Switch 图标，确认当前启用的模型
2. 在 Claude Code 中发一条消息，观察回复是否来自你选定的模型
3. 尝试在 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