Source: https://wiki.niceai.dev/guide/tech/claude-code-429-529

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

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

## 先分清是哪一种

| 报错 | 意思 | 谁的问题 | 怎么办 |
| --- | --- | --- | --- |
| `429 Too Many Requests` / `rate_limit_error` | 请求太频繁，或额度达到上限 | 你这边的请求量 | 降低并发，稍后重试；检查余额和密钥额度 |
| `529` / `overloaded_error` | 上游模型临时过载 | 上游 | 等几分钟，或 `/model` 换模型 |
| 一直显示 Retrying | Claude 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 就是配置问题，见 [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)。

## 延伸阅读

- [限流、超时与重试](https://wiki.niceai.dev/guide/api/rate-limits)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
- [大模型 API 调用失败怎么排查](https://wiki.niceai.dev/guide/tech/troubleshooting-checklist)
