导读Claude Code 接入 API 中转站的三种做法:手动在 settings.json 的 env 里写 ANTHROPIC_BASE_URL 和 Key,用 cc-switch 统一管理多个客户端,或用真测开源的 ZSwitch 一键切换。分别说明适合谁,以及接入前怎么确认中转站可用。

Claude Code 接中转站,说到底就是让它带着中转站的地址和 Key 去请求。常见做法有三种:手动改配置文件、用 cc-switch、用 ZSwitch。下面分别说明,最后按需要给出选择建议。

先确认中转站可用

不管用哪种方法,先确认三件事:中转站给的地址、API Key,以及它要求放在哪个请求头里。Claude Code 的地址一般填站点根地址,如 https://api.example.com,不带 /v1,Claude Code 会自己接上 /v1/messages。

接入前可以在 真测免费检测 填根地址、Key 和模型名跑一次,看返回的是不是声称的模型、流式是不是真的在推。

方法一:手动改 settings.json

Claude Code 启动时会读 ~/.claude/settings.json 里的 env。把地址和 Key 写进去:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx"
  }
}

ANTHROPIC_AUTH_TOKEN 以 Authorization: Bearer 发送;有的中转站要求用 ANTHROPIC_API_KEY,以 x-api-key 发送,按中转站的说明二选一。

这种方法不用装任何东西,适合只用一个中转站的人。缺点是每换一次都要手改,改错一个逗号 Claude Code 就读不了配置;文件里已有的 statusLine、hooks 等设置,也要自己小心别覆盖掉。

方法二:cc-switch

cc-switch 是 MIT 许可的开源桌面工具,支持 Windows、macOS 和 Linux。它覆盖的客户端多,除了 Claude Code 和 Codex,还有 Gemini CLI、OpenCode 等;内置大量供应商预设,带本地路由与故障转移、MCP 和 Skills 管理、用量统计和云同步。

适合同时用很多个 AI 编程客户端、想在一个地方管理 MCP 和用量的人。

方法三:ZSwitch

ZSwitch 是真测开发的开源工具(原名 z-switch,MIT 许可),参考了 cc-switch,只支持 Claude Code、Codex 和 Grok 三个客户端,把功能集中在切换和体检上:

  • 每个中转站一张卡片,点“切换”写入 settings.json 的 env,其他顶层字段保留,写前先备份。
  • 第一次启动保存原始配置,随时一键恢复。
  • 每张卡片能测连通性、测速,发一条最小流式请求看首字耗时;中转站只放行官方客户端时,可以模拟 Claude Code 的请求格式再试。
  • 可以让 Claude 桌面版和 VS Code 的 Claude Code 扩展跟随切换。

适合中转站换得勤、只用 Claude Code 或 Codex、希望每次切换前都能快速确认中转站可用的人。使用方法见 ZSwitch 使用教程。

怎么选

需要 建议
只用一个中转站,很少换 手动改 settings.json
同时用多个客户端,要管 MCP、用量 cc-switch
只用 Claude Code、Codex 或 Grok,经常换中转站 ZSwitch

三种方法都只是改 Claude Code 读到的地址和 Key,中转站本身的质量要另外判断。真测的 模型排行榜 公开了已收录站点的长期监测结果,可以对照着选。

常见问题

Claude Code 的中转站地址要不要带 /v1?

一般不带,填站点根地址即可,Claude Code 会自己接上 /v1/messages。以中转站给出的说明为准。

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 用哪个?

前者以 Authorization: Bearer 发送,后者以 x-api-key 发送。看中转站要求哪种请求头,二选一。

来源与核对

平台原创。cc-switch 与 ZSwitch 的仓库 README,2026-10-29 核对。ZSwitch 由真测开发。

最后更新 2026-10-29。平台数据会变化,以页面注明的日期为准。

内容有误或已过时?反馈给编辑