Claude Code 怎么配置中转 API

01

先判断你的情况：代理、官方 Key、公司网关还是中转地址

02

Claude Code 中转 API 怎么配置：settings.json 的 env 写法

文件必须是严格 JSON，不能有注释和多余的逗号。地址 relay.example.com 和令牌都是占位，换成你自己的。

凭据变量的优先级高于已保存的 claude.ai 登录。用 ANTHROPIC_API_KEY 时，交互模式下会先问你是否批准一次。出现两种凭据冲突的警告时，运行 /logout 保留中转凭据，或去掉变量改回登录。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-token"
  }
}

1. 拿到两样东西

   对方提供的 base URL，和一个凭据。凭据是 Bearer 令牌就用 ANTHROPIC_AUTH_TOKEN；对方说 API Key、x-api-key，就用 ANTHROPIC_API_KEY。官方写明：令牌变量以 Authorization: Bearer 头发送，API Key 变量以 x-api-key 头发送，用错变量会得到 401。

2. 写进 ~/.claude/settings.json 的 env 块

   这个文件对你的所有项目生效，终端、VS Code 扩展共用。官方提醒：不要把凭据写进项目里的 .claude/settings.json，它会被提交并分享给克隆仓库的人。

3. 运行 claude，用 /status 核对

   /status 的 Anthropic base URL 一行应显示你的地址，Auth token 或 API key 一行说明用的是你设置的凭据，而不是已保存的登录。

03

VS Code、桌面版里的中转地址怎么填

终端 CLI

读取 shell 里导出的变量和 settings.json 的 env 块。两处都设置同一变量时，官方写明以 settings.json 的值为准。

VS Code 扩展

官方建议把网关变量写在 VS Code 用户设置的 claudeCode.environmentVariables 里，扩展在启动前会检查这里的凭据。写在 ~/.claude/settings.json 的值会传给 Claude 进程，但扩展自己的登录检查看不到。

Claude 桌面版

桌面版本地会话的 ANTHROPIC_BASE_URL 由桌面版自己设置，写进 settings.json 或环境变量都不会改变它。要用网关，在桌面版的第三方推理配置里填地址。

04

配置前先验证：用 curl 确认地址和凭据可用

在终端先 export 两个变量，再发一次只要 1 个 token 的请求，能在打开 Claude Code 之前确认地址和凭据。返回以 {"id":"msg_ 开头的 JSON，说明地址通、凭据有效。官方说明返回「未知模型」之类的错误同样证明地址和凭据没问题，因为网关先验证了请求才拒绝模型名；返回 401 说明凭据被拒，换另一个凭据变量再试。

这条命令里的 model 换成对方支持的模型名。Claude Code 向网关发送的请求格式，官方在网关兼容性指南里有说明，地址需要兼容这套接口才能正常工作。

export ANTHROPIC_BASE_URL=https://relay.example.com
export ANTHROPIC_AUTH_TOKEN=sk-your-token

curl -sS -w '\n%{http_code}\n' -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": "."}]}'

05

多套中转配置怎么切换：手动、cc switch 与 Pax

手动切换最简单的办法，是把每套地址和凭据各存成一个 JSON 文件，用 claude --settings 指定。官方说明 --settings 可以传 JSON 字符串或文件路径，它只对这一次会话有效，不改写你的设置文件。

CC Switch 是 GitHub 上的第三方桌面应用，MIT 许可，在 Windows、macOS 和 Linux 上管理多个 AI 编程工具的 API 提供方配置。按项目自己的说明，它只改写连接字段，改写前会备份原文件。它和 Pax 的 AI Profile 解决的是同一类问题，选哪个看你需不需要同时看用量和网络。

# ~/.claude/relay-a.json 里放一份 env 块，然后这样启动
claude --settings ~/.claude/relay-a.json

07

验证与排查：中转配置了却用不了

先分清是网络问题还是账号问题。curl 都连不上，或报连接被拒、域名解析失败，是网络或地址问题，网络不通的做法见 Claude Code 代理设置。curl 能通但 Claude Code 报错，多半是凭据、模型名或网关兼容性。

想知道中转用了多少 Token、花了多少钱，可以用 Claude Code 用量查看里的方法，在本机日志里统计，不依赖中转方的账单页面。