Claude Code 接第三方 API：配置、分组与报错对照

配置只有两行，真正卡住人的是模型名和分组。本页把两者一次讲完，并附官方文档记录的网关侧报错原因。

配置口径核对自 Anthropic 官方 Claude Code 文档（code.claude.com/docs）· 分组与价格采集 2026-08-20

一、两个变量：地址和凭据

export ANTHROPIC_BASE_URL=https://api.tutujin.com
export ANTHROPIC_AUTH_TOKEN=你的令牌

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://api.tutujin.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的令牌"

就这两行。设置完重开一个终端跑 claude，在状态里应该能看到 base URL 与凭据来源。

二、AUTH_TOKEN 还是 API_KEY：区别在 HTTP 头

这是最多教程讲不清的一点。按 Anthropic 官方文档，两个变量的差别不是「哪个更正式」，而是凭据被放进哪个请求头：

另外两条来自官方文档、值得记住的行为：

• 设了凭据变量之后，它优先于已保存的 claude.ai 登录。用 ANTHROPIC_AUTH_TOKEN 立即生效；用 ANTHROPIC_API_KEY 会在交互模式下弹一次确认。
• 登录态和凭据变量同时存在时，启动会出一条「两个凭据来源」的告警。要它闭嘴就退出 claude.ai 登录，或干脆不设变量。

三、BASE_URL 千万不要带 /v1

Claude Code 会自己在 base URL 后面拼 /v1/messages——官方文档给出的验证命令就是 curl $ANTHROPIC_BASE_URL/v1/messages。所以：

四、写进 settings.json（持久生效）

环境变量只在当前终端会话有效。要让它在所有地方生效，写进 Claude Code 的 settings 文件的 env 块：

// ~/.claude/settings.json（用户级，对所有项目生效）
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tutujin.com",
    "ANTHROPIC_AUTH_TOKEN": "你的令牌"
  }
}

settings 文件的作用域按官方文档分为四层：用户级 ~/.claude/settings.json、项目级 .claude/settings.json（会进 git，不要把令牌写这里）、本地 .claude/settings.local.json（默认 gitignore）、以及由管理员下发的托管配置。

如果令牌会过期或来自密钥库，用 apiKeyHelper：让它执行一条只输出凭据的命令，Claude Code 默认缓存 5 分钟、遇 401 会重新执行。

五、验证连通：一条 curl 就够

官方文档给的验证方式，换成本站地址后是这样：

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":1,
       "messages":[{"role":"user","content":"."}]}'

六、模型分组可用性表（本页核心）

下表全部取自 2026-08-20 的 /api/pricing。「原生协议」一列指该模型是否声明支持 /v1/messages——Claude Code 走的就是这个端点，所以这一列为「否」的模型，即使在你的分组里也不能给 Claude Code 用。

两条必须照直说的事实：

• cc 分组的 group_ratio 是 1.2，即同样的 token 用量，在 cc 分组要多付 20%。
• cc 分组怎么开通，公开数据里查不到。本页不做任何推断，请联系客服确认。

七、模型不在 /model 选择器里怎么办

Claude Code 的模型选择器有一份内置列表，网关自有的模型名不在里面。官方提供了网关模型发现：

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

开启后 Claude Code 会在启动时向网关查询模型列表，查到的会以 From gateway 标签出现在 /model 里。用 claude --debug 可以在调试日志里看到 [gatewayDiscovery] 的结果（成功会记录缓存了几个模型，404 / 超时也会记录）。

八、成本怎么算

不给「月均多少钱」这种编出来的数字，只给单价和算法。以 default 分组、按 token 计费的 claude-haiku-4-5-20251001 为例（输入 $1、输出 $5 每百万 token，cache_ratio = 0.1）：

一次「3 万 token 输入 + 3 千 token 输出」的会话：
  输入 30000/1e6 × $1  = $0.030  →  ¥0.12
  输出  3000/1e6 × $5  = $0.015  →  ¥0.06
  合计 $0.045 = 22500 quota      →  ¥0.18

若其中 2.4 万 token 命中提示缓存（×0.1）：
  输入 = 6000/1e6×$1 + 24000/1e6×$1×0.1 = $0.0084  →  ¥0.034

把你自己一天的真实 token 用量代进去就是你的成本。控制台「日志」里能看到每次调用扣了多少 quota，直接对账即可。换算原理见计费拆解。

九、报错对照表

十、三条必须知道的限制

• Anthropic 不为第三方网关背书。官方文档明确写着：Anthropic 不认可、不维护、不审计第三方网关产品，也不支持通过网关把 Claude Code 路由到非 Claude 模型。选择第三方网关是你自己的技术决策。
• 部分依赖 claude.ai 身份的功能会不可用。官方文档写明：只要 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 处于激活状态，Remote Control 与语音听写就不可用；ANTHROPIC_BASE_URL 指向非 Anthropic 主机时 Remote Control 同样被禁用。
• 功能能不能完整跑通，取决于网关的转发实现。Claude Code 每次发版都会加新字段，网关没跟上就会出现上面第九节那类 400。本页不承诺 Claude Code 的所有功能都能在本站正常工作，接生产前请自己跑一轮真实任务验证。

常见问题