Claude Code 报 529 Overloaded、429、500 怎么办

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check your inference gateway (你的服务地址).

529 表示服务端过载，这次请求没有被处理。Claude Code 遇到 529 会自己重试，实测 claude -p 连续 3 次 529 之后停下，用时约 5 秒，显示上面这句。关掉重试时显示的是 API Error: 529 Overloaded. This is a server-side issue, usually temporary…

• 用的是 Anthropic 官方 API：多半是官方那边繁忙。到 status.claude.com 看有没有故障公告，过一会再试。
• 用的是第三方地址：报错最后括号里就是 Claude Code 连的地址，529 是这个地址返回的。可能是服务商满了，也可能是它的上游满了，等一会或者问服务商。
• 不要马上一遍遍重发，过一两分钟再试。

API Error: Request rejected (429) · 服务端给的原因

429 是限流：一段时间里发的请求太多，或者同时在跑的请求太多。点号后面那段是服务端给的原因，各家写的不一样。Claude Code 会先自动重试，实测默认重试 10 次，大约 3 分钟后才显示这句，这段时间看起来就像卡住了。

• 同时开好几个 Claude Code 会话，或者让它开很多子代理并行干活，最容易撞上并发上限。少开几个，或者把任务拆开顺序跑。
• 第三方服务一般按 Key 限并发或限速，看服务商的说明。团队共用一个 Key 的，换成每人一个 Key。
• 官方 API 的限额按组织和用量等级算，在 Console 里能看到。

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check your inference gateway (你的服务地址).

500 是服务端内部出错，和你的配置无关。Claude Code 同样会重试 10 次，实测约 3 分钟后才显示。偶尔一次可以不管；一直出现就去看服务状态，或者联系服务商。

Prompt is too long · the request is ~250000 tokens (limit 200000) …

这句不是服务端故障，是这次请求超过了模型的上下文长度。对话聊太长了，用 /compact 压缩，或者 /clear 重新开始。第一句话就超长的，多半是带的文件太大，或者接的工具太多。

429 和 500 默认要重试 10 次才显示报错。想马上看到报错，设环境变量 CLAUDE_CODE_MAX_RETRIES，设成 0 就是不重试：

CLAUDE_CODE_MAX_RETRIES=0 claude

平时别设成 0。偶尔的网络抖动和短暂过载，都是靠重试扛过去的。

401、403、404 和连不上的报错见《Claude Code 接 API 常见报错》；地址和 Key 的设置见《用 API Key 接入 Claude Code》。