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 模型）。当前可以用的：

价格单位：美元 / 百万 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 每一轮都带着相同的系统提示和项目上下文，通常每轮都能命中缓存。

常见报错