为什么需要多模型管理
你大概率不止一个模型来源:
- 多家国内大模型各有所长:DeepSeek 擅长推理与代码、智谱 GLM 中文对话好、Kimi 长文本强、通义千问生态全……
- 同一家可能注册了多个 Key:限流、并发、成本分摊时换着用
- 官方通道与第三方兼容通道并存:不同场景用不同通道
手动管理意味着:每次切换都去翻配置文件、改环境变量、重启会话、试错。这正是 cc-switch 要解决的。
cc-switch 是什么
cc-switch(GitHub:farion1231/cc-switch,唯一官网 ccswitch.io)是一个开源的跨平台桌面应用(Windows / macOS / Linux),统一管理 Claude Code、Codex、Gemini CLI 等工具的模型供应商。你可以把它理解成这些工具的「供应商遥控器」。
核心能力:
| 能力 | 说明 |
|---|---|
| Provider 管理 | 增删改查、一键切换、排序 |
| API Key 集中保存 | 真实 Key 不散落在各工具配置文件里 |
| 预设模板 | 内置 DeepSeek、智谱、Kimi 等常见模型的请求地址与默认模型 |
| 端点测速 | 对比各供应商的延迟,选快的 |
| 配置导入导出与备份 | 换机器不丢配置,改坏能回滚 |
| MCP 管理 | 跨工具同步 MCP 服务器(进阶再深入) |
它对 Claude Code 是「原生支持」:Claude Code 的配置就是普通文件,cc-switch 切换时把供应商配置直接写进这些 live 文件,Claude Code 启动时读取即生效——不需要额外路由、代理或格式转换。
快速上手
- 从 ccswitch.io 或 GitHub Releases 下载并安装对应平台的版本
- 打开应用,切到 Claude Code 标签
- 点右上角加号添加供应商:优先用预设(DeepSeek、智谱 GLM、Kimi 等已配好请求地址和默认模型),填入你的 API Key 保存即可
- 在供应商列表点「启用」完成切换
- 回到终端,重启 claude 会话,用新通道开始对话
切换后当前会话不生效是正常的——Claude Code 在启动时读取配置。
/exit退出重进即可。
落地练习:配两个供应商并切换
- 装好 cc-switch,在 Claude Code 标签下用预设添加两个供应商(比如 DeepSeek + 智谱 GLM),各填一个 Key
- 依次启用、重启会话,各问一句「你是谁家的模型」,确认两个通道都能通
- 打开测速功能,看看两个端点的延迟差异
怎么判断做对了?——两个供应商都能在 Claude Code 里正常对话,且回答能表明当前走的是哪个通道;切回第一个供应商后配置仍然保留。
卡住了怎么办? 启用后连不上 → 先确认 Key 有效、余额充足。切换后没变化 → 确认重启了 claude 会话。预设里没有你要的供应商 → 用自定义配置,按对方文档填 base URL 和模型名。
常见坑:把「切换工具」当成「路由」
最典型的误解是把 cc-switch 当成需要特殊配置的东西。对 Claude Code 来说它只是配置管理器——写入的仍是 Claude Code 原生支持的格式,直连上游,不需要开启任何路由。
需要「路由」的是另一类场景:比如 Codex 要接 Chat 格式的国内接口时,才需要在 cc-switch 里开启本地路由做格式转换(详见 Codex 课程)。Claude Code 这边,切了就能用。
另外一个安全习惯:Key 只填在 cc-switch 里,别为了省事写进 Claude Code 配置文件明文。集中管理,换机器、换人、轮换 Key 都只改一处。
小结
- cc-switch 是开源的跨平台供应商管理桌面应用,官方站 ccswitch.io
- 核心能力:Provider 管理、Key 集中保存、预设模板、测速、备份
- Claude Code 原生支持:切换即写入 live 配置,无需路由或代理
- 预设覆盖 DeepSeek、智谱、Kimi 等国内主流模型
- 切换后重启 claude 会话生效;Key 集中保存,别明文散落
下一节进入「终端与命令行基础」,我们先补齐终端底子,再和它正式对话。