Claude Code 如何通过 ANTHROPIC_BASE_URL 接入中转站

ANTHROPIC_BASE_URL 是 Claude Code 接入中转站时最重要的变量之一。官方环境变量文档说明，它可以覆盖默认 API endpoint，把请求路由到 proxy 或 gateway。

但很多人会误解它：以为设置了 Base URL 就等于换了模型，或者以为随便填一个中转站域名就能用。实际上，Base URL 只解决“请求发到哪里”，鉴权、模型名、接口格式仍然要分别配置。

最小可用配置

export ANTHROPIC_BASE_URL="https://你的中转站地址"
export ANTHROPIC_API_KEY="你的 API Key"
claude

如果你的中转站要求 Bearer Token，而不是 X-Api-Key，可以使用 ANTHROPIC_AUTH_TOKEN。官方文档说明，它会作为 Authorization header 发送，并自动加上 Bearer 前缀。

export ANTHROPIC_BASE_URL="https://你的中转站地址"
export ANTHROPIC_AUTH_TOKEN="你的 Token"
claude

写进 settings.json

临时测试可以写在 shell 里，长期使用更适合写进 ~/.claude/settings.json 的 env 字段。这样无论从哪个终端启动 Claude Code，都能读取到配置。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的中转站地址",
    "ANTHROPIC_API_KEY": "你的 API Key"
  }
}

Base URL 不会自动换模型

设置 ANTHROPIC_BASE_URL 后，Claude Code 只是把请求发到新的网关。你实际使用哪个模型，仍然取决于 /model、--model、ANTHROPIC_MODEL、settings 里的 model，以及中转站后台的模型映射。

Gateway Model Discovery 是什么

官方 LLM Gateway 文档提到，如果网关实现了 /v1/models，Claude Code 可以在启动时查询网关模型列表。这个能力需要设置 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1，且只适用于 Anthropic Messages 格式。

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

如果你的中转站没有实现模型发现，也不影响基本使用，只是模型选择器里不会自动显示网关模型。这时要靠手动指定模型名或让中转站做默认映射。

常见错误

• 401：优先检查 API Key 或 Auth Token；
• 404：优先检查 Base URL 是否多了或少了路径；
• 503：优先检查中转站上游和模型映射；
• 模型选择器里没有模型：检查 /v1/models 和 gateway model discovery。

如果你不想自己维护网关、证书、模型映射、上游兼容和各种错误排查，可以了解 YYLX.IO 鱼鱼连线。它更适合想直接稳定使用 Claude Code、Codex、Gemini CLI、Cline 等 AI 编程工具的用户。

总结

ANTHROPIC_BASE_URL 是 Claude Code 指向中转站的入口，但它不是万能开关。想稳定使用，还要配对鉴权方式、模型名、接口格式和中转站日志。

参考资料：Claude Code environment variables、Claude Code LLM gateway configuration、Claude Code model configuration。