Claude Code 默认连 Anthropic 官方的接口。要改用第三方提供的 Anthropic 兼容接口——中转站,或者公司内部的网关——只需要告诉它两件事:接口地址和 key。这篇讲清楚这两项怎么设、写在哪里、和已经登录的账号怎么共存,以及怎么确认它真的生效了。
两个环境变量
| 变量 | 填什么 |
|---|---|
ANTHROPIC_BASE_URL | 接口地址,照站点给的填,不要自己加 /v1 |
ANTHROPIC_AUTH_TOKEN | 站点给你的 key,Claude Code 会按 Authorization: Bearer 发送 |
两个容易踩的坑:
- 地址不要带
/v1。Claude Code 会自己在地址后面接上/v1/messages;写成https://api.example.com/v1,请求就会发到/v1/v1/messages,结果是 404。 - key 前面不要自己加
Bearer,Claude Code 会加。
还有一个变量 ANTHROPIC_API_KEY,它按 X-Api-Key 请求头发送 key。多数中转站两种写法都认,以站点自己的说明为准;两个都设了的时候,ANTHROPIC_AUTH_TOKEN 优先。用 ANTHROPIC_API_KEY 时,交互模式下 Claude Code 第一次会问你要不要用这个 key,选择会被记住。
只对当前终端生效
macOS、Linux:
export ANTHROPIC_BASE_URL=https://api.example.com
export ANTHROPIC_AUTH_TOKEN=你的key
claudeWindows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.example.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的key"
claude关掉终端就失效了。想每次都生效,可以把这几行写进 shell 的配置文件(如 ~/.zshrc、PowerShell 的 $PROFILE),或者用下面的 settings.json。
长期生效:写进 settings.json
推荐写在用户级的 ~/.claude/settings.json(Windows 是 %USERPROFILE%\.claude\settings.json)的 env 里,对所有项目都生效:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.example.com",
"ANTHROPIC_AUTH_TOKEN": "你的key"
}
}几点说明:
- settings.json 里
env设的值,会覆盖 shell 里 export 的同名变量。两处都设过、结果不对时,先看这里。 - 只想对某一个项目生效,写在项目里的
.claude/settings.local.json。不要写进.claude/settings.json:它通常会提交进仓库,key 就跟着泄露了。 - 第一次运行就想跳过官方登录,要把
ANTHROPIC_AUTH_TOKEN设在 shell 里或~/.claude/settings.json里。项目里的设置要等首次设置和「信任这个文件夹」的提示之后才生效。
已经登录了官方账号
设了 ANTHROPIC_AUTH_TOKEN 之后,它会立即优先于你登录的账号,启动时 Claude Code 会提示认证冲突。想完全改用第三方接口,在 Claude Code 里执行 /logout,清掉保存的登录。
用第三方的地址或 key 时,Remote Control 和语音输入用不了,这是 Claude Code 本身的限制。
站点的型号名不一样
有的站会给型号改名,比如在官方名字后面加个后缀。这时用下面几个变量把 Claude Code 里的别名指到站点的名字:
| 变量 | 作用 |
|---|---|
ANTHROPIC_DEFAULT_OPUS_MODEL | opus 别名对应的型号 |
ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet 别名对应的型号 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku 别名对应的型号;Claude Code 后台的小任务(比如给会话起标题)也用它 |
ANTHROPIC_MODEL | 这次会话直接用的型号 |
如果站点没有 Haiku,后台小任务会报错,把 ANTHROPIC_DEFAULT_HAIKU_MODEL 指到站点有的型号就好。会话里可以随时用 /model 切换。
确认真的生效了
-
在 Claude Code 里输入
/status。状态页里会多出一行 Anthropic base URL(只有设了自定义地址才会出现),并写明用的是 Auth token 还是 API key。 -
用 curl 单独测一下接口通不通:
bashcurl -s "$ANTHROPIC_BASE_URL/v1/messages" \ -H "authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model":"claude-opus-5-5","max_tokens":32,"messages":[{"role":"user","content":"只回答 OK"}]}' -
跑一句
claude -p "只回答 OK",同时看站点后台的用量有没有增加。
接口通了,只说明配置对了,不说明站点给你的是原版 Claude。要查有没有掺水,见怎么判断一个中转站有没有掺水,或者直接用中转站检测测一遍。
常见报错
| 现象 | 多半是 | 怎么办 |
|---|---|---|
401、authentication_error | key 错了,或站点只认另一种写法 | 核对 key;试试把 ANTHROPIC_AUTH_TOKEN 换成 ANTHROPIC_API_KEY |
| 404 | 地址多写了 /v1,或者路径不对 | 照站点给的地址填,去掉多写的 /v1 |
| 提示型号不存在 | 站点的型号名和官方不同 | 用 ANTHROPIC_DEFAULT_*_MODEL 指过去 |
| 429 | 被限流 | Claude Code 会自动等待重试;经常出现说明站点的并发额度不够 |
529、overloaded_error | 上游过载 | 过一会儿再试 |
| 一启动就要求登录 | Claude Code 没读到 key | 把 ANTHROPIC_AUTH_TOKEN 设在 shell 里或 ~/.claude/settings.json 里 |
| 请求很久才报超时 | 默认等响应 10 分钟(API_TIMEOUT_MS,单位毫秒,默认 600000) | 按需要调整这个变量 |
可选:关掉非必要的联网
设 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1,Claude Code 会关掉自动更新、遥测、错误上报、/feedback 等非必要的联网,不影响对接口本身的请求。代价是一些靠功能开关下发的新功能会用不了。
安全提醒
- 中转站能看到你发给 Claude 的一切:代码、文件内容、命令的输出。只把它交给你信得过的站。
- Claude Code 会执行模型给出的命令,而这些命令经过中转站。不可信的站可以改写它们,所以对不熟悉的站,不要用
--dangerously-skip-permissions这类全部放行的模式。 - key 在 settings.json 里是明文:注意文件权限,别提交进仓库,泄露了马上去站点后台作废。