
Claude Sonnet 5.5 429 报错怎么排查
429 不是封号。它是你的 key 在某一分钟里把某个维度的额度用超了,读一下响应头里的 retry-after,按它等就行。真正容易让人误判的是 529,那个跟你的额度一点关系都没有。
Sonnet 5.5 是 2026 年 9 月 28 日上线的,据雷峰网实测(来源),OpenRouter 上每百万输入 token 2 美元、输出 10 美元。便宜好用,很多人拿它当主力跑 agent,并发一上来 429 就成了日常。
先分清 429 和 529,修法完全相反
Claude Code 对这两种错误用不同措辞,看到报错先对号入座。
| 你在终端里看到的 | 状态码 | 含义 | 第一动作 |
|---|---|---|---|
| API Error: Request rejected (429) | 429 | 你的 key 超过了账户自己的每分钟限额 | 读 retry-after |
| Server is temporarily limiting requests | 429 | 流量陡增后的短期限流,不是你额度不够 | 等几秒再逐步放量 |
| Repeated 529 Overloaded errors | 529 | Anthropic 服务端满载,所有人一起排队 | 退避,或切轻一点的模型 |
| You've hit your weekly limit | 无 | Pro / Max 订阅额度,不是 API | 等窗口重置 |
429 的响应体里 error.type 是 rate_limit_error,529 对应的是 overloaded_error。分不清这两个,后面的动作全会做错方向:429 该减速,529 该等或者换模型,两者都不是「再重试一次」。

retry-after 怎么读,读完干什么
429 一般会带一个 retry-after 响应头,单位是秒。拿到之后按这个数字等,别自己拍脑袋定 3 秒。
没有这个头的时候,用 1 秒、2 秒、4 秒的指数退避,每次加随机抖动,最多 5 次就放弃往上抛。抖动这一步别省,不加抖动的话所有客户端会在同一秒一起回来,把下一次窗口又打满。
Claude Code 自己已经内置了这套逻辑,对瞬时 429 和 529 做指数退避,最多重试 10 次,界面上显示 Retrying in Ns 和 attempt x/y。看到这个倒计时别手动 Ctrl+C 再重发,手动重发不会加速,只会多占一份额度。
有一类 429 永远不该重试:余额不足、spend limit 打满这类计费上限触发的拒绝。它们不会自己恢复,重试到死也一样。
你超的到底是哪个维度
Anthropic 是三个维度分开限的,任一维度超了就返回 429:每分钟请求数 RPM、每分钟输入 token 数 ITPM、每分钟输出 token 数 OTPM。用的是令牌桶,额度持续补充,所以短时突发也会触发(来源)。
响应头里有一组 anthropic-ratelimit-* 字段,按 requests、input-tokens、output-tokens 分别给 limit、remaining 和 reset,还有合并口径的 tokens。想知道自己超的是哪一个,直接看这三个维度的 remaining 哪个先见底。

最常见的是 ITPM 先炸。长文档、大段代码、多轮工具调用堆出来的上下文,token 涨得比请求数快得多。「我只发了 20 个请求怎么就限流了」,答案通常在这。
三招把消耗降下来
降并发。把并行子代理和线程数压到 2 到 3 个,客户端按目标 RPM 的 80% 做令牌桶限速。最容易忽略的是重试逻辑本身放大并发:一次失败触发三次重试,同时进来的请求数就翻四倍。
上缓存。固定不变的 system prompt、工具定义、反复引用的长文档抽出来做 prompt cache,同一段输入不用每轮重新完整计一遍。多轮对话收益最大,因为你每次都在重发同一段历史。
拆请求。两万字以上的文档分批过,别一次塞进一个请求。发之前可以用 count_tokens 端点先估这次要吃多少 token,估出来超了就先拆,比撞 429 再重试划算。

订阅额度和 API 429 是两套机制
如果你用的是 Pro 或 Max 订阅,撞到的是 5 小时窗口或 7 天窗口用完,界面上会出现 You've hit your weekly limit 或 Your usage has reached the 5-hour limit,这不是 HTTP 429,等窗口重置就行,加钱买 API 额度也救不了这个会话。
如果你用的是按 token 计费的 API key,才是本文说的 429。两套凭据能在同一台机器共存,shell 里一个游离的 ANTHROPIC_API_KEY 可能把你路由到低 Tier 的 key 上,看起来像「额度莫名变少」。跑 /status 确认当前凭据,比改代码有用。
Sonnet 5.5 的具体数字去哪查
这里要说句实话:本文不给 RPM 和 ITPM 的具体数字,因为给不准。
限流配额按模型和 Tier 分档,会随版本调整,唯一权威来源是 Console 的 Limits 页面和官方的 rate limits 文档。而且从中国大陆网络直连 docs.anthropic.com 会返回 App unavailable in region,我核实时就撞上了这个页面,这也是一堆中文文章数字互相矛盾的原因。
第三方整理里能查到的公开数字,是 Tier 1 的 Sonnet 4.x 档 50 RPM、30,000 ITPM,出处是 2026 年 6 月的社区文章。Sonnet 5.5 的对应数字我没能在可访问的官方页面上核到,官方也没在公开页面写死,别拿上一代的表套 5.5。
Console 的 Limits 页面会显示当前档位和每个模型的实时配额,充值累计到一定额度自动升 Tier。看到 429 第一件事是去那看一眼,别先去搜。
常见问题
429 过一会儿会自己恢复吗?
速率型 429 会。令牌桶持续补充,按 retry-after 等完就能继续。但如果是 spend limit 或余额触发的 429,不会自己恢复,加额度之前重试多少次都一样。
响应里没有 retry-after 头怎么办?
按指数退避处理,1 秒、2 秒、4 秒、8 秒、16 秒,每次加 0 到 1 秒随机抖动,最多 5 次。第 5 次还 429 就说明不是瞬时抖动,去 Console 看配额。
升级 Tier 能彻底解决 429 吗?
能缓解,不能根治。Tier 上去了天花板也上去了,但如果并发随流量线性增长,迟早还会撞。结构性解法还是缓存加限速。
Sonnet 5.5 的 RPM 到底是多少?
官方没在公开页面写死一个固定值,配额随模型和 Tier 分档并且会调整。以你 Console 的 Limits 页面显示为准,网上抄来抄去的表大多对应上一代模型。
走第三方中转还会遇到 429 吗?
会,而且更难排查。中转商的并发池也会限流,你看到的 429 可能是上游透传的,也可能是它自己加的。用同一个 key 直连官方跑一次同样的请求,能通就是中转侧的问题。

京ICP备2024094994号-29