跳到正文
TrustyHub

Claude Code · 配置

Claude Code 接入第三方 API 的配置

ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 怎么设、写在哪里、和已登录的账号怎么共存,怎么确认 Claude Code 真的走了你配的地址,以及常见报错。

更新于 2026年11月16日

本页内容

Claude Code 默认连 Anthropic 官方的接口。要改用第三方提供的 Anthropic 兼容接口——中转站,或者公司内部的网关——只需要告诉它两件事:接口地址和 key。这篇讲清楚这两项怎么设、写在哪里、和已经登录的账号怎么共存,以及怎么确认它真的生效了。

两个环境变量

变量填什么
ANTHROPIC_BASE_URL接口地址,照站点给的填,不要自己加 /v1
ANTHROPIC_AUTH_TOKEN站点给你的 key,Claude Code 会按 Authorization: Bearer 发送

两个容易踩的坑:

  • 地址不要带 /v1。Claude Code 会自己在地址后面接上 /v1/messages;写成 https://api.example.com/v1,请求就会发到 /v1/v1/messages,结果是 404。
  • key 前面不要自己加 Bearer ,Claude Code 会加。

还有一个变量 ANTHROPIC_API_KEY,它按 X-Api-Key 请求头发送 key。多数中转站两种写法都认,以站点自己的说明为准;两个都设了的时候,ANTHROPIC_AUTH_TOKEN 优先。用 ANTHROPIC_API_KEY 时,交互模式下 Claude Code 第一次会问你要不要用这个 key,选择会被记住。

只对当前终端生效

macOS、Linux:

bash
export ANTHROPIC_BASE_URL=https://api.example.com
export ANTHROPIC_AUTH_TOKEN=你的key
claude

Windows PowerShell:

powershell
$env:ANTHROPIC_BASE_URL = "https://api.example.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的key"
claude

关掉终端就失效了。想每次都生效,可以把这几行写进 shell 的配置文件(如 ~/.zshrc、PowerShell 的 $PROFILE),或者用下面的 settings.json。

长期生效:写进 settings.json

推荐写在用户级的 ~/.claude/settings.json(Windows 是 %USERPROFILE%\.claude\settings.json)的 env 里,对所有项目都生效:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.example.com",
    "ANTHROPIC_AUTH_TOKEN": "你的key"
  }
}

几点说明:

  • settings.json 里 env 设的值,会覆盖 shell 里 export 的同名变量。两处都设过、结果不对时,先看这里。
  • 只想对某一个项目生效,写在项目里的 .claude/settings.local.json。不要写进 .claude/settings.json:它通常会提交进仓库,key 就跟着泄露了。
  • 第一次运行就想跳过官方登录,要把 ANTHROPIC_AUTH_TOKEN 设在 shell 里或 ~/.claude/settings.json 里。项目里的设置要等首次设置和「信任这个文件夹」的提示之后才生效。

已经登录了官方账号

设了 ANTHROPIC_AUTH_TOKEN 之后,它会立即优先于你登录的账号,启动时 Claude Code 会提示认证冲突。想完全改用第三方接口,在 Claude Code 里执行 /logout,清掉保存的登录。

用第三方的地址或 key 时,Remote Control 和语音输入用不了,这是 Claude Code 本身的限制。

站点的型号名不一样

有的站会给型号改名,比如在官方名字后面加个后缀。这时用下面几个变量把 Claude Code 里的别名指到站点的名字:

变量作用
ANTHROPIC_DEFAULT_OPUS_MODELopus 别名对应的型号
ANTHROPIC_DEFAULT_SONNET_MODELsonnet 别名对应的型号
ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 别名对应的型号;Claude Code 后台的小任务(比如给会话起标题)也用它
ANTHROPIC_MODEL这次会话直接用的型号

如果站点没有 Haiku,后台小任务会报错,把 ANTHROPIC_DEFAULT_HAIKU_MODEL 指到站点有的型号就好。会话里可以随时用 /model 切换。

确认真的生效了

  1. 在 Claude Code 里输入 /status。状态页里会多出一行 Anthropic base URL(只有设了自定义地址才会出现),并写明用的是 Auth token 还是 API key。

  2. 用 curl 单独测一下接口通不通:

    bash
    curl -s "$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-opus-5-5","max_tokens":32,"messages":[{"role":"user","content":"只回答 OK"}]}'
  3. 跑一句 claude -p "只回答 OK",同时看站点后台的用量有没有增加。

接口通了,只说明配置对了,不说明站点给你的是原版 Claude。要查有没有掺水,见怎么判断一个中转站有没有掺水,或者直接用中转站检测测一遍。

常见报错

现象多半是怎么办
401、authentication_errorkey 错了,或站点只认另一种写法核对 key;试试把 ANTHROPIC_AUTH_TOKEN 换成 ANTHROPIC_API_KEY
404地址多写了 /v1,或者路径不对照站点给的地址填,去掉多写的 /v1
提示型号不存在站点的型号名和官方不同用 ANTHROPIC_DEFAULT_*_MODEL 指过去
429被限流Claude Code 会自动等待重试;经常出现说明站点的并发额度不够
529、overloaded_error上游过载过一会儿再试
一启动就要求登录Claude Code 没读到 key把 ANTHROPIC_AUTH_TOKEN 设在 shell 里或 ~/.claude/settings.json 里
请求很久才报超时默认等响应 10 分钟(API_TIMEOUT_MS,单位毫秒,默认 600000)按需要调整这个变量

可选:关掉非必要的联网

设 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1,Claude Code 会关掉自动更新、遥测、错误上报、/feedback 等非必要的联网,不影响对接口本身的请求。代价是一些靠功能开关下发的新功能会用不了。

安全提醒

  • 中转站能看到你发给 Claude 的一切:代码、文件内容、命令的输出。只把它交给你信得过的站。
  • Claude Code 会执行模型给出的命令,而这些命令经过中转站。不可信的站可以改写它们,所以对不熟悉的站,不要用 --dangerously-skip-permissions 这类全部放行的模式。
  • key 在 settings.json 里是明文:注意文件权限,别提交进仓库,泄露了马上去站点后台作废。

看完方法,看看检测怎么做

中转站检测即将开放:按 Claude Code 的真实请求,把你在用的中转站从头到尾测一遍。

看看中转站检测

更多指南

  • 中转站检测更新于 2026年11月16日

    怎么判断一个中转站有没有掺水

    换型号、降档、塞系统提示、虚报用量、改命令:中转站掺水的几种常见做法,各自的症状,你自己能怎么查,以及为什么问模型「你是谁」没有用。