「API Error: Server is temporarily limiting requests (not your usage limit)」
更新于
「API Error: Server is temporarily limiting requests (not your usage limit)」表示 API 做了与套餐额度无关的短时节流。没有要等的窗口：稍后重试，持续出现看 status.claude.com。v2.1.199 起会先自动退避重试再显示。会话与周限额不受影响。
- 上次重置
- 09-04 20:08Z
- 状态
- 已超期
距上次重置已超过近期中位间隔的 1.5 倍。
- 预计下次
- 随时
- 距今天数
- 13.1
天
「API Error: Server is temporarily limiting requests (not your usage limit)」是什么意思？
Error reference 把这句放在用量限额一节，但说明它的性质不同：API 做了与套餐额度无关的短时节流。Claude Code 靠响应里缺少真正限额响应才会带的统一额度头来区分它。
v2.1.199 起，无论用哪种方式登录，Claude Code 都会先自动退避重试再显示它。更早的版本里，用 claude.ai 订阅登录的会话第一次遇到就会让本轮失败，只有 API key 与 Enterprise 登录会重试。
issue #68502（2026-06-15）记录了 HTTP 529 overloaded_error 被渲染成这句加「Rate limited」后缀，导致并行会话与子代理失败，也让用户误以为撞了额度。Claude Platform 的错误码文档把 529 列为 overloaded_error，与 429 rate_limit_error 不同。
满的是哪个窗口？
| 窗口 | 何时刷新 | 在哪里看 |
|---|---|---|
| 没有：这是服务端节流，不是用量窗口 | 没有刷新时间；服务端停止节流就恢复 | status.claude.com 看事故；/usage 确认自己的窗口还有余量 |
看到它该怎么办
- 稍等再试
这是文档的第一条建议。v2.1.199 起，你看到这句之前 Claude Code 已经退避重试过了。
- 看 status.claude.com
Error reference 指出持续出现就去看状态页；状态页上的事故能解释连续出现的这类错误。
- 不要换模型，也不要等重置
节流与你的会话或周窗口无关，/model 和等刷新时间都改变不了什么。
- 用 /usage 确认窗口
想确认不是额度问题，/usage 会显示会话与周进度条；真正的限额会显示「You've hit your session limit」。
什么时候重置？
你自己的窗口：这句和你的窗口无关。会话与周限额照常按自己的节奏刷新（每 5 小时、每周固定时刻），这个错误既不消耗也不延长它们。想知道自己的状态，/usage 两条进度条都在。
全员重置：节流也不是官方重置。上方板面记录的是 Anthropic 宣布的重置，每条链接原帖。连续出现这类错误更可能对应 status.claude.com 上的事故，而不是板面会显示的任何事件。
相关报错
- 「You've hit your session limit · resets {time}」Claude Code
- 「API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context」Claude Code
- 「Please run /login · API Error: 401 Invalid authentication credentials」Claude Code
常见问题
这是我的额度用完了吗？
不是。文案本身写着「not your usage limit」，Error reference 也说明 API 做的是与套餐额度无关的短时节流。Claude Code 靠缺少统一额度头把它和真正的限额区分开。
需要等重置吗？
不需要。这个错误背后没有窗口。稍等再试即可；v2.1.199 起，无论哪种登录方式，Claude Code 都会先自动退避重试再显示这句。
为什么它显示「Rate limited」还弄挂了我的子代理？
issue #68502 报告 HTTP 529 overloaded_error 在那个版本上被渲染成这句加「Rate limited」后缀，并让并行会话与子代理直接失败。Platform 错误码文档把 529 列为 overloaded_error，与真正额度用尽返回的 429 rate_limit_error 不同。
怎么和真正的限额区分？
真正的限额会显示写明窗口的文案，例如「You've hit your session limit · resets 3:45pm」，/usage 里有一条进度条到 100%。这句没有窗口也没有刷新时间，status.claude.com 上可能有事故记录。
来源
- Claude Code docs: Error reference — "Server is temporarily limiting requests"核实于 2026-09-18
- anthropics/claude-code issue #68502 (2026-06-15): [Bug] HTTP 529 overloaded_error is rendered as "Rate limited" and hard-fails parallel sessions/subagents核实于 2026-09-17
- Anthropic status page (status.claude.com)核实于 2026-09-18
- Claude Platform docs: API errors (401 authentication_error, 429 rate_limit_error)核实于 2026-09-18