用 CC Switch 给 Claude Code 和 Codex 接自定义 API

1 条回复
30 次浏览

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/v1OpenAI 兼容客户端把这当作 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

发表一个评论

R保持