Claude Code 如何使用 AI 中转站？Base URL 和 API Key 配置教程

Claude Code 是很多开发者现在最常用的 AI 编程工具之一，但在国内网络环境下，最容易卡住的往往不是命令怎么写，而是：Base URL 应该填哪里？API Key 应该放在哪里？为什么配置了还是连不上？

这篇文章就专门讲 Claude Code 接入 AI 中转站的配置方法。重点不是泛泛介绍 Claude Code，而是把 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 这几个变量讲清楚。

什么时候需要配置中转站

如果你在本地运行 claude 时经常遇到连接超时、请求失败、鉴权不稳定、公司网络无法直连 Anthropic API 等问题，就可以考虑通过 AI 中转站转发请求。

Claude Code 官方环境变量文档里也说明，ANTHROPIC_BASE_URL 可以用来覆盖默认 API endpoint，把请求路由到 proxy 或 gateway。也就是说，中转站的本质是把 Claude Code 原本发往官方 API 的请求，转发到一个你能稳定访问的网关地址。

最重要的三个变量

ANTHROPIC_BASE_URL：中转站地址。比如你的中转站给你的地址是 https://api.example.com，那它通常就填在这里。注意不要随便补路径，具体是否需要 /v1 要看中转站说明。

ANTHROPIC_API_KEY：Anthropic 风格的 API Key。官方文档说明，这个值会作为 X-Api-Key 请求头发送。大多数 Claude Code 中转站会让你把自己的 key 放在这里。

ANTHROPIC_AUTH_TOKEN：自定义 Authorization header。官方文档说明，设置这个变量后，Claude Code 会把它作为 Authorization: Bearer ... 发送。有些中转站不是读取 X-Api-Key，而是读取 Bearer Token，这时就用它。

简单理解：如果你的中转站文档写的是 x-api-key 或 Anthropic API Key，就优先用 ANTHROPIC_API_KEY；如果写的是 Authorization: Bearer sk-...，就用 ANTHROPIC_AUTH_TOKEN。

macOS / Linux 临时配置

如果你只是想先测试，不想永久写入系统环境变量，可以在终端里这样运行：

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

如果你的中转站要求 Bearer Token，而不是 X-Api-Key，可以改成：

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

临时配置只对当前终端窗口有效。关掉终端后，下次还要重新设置。

macOS / Linux 永久配置

如果你使用 zsh，可以把环境变量写进 ~/.zshrc：

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

保存后重新打开终端，或者执行：

source ~/.zshrc

然后再运行：

claude

Windows PowerShell 配置

在 Windows PowerShell 里临时测试，可以这样写：

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

如果要写入用户环境变量，可以运行：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://你的中转站地址", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的 API Key", "User")

写入后需要重新打开一个 PowerShell 窗口，再运行 claude。

推荐方式：写进 Claude Code settings.json

Claude Code 官方文档还提供了另一种更干净的方式：把环境变量写进 ~/.claude/settings.json 的 env 字段。这样无论你从哪个终端启动 claude，Claude Code 都能读到这些变量。

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

如果你只想在某一个项目里使用中转站，可以写到项目目录下的 .claude/settings.local.json。这个文件适合放个人配置，不建议提交到 Git。

如何验证配置是否成功

配置完以后，先不要急着让 Claude Code 改项目代码，可以在一个空目录里运行：

claude

然后问一个简单问题，比如：

请用一句话介绍你现在能做什么

如果能正常回复，说明基础鉴权和请求转发已经通了。接下来再测试读取文件、解释代码、运行命令等 Claude Code 的真实开发场景。

常见错误排查

401 Unauthorized：通常是 key 不对、key 过期、变量写错，或者中转站要求 Bearer Token 但你用了 ANTHROPIC_API_KEY。这时先确认中转站文档到底要求哪种鉴权头。

403 Forbidden：通常是账号没有权限、套餐不支持、模型没有开通，或者中转站限制了来源。

连接超时：可能是中转站不可达、网络被阻断、DNS 解析异常，也可能是请求超时时间太短。Claude Code 支持 API_TIMEOUT_MS，在慢网络或网关转发场景下可以适当调大。

模型不可用：这通常不是本地 Claude Code 安装问题，而是中转站没有把 Claude Code 请求的模型名映射到可用上游。遇到这类问题，要优先看中转站后台的模型路由和日志。

工具调用或 beta 参数报错：有些中转站对 Anthropic 的 beta header、thinking 参数、工具流式输出支持不完整。Claude Code 提供了若干兼容性环境变量，例如禁用实验 beta header 或调整流式行为，但更根本的办法是选择支持 Claude Code 请求格式的中转服务。

中转站需要支持什么

一个能稳定跑 Claude Code 的中转站，不只是能转发普通聊天接口就够了。它至少应该正确处理：

Anthropic Messages API 请求格式；
X-Api-Key 或 Authorization: Bearer 鉴权；
Claude Code 使用的模型名和模型别名；
长上下文、工具调用、流式输出；
合理的超时设置和错误日志。

如果中转站只适配了普通网页聊天，很可能在 Claude Code 里出现各种奇怪问题：能问答，但不能稳定跑任务；能开始回复，但中途断流；能调用主模型，但某些工具链请求失败。

一个实用建议

配置 Claude Code 时，建议先用最少变量跑通：只配置 ANTHROPIC_BASE_URL 和一种 key。不要一开始就混用多个 token、多个 model override、多个代理工具。链路越短，排查越简单。

如果你只是想稳定使用 Claude Code、Codex CLI、Gemini CLI 等 AI 编程工具，不想自己维护模型映射、网关兼容性和网络转发，可以了解 YYLX.IO 鱼鱼连线这类已经整理好接入方式的 AI 中转站。

总结

Claude Code 接入中转站的核心就是两件事：用 ANTHROPIC_BASE_URL 指向中转站，用 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 完成鉴权。

临时测试可以写在 shell 里，长期使用更推荐写进 ~/.claude/settings.json。如果配置后仍然报错，优先检查鉴权头、Base URL 路径、模型映射和中转站日志。

参考文档：Claude Code Environment variables、Claude Code settings。