· 5 分钟阅读

5 分钟把 Claude Code 接到 API 中转站

不开通官方账号、不绑信用卡,用第三方 API 中转站让 Claude Code 在国内跑起来。覆盖选 relay、拿 key、设环境变量、验证、常见报错。

为什么需要中转站

Claude 官方目前不在中国大陆开放账号注册和支付,直接用 anthropic SDK 或 Claude Code 都需要稳定的境外账号 + 信用卡。API 中转站 解决这个:他们用合规渠道接入官方 API,对你提供一个兼容 Anthropic / OpenAI 协议的 endpoint,按 token 计费充值。

中转站的好处:

代价:信息更新慢、价格随时调、跑路风险高(请小额试用)。

第一步:在 chatgpt.top 列表里挑一家

打开 中转站列表 按你用的客户端筛选 claude-code。你大概率会落到几家头部:PackyCodeAICodeMirrorSiliconFlow 硅基流动

挑选标准(不分先后):

第二步:注册 + 拿 key

任意一家:

  1. 点你选定中转站的「前往官网」按钮
  2. 完成注册(手机号 / 邮箱 / 微信,看对方)
  3. 在控制台找到 API Keys令牌 之类的菜单
  4. 创建一个 key,复制下来(一般以 sk- 开头,长 ~40 字符)
  5. 同时记下这家的 Base URL(中转站的 API 入口,例如 https://api.example.cn

不同家命名略不同:base url 可能叫 “API 地址” / “Endpoint” / “请求地址”。文档或 FAQ 通常会有一行「OpenAI / Anthropic 兼容地址」。

第三步:把 Claude Code 指向中转站

Claude Code 通过两个环境变量切到第三方 endpoint:

export ANTHROPIC_BASE_URL="https://api.example.cn"   # 第二步记下的 base url
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"  # 你的 key

⚠️ 用 ANTHROPIC_AUTH_TOKEN 不是 ANTHROPIC_API_KEY。这是 Claude Code 强制走 Bearer 鉴权的指示,否则它会按官方账号格式拒绝。

把这两行加到 ~/.zshrc~/.bashrc,再 source 一下让当前 shell 生效。

如果你同时用多个中转站、想随手切换,推荐装 cc-switch(Claude Code 配置切换器)来管理多套配置,避免反复改环境变量。

第四步:启动 Claude Code 验证

claude

启动后输入随便一个问题,例如:

> hello, what model are you?

正常会得到 Claude 的回复。如果模型版本和你预期不一致,可以在 Claude Code 里 /model 命令切换(前提是中转站支持那个模型,详情页 “覆盖模型” 列出过的就行)。

常见错误排查

报错大概率原因解决
401 Unauthorizedkey 写错 / 过期 / 余额耗尽控制台核对 key 和余额
403 Forbiddenbase url 写错(指向官方而不是中转站)重新看中转站文档里的”endpoint”
429 Too Many Requests中转站限速,并发跑满降速或换更高档套餐
model not found选的模型这家不支持换中转站详情页”覆盖模型”列出的型号
连接 reset / timeout中转站当时挂了换一家试
流式输出卡顿长链路 + 大模型组合常见换中转站、把 temperature 调低、关 verbose

下一步

如果你刚跑通,恭喜。剩下大部分时间该花在 prompt 上,而不是配 endpoint。