Claude Code 529 Overloaded 是什么意思？别慌，和 429、500 的区别及 5 个解决办法
Claude Code 报 Repeated 529 Overloaded errors，是 Anthropic 那边模型容量不够，不计入你的额度。它和 429、500 有什么区别，Claude Code 自己会重试几次，以及按顺序可以试的 5 个办法。
buffer关于作者约 8 分钟阅读
Claude Code 停下来报 “API Error: Repeated 529 Overloaded errors”，意思是 Anthropic 那边你正在用的这个模型算力不够了，不是你的额度用完了。Anthropic 官方文档写得很清楚，Claude Code 529 Overloaded 不算你的使用限额，也不扣额度。一般等几分钟、看一眼 status.claude.com，或者用 /model 换个模型就能继续。下面我把这个错误是什么、和 429、500 有什么不同、Claude Code 自己已经帮你做了哪些重试、你还能做什么，一条条讲清楚。文中的说法都来自官方文档、状态页和 GitHub 上的真实反馈，链接都放在正文里。
Claude Code 529 Overloaded 是什么意思
529 是 Claude API 返回的 HTTP 状态码，对应的错误类型是 overloaded_error。Claude API 错误文档对它只有一句解释：”The API is temporarily overloaded.”，也就是 API 暂时过载。下面还补了一句：当所有用户的总流量很高时，就可能出现 529。
Claude Code 不会把第一次 529 直接甩给你。它会先在后台自动重试，重试次数用完了，你才会看到 Claude Code 错误文档里这段完整提示：
API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.同一页还有一句原话：”A 529 is not your usage limit and doesn’t count against your quota.” 所以你的 Pro 或 Max 额度没有被用光，账号也没出问题。只是同一时间请求这个模型的人太多，Anthropic 拒掉了一部分请求。
529 和 429、500 的区别
这三个错误码经常被混在一起，但处理方法完全不一样，先分清楚是哪一个。
| 状态码 | 错误类型 | Anthropic 官方的解释 | 等一等有没有用 |
|---|---|---|---|
| 529 | overloaded_error | API 暂时过载，所有用户的总流量太高 | 有用，通常几分钟内恢复 |
| 429 | rate_limit_error | 你的组织触发了速率限制、所在等级的月度消费上限，或 Claude Code 工作区的消费上限 | 短时限流有用；触发消费上限的话，在恢复之前会一直失败 |
| 500 | api_error | Anthropic 系统内部出现意外错误 | 有用，按指数退避重试 |
| 504 | timeout_error | 请求处理超时 | 重试，长请求改用流式 |
429 是你自己或你所在组织的问题。在 Claude Code 里，用 API key、Bedrock 或 Google Cloud 项目时它显示为 “Request rejected (429)”；用 Pro 或 Max 订阅时，它显示为 “You’ve hit your session limit” 或 “You’ve hit your weekly limit”。订阅的这两个限额是所有模型共用的，所以换模型解决不了。各种报错原文我都整理在 Claude Code 常见报错速查里，额度本身怎么算可以看 Claude 额度规则详解。如果你遇到的是 429 而不是 529，可以直接看我整理的 Claude Code 429 限流速查，里面有全部提示原文、该看的响应头和 Codex 的对应情况。
500 是 Anthropic 那边的故障，也不怪你，Claude Code 对它的提示里同样指向状态页。
报错之前 Claude Code 已经替你重试过了
等你看到这条提示时，Claude Code 其实已经重试了好几次。错误文档写的是，遇到临时故障它会用指数退避最多重试 10 次，然后才把错误显示出来，过载响应也在重试范围里。重试期间，加载动画会显示 Retrying in Ns · attempt x/y 这样的倒计时。从 v2.1.198 开始，如果是 529，倒计时下面还会提示你去 status.claude.com 看看。
有个细节值得知道。环境变量文档提到，遇到 529 时重试可能会提前停止，并举了例子：用 API key 调 Opus 模型时，第三次 529 就会停下来报错。所以你用 Opus 时很快就看到这个错误，属于正常现象，不是安装出了问题。
下面这几个是官方提供的、和 529 处理相关的设置：
| 设置 | 默认值 | 作用 |
|---|---|---|
CLAUDE_CODE_MAX_RETRIES | 10 | 重试次数，从 v2.1.186 起最多 15 次 |
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS | 500 | 529 重试的起始间隔（毫秒），最高可设 32000，需要 v2.1.292 以上 |
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS | 32000 | 529 重试间隔的上限（毫秒），最高可设 64000，需要 v2.1.296 以上 |
CLAUDE_CODE_RETRY_WATCHDOG | 未设置 | 设为 1 后，在 CI 这类无人值守的任务里对 429 和 529 无限重试 |
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS | 未设置 | 开启 watchdog 时，限制每个请求最多等多久（v2.1.295 以上） |
我不建议在平时交互使用时打开 watchdog。它是给没人盯着的任务准备的，你坐在终端前的时候，看到报错自己判断会更好。
5 个解决办法，按这个顺序试
1. 等几分钟，再发一句”继续”
官方给的第一条建议就是过几分钟再试。你原来的消息还在对话里，不需要重新粘贴长长的提示词，直接输入”try again”或者”继续”就行。
2. 打开 status.claude.com 看一眼
打开 status.claude.com。如果你正在用的模型有进行中的故障，那就只能等，不用再折腾本地配置了。今天，也就是 2026 年 10 月 27 日，就有一次：”Elevated errors for Claude Sonnet 5.5″，北京时间 17:14 发布，17:56 标记为已解决。状态页写的是”错误率升高”，没有直接写 529，所以它只能作为很强的参考，不能当作证据。
3. 用 /model 换一个模型
这个办法经常管用，因为文档里写了容量是按模型分别计算的（”capacity is tracked per model”）。输入 /model 选另一个模型就行。某个模型负载特别高时，Claude Code 甚至会主动提示你，比如 Opus is experiencing high load, please use /model to switch to Sonnet。在 Claude 桌面应用里，提示是 “Opus is experiencing high load. Switch to Sonnet.”，用应用里的模型选择器切换。
4. 设置备用模型，让它自动切换
如果你经常遇到这个错误，可以配置一个备用模型链。根据模型配置文档，主模型过载或不可用时，Claude Code 可以改用备用模型，而不是直接报错。只想在本次会话生效的话，这样启动：
claude --fallback-model sonnet,haiku想长期生效，就在 settings 里把 fallbackModel 设成一个数组。切换只对当前这一轮生效，备用链最多三个模型，而且限流类错误永远不会触发切换。最后这一点很重要，意味着备用模型不会把 429 掩盖掉。从 v2.1.247 起，备用链也覆盖子代理。在这之前，子代理遇到这类错误会直接结束，这和 2026 年 7 月 GitHub 上的一个反馈对得上：一位用户在一次长会话里有四个后台代理因为 529 被终止。
5. 更新 Claude Code，还不行就反馈
上面提到的不少重试改进只有新版本才有，版本落后的话先运行 claude update。我查的时候 npm 上的最新版本是 2.1.311。如果状态页没有故障，你还是一直遇到这个错误，就运行 /feedback，把请求详情发给 Anthropic。
什么时间段用更稳？（北京时间）
我专门找了官方说法，针对 529 的没有找到。Anthropic 没有公布过容量错误的时间规律。
最接近的是 2026 年 3 月 26 日公布的一次调整。Anthropic 的 Thariq 在 X 上发帖说，工作日太平洋时间早上 5 点到 11 点之间，你的 5 小时会话额度会比以前消耗得更快，每周额度不变。这说的是会话额度消耗速度，不是 529，但它能告诉你需求最高的时段。换算成北京时间，美国夏令时期间是晚上 20:00 到凌晨 02:00，2026 年 11 月 1 日夏令时结束后是 21:00 到 03:00。我没有找到更新的官方页面确认这条高峰规则现在还在执行。
我还把状态页上这个月的模型故障按北京时间排了一遍。10 月份涉及 Claude Code、并点名具体模型的故障一共 9 次，只有 2 次是在这个晚间时段开始的，其余都发生在北京时间的上午或下午。所以白天用并不能躲开 Claude Code 529 Overloaded，它主要是让你的会话额度更耐用。
其他用户遇到的情况
遇到这个问题的不止你一个。我查的时候，在 anthropics/claude-code 仓库里搜索标题含 “529 Overloaded” 的 issue，一共有 114 个。讨论最多的是 2025 年 7 月的 #3572，有 274 条评论。最近的反馈也差不多：2026 年 7 月的 #78535 截图里是 529 Overloaded · Retrying in 0s · attempt 10/10，还有一位用户在 #75953 里统计，2026 年 6 月 8 日到 7 月 9 日之间的 13 天多里，日志记录了 322 次 529。
如果你也用 Codex，它也有自己的”容量不足”报错，写法不一样，我在 Codex 提示 Selected model is at capacity 怎么办里讲过。两个工具怎么选，可以看 Claude Code 和 Codex 该买哪个。
529 报错常见问题
529 会消耗我的 Pro 或 Max 额度吗？
不会。Claude Code 文档原话是 529 “is not your usage limit and doesn’t count against your quota”，不是使用限额，也不计入额度。
从 Pro 升级到 Max 能避免 529 吗？
我没有找到任何官方说法表示更高的套餐能避开 529。Anthropic 对它的描述是所有用户的总流量太高。Max 给你的是每个会话更多的用量，解决的是 429 会话限额，不是容量问题。如果你本来就在纠结买哪个，可以看我写的 Claude Pro 和 Max 怎么选。
为什么我用 API key 调 Opus，一下子就报错了？
这是文档里写明的行为。用 API key 调 Opus 模型时，Claude Code 在第三次 529 就停止重试并报错。设置了备用模型的话，它会切换过去而不是报错。
529 和 “Server is temporarily limiting requests” 是一回事吗？
不是。那条提示是短时的 429 限流，Claude Code 通过请求里没有额度相关的响应头来识别它，文档也注明了”not your usage limit”。v2.1.199 以后 Claude Code 会自动重试这种情况。
CI 里能让 Claude Code 一直重试吗？
可以。设置 CLAUDE_CODE_RETRY_WATCHDOG=1，它会对 429 和 529 容量错误无限重试，还可以用 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 限制最长等待时间。