Claude Code 接 API 中转站 Base URL 配置教程

用 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 配置 Claude Code 接入 API 中转站。

最小配置

Claude Code 接中转站时,通常先看服务商是不是 Anthropic 兼容接口。最常见的配置是:

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

ANTHROPIC_BASE_URL 用来把请求路由到代理或网关,ANTHROPIC_AUTH_TOKEN 会作为 Bearer token 发送。

如果你还在对比 Claude Code 可用的服务商，可以先看 Claude API 中转服务商 专题页。想同时查看 Anthropic 兼容、OpenAI 兼容和多模型聚合服务商，可以用 AI API 服务商目录 做初筛。

API Key 路径

如果服务商给的是 Anthropic 风格 API Key,可能会让你配置:

export ANTHROPIC_API_KEY="sk-..."
claude

注意: 设置 ANTHROPIC_API_KEY 后,Claude Code 会使用这个 API Key,而不是 Claude Pro / Max / Team 订阅登录的额度。测试中转站时建议开一个新终端窗口,只在这个窗口里设置变量。

常见错误

  • 401: Key 不对、Header 类型不对,或服务商要求用 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY。
  • 404: Base URL 路径不对。尤其注意服务商要求是否带 /v1。
  • model not found: 模型名不在服务商支持列表里,或需要设置自定义模型选项。
  • MCP 搜索异常: 非官方 Base URL 下,Claude Code 可能会改变 MCP tool search 行为,需要确认服务商是否完整转发相关能力。

建议

先用一个干净终端做一次临时配置,确认能跑通后,再考虑写进 shell profile、项目脚本或切换工具里。不要一开始就改全局配置,否则排障时很难分清是账号、环境变量还是服务商接口的问题。

Claude Code Base URL API Key

相关错误

Claude Code / Codex 503 No available accounts：中转站账号池不可用排查 先不要盲目换 Key。这个错误通常说明账号池、供应商、分组或模型路由暂时不可用。先测最小请求、确认模型和分组，再判断是等待恢复、降低上下文，还是换 provider。 Error 401 Unauthorized：AI API 中转站认证排查 401 是认证失败信号。先检查当前加载的是哪一个 Key、请求打到哪个 Base URL、header 格式是否正确，以及这个 Key 是否仍然在对应 provider 中有效。 Error 429 Too Many Requests：AI API 中转站限流排查 报错：exceeded retry limit, last status: 429 Too Many Requests, request id: <request-id>。AI 中转站里连续 429 多半是上游账号池限流、冷却或额度耗尽，先让服务商换号、换线路或换模型。