Codex 一直显示“正在重新连接”时,先记录完整错误,再检查同一账号下的新任务是否正常。单凭 Reconnecting 1/5 或 5/5,不能确定是网络、账号还是服务端问题,也不能据此判断需要充值。

更新于 2026 年 10 月 26 日。适用于桌面应用、VS Code/Cursor 插件及 CLI;具体操作以当前版本为准。

先按提示找到下一步

你看到的情况先检查什么下一步
1/5 到 5/5 反复重连重试结束后的完整错误保留报错,做一次新任务对照
401、Unauthorized 或要求登录ChatGPT 登录会话,或 API key/网关认证ChatGPT 登录按提示重新认证;API/网关核对 key、端点与认证传递
403 或权限提示错误说明中的权限、地区或工作区限制按具体限制处理,不能直接当作封号
429、限流或额度提示请求速率、ChatGPT 额度,或 API 余额/支出上限限流按提示等待;ChatGPT 查看额度重置;API 额度耗尽时检查余额和组织/项目支出上限
5xx 或服务器处理失败OpenAI 服务状态及实际请求的服务端点稍后重试;使用网关时同时核对网关状态
timeout、stream disconnected before completion网络、代理、证书,以及是否只影响当前任务按响应流与网络分支逐项对照

上表中的 HTTP 状态只在实际报错含有对应代码时使用,说明见 OpenAI 官方错误码文档。

先看完整提示中的 error.code。API 余额、支出或用量上限问题需处理对应限制,反复重试不能恢复;自定义网关按其原始错误处理。

Codex 正在重新连接,按四步排查

Codex 重连四步排查:记录完整错误、做小任务对照、按现象处理、核对工作后恢复
Codex 重连排查流程,点击放大。

1. 保留完整报错,确认是否在等待操作

记录客户端、版本、发生时间及最后一条错误。检查界面是否在等待审批、登录或你的回答。“正在思考”、终端命令仍在运行和连接重试是不同状态;先判断当前状态,再决定是否中断。

2. 在同一新会话连续测试两轮

保存未发送的内容,新建一个任务,先输入:

只回复 OK,不调用工具,也不要修改文件。

收到回复后,在同一新会话再发送“这一轮只回复 OK2,不调用工具,也不要修改文件”。连续测试两轮,才能发现首条正常、后续卡住的情况。

  • 新任务连续两轮正常、原任务异常:优先核对原任务状态、最后完成的步骤及输出量。
  • 第一条正常、第二条卡住:记录为后续轮次失败,继续对照其他客户端,不要直接判断为原任务损坏。
  • 所有新任务都异常:继续检查登录、网络路径和服务状态。
  • 只有一个客户端异常:记录桌面应用、编辑器插件和 CLI 各自版本,分别处理。
  • 只有远程项目异常:检查远程主机是否睡眠、断网或关闭了应用。

两轮都收到指定短回复,只说明这两次短请求成功,返回原任务后仍需检查能否继续。

3. 根据客户端和错误处理

桌面版一直重连:先重开,再做两轮测试

  1. 确认当前账号和个人/团队工作区,保存草稿及已完成的工作。
  2. 待其他运行中的任务结束后,完全退出并重新打开应用,通过原安装渠道检查更新;不要把更新独立 CLI 当作更新桌面应用。
  3. 在新会话连续发送两条短指令。两轮都成功后,再回原任务检查能否继续;只有桌面版失败时,记录桌面版本和完整错误。
macOS 用户的 Codex 截图,显示 Reconnecting 2/5 至 5/5 和 WebSocket 提前关闭错误
macOS 桌面版用户反馈:连续重连后出现 WebSocket 提前关闭错误。 来源:用户原帖(反馈发布于 2026-04-22,UTC)。

VS Code/Cursor 一直重连:检查扩展并重载窗口

  1. 保存编辑内容,确认扩展中的登录身份与预期一致。
  2. 检查 Codex 扩展版本,在命令面板运行 Developer: Reload Window。
  3. 在扩展内新建会话并做两轮短测。如果 CLI 正常而扩展失败,反馈时附上编辑器和扩展各自版本。
VS Code Dev Container 用户上传的 Codex 登录失败截图,显示 token_exchange_failed
VS Code Dev Container 用户反馈:登录时令牌交换失败,不能仅凭此判断封号。 来源:用户原帖(反馈发布于 2026-05-26,UTC)。

CLI 重连失败:先确认版本和认证方式

在运行 Codex 的终端执行以下只读检查;远程任务在对应主机上检查:

codex --version
codex login status

第二条只显示认证方式,不验证端到端连通性。使用 ChatGPT 登录时按登录提示处理;使用 API key 时核对所选 provider、端点和凭据,不要把 key 发到聊天或日志中。支持诊断命令的版本还可运行 codex doctor;命令范围见 官方命令说明。检查后新建会话做两轮短测。

Codex CLI 用户截图显示用量上限和该账号当时提示的重置时间
CLI 用量上限提示;图中时间属于原用户,不代表你的刷新时间,图中也未显示 HTTP 429。 来源:用户原帖(反馈发布于 2026-05-04,UTC)。

出现 stream disconnected before completion 或网络超时

这表示本次响应流在完成前中断,单凭这句话不能确定根因。先保留后续完整错误,再按上表中的状态码及出错范围选择分支:

Codex 用户截图显示 Reconnecting 5/5 和 stream disconnected before completion 完整错误
重连计数下方出现完整响应流错误,应同时保留这两部分信息。 来源:用户原帖(反馈发布于 2026-09-11,UTC)。
  • 核对实际代理/VPN 地址和端口是否仍可用;在网络策略允许时,一次只更换一个网络条件,再做两轮短测。
  • 普通网页能打开,不代表响应流或 WebSocket 一定稳定。企业证书问题按管理员提供的配置处理。
  • 如果只有终端工具联网失败,检查工具网络权限;这与聊天连接中断不同,开放全部权限不是通用修复。
  • 如果只有远程项目失败,检查远程主机是否睡眠、断网或关闭了应用。

4. 确认已完成的工作,再继续任务

重连失败不代表此前操作全部撤销。先看文件变化、终端输出和任务记录;Git 项目可运行:

git status --short
git diff --stat

确认后再说明“保留已完成部分,只继续未完成步骤”。以上命令只帮助检查本地 Git 变化,不能证明邮件、部署或其他外部操作是否已完成,这些要到对应服务核对。

Codex 用户截图中,Edited 2 files 出现在两次 Reconnecting 1/5 之间
重连期间已有文件改动记录,重新执行前先核对实际文件。 来源:用户原帖(反馈发布于 2026-05-25,UTC)。

用户讨论:账号与繁忙时段有关系吗?

账号与登录状态:看同账号、不同客户端的表现

公开讨论中,有 Windows 桌面版用户在特定版本遇到“第一条消息正常,后续消息卡住”,同一账号在 CLI 或 VS Code 中却可继续工作。重新登录曾暂时改善,但后续反馈仍有不同结果。可查看 Codex 项目中的用户反馈。

这类个人反馈提示应检查会话和客户端状态,不能证明账号被封或换账号就能解决。先确认当前账号、个人/团队工作区及额度;切换过账号的用户,还应核对当前登录身份是否与预期一致。不要照搬他人的删除认证文件操作。

另一位 Codex 用户的截图显示 Reconnecting 5/5 后出现 HTTP 401 Unauthorized
另一位用户的 401 反馈:这张图未说明平台或认证方式,不能直接认定是本地 API key 或封号问题。 来源:用户原帖(反馈发布于 2026-09-25,UTC)。

繁忙时段:可以对照测试,没有统一“必卡时间表”

一位用户在 2026 年 6 月 19 日的讨论中,观察到当地 14:00–15:00 CEST(UTC+2)重连更频繁,折合北京时间 20:00–21:00。该观察见 Reconnecting Issues 用户讨论,不是官方繁忙时段公告,也不能直接套用到其他日期、地区或账号。

如果你也觉得晚上更容易重连,用同一账号、同一网络和同一条短指令,在两个时段各测一次,记录时间、模型和报错。这样能提供排查线索,但不能单独证明服务拥堵。服务状态页反映整体情况,显示正常也不保证每个个人请求都正常。

仍然无法恢复,反馈时提供什么?

  • 操作系统、应用/插件/CLI 版本;
  • 发生时间和时区、完整错误、Request ID 或会话 ID;
  • 是否使用远程主机、公司网络或自定义模型网关;
  • 同账号新任务、不同客户端及不同时段的对照结果。

Windows/macOS 桌面应用中,可在输入框输入 / 并选择可用的反馈项,或使用 /feedback;按界面选择是否附带会话。仅 macOS 的应用日志通常位于 ~/Library/Logs/com.openai.codex/YYYY/MM/DD;提交前删去密钥、账号及项目敏感内容。日志与反馈入口见 官方排障说明。

常见问题

Reconnecting 5/5 是进度到了 100% 吗?

不是任务完成百分比。应看重试后是否恢复、是否出现明确失败及完整报错,不要只盯着计数。

重连是不是套餐失效,付费账号就不会出现吗?

不能这样判断。先查看实际登录、权益和错误提示;付费也不保证免于连接或客户端问题。只有确认是充值未到账时,再按ChatGPT 充值与到账检查教程核对。

需要马上重装或调高重试次数吗?

先做小任务对照并保留错误。重装不能解决所有服务端或账号状态问题;增加重试次数也不会修复失效凭据和错误的服务地址。