Codex 429 Too Many Requests错误排查指南与解决方法

Codex 报出exceeded retry limit, last status: 429 Too Many Requests是 2026 年开发者社区反馈最集中的问题之一，相关 GitHub Issue（#9135、#9748、#11508 等）累计数百条讨论，r/codex 版块多次出现置顶帖。这条错误本质上只有三种根因：配额耗尽（5 小时窗口或周限制触及上限）、并发子 Agent 意外瞬间压榨配额、以及短暂的服务端限速（配额显示正常但仍 429）。三种情况的处理方式完全不同，混淆后会浪费大量时间。

本文从错误日志的区分、根因的定位，到六种经验证的解法逐步拆解，并附 BYOK 模式下接入自定义 API 端点绕过订阅配额的完整配置方法。

Codex 产生 429 错误的四种形态

Codex 产生 429 相关错误时，日志和 UI 里会出现以下几种形态：

1. exceeded retry limit（最常见）

ERROR: exceeded retry limit, last status: 429 Too Many Requests, request id: 9bd33f31fd269bb1-HNL

输出，意味着 Codex 已内部重试多次（默认指数退避），全部失败后放弃本次请求。

2. API 层直接 429

error=http 429 Too Many Requests: Some("{
  \"error\": {
    \"message\": \"You've exceeded the rate limit, please slow down and try again after 60.616292 seconds.\",
    \"type\": \"invalid_request_error\",
    \"code\": \"rate_limit_exceeded\"
  }
}")

错误响应体里的 message 字段包含等待时间，这是最有用的诊断信息。

3. 配额耗尽提示

ERROR: exceeded retry limit, last status: 429 Too Many Requests
Usage: 5h limit [████████████████████] 100% (resets in 4h 32m)

UI 显示 5 小时窗口已满，这是配额耗尽，而非服务端限速。

4. 配额显示正常但仍 429

5h limit:   [███████████████████░] 96% left (resets 17:16)
Weekly limit: [███████████████████░] 95% left (resets 11:33)

这是最令人困惑的情况——用量显示充裕，却仍然 429。这对应的是服务端短暂限速（见下文根因三）。

三类根因的区分

1. 5 小时窗口或周配额耗尽（最常见）

Codex 的限速体系在 2026 年 4 月 9 日更新后改为按推理时间计费，不再按消息数计。不同套餐每 5 小时窗口内的可用推理时间：

（数据来源：OpenAI 社区帖子 “Understanding the New Codex Limit System After the April 9 Update”，2026 年 4 月 10 日）

关键点：Business 套餐描述为”比 Plus 少 60%”，实际推理时间约为 Plus 的 31%，每分钟消耗速度是 Plus 的 3.2 倍。

在 5 小时窗口之外，还有周限制（Weekly Cap）。多次触发 5 小时窗口可以累计耗尽周配额——有用户报告 Pro 账户周配额在一天内从 67%跌至 45%，背后原因是并发子 Agent（见根因二）。

判断方法：运行 /status 命令，查看 5h limit 和 Weekly limit 的百分比；或访问 chat.openai.com 的用量页面确认实际消耗。

2. 并发子 Agent 瞬间压榨配额

GitHub Issue #9748（2026 年 1 月 23 日，31 条评论）记录了一个极端情况：

同时启动约 6 个并发子 Agent（用于并行代码库探索），整个 Pro 套餐的 5 小时配额立即被清空至 100%。

这与按实际 token 计费的预期完全不符。当时的行为是：每个子 Agent 在启动时以推理时间方式预留配额，而不是根据实际完成量计费，导致 6 个并发 Agent 相当于同时”占坐”了 6 份推理时间配额。

相关问题在 2026 年初陆续报告（#9748、#11508），OpenAI 在此后的更新中对子 Agent 的配额扣减逻辑进行了调整，但激进使用并发子 Agent 仍是触发快速配额耗尽的主要路径之一。

判断方法：在 429 发生前是否有多个子 Agent 并行运行？单次任务是否显式使用了 spawn_agent 或类似工具？

3. 服务端短暂限速（配额充裕但仍 429）

Issue #9135（2026 年 1 月 13 日）描述了另一种模式：

在 5 小时窗口快结束时，Codex 突然开始 429——但用量显示还有约 61%剩余，每次重试等待约 60 秒。持续约 15 分钟，直到 5 小时窗口重置后恢复正常。

多位用户在评论中确认相同现象：配额显示 95%-96%剩余，仍然 429。OpenAI 方面最终回复”已处理底层原因”，但类似情况在此后仍有零散报告。

这类 429 的特点：错误持续时间短（通常 10-30 分钟）、等待时间固定（60-90 秒/次）、配额显示正常、重置窗口后自动恢复。通常是服务端在高峰期主动限速，与用户配额无关。

六种解决办法

1. 等待 5 小时窗口重置（配额耗尽时）

最直接的方案。/status 输出会显示窗口重置时间：

# 在 Codex 内运行
/status

输出样例：

5h limit:   [████████████████████] 100% (resets in 4h 32m)
Weekly limit: [████████████████░░░░] 78% left (resets Thu 08:00)

如果周配额也已接近耗尽，则需要等到周重置时间（通常为账户注册时间的周滚动窗口）。

2. 降低推理级别（减少每次请求消耗）

推理级别直接影响每次请求消耗的推理时间。在 ~/.codex/config.toml 里设置：

model = "gpt-5.4-codex"
reasoning_effort = "low"   # 可选值: low / medium / high / xhigh

可选值：low / medium / high / xhigh。从 xhigh 降到 medium 在大多数日常编码任务中质量差异有限，但配额消耗可降低约 60-70%。

或者在单次调用时临时覆盖：

codex --reasoning-effort low "重构这个函数"

3. 限制并发子 Agent 数量

如果任务设计里有多个并发子 Agent，将并发数限制在 2-3 个以下，或改用顺序执行：

# 不推荐（触发大量并发）
"并行分析这 10 个模块，每个模块一个子 Agent"

# 推荐（顺序处理）
"逐一分析这 10 个模块，每次只处理一个，完成后再进行下一个"

如果必须并发，在任务描述里明确限制：

"使用最多 2 个并发子 Agent 完成以下任务..."

4. 等待服务端限速自动恢复（配额显示充裕时）

如果 /status 显示配额充裕但仍然 429，通常不需要任何操作，等待 10-30 分钟即可：

# 确认是服务端限速，不是配额问题
/status
# → 5h limit 和 Weekly limit 均显示 >50% 剩余
# → 则等待，不要反复重试（重试会加剧限速）

反复重试在服务端限速期间适得其反——Codex 内部已有指数退避逻辑，额外手动重试只会让服务端更快触发更长时间的限速。

5. BYOK 模式接入自定义 API 端点

Codex 支持”Bring Your Own Key”模式，绕过 OpenAI 订阅配额，直接使用其他 API 端点。配置方式：

# ~/.codex/config.toml（BYOK 模式，具体字段名以官方文档为准）
model = "deepseek/deepseek-v4-pro"
provider = "custom"

[providers.custom]
name = "自定义提供方"
base_url = "https://api.your-provider.com/v1"
api_key_env_var = "CUSTOM_API_KEY"

启动时传入 API Key：

export CUSTOM_API_KEY=sk-your-key
codex

对于需要同时使用多个国产大模型（DeepSeek、Kimi、GLM、MiniMax 等）作为备选的团队，七牛云 Token Plan（qiniu.com/ai/plan）提供 4 家厂商 25 个模型的统一订阅接入，一个 API Key 覆盖多个模型端点，在 Codex 频繁遭遇 OpenAI 订阅限速时可作为直接可用的备选提供方。

6. 拆分长任务，避免单次长会话

Codex 的用量按会话内实际推理时间累积。一个运行 4 小时的单次会话和 4 个各运行 1 小时的独立会话消耗相同的配额，但后者每次任务结束后可以根据剩余配额决定是否继续，而不是在单次会话里耗尽后才发现。

实操建议：

# 长任务前先检查配额
/status

# 将大任务拆分为阶段性检查点
"完成第一步后停下来，等我确认结果再继续"

自查流程：发生 429 后 30 秒定位根因

1. 运行 /status
   ├─ 5h limit 100% → 等待窗口重置（根因一）
   ├─ Weekly limit 100% → 等待周重置（根因一）
   ├─ 两者均充裕（>50%）→ 继续步骤 2
   └─ 接近耗尽（<10%）→ 等待或降低 reasoning_effort 
2. 回顾刚才的操作
 ├─ 刚启动了多个并发子 Agent → 等待+限制并发数（根因二）
 └─ 单个任务常规使用 → 服务端短暂限速（根因三），等 10-30 分钟 
3. 看错误消息里的 retry-after 时间
 ├─ retry-after 60-90 秒，持续出现 → 根因三，等待即可
 └─ retry-after >1 小时 → 配额问题，检查用量面板

常见问题

429 错误会自动重试吗，还是需要手动重新运行？

Codex 内置了指数退避重试逻辑，每次 429 后会自动等待再重试，直到超过最大重试次数后才报”exceeded retry limit”。也就是说，你看到的”exceeded retry limit”已经是多次重试全部失败的结果，手动立即重试通常无效——应先等待至少retry-after指定的时间（通常 60 秒），或直接等待限速周期结束。

Pro 用户也会碰到 429 吗？

会。Pro 套餐的 5 小时窗口更大（约 400 分钟推理时间，为 Plus 的 10 倍），但高强度使用（特别是 xhigh 推理级别的长时间任务，或并发子 Agent）同样可以在短时间内耗尽。Issue #11508 记录的就是 Pro 用户在约 1.5 小时内耗尽全部 5 小时窗口配额的案例。

配额显示还有剩余为什么还会 429？

这是根因三：服务端在高负载时对所有用户触发短暂限速，与个人配额无关。OpenAI 的限速系统分为两层：用户级别的配额（5h 窗口/周限制）和服务端全局的 QPM/RPM 限制。后者在高峰期可能临时限制配额仍充裕的用户。这类情况通常在 10-30 分钟内自动解除。

更换模型（比如用 GPT-5.3 代替 GPT-5.4）能缓解 429 吗？

一定程度上有效。GPT-5.3 在 Plus 套餐下的推理时间是 GPT-5.4 的 1.5 倍（60 分钟 vs 40 分钟），意味着相同任务消耗更少配额比例。但注意：GPT-5.3 的每次推理如果更慢，绝对时间未必减少，只是”配额消耗率”降低。对于简单任务可以尝试；复杂推理任务降级模型可能需要更多轮次完成，最终消耗反而相近。

总结

Codex 的 429 Too Many Requests 对应三种完全不同的情况：配额耗尽需要等待重置，并发子 Agent 压榨配额需要限制并发数，服务端短暂限速只需等待 10-30 分钟。三种情况处理方式不同，关键诊断工具是 /status 命令和错误消息里的 retry-after 值。长期解法是降低 reasoning_effort、拆分长任务、在订阅配额不足时接入 BYOK 自定义 API 端点。2026 年 4 月 9 日的计费模式更新将配额体系从消息数改为推理时间，这是当前大量 429 报告的直接背景——理解这一机制才能准确预测配额消耗，而不是在任务进行中遭遇意外中断。

以上关于Codex 429 Too Many Requests错误排查指南与解决方法的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。