导读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 发送。看中转站要求哪种请求头,二选一。