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