Codex 常见报错怎么处理：capacity、429、503、usage_limit 一次看懂

Fri, 18 Sep 2026 12:40:00 +0800

联系逍遥

扫码添加微信，或点击下方按钮复制联系方式。

同样是“发不出去”，原因可能完全不同。先看完整报错、HTTP 状态和 error.code，再决定怎么处理；不要看到一个 429 就一律等，也不要看到 capacity 就马上换账号。

提示	常见原因	建议
提示/状态	常见原因	先做什么
—	—	—
`Selected model is at capacity`	目标模型当前没有足够容量；常见于模型瞬时拥堵	等几分钟，换一个可用模型，查看状态页。如果所有模型长期失败，再检查账号/工作区并联系支持；不能仅凭这句话断言账号没问题或一定被标记。
`server_is_overloaded`（通常为 `503`）	模型或服务端暂时过载	有 `Retry-After` 就按它等待；没有时逐步拉长间隔，并查看状态页。
`429 Too Many Requests`、`rate_limit_error`	请求太密、并发过高、Token 突然增长，或同一组织的其他程序也在用额度	降低并发，停止重复点击；按 `Retry-After` 等待，没有时用逐渐加长的退避，只重试有限次数。
`429` + `slow_down`	流量增长过快，即使还没达到每分钟上限也可能触发	让请求速率稳定下来，等一段时间后再逐步恢复，不要短时间内把并发重新拉满。
`429` + `credit_balance_exhausted`	API 预付余额耗尽	补充余额；单纯等待不会恢复。
`429` + `project_spend_limit_exceeded` / `organization_spend_limit_exceeded`	项目或组织支出上限	让管理员调整对应限额，或等账期恢复；先确认是哪个项目在发请求。
`429` + `organization_usage_limit_exceeded`	组织用量上限达到	联系组织管理员或 OpenAI 支持申请更高的用量上限。
`usage_limit_reached`	ChatGPT/Codex 计划周期内的使用量达到上限	查看 Codex 用量页面或提示中的 reset 时间，按页面提供的等待、加额度或升级选项处理；支持团队通常不会人工提前重置周期额度。
`server_unavailable`、`503 Service Unavailable`	服务暂时不可用、网络出口异常，或客户端重试已耗尽	先确认状态页、网络和代理，再按退避规则重试；不要无限循环。
`exceeded retry limit`	客户端已经用完本次请求的重试次数	它不是新的根因，回看它前面的最后一个 `429`、`503`、超时或连接错误。

另外，401/403 更像是登录、权限、组织/项目或地区设置问题：官方登录先运行 codex login status，API 则检查 Key、组织和项目；不要先反复换网络。400 往往是参数、模型名或接口格式不对；500 是服务端内部错误，短暂等待并查状态页即可。

一个简单的判断流程

看 HTTP 状态和 error.code，不要只看界面上一行摘要。
401/403 先查登录和权限；429 先区分限流、余额和组织/项目上限。
503、server_is_overloaded 或 capacity 先等、换模型、查状态页；不要因为一次过载就重装客户端。
只有在等待和退避后仍失败，才做网络/代理对照，并尝试新会话。

向支持反馈时记录模型、客户端版本、请求时间和时区、完整错误、HTTP 状态、error.code、请求 ID（如有）、是否换模型/网络后恢复。反馈时删掉 API Key、auth.json、OAuth/access token、代码和代理密钥。官方建议对于限流遵守 Retry-After，并限制重试次数；账单、余额和用量错误不能靠继续重试解决。

官方说明：错误代码｜速率限制｜Codex 用量。

429 on 逍遥笔记

Codex 常见报错怎么处理：capacity、429、503、usage_limit 一次看懂

联系逍遥

一个简单的判断流程