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

> Claude Code 不一定要买订阅：把请求地址换成中转站，就能按 token 付费，也没有 5 小时窗口，只要设置两个环境变量。今天 Claude 中转站进榜 1,866 家，中位倍率 **1x**，约官方价的 1.5 折。

- 网页版：https://tokenprice.cc/guide/claude-code-api-setup
- 数据更新：2026-11-03 13:16（北京时间）；正文更新于 2026-11-03，文中价格每小时跟着数据更新
- 来源：TokenPrice（tokenprice.cc），转述请注明出处并附网页链接

- Claude 中转站中位倍率：**1x**（约官方价的 1.5 折）
- 每月 $100 用量走中转站：**¥100**（官方直接买约 ¥667）
- 可比的中转站：**1,866 家**（可用率 95% 以上）

## 开始前准备三样东西

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

> **先小额**：第一次用一家中转站，先充最少的钱（比如 10 元），测通、测出真假再多充。挑哪家可以先看 [Claude 中转站价格榜](https://tokenprice.cc/relay)。

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

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

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

Windows PowerShell：

```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 会自己在后面拼接口路径。

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

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

`~/.claude/settings.json`

```json
{
  "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” 一行能看到读到了哪些设置文件。

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

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

`~/.claude/settings.json`

```json
{
  "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，账单能少一半。

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

1. **发一句话**：随便问一句（比如“用一句话介绍这个项目”），能正常回复，说明地址和令牌都对了。
2. **对账**：去中转站后台的使用日志看这次请求：模型名、输入输出 token 数、扣费都应该有记录，扣费约等于官方价 × 倍率。
3. **干一件真活**：让它读一个项目、改一个函数、跑一遍测试。真 Claude 会主动读文件、调用工具、跑命令；掺水的模型常见的表现是工具调用出错、长任务做到一半就乱。
4. **对比一次**：同一个任务在官方或口碑好的中转站跑一遍，速度和质量差很多就换一家。

> **别信“问它是谁”**：模型自报家门可以被系统提示词改掉，问“你是什么模型”不能当证据。

## 常见报错怎么排查

| 报错 | 多半是 | 怎么办 |
| --- | --- | --- |
| `401` 认证失败 | 令牌填错、被删了，或者变量名和中转站要求的不一致 | 重新复制令牌；`ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_API_KEY` 换着试，只留一个 |
| `403` 没有权限 | 令牌没有这个模型或分组的权限，或者余额不足 | 后台看令牌绑定的分组、可用模型和余额 |
| `404` 找不到模型 | 模型名不对，或者地址多带了 `/v1` | 用后台模型列表里的名字；`ANTHROPIC_BASE_URL` 只填到域名 |
| `429` 请求太多 | 请求太快，或者中转站的上游额度不够 | 等一会儿重试；经常出现就换一家 |
| `529` 过载、`5xx` | 上游过载或中转站故障 | 稍后重试，长时间不行看中转站公告 |
| 提示认证冲突，或者还在用订阅额度 | 之前用 Claude 账号登录过，订阅和令牌同时存在 | 运行 `/logout` 退出订阅登录再试；用 `ANTHROPIC_API_KEY` 的，启动时按提示同意使用这个 Key |
| 一直转圈、超时 | 网络慢或中转站响应慢 | 换个网络试试；需要时在 `env` 里把 `API_TIMEOUT_MS` 调大（默认 600000，即 10 分钟） |

## 今天 Claude 中转站哪家便宜

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

| # | 中转站 | 倍率 | 折合官方 | 可用率 |
| --- | --- | ---: | ---: | ---: |
| 1 | [VM2](https://vm2.pro) · Claude 专卖（官方合作 合作位） | 1x | 1.5 折 | 100% |
| 2 | [ClaudeHub](https://qinzhiai.com)（qinzhiai.com） | 0.1x | 0.15 折 | 100% |
| 3 | [词元神 - 全球AI聚合平台](https://api.ciyuanshen.top)（api.ciyuanshen.top） | 0.1x | 0.15 折 | 100% |
| 4 | [YUapi](https://api.yuaiapi.com)（api.yuaiapi.com） | 0.1x | 0.15 折 | 100% |
| 5 | [1024 TOKEN](https://api.1024token.xyz)（api.1024token.xyz） | 0.1x | 0.15 折 | 100% |
| 6 | [CaMeL ToB](https://b.kr777.top)（b.kr777.top） | 0.1x | 0.15 折 | 100% |
| 7 | [EthanCode](https://api.ethancode.xyz)（api.ethancode.xyz） | 0.1x | 0.15 折 | 100% |
| 8 | [GreatWall Link](https://gwlink.cc)（gwlink.cc） | 0.1x | 0.15 折 | 100% |
| 9 | [New API](https://xinfeng.best)（xinfeng.best） | 0.1x | 0.15 折 | 100% |

注：倍率 = 官方每 1 美元用量在这家花多少人民币；去掉了体验价、引流价和可用率不到 95% 的站，按倍率从低到高排。完整榜单见 [Claude 中转站价格榜](https://tokenprice.cc/relay)。

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

- [Claude 中转站价格榜](https://tokenprice.cc/relay)：1,866 家按倍率排序，可以按名字筛选
- [中转站倍率怎么看](https://tokenprice.cc/guide/relay-ratio-guide)：倍率怎么算，怎么识别引流价和跑路
- [订阅还是 API 计算器](https://tokenprice.cc/calculator)：按自己的用量算哪种更省

## 常见问题

### Claude Code 走中转站会封号吗？

走中转站用的是中转站的令牌，不需要你自己的 Claude 账号，也就没有账号可封。风险在中转站本身：可能掺水、限速或跑路，所以别一次充太多。

### ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 用哪个？

看中转站的说明。前者以 Authorization: Bearer 发送，后者以 x-api-key 发送，大多数中转站两种都认。填一个就行，别两个同时填不同的值。

### ANTHROPIC_BASE_URL 要不要带 /v1？

不要。Claude Code 会自己在地址后面拼接口路径，填到域名（或中转站说明里给的地址）为止。

### 订阅和中转站能一起用吗？

能。平时用订阅，额度用完时在新的终端窗口里 export 中转站的两个变量继续干；反过来也行。注意写进 settings.json 的变量会一直生效，想切回订阅要先删掉。

### 用中转站一个月大概花多少？

取决于用量。运行 `npx ccusage@latest claude monthly` 看每月用量折合官方多少美元，再乘中转站倍率。按今天的中位倍率 1x，$100 的用量约 ¥100。想和订阅比，用 [订阅还是 API 计算器](https://tokenprice.cc/calculator)。

## 相关攻略

- [API 中转站倍率怎么看：充值系数 × 分组倍率，算出真实价格，避开引流价和跑路](https://tokenprice.cc/guide/relay-ratio-guide)
- [AI 编程订阅还是按量 API 更划算：回本线怎么算（Claude Code、Codex）](https://tokenprice.cc/guide/subscription-vs-api)
- [Claude Pro、Max、Ultra 国内怎么买最便宜：官方低价区、代充、成品号实时比价](https://tokenprice.cc/guide/claude-subscription-cheapest)

## 更多页面（Markdown 版）

- [Claude Code 怎么用最便宜](https://tokenprice.cc/claude-code.md)
- [Codex 怎么用最便宜](https://tokenprice.cc/codex.md)
- [Cursor Pro 多少钱、哪里买便宜](https://tokenprice.cc/cursor.md)
- [Gemini 编程订阅与 API 怎么买便宜](https://tokenprice.cc/gemini.md)
- [Kiro 账号多少钱、哪里买便宜](https://tokenprice.cc/kiro.md)
- [Claude API 中转站价格榜](https://tokenprice.cc/relay.md)
- [GPT API 中转站价格榜](https://tokenprice.cc/relay/gpt.md)
- [Gemini API 中转站价格榜](https://tokenprice.cc/relay/gemini.md)
- [DeepSeek API 中转站价格榜](https://tokenprice.cc/relay/deepseek.md)
- [GLM API 中转站价格榜](https://tokenprice.cc/relay/glm.md)
- [Kimi API 中转站价格榜](https://tokenprice.cc/relay/kimi.md)
- [Qwen API 中转站价格榜](https://tokenprice.cc/relay/qwen.md)
- [MiniMax API 中转站价格榜](https://tokenprice.cc/relay/minimax.md)
- [Grok API 中转站价格榜](https://tokenprice.cc/relay/grok.md)
- [订阅还是 API 计算器](https://tokenprice.cc/calculator.md)
- [Claude Code 接中转 API 教程](https://tokenprice.cc/guide/claude-code-api-setup.md)
- [Claude Code 接国产模型](https://tokenprice.cc/guide/claude-code-domestic-models.md)
- [Claude Max 和 Ultra 怎么选](https://tokenprice.cc/guide/claude-max-vs-ultra.md)
- [Codex 怎么用最省钱](https://tokenprice.cc/guide/codex-cheapest.md)
- [Claude 订阅怎么买最便宜](https://tokenprice.cc/guide/claude-subscription-cheapest.md)
- [订阅还是 API 更划算](https://tokenprice.cc/guide/subscription-vs-api.md)
- [中转站倍率怎么看](https://tokenprice.cc/guide/relay-ratio-guide.md)
- [数据与立场](https://tokenprice.cc/about.md)
- [全站合集 llms-full.txt](https://tokenprice.cc/llms-full.txt)