# 遇到 429 怎么办

如果 Codex、Claude Code 或其他客户端显示：

```text
exceeded retry limit, last status: 429 Too Many Requests
```

意思是：客户端尝试了几次，每次都遇到使用限制，于是停止继续尝试。

只看这行英文无法判断具体原因。常见情况包括额度用完、短时间请求太多，以及同时运行的任务太多。

额度用完需要等待刷新、充值或升级套餐；短时间请求太多通常暂停 1 分钟即可恢复。

## 现在先这样处理

1. 暂停当前任务，避免客户端反复尝试。
2. 打开 4AICode 的[用量页面](/usage)，查看套餐额度、24 小时额度和钱包余额。
3. 查看控制台右上角的站内通知。
4. 已绑定 Telegram 的用户，也可以查看 Bot 发来的提醒。

根据页面提示处理：

| 看到的提示 | 怎么处理 |
|---|---|
| 今日额度已用完 | 等待当天额度刷新，或升级套餐 |
| 当前 24 小时额度已用完 | 等待用量页面显示的刷新时间，或升级套餐 |
| 套餐总额度或余额已用完 | 充值、续费或升级套餐 |
| 请求过于频繁 | 暂停 1 分钟，然后减少同时运行的任务 |
| 请求繁忙 | 关闭部分并行任务，等待 10～30 秒后再试 |
| 图像调用频次超限 | 按页面或通知提示的时间等待 |

## 今日额度什么时候恢复

不同套餐的刷新时间不同：

- 月度套餐：每天北京时间上午 8 点刷新。
- 周卡：从购买时间开始，每 24 小时刷新一次。具体时间显示在[用量页面](/usage)。

账户里仍有套餐总额度，也可能遇到当天或当前 24 小时额度用完。每日限制用于控制一天内的使用量。

急需继续使用时，可以在[账单页面](/billing)升级套餐或充值。开启“订阅额度不足时使用钱包余额”后，系统也可以自动改用钱包余额。

## 一分钟内请求太多

短时间启动大量任务时，所有任务会共享组织的使用频率。

处理方法：

1. 暂停 1 分钟。
2. 把同时运行的任务减少到 1～3 个。
3. 减少自动刷新和批量任务的频率。
4. 再次运行任务。

创建更多密钥仍会共享整个组织的限制。

## 同时运行的任务太多

一个任务在生成较长内容时，会持续占用运行位置。同时启动多个 Codex、Claude Code 或批量任务，可能出现“请求繁忙”。

这时请关闭部分任务，等待 10～30 秒，再逐个重新运行。持续反复点击重试会让等待时间更长。

## 还是不知道原因

请勿发送 4AICode 密钥、Telegram Bot 密钥、密码或登录验证码。

联系客服时请提供：

- 错误发生的大概时间
- 当时使用的模型
- 错误文字，或已经遮挡敏感信息的截图
- 页面中显示的错误编号（`trace_id`），如果有

直接提供错误编号即可，无需附带请求内容。