Claude Code 自定义 API 端点配置指南（ANTHROPIC_BASE_URL 详解）
用环境变量把 Claude Code 的请求指向自定义端点：ANTHROPIC_BASE_URL 与 ANTHROPIC_API_KEY 的正确配置位置、OpenAI 兼容端点的注意事项、配置不生效的排查清单。
内容复核中：以下为保留的旧稿，不代表本站接入实测；配置、价格与模型信息请以对应产品当前官方文档为准。
Claude Code 通过环境变量支持自定义 API 端点，配置方式比图形界面工具更直接，但也有自己的一套规则。本文记录完整配置过程。
两个核心变量
| 变量 | 作用 |
|---|---|
ANTHROPIC_BASE_URL |
覆盖默认的 Anthropic API 地址 |
ANTHROPIC_API_KEY |
认证密钥 |
配置方法
方式一：临时生效（当前终端会话）
export ANTHROPIC_BASE_URL="https://你的端点地址"
export ANTHROPIC_API_KEY="sk-你的key"
claude方式二：写入配置文件（永久生效）
编辑 ~/.claude/settings.json：
{
"env": {
"ANTHROPIC_BASE_URL": "https://你的端点地址",
"ANTHROPIC_API_KEY": "sk-你的key"
}
}保存后重新启动 Claude Code 即可。
重要：理解 API 格式差异
Claude Code 原生说的是 Anthropic Messages 协议（/v1/messages），不是 OpenAI 的 /v1/chat/completions。这决定了你能不能直接换端点：
- 端点是 Anthropic 协议兼容（很多聚合网关都支持）：直接换 Base URL 即可，无感切换
- 端点只有 OpenAI 兼容协议：Claude Code 无法直连，需要网关做协议转换，或者使用端点的 Anthropic 兼容入口（如果有的话）
所以选端点前先确认一件事：**它支持 Anthropic 协议吗？**支持的话，配置体验和官方完全一致。
如果同时用 OpenAI 系模型
Claude Code 也可以调用 OpenAI 系模型，用这组变量：
export OPENAI_BASE_URL="https://你的OpenAI兼容端点/v1"
export OPENAI_API_KEY="sk-你的key"然后用 --model 参数指定模型即可，Claude Code 会根据模型归属自动选择对应的 Base URL。
配置不生效的排查清单
- 环境变量没传进去：
echo $ANTHROPIC_BASE_URL看看输出。写在~/.zshrc但用的是 bash 之类的低级错误很常见 - settings.json 语法错误：JSON 多个逗号都会导致整个文件失效，可以用
cat ~/.claude/settings.json | python3 -m json.tool验证 - 端点协议不匹配：确认端点支持 Anthropic 协议，地址一般以
/结尾或不带/v1（以服务商文档为准） - 代理干扰：如果终端里有
HTTP_PROXY/HTTPS_PROXY，请求会走代理，先排除代理层的问题
实测建议
配置完成后，先用一个小任务测试：
claude "用一句话解释什么是 API"能正常返回说明链路通了。之后跑一个真实编码任务，观察长上下文场景下的稳定性——Claude Code 的上下文消耗比较大，端点的吞吐能力在这里很重要。