外观
Claude Code 报 429、529 或一直 Retrying 怎么办
一句话答案:429 是“你发得太快或额度到顶”,减少并发;529 是“上游模型忙”,等几分钟或换模型。两种都不是改配置能解决的,别反复重装。
先分清是哪一种
| 报错 | 意思 | 谁的问题 | 怎么办 |
|---|---|---|---|
429 Too Many Requests / rate_limit_error | 请求太频繁,或额度达到上限 | 你这边的请求量 | 降低并发,稍后重试;检查余额和密钥额度 |
529 / overloaded_error | 上游模型临时过载 | 上游 | 等几分钟,或 /model 换模型 |
| 一直显示 Retrying | Claude Code 在自动重试上面两种错误 | 看具体状态码 | 按 Esc 停下,按状态码处理 |
503 | 当前线路暂时没有可用上游 | 服务端 | 稍后重试;持续出现找服务商 |
遇到 429 的处理步骤
- 关掉多余的 Claude Code 窗口,每个会话都在独立发请求。
- 少开并行子代理,长任务拆小一点。
- 不要多人或多台机器共用同一个密钥,给每个用途单独建密钥。
- 看报错里的
message:如果是额度或余额问题,充值或调高密钥额度。 - 等一会儿再继续;响应头带
retry-after时,按它的时间等。
遇到 529 的处理步骤
- 按 Esc 停止当前的自动重试。
- 等几分钟再继续。
- 着急的话,在 Claude Code 里输入
/model换一个模型先把活干完。 - 如果只有某一个模型持续 529、其他模型正常,记下时间和模型名反馈给服务商。
不建议的做法
- 把重试次数和超时调得很大:上游忙的时候只会排更久的队。
- 一出错就重装 Claude Code 或换密钥:429、529 和安装、密钥都无关。
- 同时开很多会话“抢”请求:会让 429 更频繁。
怎么确认不是配置问题
用 curl 直接发一条最小请求(以 NiceAI 为例,地址不带 /v1,路径是 /v1/messages):
bash
curl -sS -w '\n%{http_code}\n' https://api.niceai.dev/v1/messages \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"<模型名,见模型广场>","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'返回 200 说明配置没问题,刚才只是临时限流或过载;返回 401、404 就是配置问题,见 常见错误码对照。