Claude Code

何时阅读本页复制链接

你在用 Claude Code，希望它的请求通过 EZAT Router 发送，并从你的 EZAT 余额中扣费。设置两个环境变量即可。Claude Code 自带的模型名称照常可用，其他都不用改。

准备工作复制链接

• 一个 EZAT API key（ezat_sk_…）。在控制台的 API Key 页面创建；说明见 API key。
• 余额中有额度（计费）。
• 照常安装好的 Claude Code。

设置复制链接

export ANTHROPIC_BASE_URL="https://api.router.ezat.io"
export ANTHROPIC_AUTH_TOKEN="$EZAT_API_KEY"

如果想不通过 Claude Code 测试 key 和 URL，可以用 Claude Code 使用的同一个请求头发送一个请求：

curl --fail-with-body https://api.router.ezat.io/v1/messages \
  -H "Authorization: Bearer $EZAT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "anthropic/claude-sonnet-5-5", "max_tokens": 16, "messages": [{"role": "user", "content": "Hi"}]}'

返回带有 "type": "message" 的 JSON，说明 key 和 URL 都正确。返回 401 说明 key 不对。

永久生效复制链接

Shell 中的 export 只在当前终端有效。要保留设置，可以把两行 export 加到你的 shell 配置文件（~/.zshrc、~/.bashrc 或 PowerShell 的 $PROFILE）中，或者放进 Claude Code 设置文件的 env 块：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.router.ezat.io",
    "ANTHROPIC_AUTH_TOKEN": "ezat_sk_…"
  }
}

如果文件已经存在，把 env 中的条目加进去，不要替换整个文件。当一个变量同时在 shell 和设置文件中设置时，以设置文件为准。设置文件也会作用于 Claude Code 的后台 agent，而 shell export 不一定能。

Claude Code 只有在你信任该文件夹之后才会应用项目的 env 块。如果首次启动时它要求你登录，请改为把 key 放在 shell 中或 ~/.claude/settings.json 里。

为什么用 ANTHROPIC_AUTH_TOKEN复制链接

两种方式 EZAT 都接受，但 ANTHROPIC_AUTH_TOKEN 更简单：

设置了 token 时，Claude Code 不会使用你的 claude.ai 订阅：请求从你的 EZAT 余额扣费，订阅的限额也不适用。你的登录信息仍然保存着；取消设置该变量即可切回。只设置 ANTHROPIC_BASE_URL 是不够的，因为那样 Claude Code 会发送你的 claude.ai 凭据，而 EZAT 会拒绝它。

选择模型复制链接

你不需要设置模型。Claude Code 的别名（opus、sonnet、haiku、fable）会解析为 Anthropic 的模型名称，例如 claude-opus-5-5，而 EZAT 把这些名称当作自己 id 的别名接受。后台任务使用 haiku 别名指向的模型。

• 切换当前会话的模型：/model（打开选择器），或 /model opus。
• 以指定模型启动：claude --model sonnet，或设置 ANTHROPIC_MODEL。
• 固定一个确切版本：使用 Anthropic 的完整名称，例如 claude-opus-5-5，配合 /model、ANTHROPIC_MODEL 或 model 设置使用。

请使用 Anthropic 的名称（模型页面的别名一列），而不是 EZAT 的 anthropic/… id。Claude Code 根据模型名称设置上下文窗口和功能，所以需要一个它认识的名称。

提示缓存复制链接

Claude Code 会自己标记提示缓存（prompt caching）的断点，EZAT 会把每个对话保持在同一个部署上，让缓存能被读回。无需任何设置。缓存 token 显示在「用量」页面的「缓存（写入 / 读取）」下。见提示缓存与会话。

查看用量和费用复制链接

每个请求都会出现在控制台的「用量」页面上，并按模型和按 key 显示 token 和费用。给 Claude Code 单独分配一个 key，就能单独查看它的用量（「按 key」）；如果需要封顶，还可以给这个 key 设置消费上限（API key）。

运行 Claude Code 的其他方式复制链接

VS Code 扩展。在 VS Code 的用户设置（Preferences: Open User Settings (JSON)）中设置这些变量。扩展在启动前会先从这项设置中检查凭据：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.router.ezat.io" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "ezat_sk_…" }
  ]
}

GitHub Actions。把 key 存为仓库 secret，并作为 action 的 anthropic_api_key 输入传入。action 会以 x-api-key 发送它，EZAT 接受这种方式：

env:
  ANTHROPIC_BASE_URL: https://api.router.ezat.io

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.EZAT_API_KEY }}

无法通过 EZAT 使用：网页版 Claude Code（云端会话）和 Slack 中的 Claude Code 不会应用这些变量，所以无法在 EZAT 上运行。Remote Control 和语音听写需要 claude.ai 登录，设置了 ANTHROPIC_AUTH_TOKEN 时 Claude Code 会关闭这两项功能。

常见问题复制链接

更多情况见故障排查。

给 AI agent 的说明复制链接

1. 不要让用户把 key 粘贴到对话里。从 EZAT_API_KEY 读取，或让用户自己设置。
2. 把 ANTHROPIC_BASE_URL 设为 https://api.router.ezat.io（不带 /v1），ANTHROPIC_AUTH_TOKEN 设为该 key，写在 ~/.claude/settings.json 的 env 块中（合并到现有文件，不要覆盖），或写在 shell 配置文件中。
3. 不要把 key 写进项目的 .claude/settings.json：它会被提交。
4. 不要同时设置 ANTHROPIC_API_KEY 或 apiKeyHelper。如果 ANTHROPIC_API_KEY 中是另一个 key，取消设置它。
5. 不要设置模型。如需固定模型，使用模型页面别名中的 Anthropic 模型名称，而不是 anthropic/… id。
6. 用上面的 curl 请求验证，然后让用户运行 /status，检查 Anthropic base URL 和 Auth token。