Codex 报「exceeded retry limit, last status: 429 Too Many Requests」：原因与解决

这条报错是什么意思

这行报错里的状态码和 request id 都来自 Codex 收到的最后一个 HTTP 响应。按 openai/codex 源码（rust-v0.163.0，2026-10-17 核对），exceeded retry limit 是 Codex「重试上限」这个错误的固定文字；last status 后面是那个响应的 HTTP 状态，打印成 429 Too Many Requests；响应带 x-request-id 头时，后面再接 , request id: …，没有这个头就依次改读 x-oai-request-id、cf-ray。在 Codex 的终端界面里，这一行显示为红色，开头是 ■。别被字面意思误导：Codex 不一定真的重试过，不带 Retry-After 的 429 在第一次响应时就会得到同一句话。凡是不属于下表前四类（用量上限、套餐不含 Codex、配额、flex）的 429，Codex 都用这句话报告；看到它时，Codex 已经不会再重试了。

Codex 怎样重试 429

按 openai/codex 源码（rust-v0.163.0，2026-10-17 核对），Codex 有两层重试，429 只会走到第二层：

• HTTP 层最多重试 request_max_retries 次（默认 4 次），只管 5xx 响应和网络传输错误；它的重试策略不含 429，所以 429 直接交给采样循环。
• 采样循环（sampling loop，Codex 包在每次模型请求外面的那层循环）只在响应带 Retry-After 头（秒数或 HTTP 日期）时重试 429：Codex 等到那个时间再重发，最多 stream_max_retries 次（默认 5 次），等待期间显示 Reconnecting... 1/5、2/5 等进度。
• 内置的 OpenAI provider 走 WebSocket 传输：Codex 不显示第一行 Reconnecting...，这些重试用完后会回退到 HTTPS 并重新计数，同一个 429 的重试次数因此大约翻倍。自定义 provider 不设 supports_websockets 就不走 WebSocket，所以对下面的 Router One 配置来说，stream_max_retries 就是全部的重试次数。
• 不带 Retry-After 的 429 会立刻结束这一轮：不会出现 Reconnecting... 行，直接打印这句报错。
• 这两项都按自定义 provider 设置，写在 [model_providers.<id>] 下，取值上限都是 100，写得更大也按 100 算。调大 stream_max_retries 只会给带 Retry-After 的 429 增加重试次数。
• OpenAI 的 Codex 配置参考（2026-10-17 核对）写的默认值相同：request_max_retries 为 4，stream_max_retries 为 5。

哪些 429 会变成这句报错

Codex 先读 429 响应 JSON 里的 error 对象，再决定打印哪句话。按 openai/codex 源码（rust-v0.163.0，2026-10-17 核对）：

经 Router One 时：这个 429 是谁的

不管 429 是谁返回的，Codex 都打印同一句话，所以先按报错时间看控制台 → 日志。日志里有记录的 429，是网关重试之后上游仍返回的。网关对这把 Key、这个账户或账户在单个模型上的限额会在调用任何模型之前拒绝请求：这类 429 在控制台 → 日志里没有记录，只要流量不变，就按同一频率反复出现。流式请求在输出任何内容之前就遇到上游限流时也可能没有记录，所以没有记录、但突发出现又会自行消散的 429，同样指向上游。接下来：

• 日志里有记录：模型上游的限额在网关重试之后仍未解除。稍后重发，同一个模型上少开几个并行的 Codex 会话，或者把 model 行换成 /models 里列出、且模型页列有 POST /v1/responses 的其他模型。
• 没有记录、每次频率都一样：是网关对 Key 或账户的限额。把任务错开，把流量大的任务分到单独的一把 Key 上，或者申请调高限额（见下一节）。
• 没有记录、突发出现又自行消散：按上游限流处理，稍后重发。
• 留好 Codex 打印的 request id，写邮件给 support@router.one 时附上。

申请调高网关限额

Router One 对每把 Key 和每个账户的请求数与 token 数限额是平台默认值，不能在控制台里自己改：需要更高吞吐时，发邮件到 support@router.one，写明账户 ID、Key 以及预计峰值的每分钟请求数与 token 数，申请调高；网关限额之上仍受上游容量约束。再开一把 Key，可以让流量大的任务不再挤占原来那把 Key 的限额，但同一账户的 Key 仍共享账户级限额。

用一键命令把 Codex 接到 Router One

带上你的 Router One Key 运行一键命令。它会在缺少 Codex CLI 时先安装，备份已有的 config.toml，写入下一节那份配置（provider 为 router，env_key = ROUTER_ONE_API_KEY），把 Key 写进 shell 配置文件，再发一个测试请求验证连通。Windows 用 PowerShell 那一行。

curl -fsSL https://router.one/install/codex.sh | bash -s -- sk-your-api-key
# Windows PowerShell：
$env:ROUTER_ONE_API_KEY = "sk-your-api-key"; irm https://router.one/install/codex.ps1 | iex

一键命令写入的 config.toml

request_max_retries 和 stream_max_retries 如果要改，也写在 [model_providers.router] 这个块里；一键配置不设置这两项，保持 Codex 的默认值。顶层的 model = "gpt-5.6-sol" 和 model_provider = "router" 两行写在第一个表头之前，块里保留 wire_api = "responses" 和 env_key = "ROUTER_ONE_API_KEY"。下面就是一键安装写入的完整文件：

model = "gpt-5.6-sol"
model_provider = "router"
model_reasoning_effort = "high"
model_verbosity = "high"
web_search = "live"

[model_providers.router]
base_url = "https://api.router.one/v1"
env_key = "ROUTER_ONE_API_KEY"
env_key_instructions = "Create an API key at https://router.one/dashboard/api-keys and set the ROUTER_ONE_API_KEY environment variable."
name = "Router One"
wire_api = "responses"

另一种报错：ChatGPT 登录的用量上限

用 ChatGPT 登录时，Codex 报告套餐上限用的是另外几种提示。按 openai/codex 源码（rust-v0.163.0，2026-10-17 核对），用量上限打印的是以 You’ve hit your usage limit 开头的提示，或者以其他说法写明用量上限、工作区额度或消费上限的提示，Codex 不会重试；ChatGPT 登录用不了的模型会收到另一种回复，见「model is not supported」报错页（https://router.one/zh/codex-model-not-supported）。把 Router One 配成 model provider 的 Codex 会话，请求用你的 Router One Key 发往 https://api.router.one/v1，不经过 ChatGPT 登录；完整配置见 Codex CLI 国内接入（https://router.one/zh/codex-china）。

常见问题