用 CC Switch 给 Claude Code 和 Codex 接自定义 API
CC Switch 是开源桌面应用,用来给 Claude Code、Codex 这些命令行工具切换 API 供应商,不用自己改配置文件。下面按官方手册把安装、添加自定义供应商,以及两个工具在端点地址上的差别过一遍。
步骤以 CC Switch 中文手册 为准,安装包以官网或 GitHub Releases 的版本为准。
安装
只从 ccswitch.io 或 GitHub Releases 安装,不要用来路不明的包。
装好后,先在侧栏选要配置的工具,Claude Code 和 Codex 要分开配。
添加自定义供应商
多数自建网关或中转不在预设列表里,需要手动添加。侧栏选好工具后,点「添加供应商」,再选「自定义配置」。
名称自己起。API Key 和模型 ID 都到供应商控制台里复制,模型 ID 不要手打。Key 不要写进截图、仓库或评论。
接下来填端点。Claude Code 和 Codex(以及其它 OpenAI 兼容客户端)对 /v1 的要求不一样,填错最常见的报错是 404。
| 工具 | 端点怎么填 | 原因 |
|---|---|---|
| Claude Code | 只填主机,不要加 /v1。示例:https://api.niceai.dev | 客户端会自己拼接 /v1/messages,这里再加 /v1 就会重复 |
| Codex | 主机后面要加 /v1。示例:https://api.niceai.dev/v1 | OpenAI 兼容客户端把这当作 base_url,手册里的示例也带 /v1 |
Claude Code: 高级选项里把「上游格式」设为 Anthropic Messages(原生),不必开路由。
Codex: 高级选项把「上游格式」设为 Chat Completions(需开启路由),然后打开顶部「路由」标签,点「开始路由」。用的过程中不要退出 CC Switch。
切换和验证
在供应商卡片上点「切换」,按钮变为「使用中」。Claude Code 一般会热重载;Codex 需要完全退出后再打开。然后在对应工具里发一句很短的话,能正常回复即可。也可以对照供应商控制台同一时段的请求记录,确认走的是刚配的这条。
常见错误
/v1加错,返回 404。Claude Code 不加,Codex 和其它 OpenAI 客户端要加。- Codex 的上游如果只有 Chat Completions,却选了 Responses(原生),请求会失败。
- 系统环境变量里的
ANTHROPIC_API_KEY、OPENAI_API_KEY等,优先级通常高于配置文件。CC Switch 检测到会出黄色警告,先把冲突的环境变量去掉再试。 - 不要和 magpie 同时改同一个 Agent,两者都会写配置文件,容易互相覆盖。
更完整的步骤见手册 2.1 添加供应商 和 2.2 切换供应商 。
示例里用的是 niceai.dev
现在还有人用 cc?