跳到正文

Claude API 常见报错怎么解决:401、403、404、429

调用 Claude API 时最常见的报错是 401、403、404 和 429。下面按状态码列出原因和处理方法,适用于 curl、SDK 以及 Claude Code、Cline、Cherry Studio 等工具。完整的错误码说明见 API 文档。

状态码 / 错误 原因 处理
401 API_KEY_REQUIRED 请求没带 Key 在 x-api-key 或 Authorization: Bearer 请求头里带上 Key;工具里检查 Key 有没有填上。
401 INVALID_API_KEY Key 不对 Key 抄错,或前后多了空格、引号。到控制台重新复制完整的 Key。
401 API_KEY_DISABLED Key 已停用 在控制台启用它,或新建一个 Key。
403 INSUFFICIENT_BALANCE 余额不足 充值后重试。可以在控制台「钱包」查看余额和消费。
404 路径或模型不对 接口地址多写或少写了 /v1:Anthropic 兼容格式填 https://api.6090ti.com,OpenAI 兼容格式填 https://api.6090ti.com/v1;模型名写错或 Key 没开通该模型,用 /v1/models 核对。
429 请求太频繁或上游繁忙 降低并发、稍等再试;工具里可以开启自动重试。
5xx 上游暂时不可用 稍后重试;持续出现请把请求时间和模型名发给客服。
QQ用户群:1109931264
超时 回答很长或网络慢 开启流式输出,或调大工具的超时设置(Claude Code 用 API_TIMEOUT_MS)。

排查顺序

  1. 用 curl 请求 https://api.6090ti.com/v1/models,确认 Key 有效、能看到模型。
  2. 用 curl 发一条最简单的消息,确认接口地址和模型名正确。
  3. 以上都正常但工具里报错,再检查工具的接口地址写法(是否多了或少了 /v1)。

相关:接入教程 · 常见问题