# Claude Code

NezhaGate 提供与 Anthropic 一致的 Messages 接口，Claude Code 的工具调用、思考和提示缓存都原样可用。设好两个环境变量就能开始。

> https://nezhagate.com/docs/integrations/claude-code

## 开始前

- 一把 NezhaGate API Key（控制台「API Keys」页面创建）。

- 已经装好 Claude Code。还没装的话，运行下面的命令（需要 Node.js 18 或更高版本）：

```
npm install -g @anthropic-ai/claude-code
```

## 第 1 步：设置环境变量

在要运行 `claude` 的终端里设置。`ANTHROPIC_AUTH_TOKEN` 填你的 NezhaGate Key，`ANTHROPIC_MODEL` 是默认使用的模型。

```
export ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5
claude
```

```
$env:ANTHROPIC_BASE_URL = "https://nezhagate.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-sonnet-5"
claude
```

这样设置只对当前终端有效，新开终端要重新设置。想一直生效，用下一步的 settings.json。

## 第 2 步（推荐）：写进 settings.json

把同样的设置写进 Claude Code 的用户配置文件，以后打开任何终端都生效。文件位置：macOS / Linux 是 `~/.claude/settings.json`，Windows 是 `%USERPROFILE%\.claude\settings.json`；文件不存在就新建一个。

```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://nezhagate.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}
```

## 第 3 步：启动并确认

在项目目录里运行 `claude`，然后输入 `/status` 查看当前设置，确认 base URL 是 `https://nezhagate.com/anthropic`。

## 选择模型

Claude Code 只能使用 Claude 模型（/anthropic 接口只接受 Claude 模型）。当前可以用的：

| 模型 ID | 输入 | 输出 | 缓存读 |
| --- | --- | --- | --- |
| `claude-sonnet-4-6` | $1.50 | $7.50 | $0.15 |
| `claude-opus-5` | $4.00 | $20.00 | $0.40 |
| `claude-fable-5` | $8.00 | $40.00 | $0.80 |
| `claude-sonnet-5` | $1.00 | $5.00 | $0.10 |

价格单位：美元 / 百万 token。

会话里输入 `/model` 加模型 ID 就能切换，例如 `/model claude-opus-5`。在 `/model` 菜单里选 Opus 或 Sonnet 时用哪个模型，分别由 `ANTHROPIC_DEFAULT_OPUS_MODEL` 和 `ANTHROPIC_DEFAULT_SONNET_MODEL` 决定。

### 后台任务用的模型

Claude Code 会用一个小模型处理后台任务（比如给会话起标题），默认请求 Claude Haiku。NezhaGate 目前不提供 Haiku，请用 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 指向上表里的某个模型，否则这些后台请求会返回 404。

## 计费与缓存

按 token 计费，和 /v1 接口同价。提示缓存命中的部分按上表的「缓存读」价格计费，比输入价低得多。Claude Code 每一轮都带着相同的系统提示和项目上下文，通常每轮都能命中缓存。

## 常见报错

**401 或「Invalid API key」**

Key 填错了、带了多余的空格，或者这把 Key 已停用。到控制台确认后重新设置。

**404「model: …」**

请求的模型不在 NezhaGate 的列表里，最常见的是后台任务默认请求的 Haiku。按上面的说明设置 `ANTHROPIC_MODEL` 和 `ANTHROPIC_DEFAULT_HAIKU_MODEL`。

**402 余额不足**

账户余额不足，或者这把 Key 达到了你设置的预算上限。到控制台充值，或调整这把 Key 的限额。

**设置好像没有生效**

环境变量要在启动 `claude` 之前、在同一个终端里设置；改了 settings.json 要重启 Claude Code。用 `/status` 检查当前的 base URL。

**429 或「overloaded」**

这个模型的线路暂时满载，等几秒重试即可，不会计费。