# Claude API 错误 529：过载、证据与重试

Claude 文档将 529 overloaded_error 定义为暂时的 API 过载。它与 429 请求或支出限制不同，单个响应不能确认事件影响范围。

作者：IsAnythingDown. 核对于 2026-10-06.

规范页面： https://isanythingdown.com/zh-cn/guides/ai-api-error-529

## 简要回答

Claude 文档将 529 overloaded_error 定义为暂时的 API 过载。它与 429 请求或支出限制不同，单个响应不能确认事件影响范围。

## 读取响应和流

Claude 区分 529 过载与 429 请求限速。文档还说明流式错误可能在 HTTP 200 后到达；应检查流中的错误和完成情况，不能仅依赖响应头。

- [Claude API 错误](https://platform.claude.com/docs/en/api/errors)

## 建议的应用处理方式

对于暂时过载响应，应设置有界延迟和重试预算，并考虑 SDK 已执行的重试。保留请求 ID 和时间用于排查。不能仅因模型请求失败就重复执行 Agent 后续动作。

将官方报告中的 Claude API 组件与失败时间对照。已保存的 Claude 报告包含多个产品，不验证每个模型、账户或地区。如果通过路由服务调用 Claude，也应检查该路由服务的错误与范围。

- [Claude 服务报告](https://isanythingdown.com/zh-cn/services/claude)
- [429 的不同原因](https://isanythingdown.com/zh-cn/guides/ai-api-error-429)
- [Agent 的状态决策](https://isanythingdown.com/zh-cn/guides/agent-status-checks)

## 相关服务页面

- [Claude](https://isanythingdown.com/zh-cn/services/claude)

每个条目显示自己的采集覆盖。链接到服务不一定表示自动采集。

编辑审核日期适用于本指南。实时报告采集时间显示在服务页面。