「API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.」
作者 vortwang更新于
「API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.」按 Error reference 的解释,是你撞到了 API key、Amazon Bedrock 项目或 Google Cloud 项目上配置的速率限制。它不是 claude.ai 订阅的 5 小时会话或周限额,所以文案里没有刷新时间,也没有全员重置可等;下方板面行是给订阅用户看的。
- 上次重置
- 09-04 20:08Z
- 状态
- 已超期
距上次重置已超过近期中位间隔的 1.5 倍。
- 预计下次
- 随时
- 距今天数
- 14.5
天
「API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.」是什么意思?
Error reference 把这条归到与订阅限额不同的原因:你 API key、Amazon Bedrock 项目或 Google Cloud 项目的速率限制。末尾那句话指向哪里看服务状态,因厂商而异:Bedrock、Google Cloud 的 Agent Platform 与 Microsoft Foundry 各写自己的状态页,自定义 ANTHROPIC_BASE_URL 则写网关主机名。
有两条看起来相似的邻居。「API Error: Server is temporarily limiting requests (not your usage limit)」是短暂的服务端限流,Claude Code 会自动退避重试。「You've hit your session limit · resets {time}」是订阅窗口,带刷新时间。429 这条既没有刷新时间也没有 /usage-credits 链接,可以据此区分。
常见的坑是明明在 Pro 或 Max 计划上还看到它:环境里残留的 ANTHROPIC_API_KEY 会把请求路由到一个低层级的 key,而不是你的订阅。/status 显示当前生效的凭证。
满的是哪个窗口?
| 窗口 | 何时刷新 | 在哪里看 |
|---|---|---|
| API key / 云项目速率限制 | 厂商控制台里按分钟、按天设定的层级;没有会话或周刷新时钟 | /status 显示生效凭证;Claude Console 或云控制台显示限制 |
| 订阅的会话与周限额 | 与此无关:这条文案不来自 claude.ai 订阅窗口 | /usage(只有 claude.ai 登录是生效凭证时才有意义) |
看到它该怎么办
- 运行 /status
确认生效的凭证是你想用的那个。想用 Pro 或 Max 订阅的话,在 shell 里取消 ANTHROPIC_API_KEY、从 shell 配置文件里删掉、重启 claude,必要时 /login。
- 看状态页
在 Anthropic API 上文案指向 status.claude.com;Bedrock、Google Cloud 与 Foundry 配置会改写各自的状态页。
- 看厂商控制台
Anthropic API key 的速率限制参考解释了层级怎么算、怎么设按 workspace 的上限;经常撞到就申请更高层级。
- 降低并发
调低 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY,避免同时跑很多 subagent,或在大批量脚本运行里用 /model 换更小的模型。
什么时候重置?
没有会话或周刷新可等。API 速率限制是你 key 或云项目上按分钟、按天的层级,所以文案不带刷新时间;如果只是暂时的容量问题,文档建议稍等再试。
本站板面上的全员重置针对 claude.ai 订阅窗口。如果 /status 显示生效凭证是 API key,这些重置与你无关;付的是订阅的话先切回订阅登录。
相关报错
常见问题
我是 Max 用户,为什么 429 没有刷新时间?
多半是残留的 ANTHROPIC_API_KEY 把请求路由到了 API key 而不是订阅。文档说运行 /status 看 API key 那一行,取消该变量、从 shell 配置文件删掉、重启 claude 并 /login。
这和「Server is temporarily limiting requests」一样吗?
不一样。那条是与任何配额无关的短暂服务端限流,会自动重试。「Request rejected (429)」是你 API key 或云项目上配置的速率限制;解法是更高层级、更低并发,或换对凭证。
板上的全员重置有帮助吗?
没有。板上的重置刷新的是 claude.ai 订阅窗口。API key 与云厂商的用量按请求计入你的层级,交互模式文档写明这类凭证没有可等的重置。
为什么文案里写的是别的状态页?
末尾那句话因厂商而异:Amazon Bedrock、Google Cloud 的 Agent Platform 与 Microsoft Foundry 配置会写该厂商的服务状态而不是 status.claude.com,自定义 ANTHROPIC_BASE_URL 会写网关主机名。
来源
- Claude Code docs: Error reference — "Request rejected (429)"核实于 2026-09-18
- Claude Platform docs: API errors (401 authentication_error, 429 rate_limit_error)核实于 2026-09-18
- Claude Platform docs: Rate limits (tiers, per-workspace caps)核实于 2026-09-18
- Claude Code docs: Error reference — "Server is temporarily limiting requests"核实于 2026-09-18
- Claude Help Center: Use Claude Code with your Pro or Max plan (/status, /login, shared limits)核实于 2026-09-17
- Anthropic status page (status.claude.com)核实于 2026-09-18