Codex exceeded retry limit 429、401 与 Stream Disconnected 排查
Codex 报 exceeded retry limit, last status: 429 时,这不是套餐用完的提示;先查并行会话、中转和状态页,再决定等待还是停。
文章目录

Codex 里冒出这样一行,任务随即停下:
■ exceeded retry limit, last status: 429 Too Many Requests, request id: …字面意思是"超过重试上限,最后一次状态:429 请求过多"。但在当前的 Codex 客户端里(截至 2026 年 10 月 15 日的 openai/codex 源码和 rust-v0.162.1 版本),它的含义要窄得多:服务器或中间的代理返回了 429,而 Codex 没能从响应里认出"套餐用量用完""套餐不含 Codex""API 余额或支出上限"这几种原因。真正用完套餐时,Codex 显示的是 You’ve hit your usage limit…,通常附带恢复时间;API 余额或支出上限显示的是 Quota exceeded. Check your plan and billing details.。
所以看到这条裸报错,先别急着买额度、删登录文件或改重试配置。按三件事分流:
- 报错前面有没有前缀,例如
Error running remote compact task:或Automatic approval review failed:。前缀说明失败的是哪一个请求。 - Codex 走的是 ChatGPT 登录、API key,还是 CC Switch、CLIProxyAPI 这类中转或代理。
- 出错时是不是同时开着几个会话或子代理,OpenAI 状态页上当时有没有 Codex 事件。
401 Unauthorized 和 stream disconnected before completion 常与 429 出现在同一段时间,但含义不同,后面各有一节。
exceeded retry limit 429 是什么意思:不是套餐用完的提示
Codex 收到 HTTP 429 后,会先读响应体里的 error.type 和 error.code,再决定显示哪一句。当前源码里的对应关系如下(openai/codex 的 api_bridge.rs 中 429 分支,提示文字定义在 protocol/src/error.rs):
| 你看到的报错 | Codex 认出的原因 | 实际含义 | 下一步 |
|---|---|---|---|
You’ve hit your usage limit…,可能带 Try again at …、升级或购买 credits 的链接 | usage_limit_reached | ChatGPT 套餐的 Codex 用量用完 | 等到提示的时间,或按提示购买 credits |
To use Codex with your ChatGPT plan, upgrade to Plus… | usage_not_included | 当前套餐不含 Codex | 升级套餐,或改用 API key 登录 |
Quota exceeded. Check your plan and billing details. | insufficient_quota、credit_balance_exhausted、组织或项目支出上限、organization_usage_limit_exceeded | API 余额、支出上限或组织用量上限 | 去 OpenAI Platform 查账单,重试不会恢复 |
exceeded retry limit, last status: 429 Too Many Requests | 以上都不是 | 临时限流、并发过多、服务端异常,或中转把别的错误包装成了 429 | 按下文的四种情况判断 |
这张表能说明的是 Codex 怎么归类,不是服务器内部的真实原因。读它时有两个限制:
- 裸 429 不证明你的额度还有剩余,只说明这次响应里没有"套餐用完"的标记。中转或代理可以把上游任何错误包成自己的 429,这时 Codex 读到的已经是代理的说法。
- 旧版本客户端的判断可能不同,以后的版本也可能再改。用的是很旧的 Codex 时,先升级再判断。
套餐用完的那一支,查剩余额度和重置时间分别见 ChatGPT Pro Codex 额度怎么查、ChatGPT Plus 的 Codex 额度:5 小时估算、周限制与 credits,以及 Codex 每周限额什么时候重置。
先做三项只读检查
在改动任何东西之前,先花一两分钟留下这三样证据。它们决定你属于哪一支,也是之后提交报告要用的材料。
第一,抄下完整报错,包括行首的前缀、末尾的 request id,以及失败时间和时区。CLI 用户顺手记下版本:
codex --version
codex login status第二条只确认当前的登录方式。不要把输出里的账户标识、token 或 key 贴进公开 issue。
第二,确认请求实际发到哪里:是 ChatGPT 登录、API key,还是配置了自定义 provider 或 base_url。只看当前生效的 model_provider、openai_base_url 或 model_providers.<id>,不要粘贴含凭据的完整配置。
第三,看当时的负载和用量:
- 在 CLI 会话里运行
/status,它显示对话 ID、上下文用量和速率限制;ChatGPT 登录时/usage会打开用量与账单设置(Codex 斜杠命令文档)。 - 数一下出错时同时在跑的会话、桌面 App 里的对话和子代理。
- 打开 OpenAI 状态页的历史事件,看失败时间附近有没有 Codex 相关事件。
如果失败发生在启动或发送之前、报的是 401,先看登录路线;收到明确 429,看上表;输出了一部分才断开,按流中断处理。
先确认是哪条账户与 provider 路线
同一个 Codex 界面背后,可能是完全不同的计费方式、凭据和限流规则。看错了账户或控制台,"还有额度"也说明不了任何事。
| 当前路线 | 应查看的证据 | 常见误判 |
|---|---|---|
| ChatGPT 登录的 Codex | codex login status、/status、同账户的新会话能否复现 | 拿 Platform API 余额解释套餐用量 |
| OpenAI API key | API 错误响应内容、组织与项目、账单和速率限制、响应头 | 拿 ChatGPT Plus/Pro 的状态证明 API 一定可用 |
| 自定义 provider 或网关 | 生效的 provider 与 base_url、网关日志、上游 request ID、该服务的账户状态 | 默认所有 401、429 都是 OpenAI 返回的 |
| 中转、代理、号池工具(CC Switch、CLIProxyAPI 等) | 代理自己的日志或管理页、代理版本、代理里的账户状态 | 以为 Codex 看到的 429 就是 OpenAI 的 429 |
API key 登录的 Codex 按 API 价格计费,不受 ChatGPT 套餐的 5 小时和周限制约束(Codex 定价与用量说明)。反过来,套餐页面上的剩余用量也解释不了 API key 路线的 429。
Codex 429 怎么解决:先看是谁返回的,再决定是否等待
裸 429 的常见来源可以分成四种。按你在三项检查里看到的证据对号入座,一次只验证一个假设。
同时开了多个会话或子代理
2026 年 8 月下旬以来,GitHub 上反复有 ChatGPT 登录的 Pro、Plus 用户报告:单个会话一切正常,同时跑几个会话,或一个会话里派出几个子代理,就开始批量报这条 429,而用量表显示还剩不少。
- openai/codex issue #41702(Pro,仍开放):跨会话同时跑四五个子代理就触发,影响整个账户。
- issue #42685(已作为重复关闭):同时超过两三个流就失败,子代理也算在内,约从 8 月 29 日开始。报告者转述,OpenAI 支持回复称子代理请求计入速率限制,且没有公开的按套餐并发上限。
- 2026 年 10 月 14 日又集中出现一批:#54017 在桌面 App 开第三个对话时失败,周用量表显示 57%;#54010 在 WSL 上开三个会话,剩余 69%;#53978 剩余约 70%。截至 10 月 15 日没有维护者回复。
这些是用户报告。OpenAI 没有确认存在并发上限,更没有公布具体数字,所以不要把"两个""三个"当成规则。可以做的对照测试是:
- 关掉其他会话,只留一个,发一个短请求。
- 单流成功、一并行就失败时,减少同时运行的子代理。在
config.toml里调低agents.max_concurrent_threads_per_session,它限制一个会话里同时打开的子代理线程数,不含主线程(Codex 配置参考)。 - 记下"几个流时开始失败",放进之后的报告。
调低这个值只是客户端自己的上限,不保证上游有对应的容量;它是隔离原因的办法,不是官方修复。
状态页有 Codex 事件,或单个会话也失败
只开一个会话、发短请求也报 429 时,服务端问题的可能性更大。OpenAI 状态页 2026 年 10 月 13 日记录了"GPT-6.1 Sol Codex and Work mode"性能下降,10 月 14 日记录了"Codex and ChatGPT Work"性能下降,两次都已恢复;10 月 6 日有多起涉及 Codex 的错误率升高事件。这些事件的说明里都没有提到 429,所以它和 10 月 14 日那批报告只是时间吻合,不能当作已确认的原因。
同一句报错过去也出现过服务端原因:2026 年 1 月,OpenAI 维护者关闭 issue #9135 时说底层问题已处理,之后再出现类似情况属于新问题,需要用 /feedback 附日志重新报告;6 月 3 日也出现过一批相同报错的 issue,两天内关闭。
这种情况的动作是等事件结束,再用一个短请求验证。没有官方给出的恢复时间,不要按固定分钟数反复重跑大任务。
经中转、代理或 CC Switch 使用 Codex
中间多了一层,429 就可能是代理自己的。两个公开案例:CLIProxyAPI 的一个 issue(2026 年 7 月 15 日)里,上游 OpenAI/Cloudflare 返回的是 520,代理管理页却记成了 429;CC Switch 的一个 issue(2026 年 6 月 28 日)里,反复出现的 429 背后是 tool_call_id 转换导致的 400 错误。
所以先看代理自己的日志或管理页,找到同一时间上游真正返回的状态码,再决定是升级代理、修正转换配置,还是处理上游账户。换网络节点有时能避开某个出口的问题,但它解释不了根因,也不适用于直连 OpenAI 的用户。自定义 provider 和 Base URL 怎么配,见 Codex 自定义 API 配置:Key、Base URL 与 Provider 怎么选。
用 API key 登录 Codex
API key 路线的余额和支出上限类 429,在当前客户端会显示 Quota exceeded…。剩下的裸 429 多半与 Platform 的速率限制有关:看响应头里的限流信息,降低并发,再做有限次数的重试。API 429 的几种类型和处理方式见 OpenAI API 429 错误怎么解决:限流、余额与支出上限排查。
什么时候不必再重试
同时满足这三条,继续点重试就没有意义了:只开一个会话、发短请求仍然失败;状态页没有正在进行的 Codex 事件;不经过中转,或代理日志显示上游确实返回了 429。这时运行 /feedback 提交报告并附上日志,按最后一节整理证据。
带前缀的 429 变体:remote compact、自动审批与 account warmup
报错前面的前缀说明是哪个请求被拒,处理方式也随之不同。
| 报错原文 | 失败的是什么 | 怎么处理 |
|---|---|---|
Error running remote compact task: exceeded retry limit, last status: 429 Too Many Requests | 旧版 Codex 的服务端上下文压缩 | 升级客户端。OpenAI 维护者 2026 年 6 月 29 日在 issue #15468 中说,压缩已改为在本地用普通对话的同一接口完成,"remote compaction" 错误因此消失;之后仍有压缩问题就用 /feedback 新开报告 |
Automatic approval review failed: exceeded retry limit, last status: 429 Too Many Requests 加上 The action was not executed… | 自动审批审查(codex-auto-review)这个请求被 429,不是主对话 | 这次操作没有执行,需要重新发起。issue #53324 报告普通用量仍可用时也会出现,仍开放,没有官方解决方法 |
Codex account warmup failed. Reauthenticate the account and try again. (http_status:429) | 第三方号池代理(如 opencodex 一类项目)里的账户预热 | 这句话不在 openai/codex 里,是代理输出的。在代理里重新认证该账户、查看代理日志 |
自动审批那一行,如果想确认是不是审查请求单独被限流,可以临时关闭自动审批做一次对照。关闭后,哪些操作需要你确认会跟着改变,测完恢复原设置;它不是修复办法。
如果看到的是 Selected model is at capacity. Please try a different model.,那不是 429:这是服务器报告模型过载时 Codex 给出的提示,会话日志里记为 server_overloaded,排查见Codex Selected model is at capacity 怎么解决:不是额度用完。
401:先证明谁拒绝了哪种凭据
401 表示某一条路线拒绝了认证,原因要看错误响应内容和当前路线。OpenAI Platform API 的错误文档把 401 分成无效认证、错误的 API key、缺少组织成员资格、IP 白名单不匹配等几种(OpenAI API 错误码文档),所以不是一律"重新登录"。
ChatGPT 登录路线
先看 codex login status 是否和预期的账户、登录方式一致。账户明显不对或登录已失效,才走官方登录流程重新认证。codex logout 会清除本地保存的凭据,属于改变状态的操作;在没记下当前方式、没确认有无受管身份或工作区约束之前,不要把它当第一步(Codex 认证文档)。
重新认证成功的标准,不是登录页打开了,而是原账户、原 provider 上的一个短请求能完成。只有换账户才成功,说明绕开了原路线,原问题并没有修好。
API key 路线
核对实际进程用的 key 属于哪个组织和项目,不要在 shell history 或 issue 里打印 key。错误明确是 invalid_api_key、组织成员资格或 IP 白名单时,修正对应条件后再发一次短请求。稳定的 401 不该退避重试,凭据和权限没变,重发不会成功。看到 Incorrect API key provided 时,具体查法见 Codex 报 401 Incorrect API key provided:先看 URL 和 key 文本。
自定义 provider 路线
401 可能是网关自己返回的,也可能是网关转发了上游的拒绝。用网关的 request ID 对齐同一时刻的日志,确认失败发生在客户端到网关、网关认证,还是最终的模型服务。不要拿一个 provider 的 key 去测另一个 base_url。
Stream disconnected:先判断响应走到哪一步
stream disconnected before completion 只说明响应流没有完整结束,可能发生在客户端、代理或 TLS 检查、公司网络、网关、上游服务,也可能是电脑睡眠或切换网络打断了长连接。错误文字本身不能告诉你是哪一处。
做一次小范围对照就够了:
- 用同一账户、同一 provider、同一个短请求新建会话;
- 记录是完全没有输出、输出一部分后中断,还是返回了明确的 HTTP 状态;
- 组织策略允许的话,在不上传敏感内容的前提下,换一条可信网络做同样的测试;
- 把失败时间和 provider 或网关日志对齐;
- 只在某个客户端或版本上复现时,记下版本差异,然后停止反复换变量。

换一条网络就成功,只说明网络路径值得继续查,不说明必须关掉 VPN、防火墙或证书检查;受管设备上的安全策略不应为了排障而绕过。两条网络在同一时刻、同一 provider 上都失败,更该去看上游状态、账户和 request ID。
输出到一半才断开时,先看能否安全续接,或者把任务拆小再发;不要直接调大 stream_idle_timeout_ms(默认 300000 毫秒)。timeout 只改变客户端等多久,修不好稳定的 401、错误的 base_url、耗尽的余额,也修不好被网关主动关闭的连接。
为什么提高重试次数通常不是第一步:429 不在自动重试范围
如果你打算"改一行配置、把重试次数调大",先看这一行改的是什么:request_max_retries 和 stream_max_retries 对不带 Retry-After 的 429 不起作用;服务器带了 Retry-After 时,stream_max_retries 才决定 Codex 再试几次。ChatGPT 登录用户遇到的裸 429,调大这两个数字没有用。
在当前的 Codex 源码里,向模型 provider 发 HTTP 请求的重试设置是 retry_429: false、retry_5xx: true、retry_transport: true(model-provider-info 源码)。也就是说,在发请求这一层,5xx 和网络错误会自动重试,429 不会。request_max_retries 默认 4、stream_max_retries 默认 5、上限都是 100,调大它们会让 5xx 和断流多试几次;对 429,只有服务器给了 Retry-After 时 stream_max_retries 才起作用。
到了对话这一层,这条裸 429 只有在服务器给了 Retry-After 时,Codex 才会按这个时间等待后重试整轮,次数等于 stream_max_retries(默认 5 次,连同第一次共 6 次请求);没有 Retry-After 就直接结束。issue #42685 的报告者在 CLI 日志里没有找到 Retry-After 或 x-ratelimit 响应头。所以报错里的"retry"不保证 Codex 真的试了好几次。有人在 issue #30471 里请 OpenAI 让 Codex 重试 429 或改清楚这句提示,截至 2026 年 10 月 15 日没有维护者回复。
调大重试次数还有副作用:让一个注定失败的任务拖得更久,在多层网关里放大请求量,把第一条有用的错误埋进更多重试日志里。只有在确认是短暂的传输失败、上游允许重试、并且有明确的总时间上限时,才值得调整;改完仍用一个短请求验证,原错误照旧出现就恢复默认值。自己调用 API 时重试和换备用模型怎么取舍,见 大模型 API 该重试还是切备用模型?先过这五道门。
实测 Codex 429 重试:不带 Retry-After 只发 1 次请求
实际运行了什么:2026 年 10 月 15 日,在 ChatGPT 桌面 App 自带的 Codex CLI 0.162.0-alpha.17.2 上,用一个单独的临时 CODEX_HOME,在 model_providers 里加一个自定义 provider,base_url 指向本机一个很小的 Python 测试服务。这个服务对每个 POST /v1/responses 固定返回某个状态码、JSON 响应体和 x-request-id,并记下收到的每个请求。每个场景单独运行一次 codex exec --skip-git-repo-check "say hi" < /dev/null,用服务端日志数请求次数。
没有运行什么:ChatGPT 登录路线,也就是没有接触 OpenAI 的真实响应,OpenAI 发给 Codex 的 429 带不带 Retry-After 仍然不清楚(issue #42685 的报告者在日志里没有看到);用 API key 调用真实 API;任何中转、代理或 CC Switch;桌面 App 界面和 IDE 插件;Codex 能认出的"套餐用完""额度不足"响应体;连接中途断开。只测了这一个客户端版本。
| 测试服务返回 | 配置 | 服务端收到的请求 | 用时 | Codex 最后输出 |
|---|---|---|---|---|
429,响应体 code 为 rate_limit_exceeded,不带 Retry-After | 默认 | 1 次 | 约 0.3 秒 | exceeded retry limit, last status: 429 Too Many Requests, request id: req_mock_429_test |
| 同上 | request_max_retries = 10、stream_max_retries = 10 | 1 次 | 约 0.15 秒 | 同一行 |
429 + Retry-After: 3 | 默认 | 6 次,每次间隔 3 秒 | 约 15 秒,屏幕显示 Reconnecting... 1/5 到 5/5 | 同一行 429 |
429 + Retry-After: 3 | stream_max_retries = 2 | 3 次,间隔 3 秒 | 约 6 秒,显示 Reconnecting... 1/2、2/2 | 同一行 429 |
| 503 | 默认 | 30 次 | 约 24 秒 | unexpected status 503 Service Unavailable: server overloaded, url: …/v1/responses, request id: … |
| 500 | 默认 | 30 次 | 约 25 秒 | We’re currently experiencing high demand, which may cause temporary errors. |
这几组结果说明三件事:
- 服务器不带
Retry-After时,exceeded retry limit, last status: 429是在只发了 1 次请求、不到 1 秒内出现的。报错里的"retry limit"不代表 Codex 重试过;把两个重试配置调到 10,仍然只有 1 次请求。 - 服务器带了
Retry-After时,Codex 按给出的秒数等待,再重试整轮,次数等于stream_max_retries,全部用完后打印的还是同一行 429。在这个版本里,没有任何Reconnecting...计数、立刻报出这行 429,符合不带Retry-After的情况;反过来,出现计数不一定是Retry-After,5xx 和断流重试时也会显示它。 - 真正的 5xx 会被重试很多次:每轮最多 5 次带退避的 HTTP 尝试,共 6 轮,30 次请求。用完后报的是另一句话,503 是
unexpected status 503 …,500 是 "high demand" 那句提示,都不是exceeded retry limit。看到last status: 429,说明 Codex 收到的就是 429 状态码,它可能来自 OpenAI,也可能来自中间的代理。
这组测试测的是客户端拿到某种响应后怎么做,不是 OpenAI 服务器的行为。走的是自定义 provider,不等于 ChatGPT 登录路线:它回答不了 ChatGPT 登录时 OpenAI 返回了什么、有没有并发上限,也回答不了中转会怎么包装错误。对排查的用处在于:遇到这条裸 429,调大重试配置换不来更多尝试,该做的仍是前面几节的分流,即减少并行、看状态页、查代理日志。
想在脚本里自己复现,codex exec 要关掉标准输入(命令末尾的 < /dev/null),否则它会显示 Reading additional input from stdin... 一直等着,看起来像卡在网络上。
一份可以直接用于升级处理的证据包
问题在新会话里持续、用量页面和报错互相矛盾、单会话短请求稳定失败,或只在特定版本和 provider 组合下失败时,停止猜测,在 Codex 里运行 /feedback:它会打开反馈窗口,可以选择附上日志。同时整理这些信息:

此图早于 2026 年 10 月更新,以正文为准。
- Codex 版本、CLI、桌面 App 或 IDE 插件、操作系统;
- 登录方式和 provider 名称,
base_url只保留主机和必要路径;是否经过中转或代理; - 完整报错原文,包括前缀和
request id; - 首次和最近一次失败的时间及时区;
- 失败发生在发送前、首字节前,还是部分输出之后;
- 出错时同时运行的会话和子代理数量,单流是否成功;
/status显示的剩余限额,状态页当时有无事件;- 做过的一次对照测试和结果;
- 脱敏后的最小日志片段。
不要附 API key、token、完整认证文件、未脱敏的环境变量或业务源码。证据包的目的,是让支持人员能把 request ID、时间和路线对上,不是上传整台机器的状态。
最后的恢复验收也要回到原路线:原账户、原 provider、原客户端上的一个短请求能完整结束,而且最初那条报错不再出现。换网络、换模型或换账户后成功,只说明找到了临时绕行,原路径是否恢复还要单独验证。
Codex 429 的几个相关问题
Codex 报 exceeded retry limit 429 要等多久?
没有固定答案。套餐用完时,You’ve hit your usage limit… 会给出恢复时间;裸 429 没有。由并行任务引起的,减少并行后通常马上就能验证;由服务端事件引起的,要等状态页显示恢复。OpenAI 没有公布裸 429 的恢复时间,按固定分钟数等待没有依据。
换成 API key 登录能避开 Codex 的 429 吗?
可以换到另一套规则,但不是免费的绕行。API key 登录后按 API 价格计费,受 Platform 的速率限制和账单约束,套餐用量不再适用。它适合本来就打算按量付费的场景;只为躲开一次临时 429,先按上面的四种情况排查更划算。
Codex 429 是我自己的问题吗?
不一定。同时开了多个会话或子代理、经过中转,这两种和你的用法有关,可以自己调整;单会话短请求也失败、状态页有事件时,多半是服务端的问题,等待并用 /feedback 报告即可。
参考来源18
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月15日。
参考来源18
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月15日。
- 1.openai/codex 的 api_bridge.rs 中 429 分支github.com/openai/codex/blob/rust-v0.162.1/codex-rs/codex-api/src/api_bridge.rs
- 2.protocol/src/error.rsgithub.com/openai/codex/blob/rust-v0.162.1/codex-rs/protocol/src/error.rs
- 3.Codex 斜杠命令文档learn.chatgpt.com/codex/reference/slash-commands
- 4.OpenAI 状态页的历史事件status.openai.com/history
- 5.Codex 定价与用量说明learn.chatgpt.com/docs/pricing
- 6.openai/codex issue #41702github.com/openai/codex/issues/41702
- 7.issue #42685github.com/openai/codex/issues/42685
- 8.#54017github.com/openai/codex/issues/54017
- 9.#54010github.com/openai/codex/issues/54010
- 10.#53978github.com/openai/codex/issues/53978
- 11.Codex 配置参考learn.chatgpt.com/docs/config-file/config-reference
- 12.issue #9135github.com/openai/codex/issues/9135
- 13.issue #15468github.com/openai/codex/issues/15468
- 14.issue #53324github.com/openai/codex/issues/53324
- 15.OpenAI API 错误码文档developers.openai.com/api/docs/guides/error-codes
- 16.Codex 认证文档learn.chatgpt.com/docs/auth
- 17.model-provider-info 源码github.com/openai/codex/blob/rust-v0.162.1/codex-rs/model-provider-info/src/lib.rs
- 18.issue #30471github.com/openai/codex/issues/30471





