疑难排查 · Claude Code
Claude Code API Error 529 Overloaded 是什么意思
当所选 GPT 或 Gemini 模型的上游容量饱和时,Claude Code 会打印 API Error: 529 Overloaded。为什么这不是你请求的错、为什么它会扎堆出现,以及真正有用的做法。
你看到的报错
API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}为什么会发生
- 所选 GPT 或 Gemini 模型的上游容量暂时饱和。端点把它报告为 529 overloaded_error——Claude Code 本来就会重试的状态码。它描述的是服务那一刻的状态,而不是你的请求——你的请求内容里没有任何东西导致它。
- 它会在故障期间和高峰时段扎堆出现:同样的请求通常几分钟后无需你做任何改动就能成功。
如何解决
- 让 Claude Code 自己重试——它会自动退避。如果一次运行总是中断,就等几分钟,而不是在同一分钟里反复猛打。
- 对于长时间无人值守的运行,机械性步骤选用更轻量的模型:它通常竞争更少,运行就能熬过容量低谷。
- 如果 529 长时间持续,把 ANTHROPIC_MODEL 指向另一个 GPT 或 Gemini 模型——你的配置几乎从来不是原因。
相关搜索
claude code overloaded errorclaude code 529 keeps happening
常见问题
529 和 429 不一样吗?+
不一样。429 是你自己的吞吐量上限;529 是上游容量。退避对两者都有帮助,但只有 429 会因为你降低用量而缓解。
是我的提示词导致了 529 吗?+
不是。Overloaded 是服务端的状态。容量恢复后,完全相同的请求通常就会成功。
看到 529 时应该换模型吗?+
对延迟敏感的工作,临时换用另一个 GPT 或 Gemini 模型会有帮助,因为容量按模型分别计算。其他情况下,等待就够了。