Claude Code 常见报错：版本过低或过高、鉴权失败、模型不可用

这一页汇总 Claude Code 接入 HRouter 时最常见的几类报错，包括版本不在允许范围内、连不上、401、模型不可用。大部分问题可以先用一条命令定位：看 claude 本身是否正常、请求有没有到达 HRouter。

安装和配置步骤见 Claude Code 安装与配置。

版本报错（HTTP 400）

网关会检查 Claude Code 的版本。版本不在允许范围内时，返回 400 invalid_request_error，信息里会告诉你该怎么做。

版本低于最低要求

Your Claude Code version (x.y.z) is below the minimum required version (a.b.c).
Please update: npm update -g @anthropic-ai/claude-code

升级即可：

npm update -g @anthropic-ai/claude-code
claude --version

无法识别版本

Unable to determine Claude Code version. Please update Claude Code: ...

同样是版本太旧，按上面的命令升级。

版本高于允许的最高版本

Your Claude Code version (x.y.z) exceeds the maximum allowed version (a.b.c). Please downgrade: ...

这说明新版本发布后，服务端还没有完成适配。按提示降级到指定版本：

npm install -g @anthropic-ai/claude-code@指定版本

**降级后一定要关闭自动升级，**否则 Claude Code 会再次升级到新版本，同样的错误又会出现。在 settings.json 的 env 里加上：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://hrouter.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxx",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 会关闭非必要的网络请求，包括自动升级检查，这也是教程里默认写入它的原因。

打开 claude 后没有反应，或者仍在要求登录

说明请求没有走 HRouter，还在使用官方的登录流程：

1. 确认 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 都已设置，见 配置不生效怎么排查。
2. 在 使用记录 看有没有请求，没有说明配置没生效。
3. 配置只写了一半（只有 Base URL 没有 Token，或者相反）也会触发登录流程。

401 或鉴权失败

按 API 401 报错 排查：Key 是否完整、有没有空格、是否已被停用。Claude Code 通过 x-api-key 或 Authorization 发送 Key，两种方式网关都支持。

404

最常见的原因是 Base URL 写成了 https://hrouter.net/v1。Claude Code 会自己拼接 /v1/messages，Base URL 应该是 https://hrouter.net，见 API 404 报错。

模型不可用或找不到

• 用 /model 命令查看当前模型，切换到当前 Key 返回的 claude-* 模型。
• 设置了 ANTHROPIC_MODEL 或 ANTHROPIC_DEFAULT_*_MODEL 环境变量时，确认值在 Key 的模型列表里。
• 分组名称或说明带 “Claude Code only” 的，只能给 Claude Code 使用，在其他客户端会被拒绝。

详见 model_not_found 和 查询可用模型。

余额、额度与限流

在 VSCode、JetBrains 里不可用

先确认终端里直接运行 claude 正常。终端里不通，编辑器里一定不通；终端正常但编辑器不通，见 Claude Code VSCode 和 Claude Code JetBrains。

自检清单

1. claude --version 能输出版本号。
2. echo $ANTHROPIC_BASE_URL 输出 https://hrouter.net（Windows 用 echo $env:ANTHROPIC_BASE_URL）。
3. curl https://hrouter.net/v1/models -H "Authorization: Bearer $你的Key" 返回 200。
4. 发一句测试消息，在 使用记录 能看到请求。