CC Switch 使用教程：一键切换 Claude Code / Codex 的 API 供应商

用过中转额度的人都懂这个痛点：手里攒了好几家中转站的 key，Claude Code 要改 ~/.claude/settings.json，Codex 要改 ~/.codex/auth.json 和 config.toml，每换一家就手动改一遍文件，改错一个字段就跑不起来。CC Switch 就是解决这个问题的开源桌面工具：把每家供应商存成一条配置，点一下就切换。

项目地址：github.com/farion1231/cc-switch（截至 2026‑08 约 12 万+ star，最新版 v3.19.x，更新非常活跃），官网 ccswitch.io。具体功能以官方 README 为准。

CC Switch 是什么

基于 Tauri 2 的跨平台桌面应用（Windows / macOS / Linux），图形界面，不用记命令；
一个界面管理多个 AI 工具的供应商配置：Claude Code、Claude Desktop、Codex、Gemini CLI 等（新版本还支持 OpenCode 等更多工具）；
内置 50+ 供应商预设（官方登录、各家中转、AWS Bedrock 等），也可以完全自定义 Base URL + Key；
支持系统托盘直接切换、多设备云同步（WebDAV 等）、统一管理 MCP 与 skills 配置。

第一步：下载安装

到 GitHub Releases 下载对应平台的安装包（Windows 是 .exe/.msi，macOS 是 .dmg，Linux 有 .AppImage/.deb）。macOS 首次打开如果提示无法验证开发者，在「系统设置 → 隐私与安全性」里允许即可。

第二步：添加供应商

以「给 Claude Code 添加一个中转站」为例：

打开 CC Switch，顶部切到 Claude Code 标签；
点「添加供应商」，选一个预设或选择自定义；
填入中转站给你的 Base URL 和 API Key（买中转额度后商品页/卡密里会给这两样）；
保存。Codex 同理，在 Codex 标签下添加（Codex 的配置会写入 auth.json + config.toml，工具会帮你处理格式）。

如果你之前已经手动配置过，CC Switch 首次使用时可以把当前的 live 配置导入为默认供应商，不会丢现有配置。

第三步：一键切换

在主界面选中目标供应商，点切换；或直接从系统托盘菜单选择，立即生效；
切换的本质是把目标供应商的配置写入对应工具的 live 配置文件（Claude Code 是 settings.json；Codex 是 auth.json + config.toml）；
切换后新开一个终端再运行 claude / codex，确保新配置生效；
想切回官方账号登录，选择内置的「官方登录」预设，重启终端后按官方流程 /login 即可。

实用建议

额度用尽秒切备用：主力中转限流或维护时，托盘一点就切到备用家，任务不中断——建议常备两家以上中转额度；
官方订阅 + 中转混用：日常用官方订阅（Pro/Max），跑批量任务前切到便宜的按量中转；
改前备份：CC Switch 有配置迁移与备份机制，但手动改过大量配置的建议先自己备份 ~/.claude/ 和 ~/.codex/；
key 属于敏感信息，只存在本地配置里，不要截图外传。

和 Claude Code Router 怎么选

CC Switch 是「切换器」：改的是本地配置文件，一次只用一家。如果你想要自动路由（按任务把请求分发给不同模型、失败自动切换），要用的是网关类工具（如 Claude Code Router），两类工具的对比见开源 API 切换与管理工具对比。