第 01 模块 · 4 节

用 cc-switch 管理多模型与 API Key

《Claude Code 基础入门》01 认识 Claude Code · 本节时长 20 分钟

贯穿项目这一节不写代码,但它会是你后面所有课程的「遥控器」:多个国内大模型、多个账号、多套 Key 来回切换,手改配置又慢又容易错。学完这节课,你会在一个图形界面里一键管理它们,把精力留给真正的开发。

为什么需要多模型管理

你大概率不止一个模型来源:

  • 多家国内大模型各有所长: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 启动时读取即生效——不需要额外路由、代理或格式转换。


快速上手

  1. 从 ccswitch.io 或 GitHub Releases 下载并安装对应平台的版本
  2. 打开应用,切到 Claude Code 标签
  3. 点右上角加号添加供应商:优先用预设(DeepSeek、智谱 GLM、Kimi 等已配好请求地址和默认模型),填入你的 API Key 保存即可
  4. 在供应商列表点「启用」完成切换
  5. 回到终端,重启 claude 会话,用新通道开始对话

切换后当前会话不生效是正常的——Claude Code 在启动时读取配置。/exit 退出重进即可。


落地练习:配两个供应商并切换

  1. 装好 cc-switch,在 Claude Code 标签下用预设添加两个供应商(比如 DeepSeek + 智谱 GLM),各填一个 Key
  2. 依次启用、重启会话,各问一句「你是谁家的模型」,确认两个通道都能通
  3. 打开测速功能,看看两个端点的延迟差异

怎么判断做对了?——两个供应商都能在 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 都只改一处。


小结

  1. cc-switch 是开源的跨平台供应商管理桌面应用,官方站 ccswitch.io
  2. 核心能力:Provider 管理、Key 集中保存、预设模板、测速、备份
  3. Claude Code 原生支持:切换即写入 live 配置,无需路由或代理
  4. 预设覆盖 DeepSeek、智谱、Kimi 等国内主流模型
  5. 切换后重启 claude 会话生效;Key 集中保存,别明文散落

下一节进入「终端与命令行基础」,我们先补齐终端底子,再和它正式对话。