Skip to content

Claude Code 报 429、529 或一直 Retrying 怎么办 ​

一句话答案:429 是“你发得太快或额度到顶”,减少并发;529 是“上游模型忙”,等几分钟或换模型。两种都不是改配置能解决的,别反复重装。

先分清是哪一种 ​

报错意思谁的问题怎么办
429 Too Many Requests / rate_limit_error请求太频繁,或额度达到上限你这边的请求量降低并发,稍后重试;检查余额和密钥额度
529 / overloaded_error上游模型临时过载上游等几分钟,或 /model 换模型
一直显示 RetryingClaude Code 在自动重试上面两种错误看具体状态码按 Esc 停下,按状态码处理
503当前线路暂时没有可用上游服务端稍后重试;持续出现找服务商

遇到 429 的处理步骤 ​

  1. 关掉多余的 Claude Code 窗口,每个会话都在独立发请求。
  2. 少开并行子代理,长任务拆小一点。
  3. 不要多人或多台机器共用同一个密钥,给每个用途单独建密钥。
  4. 看报错里的 message:如果是额度或余额问题,充值或调高密钥额度。
  5. 等一会儿再继续;响应头带 retry-after 时,按它的时间等。

遇到 529 的处理步骤 ​

  1. 按 Esc 停止当前的自动重试。
  2. 等几分钟再继续。
  3. 着急的话,在 Claude Code 里输入 /model 换一个模型先把活干完。
  4. 如果只有某一个模型持续 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 就是配置问题,见 常见错误码对照。

延伸阅读 ​

NiceAI · 稳定的 AI 大模型 API 中转站