Claude Code 怎么接中转站 API：环境变量、settings.json 配置和报错排查

01开始前准备三样东西

• 装好 Claude Code：终端里运行 claude --version 能看到版本号。
• 中转站的接口地址（Base URL）：一般就是中转站的域名，形如 https://api.example.com，以中转站后台的说明为准。
• 中转站的 API Key（令牌）：在中转站后台的“令牌”页新建，一般以 sk- 开头。

02方法一：用环境变量临时接入

先在终端里设置两个变量再启动 claude，只对当前这个终端窗口有效，适合先测试。macOS / Linux：

export ANTHROPIC_BASE_URL="https://你的中转站域名"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
claude

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://你的中转站域名"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的令牌"
claude

• ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer 令牌 的形式发给中转站，绝大多数中转站都认。
• 中转站说明里写的是 ANTHROPIC_API_KEY 的，就换成它（以 x-api-key 请求头发送）。交互模式下第一次启动会问要不要用这个 Key，选是；之后它会代替你登录的 Claude 订阅。
• 地址只填到域名为止，不要带 /v1：Claude Code 会自己在后面拼接口路径。

03方法二：写进 settings.json，长期生效

测通以后，把变量写进 ~/.claude/settings.json 的 env 里，以后直接运行 claude 就走中转站。终端、VS Code 和 JetBrains 插件、桌面版读的都是这个文件。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的中转站域名",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}

• 文件是严格的 JSON：不能写注释，最后一项后面不能有逗号，否则启动时会提示 Settings Error。已经有这个文件的，把 env 合并进去，别整个覆盖。
• Windows 上的路径是 %USERPROFILE%\.claude\settings.json。
• 只想让某个项目走中转站：写在项目里的 .claude/settings.local.json。Claude Code 自己创建这个文件时会把它排除出 git；手动新建的记得加进 .gitignore，别把令牌提交上去。
• settings.json 里的 env 会覆盖终端里 export 的同名变量。改完运行 /status，“Setting sources” 一行能看到读到了哪些设置文件。

04选模型：/model 和三个别名

进入 Claude Code 后输入 /model 切换模型。opus、sonnet、haiku 是别名，默认指向官方当前的版本。中转站的模型名和官方不一样时，用下面三个变量把别名指过去（模型名在中转站后台的模型列表里查）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的中转站域名",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "中转站里 Opus 的模型名",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "中转站里 Sonnet 的模型名",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "中转站里 Haiku 的模型名"
  }
}

• haiku 这个别名还会被拿去做后台的小任务。中转站没有 Haiku 的话，把它也指向一个便宜的模型，免得后台请求一直报错。
• 中转站按“官方价 × 倍率”收费，模型之间的差价照样保留：官方 Opus 5.5 每百万 token 输入 $4、输出 $20，Sonnet 5.5 是 $2、$10（2026 年 11 月官网价）。日常改代码用 Sonnet，难题再切 Opus，账单能少一半。

05怎么确认测通了、是不是真模型

1. 1
   发一句话

   随便问一句（比如“用一句话介绍这个项目”），能正常回复，说明地址和令牌都对了。

2. 2
   对账

   去中转站后台的使用日志看这次请求：模型名、输入输出 token 数、扣费都应该有记录，扣费约等于官方价 × 倍率。

3. 3
   干一件真活

   让它读一个项目、改一个函数、跑一遍测试。真 Claude 会主动读文件、调用工具、跑命令；掺水的模型常见的表现是工具调用出错、长任务做到一半就乱。

4. 4
   对比一次

   同一个任务在官方或口碑好的中转站跑一遍，速度和质量差很多就换一家。

06常见报错怎么排查

07今天 Claude 中转站哪家便宜

挑中转站看三样：倍率（价格）、可用率（稳不稳）、口碑（会不会跑路）。下面是今天倍率最低的 8 家：

按今天的中位倍率 1x，每月用量折合官方 API $100，走中转站约 ¥100，直接买官方 API 约 ¥667。