疑难排查
Claude Code API 报错——429、401、402、529
在这里 Claude Code 通过 Messages API 调用 GPT 和 Gemini 模型,并把 API 故障显示为以 "API Error:" 开头、后跟原始响应体的一行文本。下面的页面逐一覆盖每种形式:报错原文、产生原因以及解决办法。
| 错误 | 含义 |
|---|---|
API Error: 429 {"type":"error","error":{"type":"rate_limit_error… | 当账户的速率或并发上限被触达时,Claude Code 会打印 API Error: 429 rate_limit_error。为什么在 GPT 和 Gemini 模型上并行代理会触发它,以及如何解决。 |
API Error: 401 {"type":"error","error":{"type":"authentication_e… | 当没有任何有效密钥到达它所连接的端点时,Claude Code 会打印 API Error: 401 authentication_error。导致它的环境变量规则以及修复方法。 |
API Error: 529 {"type":"error","error":{"type":"overloaded_error… | 当所选 GPT 或 Gemini 模型的上游容量饱和时,Claude Code 会打印 API Error: 529 Overloaded。为什么这不是你请求的错、为什么它会扎堆出现,以及真正有用的做法。 |
API Error: 402 {"type":"error","error":{"type":"invalid_request_… | 当预付余额或密钥的消费上限不足以支付本次请求时,Claude Code 会打印 API Error: 402。去充值;不要把 402 当成限流去重试。 |
Claude Code API Error 429(rate_limit_error)原因与解决方法
当账户的速率或并发上限被触达时,Claude Code 会打印 API Error: 429 rate_limit_error。为什么在 GPT 和 Gemini 模型上并行代理会触发它,以及如何解决。
Claude Code API Error 401 authentication_error 解决方法
当没有任何有效密钥到达它所连接的端点时,Claude Code 会打印 API Error: 401 authentication_error。导致它的环境变量规则以及修复方法。
Claude Code API Error 529 Overloaded 是什么意思
当所选 GPT 或 Gemini 模型的上游容量饱和时,Claude Code 会打印 API Error: 529 Overloaded。为什么这不是你请求的错、为什么它会扎堆出现,以及真正有用的做法。
Claude Code API Error 402——余额不足
当预付余额或密钥的消费上限不足以支付本次请求时,Claude Code 会打印 API Error: 402。去充值;不要把 402 当成限流去重试。