CC Switch：给 Claude Code 一键换模型

装好 agent 工具之后，很多人遇到的第一个现实问题是：贵，或者不够用。

• 官方套餐额度用完了，还没到重置时间
• 简单的重复任务也在跑最贵的模型（原因见 2.6 Token 与模型选择）
• 想试试国产模型，价格能差一到两个数量级
• 某些地区访问官方服务不稳定

这些情况的解法是同一个：让 agent 工具去连别家的模型。

技术上这件事不难——多数工具都支持通过配置文件或环境变量指定「用哪家的接口、用哪个 key」。麻烦的是手改：改哪个文件、写哪几个字段、切回去怎么办、每个工具还不一样。

CC Switch 就是把这件事做成了点几下鼠标。

它是一个开源的桌面应用（基于 Tauri + Rust，Windows / macOS / Linux 三平台都有），官方的说法是：

给你一个桌面 App，统一管理所有支持的 AI 工具。不用手动编辑配置文件，你得到的是一个可视化界面：一键导入供应商、瞬间切换，内置 50+ 供应商预设。

它管得住的工具（八个）：

Claude Code、Claude 桌面端、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes。

它管的不止是模型： MCP 服务端、Skills、提示词也能在这个界面里统一管理——这几个概念分别见 2.4 MCP 是什么、2.3 Skill 是什么。

一句话定位：它不是模型，也不是 agent 工具，而是这两者中间的配置管家。

这一步值得看清楚，出问题的时候你才知道去哪查。

CC Switch 做的事情是：替你写 agent 工具原本就要读的那份配置。 具体来说，它管理的是各工具依赖的接口地址和认证信息，例如 Claude Code 这边就是 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 这类配置项——你在界面上点「启用」，它就把对应供应商的地址和 key 写进去。

它自己的数据存在这里：

知道这两个位置有两个用处：备份（换电脑时带走）和排查（怀疑配置乱了时先看这里）。

⚠️ 数据库里存着你的 API Key，不要把这个目录同步到公开的云盘或代码仓库。相关的安全常识见 3.8 API Key 和 .env 是什么。

去项目的 GitHub Releases 页面下载对应系统的安装包：github.com/farion1231/cc-switch

macOS 用命令行装最省事：

brew install --cask cc-switch

装完直接从应用列表打开，是一个带界面的窗口，不需要在终端里操作。

下载认准官方仓库地址。这类「配置管家」拿得到你的 API Key，来源必须可靠——这是 2.4 MCP 是什么 那篇里讲过的同一条纪律。

打开 CC Switch，基本流程只有三步：

1. 点 Add Provider（添加供应商）
2. 从 50+ 内置预设里选一个（DeepSeek、硅基流动、AWS Bedrock 等都在其中）
3. 填入你在那家申请到的 API Key，保存

预设会自动带上正确的接口地址和模型名，你只需要提供 key——这正是它省事的地方：不用去查该填哪个 URL、模型名怎么写。

API Key 从哪来？ 去对应厂商的开放平台注册、创建 key。这一步的通用知识（key 是什么、为什么不能泄露、怎么保管）在 3.8 API Key 和 .env 是什么 里讲过。

先想清楚再填：

• 用之前先在那家的控制台确认余额和限流，很多「切换后不能用」其实是余额为零
• 一个 key 只给它该有的权限，别到处复制粘贴

配好之后，切换只有两步：

1. 选中你要用的供应商
2. 点 Enable（启用）

也可以从系统托盘图标直接切，不用每次打开主界面。

关键的一条差别（官方明确写了）：

对大多数工具来说，切换后需要重启终端或该 CLI 工具才生效。例外是 Claude Code，它目前支持热切换。

所以：

建议养成一个习惯：切完之后，先用一句简单的话试一下（比如「你现在用的是哪个模型」），确认真的切过去了再干正事。

这是使用中最高频的问题，按顺序排查：

① 没重启。 除了 Claude Code，其他工具都要退出终端、重新打开、再启动。这一条能解决大半。

② 你自己也设了环境变量。 如果你之前手动在系统里配过 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 之类的变量，它可能会盖过 CC Switch 写的配置。检查一下：

# macOS / Linux
echo $ANTHROPIC_BASE_URL

# Windows PowerShell
$env:ANTHROPIC_BASE_URL

手动设过的，先清掉，让 CC Switch 统一管。

③ 余额或限流。 报 401 多半是 key 不对或过期，报 429 是被限流了，报余额不足就去充值。这些是供应商侧的问题，不是 CC Switch 的。

④ 模型名对不上。 用自定义供应商（不是内置预设）时容易出现——对方的模型名和你填的不一致，去那家的文档确认一次。

排查顺序建议永远是：先重启，再看环境变量，再看供应商控制台。

接下来可以看：

• 3.7 在 Codex 里直接用 DeepSeek —— 不装任何第三方工具，官方脚本直接换
• 2.6 Token 与模型选择 —— 换之前先想清楚该换成哪一档
• 3.8 API Key 和 .env 是什么 —— key 的保管方式

提醒一句：换模型是省成本的手段，不是提升质量的手段。复杂任务用便宜模型反复做错，并不省钱——判断标准是「完成这件事的总成本」，包括你返工的时间。