Claude Code 接第三方端点只需要两个值:ANTHROPIC_BASE_URL(端点根地址)和 ANTHROPIC_AUTH_TOKEN(Key)。先用「临时生效」那段在当前窗口验证,能用了再选「永久生效」或写进 settings.json。
生成的变量名与请求头对应关系已在 Claude Code 2.1.312 实测(2026-11-03):ANTHROPIC_AUTH_TOKEN 发 Authorization: Bearer,ANTHROPIC_API_KEY 发 x-api-key;Claude Code 会在 Base URL 后自动拼接 /v1/messages。
四段输出分别什么时候用
| 输出 | 作用范围 | 适合 |
|---|---|---|
| ① 临时生效 | 只对当前终端窗口,关掉就没了 | 第一次配置,先确认能用 |
| ② 永久生效 | 之后新开的终端都能读到 | 确认能用之后,只在终端里用 Claude Code |
| ③ settings.json | Claude Code 所有入口,包括 VS Code、JetBrains 插件 | 在 IDE 里用,或者不想改系统环境变量 |
| ④ 验证命令 | 不经过 Claude Code,直接请求端点 | Claude Code 报错时,判断问题出在本地配置还是端点、Key |
②和③选一个就够了。两处都写而且值不一样时,排查起来很麻烦。
生成器会帮你检查的几个错误
- 地址多写了 /v1:Claude Code 实测会在 Base URL 后面自己拼
/v1/messages。地址写成https://xxx/v1,实际请求就变成/v1/v1/messages,结果是 404。 - Key 首尾有空格或换行:从网页或聊天软件复制时最常见。Claude Code 会把它原样发出去,服务端判定为无效 Key。
- Windows 用 setx 后当前窗口不生效:setx 只影响之后新开的窗口,生成的命令里加了提醒。
- zsh 和 bash 写错文件:macOS 默认是 zsh,配置要写进
~/.zshrc,写进~/.bashrc不会生效。
两个变量选哪个
生成器默认用 ANTHROPIC_AUTH_TOKEN。实测两者的区别只在请求头:前者发 Authorization: Bearer,后者发 x-api-key。服务方文档写哪个就用哪个;两种都支持的话,选哪个都可以,但只设一个。
Key 会不会泄露
不会离开你的浏览器。这个页面没有任何把输入发往服务器的代码,所有拼接都在本地 JavaScript 里完成。不放心可以把 Key 留空,生成后再手动替换占位符。
常见问题
配好之后 Claude Code 还提示 Not logged in?
先看报错出现得快不快。1 秒内出现说明变量没被读到,检查是不是在同一个窗口、是不是写错了配置文件;等了几分钟才出现说明 Key 被服务端拒绝,用第④段命令看具体原因。详见 Not logged in 排查。
settings.json 已经有内容了怎么办?
只把 env 里的几行合并进去,不要整个覆盖。文件里如果已经有 env 对象,就把这几个键加到原有的 env 里。
API_TIMEOUT_MS 要不要设?
网络稳定时不用设。经常在长任务中途报超时,可以适当调大。这个值只影响等待单次响应的时长,不会让请求变快。