疑难排查 · Claude Code
Claude Code API Error 529 Overloaded 是什么意思
当上游容量饱和时，Claude Code 会打印 API Error: 529 Overloaded。为什么这不是你的请求的问题、为什么它会集中出现，以及什么才真正有用。
你看到的报错
API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}为什么会发生
- 上游容量暂时饱和。529 描述的是那一刻的服务状态，而不是你的请求——你的负载里没有任何东西引发了它。
- 它在故障期和高峰时段集中出现：同样的请求通常几分钟后就能成功，你这边无需任何改动。
如何解决
- 让 Claude Code 自己重试——它会自动退避。如果一次运行反复失败，等几分钟，而不是在同一分钟里反复轰击。
- 对于长时间无人值守的运行，机械性步骤优先用较小的模型：它们通常竞争更少，运行更能扛过容量波动。
- 如果 529 长时间持续，先查看提供商的状态页面，再考虑改动你的配置——你的配置几乎从来不是原因。
相关搜索
claude code overloaded errorclaude code 529 keeps happening
常见问题
529 和 429 有什么区别？+
有。429 是你自己的吞吐量上限；529 是上游容量问题。退避对两者都有帮助，但只有 429 会因为你减少用量而缓解。
是我的提示词导致了 529 吗？+
不是。Overloaded 是服务端状况。完全相同的请求通常在容量恢复后就能成功。
看到 529 时应该换模型吗？+
对延迟敏感的工作，临时改用较小的模型有帮助，因为它竞争更少。其他情况下，等待就足够了。