遇到“Claude Code 怎么走中转站 API”这类问题,我一般不会直接给出一套环境变量让读者复制,而是先问一句:中转站到底给出的是哪种接口?因为没有这个前提,后续所有配置都可能白做。以下是我在实际处理时走的顺序,以及每一步需要观察的指标。
先确认中转站支持什么协议
接入中转站前,先确认该中转站是否提供与 Anthropic 官方相同的 Messages API。Claude Code 默认请求的是 /v1/messages 路径,并携带 x-api-key 与 anthropic-version 头。你可以用 curl 向中转站的健康检查或模型列表接口试探,比如 GET /v1/models,但更关键的是看文档是否明确列出支持 Claude 系列模型。如果只提供 OpenAI 兼容接口,可能无法直接对接,需要额外转换层。
这一步通常花不了几分钟,但能筛掉大半不匹配的中转站。文档里如果写着“Claude Code 接入”或“Anthropic API”,那大概率可以直接用;如果只写“OpenAI 格式”,就要准备好做一层协议转换,而不是改改 Base URL 就能通。也可以直接发一个 POST /v1/messages 的请求,看返回的是 JSON 还是 HTML 错误页,能快速判断对方是否真的实现了这个协议。
配置环境变量时的关键细节
对于支持 Anthropic 协议的中转站,核心设置是环境变量:在终端执行 export ANTHROPIC_BASE_URL="https://中转站地址" 与 export ANTHROPIC_API_KEY="中转站分配的密钥"。注意变量名必须完全大写,且 Base URL 不应带 /v1 后缀,Claude Code 会自动拼接。设置后直接运行 claude 命令,如果出现连接错误或 401,可检查变量是否被正确读取:echo $ANTHROPIC_BASE_URL。如果中转站要求额外的项目 ID 或路由参数,则需要按文档拼入 URL 或增加环境变量。
这里我见过最典型的错误是 Base URL 带上了 /v1,或者变量名写成小写。Claude Code 内部拼接 API 路径时不会帮你做容错,多一个 /v1 就会导致 404。另外,有些中转站要求把密钥放在 Authorization 头而不是 x-api-key,这时需要看中转站是否提供了专门的 Claude 配置文件,只设环境变量可能不够。如果你希望设置永久生效,可以把 export 写进 ~/.bashrc 或 ~/.zshrc,但我不建议直接覆盖默认配置,而是先把原来的值存一份,例如注释掉。这样以后要切回官方 API,不用凭记忆重新拼。
如何验证链路是否真的通了
验证是否接入成功,最简单的方法是使用 claude 发起一句对话,观察响应内容。若收到正常回复,说明链路可用。若出现 401 或 403,说明密钥或权限有问题;若出现 404 或 405,说明 Base URL 路径不对;若是超时或 SSL 错误,则要检查网络代理和证书。也可以先对中转站地址做一次 curl 测试:curl -X POST https://中转站地址/v1/messages -H "x-api-key: 你的密钥" -d '{"model":"claude-3-5-sonnet-20241022","max_tokens":10,"messages":[{"role":"user","content":"ping"}]}',这样可以区分是 Claude Code 配置问题还是中转站本身问题。
curl 返回的内容要分两层看:HTTP 状态码和响应体。200 且带 content 字段,说明接口是通的,问题在 Claude Code 一侧,比如模型名不匹配或环境变量没被读到。如果是 404,多半是路径拼接错误,检查 Base URL 是否多了 /v1。如果是 401,先确认密钥是否复制完整,很多密钥有隐藏换行符。还有一种情况是证书报错,通常需要加上 -k 先临时跳过验证,但生产环境不应该这样做,要解决根证书问题。
容易误判的几个点
接入成功后遇到最多的不是连不上,而是报 model not found。不少中转站会对模型名做别名映射,比如把 claude-3-5-sonnet-20241022 写成 claude-sonnet-3.5。如果你一直用官方模型名请求,就会失败。处理方式是去中转站控制台或文档查看它实际支持的名字,然后通过环境变量 ANTHROPIC_MODEL 或 claude 的配置文件指定,或者在中转站后台设置默认模型。另一个容易误判的是 max_tokens 限制。中转站通常会在服务端设一个最大值,超过就拒绝请求。Claude Code 的部分操作会请求较长的输出,如果被拒绝,可以手动调低 max_tokens,或者换用一个支持更大上限的套餐。并发限制也类似,多任务并行出现 429 时,要做的是减少并行度,而不是反复重试。这些限制不会显示在文档第一屏,需要你实际跑几次才能摸清。
回滚和后续维护
用中转站期间,我会把官方 API 的配置保留在一个单独的 shell 文件里,比如 ~/.claude_official.sh,切换时一行 source 就能恢复。回滚的步骤很简单:先 unset ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY,再重新 export 官方值。如果你之前把 Base URL 写进了配置文件,也需要改回来,否则环境变量会被覆盖。这里给出一段简单的回滚示例:unset ANTHROPIC_BASE_URL; unset ANTHROPIC_API_KEY; export ANTHROPIC_BASE_URL="https://api.anthropic.com"; export ANTHROPIC_API_KEY="你的官方密钥"。
数据安全方面要多想一步。中转站会记录你的请求内容,虽然大多数情况下是日志存储,但是否会被查看或用于其他用途并不透明。因此不要在对话里输入真实密码、私钥、身份证号等敏感信息。部分中转站为了降本,可能会在特殊时段替换成更便宜的模型或缩短上下文窗口,导致同样的 prompt 回复质量波动。这类问题难以从配置层面发现,只能通过对比官方回复来确认。
如果只是临时测试或网络环境受限,中转站是一个可以接受的替代路径。但长期使用,还是要评估稳定性和数据敞口。建议在 Claude Code 配置中保留官方和第三方两套参数,需要时快速切换,而不是把所有希望寄托在一个第三方通道上。