疑难排查 · Claude Code
Claude Code API Error 429（rate_limit_error）报错原因与解决方法
当每分钟吞吐量耗尽时，Claude Code 会打印 API Error: 429 rate_limit_error。这个限制到底是什么、为什么并行智能体会触发它，以及如何解决。
你看到的报错
API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"This request would exceed your organization's rate limit of 80,000 input tokens per minute. Please reduce the prompt length or the maximum tokens requested, or try again later."}}为什么会发生
- 你的密钥背后 API 组织的每分钟 token 或请求上限被超出。消息中的数字是该组织自己的限额，因此不同账户各不相同。
- 多个 Claude Code 会话或子智能体并行使用同一把密钥——每个会话每轮都会重发完整上下文，突发流量累积得比表面上看起来快得多。
- 单个超大上下文本身就可能超出每分钟 token 预算，这也是消息同时建议缩短提示词而不只是等待的原因。
- 重试叠加在引发第一个 429 的突发流量之上，不但没有排空窗口，反而把它撑得更满。
如何解决
- 等过这一分钟窗口——Claude Code 会自动重试并遵守 Retry-After。如果持续复发，就减少共享同一把密钥的会话数量。
- 缩减每轮携带的内容：用 /compact 压缩过大的对话，或者开一个新会话，而不是拖着冗长的历史继续。
- 不要把它和 "Claude usage limit reached" 混淆——后者是带重置时间的订阅上限，不是每分钟吞吐量。两者的解决方法不同。
- 如果你持续需要的吞吐量超过密钥所属组织的允许值，那是容量问题而不是重试问题——去找你的提供商谈。
相关搜索
claude code api error 429claude code rate limit error
常见问题
Claude Code 里的 API Error 429 意味着我的订阅用完了吗？+
不是。429 是 API 密钥的每分钟吞吐量限制。订阅用完会显示为带重置时间的 "Claude usage limit reached"。
Claude Code 会自己重试 429 吗？+
会——它会自动退避并重试。如果错误持续，说明窗口被填充的速度快于排空的速度，通常是同一把密钥上的并行会话造成的。
为什么一个巨大的提示词自己就能引发 429？+
速率限制按每分钟 token 计数，一个超大的上下文可能在单次请求中就花光整分钟的预算。