ANTHROPIC_BASE_URL 不生效：7 项排查清单

1. 确认当前进程真的读到了变量

# macOS / Linux
printf '%s\n' "$ANTHROPIC_BASE_URL"

# PowerShell
$env:ANTHROPIC_BASE_URL

期望值为 https://api.openlux.ai。空值说明配置根本没进入当前终端。

2. 排除错误路径

只填基础地址，不要写成 https://api.openlux.ai/v1/messages。网关会根据 Claude Code 的请求自动拼接接口路径。多写路径通常导致 404。

3. 检查认证变量

# 只确认是否存在，不要把 Key 输出到日志
test -n "$ANTHROPIC_AUTH_TOKEN" && echo TOKEN_SET

Claude Code 网关可使用 ANTHROPIC_AUTH_TOKEN。注意不要把 OpenAI 客户端的变量名直接照搬过来。

4. 彻底重启进程

退出所有 Claude Code 会话并新开终端。VS Code 内置终端是在 VS Code 启动时继承环境的，必要时连编辑器一起重启。

5. 网络与状态码定位

curl -I --max-time 10 https://api.openlux.ai
claude -p "只回复 OK"

• 401/403：密钥、余额或权限；
• 404：Base URL 或模型路由；
• 429：额度或速率限制；
• 连接超时：DNS、代理或防火墙。

6. 更新并诊断客户端

claude update
claude doctor

如果同一组变量在另一个设备可用，优先检查本机版本、证书和代理环境，而不是反复换 Key。

常见问题

变量名区分大小写吗？

在 macOS 和 Linux 上区分，必须准确写成 ANTHROPIC_BASE_URL。

能同时设置 HTTPS_PROXY 吗？

可以，但它是网络代理，与 LLM 网关地址不是同一概念；错误代理也可能造成超时。

参考资料

Anthropic：LLM gateway configuration · Cline：OpenAI Compatible