Claude too many requests 报错（429）：是 Anthropic 的限流，不是套餐上限，按顺序操作的6个修复办法

Claude 提示 too many requests 怎么修复？

按顺序做这六步。没有一步会动你的聊天记录或套餐。

1. 等一分钟，再重试一次。 Anthropic 的 Claude Code 错误参考写的是 "Wait briefly and try again"。反复点重试只会发出更多请求。
2. 用 claude update 更新 Claude Code。 2.1.199 及以后的版本会在你看到报错之前，先用退避方式自动重试这类限流。当前版本是 2.1.316，发布于2026年10月31日。
3. 运行 /status，检查当前使用的凭证。Anthropic 提醒："A stray ANTHROPIC_API_KEY in your environment can route requests through a low-tier key instead of your subscription."
4. 关闭多余的会话和子代理。 对于 API 密钥上的 429，文档建议 "avoid running many parallel subagents"。在一位 Max 订阅用户的日志里，122分钟中有114分钟出现 429，而那些时段开着六个或更多桌面会话。
5. 用 /model 切换模型。 在 API 上，每个模型都有各自的每分钟请求数和 token 数，所以换成较小的模型可以让脚本继续跑。
6. 查看 status.claude.com，然后上报。如果页面上没有公告，报错又持续数小时，就把完整的报错信息和 request ID 发过去。

下面是 Claude Code 打印的原文："API Error: Server is temporarily limiting requests (not your usage limit)"。Anthropic 的解释只有一行："The API applied a short-lived throttle that is unrelated to your plan quota." Claude Code 区分它和真正的上限，依据是 "by the absence of the unified quota headers a real limit response carries"。在 Claude 桌面应用的 Code 标签页里，一份2026年5月30日的 bug 报告显示，同样的限流以 "Server is temporarily limiting requests" 的形式出现，上面还有一行 "Too many requests right now"。这就是大家搜索的 "claude too many requests right now"。

2026年11月2日，我们在 Anthropic 公开的 Claude Code issue 列表里，搜索了2026年所有标题或正文含有 "temporarily limiting requests" 的 issue，共410条。其中一个账号提交了275条，它7月下旬的报告都写的是 Claude Code 2.1.114，那是4月的版本。我们把这个账号剔除了。其余135条来自125个不同的人，其中129条在7月之前提交。2.1.199 的更新日志写道："Transient server rate-limit errors (429s unrelated to your usage limit) are now retried automatically with backoff for subscribers instead of failing the turn"。限流并没有消失。9月有一份报告统计到一天内有195次 429 被重试。所以这个下降应理解为失败的对话轮次变少了，而不是 429 变少了。

你看到的是哪一种 Claude too many requests 提示？

提示的措辞说明你撞上的是谁的上限。下表涵盖 Claude Code、Claude 桌面应用和 Claude API，内容截至2026年11月2日。

Anthropic 面向 Claude 应用的错误信息指南里，根本没有列出 "too many requests" 这条提示。它列出的达到上限的提示都写明了重置时间，只有 "approaching" 之类的预警没有。所以，如果你的提示里写了时间，你撞上的就是套餐上限，修复办法见 Claude usage limit reached。如果提示是 overloaded 或 529，那是容量问题，见 Claude overloaded。

用量很低，为什么 Claude 还提示 too many requests？

用量低时 Claude 仍提示 too many requests，是因为限流统计的是请求到达的速度，而不是你花掉了多少套餐额度。Anthropic 的速率限制页面说，限制可能在很短的时间内生效："a rate of 60 requests per minute (RPM) might be enforced as 1 request per second." 所以一阵突发的调用可能失败，即使这一分钟的平均值看起来没问题。

bug 报告把这一点写得很清楚。一位2026年5月30日的 Max 订阅用户在额度刚重置的那天就遇到了限流。一份8月18日的报告在用量1%时持续遇到 429。一份9月24日的报告在套餐用量26%到27%时，开着六个或更多桌面会话，14%的会话分钟里出现了 429；开五个或更少时，不到1%。

用量突然增长也会触发。Anthropic 的 API 错误页面写道："if your organization has a sharp increase in usage, you might see 429 errors because of acceleration limits on the API." 它的建议是 "increase your traffic gradually and maintain consistent usage patterns." 一个同时分出许多子代理的 Claude Code 工作流，发出的正是这种突增。对于使用 claude.ai 套餐的用户，Anthropic 没有公布这种限流背后的具体数字。

Claude 的 too many requests 报错会持续多久？

Claude 的限流通常在几秒到几分钟内恢复。Claude Code 会用指数退避最多重试10次短时 429，等待期间会显示 Retrying in Ns · attempt x/y。只有这些重试都用完之后，你才会看到报错。

有些报告持续的时间长得多。5月30日的那位报告者说它持续了 "two days"，新开一个会话后能工作 "3 hours at least" 才再次出现。一份6月15日的报告说，在 Opus 4.8 上这个限流已经持续了 "for the last 24 hours"。在5月的那个帖子里，新开会话并换一个模型，让大家又能工作了。如果只开一个会话，一小时后仍然出现，那就不是你这边能解决的。

对于你不在时运行的任务，Claude Code 有一个专门的开关。设置 CLAUDE_CODE_RETRY_WATCHDOG=1，它会无限期重试 429 和 529 错误。用 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 限制等待时间，例如 3600000 表示一小时。如果脚本需要快速失败，就改设 CLAUDE_CODE_MAX_RETRIES=2。

付费订阅 Claude Max 能避免 too many requests 吗？

不能。这个限流 "unrelated to your plan quota"，上面的报告也来自 Pro 和 Max 订阅用户。根据 Anthropic 的定价页面，截至2026年11月，Claude Pro 每月 $20，Max 为 $100，Ultra 为 $200。Max 列出了 "Priority access at high traffic times"。Anthropic 没有说明这是否涵盖这种限流。

发布这篇文章的 Whizi 也有同类防护，并且把数字公开：每位用户每分钟10条聊天消息，每小时60条，所有套餐相同。它的每分钟报错写的是 "Too many requests. Please wait and try again."，被拒绝的请求不会消耗你的额度（见 Whizi 速率限制）。Whizi 的劣势在于：每小时60条是硬性上限，而 Claude Max 根本没有公布每小时的数字。

Claude API 返回 429 rate_limit_error 怎么修复？

重试之前先读错误正文，因为 Claude API 对不止一种问题都返回 429 rate_limit_error。Anthropic 的错误页面说你的组织 "has hit a rate limit, reached its usage tier's monthly spend cap, or reached a spend limit on the Claude Code workspace." 其中只有一部分会随时间自行恢复。

有两个细节容易让人踩坑。第一，你自己设置的花费限制不是 429，而是 400 invalid_request_error，开头是 "You have reached your specified API usage limits"。第二，花费上限是 Start 档每月 $500，Build 档 $1,000，Scale 档 $200,000。到达上限后，"API usage pauses until 00:00 UTC on the first day of the next month"，连 SDK 的自动重试也会一直失败到那时。

这些限制属于你的整个组织，而不是某一个密钥。截至2026年11月，在 Start 档，Claude Opus 5.5、Sonnet 5.5 和 Haiku 5.5 每个模型每分钟可发 4,000 个请求、2,000,000 个输入 token。新组织可能从更低的 Evaluation 档开始。在大多数模型上，从缓存读取的 token 不计入每分钟输入 token，所以提示缓存能抬高你实际可用的上限。官方 SDK 默认对 429 重试两次，并遵循 retry-after。留意每个响应里的 anthropic-ratelimit-requests-remaining 响应头，在它降到零之前就放慢速度。