Codex连接失败怎么排查？doctor与network-only网络诊断教程

Codex能启动却一直重连，或者登录看似完成但任务发不出去，直接重装往往无法解释原因。官方在2026年10月29日发布的CLI 0.166.0中新增codex doctor –network-only，集中检查配置、连接及WebSocket问题。本文说明如何先保存现象，再读诊断，最后复现验证，不通过关闭安全检查来碰运气。

第一步：记录失败位置与版本

先记下错误出现时间、系统、终端、CLI版本，以及失败发生在启动、登录、提交任务还是运行中途。使用自己已安装的CLI帮助查看可用选项；旧版没有network-only时，先按原安装方式查看受支持更新，不混用多个安装来源导致实际运行的仍是旧二进制。

codex --version
codex doctor --help

这两条用于确认版本与本机命令说明，不会替你证明服务器健康。浏览器网页能打开也不代表CLI的连接路径完全相同：代理、证书、组织网络策略和长连接处理都可能不同。不要先删除认证目录或整个配置文件，否则会丢失最有用的排查线索。

第二步：先运行网络专项诊断

codex doctor --network-only

在刚才失败的同一个终端和网络环境执行，读完报告，记录哪一项通过、哪一项失败以及原始错误短句。官方将此选项定义为配置、连通性与WebSocket诊断，并不是自动修复所有问题的命令；不要假定它会重置网络、更新证书或自动换线路。

若报告提到配置加载，优先核对相关设置；若是连接或握手失败，再由网络管理人员检查相应路径。保留错误对应关系，不把所有失败都叫“账号被封”。报告可能包含本机路径和环境细节，发到公开论坛前只摘取必要且脱敏的片段。

第三步：需要时扩大到完整doctor报告

codex doctor

完整诊断还检查安装、配置、认证、运行时、Git、终端、app-server及线程清单健康情况。网络专项没有解释清楚时再运行，比较完整报告与当前症状。例如安装来源不一致应先处理安装问题；认证项异常应走当前官方登录流程，不能把一条网络成功结果当成所有组件均正常。

不要照搬网上未在本机帮助出现的参数，也不在未经确认时加入忽略证书、关闭代理检查等选项。若需要调整配置，先备份受影响文件，只改与报告直接相关的一项，记录修改前后值；组织管理的设置交给有权限的人处理。

第四步：整理一份可用的问题说明

问题：提交只读练习任务时持续重连。
环境：系统、终端、codex --version。
发生时间与时区：填写实际时间。
失败阶段：启动/登录/提交/运行中。
network-only结果：仅贴已脱敏的失败项。
完整doctor线索：仅贴相关组件。
已修改事项：逐项列出；未修改则写无。
复现：同一网络下的最小只读任务与实际错误。

不要把API密钥、Cookie、认证文件或整个用户目录放进报告。报告中提到的路径也可能泄露用户名和项目名称，先检查再分享。可复现的阶段与错误比一大段未经筛选的日志更容易定位问题，也能避免支持人员误判为另一个客户端故障。

第五步：回到原场景验证

完成一项有依据的调整后，在同一终端重新运行相应诊断，再提交一个无敏感信息的只读小任务，确认原来失败的阶段已经通过。本文命令用于操作示例，没有在你的环境中代为执行诊断，也不声称某种代理配置适合所有网络。

验收时同时记录诊断变化和任务实际结果。如果诊断通过但任务仍失败，保留这个差异继续排查模型访问、组织策略或服务状态；不要反复重装覆盖证据。一次成功也不足以证明长时间连接稳定，若问题是运行中断，应按原持续时长观察并记录是否复现。

官方资料

资料核对日期：2026年11月6日。

• OpenAI：Developer commands
• OpenAI：Codex changelog