Claude Code 429 报错速查：四种文案对号入座解决
Claude Code 报 429（Rate limit reached），十有八九不是 Anthropic 宕机，而是你的账户撞上了某条每分钟的请求或 token 预算。修法很干脆：读一个响应头，然后给对的那个维度减速。下面把四类报错文案做成一张对号入座表，对照你的终端再动手。
先对号入座：你终端里的文案是哪一种
你的动作完全取决于你看到哪句：
| 终端文案 | 含义 | 第一步 |
|---|---|---|
| Request rejected (429) | 超自己账户每分钟限额（RPM/ITPM） | 读 retry-after，降并发 |
| Server is temporarily limiting (429) | 服务端短暂限流，不是你的额度 | 稍等再逐步放量 |
| Repeated 529 Overloaded | 服务器满载，非你的问题 | 等待或切轻量模型 |
| You've hit your weekly limit | Pro/Max 订阅周额度 | 查订阅用量，与 API 429 无关 |
前三种才是 API 侧要处理的，最后一行是订阅套餐的额度，别混在一起修。
三步解决：读头、验凭据、降并发
第一步：读 retry-after 响应头。 429 响应里往往带 retry-after，告诉你要等多少秒。先按它老实等，别硬顶着重试。
第二步：确认当前生效的是哪个凭据。 在 Claude Code 里按 / 调出 /status，看当前路由到的账户是不是你以为的那个。常见坑是 shell 里游离的 ANTHROPIC_API_KEY，把你路由到一个低 Tier 的 key，一上来就撞限。
第三步：按维度降级。
- 是 RPM 撞了，减少并行子代理数。
- 是 ITPM（输入 token）撞了，给长上下文减负，或加缓存避免反复喂同一段。
- 想一步到位，去 Console 的 Limits 页看你的 Tier 对应实时额度，按真正卡住的那条决定升 Tier 还是加缓存。
关于具体 Tier 的限额数值，Anthropic 会随模型和账户动态调整，请以官方 rate-limits 文档和 Console 的 Limits 页为准，别照搬别人的数字。
官方口径与常踩的坑
Anthropic 官方在 rate-limits 文档里把 429 定义为客户端超限，和 529 服务端过载区分开，同时提供 errors 参考文档（详见 官方 rate-limits 与 官方 errors）。
关键认知：429 是因为它给了额度，不是崩了。
另一个坑是「订阅额度和 API 额度是两套」。Pro/Max 订阅撞到的是每周用量上限，走 /status 看订阅剩余；Anthropic API 按 token 计费走 Console limits。两套东西分开看，不然会越修越糊涂。
一句预防 429
并行开太多、长 Agent 循环、上下文塞太满，都会提前耗尽每分钟预算。
想省，可先看站内几篇：搞懂订阅和 API 谁在算账，读 Claude Code 订阅与额度指南；想让请求更省 token，读 Claude Code 怎么省 token。
中断会话恢复，读 Claude Code 会话续接技巧。
常见问题
Claude Code 报 429 是不是账号被封了？
答：不是。429 是速率限制，通常返回你账户在某一时刻的每分钟额度，等 retry-after 后重试即可；封号是另一回事，要去看账号状态。
Request rejected (429) 和 529 有什么区别？
答：429 是客户端（你的账户）超过自己的每分钟限额，问题在你这边怎么并发；529 是 Anthropic 服务器满载，对所有客户有影响，只能等或换模型。
怎么判断我卡在请求数还是 token 数？
答：看 429 响应里 anthropic-ratelimit-requests- / anthropic-ratelimit-input-tokens- 头的剩余值，哪个接近 0 就卡哪个，再对症减并行或减 token。
429 是到整分钟再重试吗？
答：不完全是。RPM、ITPM、OTPM 各自有独立的 reset 时间戳，响应里 -reset 头会告诉你下次复位点，跟着那个重试即可，不必死等一整分钟。
Claude Pro 周限量也会报成 429 吗？
答：会但文案不同，通常写 you've hit your weekly limit · resets。这是订阅套餐的每周额度，不是 API 429，要走订阅用量页或等周重置。
京ICP备2024094994号-29