# Claude Code、Codex 怎么接 API 中转站（环境变量与 config.toml）

> 来源：TokenPrice（tokenprice.cc）https://tokenprice.cc/guide/claude-code-relay · 数据更新于 2026-11-06。引用时请注明 TokenPrice 并附上链接。

> Claude Code 设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 接中转站，Codex 在 ~/.codex/config.toml 加自定义 model_provider；附常见报错和怎么挑适合编程的中转站。

先在[首页](https://tokenprice.cc/)选好中转站（Claude Code 选 Claude 标签，Codex 选 ChatGPT 标签），在中转站后台拿到两样东西：**接口地址**（Base URL，一般就是站点域名）和 **API Key**（令牌，多以 `sk-` 开头）。

## Claude Code

先在终端里临时设置，测通再写进配置文件。macOS / Linux：

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

- 地址只填到域名，**不要带 `/v1`**，Claude Code 会自己拼接口路径。
- `ANTHROPIC_AUTH_TOKEN` 以 `Authorization: Bearer` 请求头发送，绝大多数中转站都认；站点说明里写的是 `ANTHROPIC_API_KEY` 的，换成它。
- 进入后输入 `/status` 能看到当前用的地址。

测通以后写进 `~/.claude/settings.json`（Windows 是 `%USERPROFILE%\.claude\settings.json`）：

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

文件是严格的 JSON，不能有注释和多余的逗号；已有这个文件的，把 `env` 合并进去。终端、VS Code / JetBrains 插件读的都是它。

想指定模型，可以再加 `ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`，填中转站模型列表里的名字。

## Codex

Codex 在 `~/.codex/config.toml` 里加一个自定义模型提供方：

```toml
model_provider = "relay"
model = "中转站模型列表里的模型名"

[model_providers.relay]
name = "relay"
base_url = "https://中转站域名/v1"
env_key = "RELAY_API_KEY"
wire_api = "responses"
```

然后 `export RELAY_API_KEY="sk-你的令牌"` 再运行 `codex`。

- `wire_api` 只支持 `responses`，所以中转站必须支持 `/v1/responses` 接口，只支持 `/v1/chat/completions` 的站接不上。
- 不能自定义名为 `openai` 的提供方。
- 这几项不能写在项目级 `.codex/config.toml` 里，要写在用户目录。
- `model` 填中转站模型列表里实际有的名字。

## 常见报错

- **401 / 403**：令牌错了、过期，或这个令牌没开对应模型的分组。
- **404**：地址多写或少写了 `/v1`，或模型名不对。
- **429**：触发限流，换分组或稍后再试。
- **5xx / 529**：中转站上游不稳定，看榜单的可用性列，准备一家备用。

## 编程用的中转站怎么挑

- Claude Code、Codex 的长任务里，**缓存读**占了绝大部分 token。缓存价按官方比例收的站更划算（有的站缓存读比官方贵一倍），在站点页里看缓存价格。
- 需要的模型要齐：Claude Code 至少要 Opus / Sonnet / Haiku 三档，Codex 要支持 Responses 接口的 GPT 模型。
- 编程一跑就是几小时，可用性比便宜一两分更重要。

倍率怎么换算成月花费见[中转站倍率怎么看](https://tokenprice.cc/guide/relay-ratio)。