529 速览
- 529 Overloaded 表示 Anthropic 的 API 暂时对所有用户满容量——官方文档原话：它"不是你的用量限制，也不计入你的配额"。它绝不是封号。
- 第一步永远是同一个：查 status.claude.com（或 curl -I 一下），确认是不是 Claude 官方在降级——我们的 Claude 状态实时指南教你怎么读这个页面。
- 立即解法按顺序来：等 Claude Code 自动重试跑完、/model 切到更轻的档位（容量按模型分别统计）、降低工具并发。
- 从 Claude Code 2.1.296 起，可以设置 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS，把 529 重试的退避上限拉长，适合长任务。
- 529 ≠ 429：429 是你的密钥撞了自己的速率限制（你的问题），529 是所有人的容量满了（Anthropic 的问题），500 是 API 内部意外故障（等一分钟重发）。
How to Fix Claude API "Overloaded" Error (529 Status Code)
频道Nexustech4:32
Claude errors reference — 529, 429, 500 & retry tuning
文档code.claude.com/docs
画面全部来自一支干净的录屏——"currently unavailable" 容量横幅、VS Code 里的 curl 状态检查、标灰过载模型的模型选择器、529 故障转移布局和应用内支持聊天（Nexustech，JGlrcRDtdls）。另外三支视频——Extreme Guides 的 CLI 演示（_oEU-6xbcWs，其中的命令在 Claude Code 里并不存在）、Izoate 的文章念屏（fHlvs5evSi0，烧录按钮和频道台标）、Last Error Fixer 的 400 修复（vHEi32hIh1I，烧录字幕）——只提供了事实或框架，因画面不合格被淘汰。报错措辞以官方错误文档和 Claude Code 2.1.296 更新日志（2026-10-09）为准。每一步都深链到来源视频的精确秒数。
视频截图版权归原创作者所有，此处以图文教程形式引用并署名、深链。
一步一步修好 Claude Code overloaded（529）
第 1 步 — 确认是官方的问题，不是你的
- 1
认出容量过载状态的样子
529 是全 Claude 范围的容量压力，所以它的迹象会同时在所有表面出现：Claude 应用在输入框上方挂出 "currently unavailable" 横幅，直接调 API 返回 HTTP 529 和 overloaded_error 响应体，Claude Code 的转圈提示变成 "Retrying… attempt x/y"。如果只有你的终端报错而应用一切正常，那要怀疑本地环境——我们另有一篇卡死排查指南管这条线。
Claude 应用首页挂着 "Claude Fable 5 is currently unavailable" 横幅——和 529 报给你终端的是同一种容量压力。在 0:02 观看 - 2
先查官方状态页
动任何配置之前先开 status.claude.com——它是降级与故障的唯一权威来源。终端里 curl -I https://status.anthropic.com/ 会直接解析到状态页。看板全绿但你在吃 529，说明过载是单个模型的事，下面的解法照用；看板变红，就跟着事故处理走，别按你的 runbook 硬来。我们的 Claude 状态实时指南教你怎么读这个页面、哪几栏预示终端会报错。
VS Code 终端里对 status.anthropic.com 执行 curl -I——307 重定向的 location 头落在 status.claude.com，529 是否官方一看便知。在 1:00 观看 - 3
排除本地嫌疑
在 Claude Code 里运行 /status：它会显示当前模型、账号和连接状态。529 不花你一分钱——文档明说它"不计入你的配额"——所以这里没有用量条要看。如果 /status 显示账号正确、连接正常，那错误确实在服务端；其他情况（401、403、计费报错）归另外的指南管。
第 2 步 — 立刻解 blocked 的几个办法
- 4
让内置重试先跑完
Claude Code 本来就会对瞬时故障做最多 10 次指数退避重试，转圈时还带倒计时（"Retrying in 8s · attempt 2/7"）。529 高峰期最聪明的做法通常是等这些尝试跑完，而不是疯狂按回车——多出来的每个请求都在同一条容量队伍里排队。如果次数耗尽还报错，再进入下一步。
- 5
用 /model 切到更轻的模型
容量按模型分别统计，所以官方文档对 overload 的第一条建议就是："Run /model and switch to a different model to keep working." 在 Claude Code 提示符里输入 /model 选一个更低的档位——旗舰模型堵死时，Sonnet 和 Haiku 档通常还在正常响应。Claude 应用里同样的选择器会把过载模型标成 "Currently unavailable"，选之前就能看清哪条道被堵了。
模型选择器里 Fable 5 被标为 "Currently unavailable"，Sonnet 4.6 仍带勾、Haiku 4.5 仍可选。在 1:36 观看 - 6
降低你这边的并发
并行工具调用和后台任务会成倍放大你占用的容量。把 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY 降到 2-3，暂停其他正在跑的会话或 agent 团队，事故期间别在同一个仓库上再开第二个 Claude Code 实例。并发请求越少，容量恢复后重试队列也清得越快。
- 7
事故拖长了就联系支持
如果状态页已经恢复、529 还在源源不断，就交给 Anthropic：在 Claude 应用里点开左下角的个人菜单，选 Get help。应用内助手可以直接收错误报告——把状态码和发生时间贴进去就行，不用去找客服邮箱。
个人菜单里 Get help 就在 Settings 和 Language 下面——反馈顽固 529 的入口。在 2:20 观看 - 8
向支持助手描述这个 529
在支持聊天里写清状态码、模型和时间段："I've received a 529 status code on claude-opus-4-8 since 14:00"。助手会给你一个会话 ID 备查——留着，方便追问。支持能告诉你是你的账号撞上了罕见的持续故障，还是整个模型档位对所有人都在下沉。
支持聊天里已输入 "I've received a 529 status code can you help…"，会话 ID 已经分配。在 3:06 观看
第 3 步 — 调 529 退避参数（Claude Code 2.1.296+）
- 9
拉长退避上限（2.1.296+）
Claude Code 2.1.296 新增了 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS——更新日志原话："Added CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS environment variable to set a longer maximum delay for the backoff when retrying an overloaded (529) request." 启动前导出即可，比如 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=30000 表示重试间隔最长 30 秒。Anthropic 没有公布内置默认值，别处看到的具体数字都当未证实处理——这个变量保证的是：长的重试序列会等得更久，而不是早早放弃。
- 10
搭配另外两个重试旋钮
还有两个相邻变量：CLAUDE_CODE_MAX_RETRIES（默认 10）调高瞬时错误的尝试次数；CLAUDE_CODE_RETRY_WATCHDOG=1 会无限重试 429/529——文档推荐在无人值守的会话里开它，因为提前放弃会浪费整场任务。Watchdog 加上一个宽裕的最大延迟，能把 529 高峰从崩溃变成暂停。
第 4 步 — 预防下一次被容量卡住
- 11
预防下一次：错峰、拆任务、故障转移
三个习惯能显著减少 529：重活避开美国高峰时段（大约工作日 11:00-20:00 太平洋时间）；把巨型 prompt 拆成小任务——每个任务一个 git worktree，会话互不拖累；直接调 Messages API 的话，写上故障转移：捕获 529，热切换到更轻的模型，再按指数退避重试。套餐侧的上限看我们的用量限制指南；529 本身永远不会扣你的配额。
一份原始请求故障转移布局：主目标是 claude-sonnet-4-5，收到 529 响应就热切换到 claude-haiku-4-5 兜底。在 2:08 观看
529、429、500：到底谁是谁
Claude 的报错都带着编号，编号决定了这是谁的问题。官方错误参考把它们分得很干净——动手删配置文件之前，先把这份清单过一遍。
- 1429 速率限制——你的密钥、项目或套餐撞上了配置在你侧的限制。用 /status 确认当前凭证，查你的服务商控制台，把 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY 调低。短时节流会自动重试；网关的支出上限 429 不会。
- 2529 Overloaded——API 暂时对所有用户满容量。定义上就是服务端：你的代码、密钥、配置都不可能是原因，也永远不计入配额。等、切模型、或者拉长退避。
- 3500 内部服务器错误——API 内部的意外故障，通常是暂时的。等一分钟原样重发；长 prompt 的话，输入 "try again" 会从断点继续。
- 4"Server is temporarily limiting requests"——与套餐配额无关的短时限流。稍等再试就行；改任何配置都不会让它更快解除。
- 560 秒分诊：状态页全绿 + 529 = 等它过去；全绿 + 429 = 用 /status 查自己的限制；状态页泛红 = 什么错都可能出现——跟事故处理走，别盲重试添堵。
- 6什么时候才需要真着急：单个模型连续数小时聚集 529 而状态页保持全绿，值得带上时间戳找支持（第 8 步）。其余情况设计上就是瞬时的——官方文档对这三个码的态度都是"值得重试"，而不是"账号出了问题"。
本站的分工也一样：卡死冻结归卡死排查指南，529/500 容量报错归本页，429 式上限归用量限制指南。如果你的会话是冻住而不是报错，请换指南——两边的修法不重叠。