CODEX · 网络排查

Codex 一直 Reconnecting 5/5 怎么办?

从网络路径、系统代理到 respect_system_proxy 实验配置,按步骤排查 Codex 桌面端反复重连,并附 Windows 与 macOS 的验证和恢复方法。

图文指南 · 约 6 分钟 · 整理于 2026 年 11 月

先按这条路径定位问题

01确认网络代理软件与系统连接正常
02检查系统代理确认 Codex 请求能使用
03小步调整一次只改一个配置
04重新验证测试后保留或回退

Reconnecting 5/5 代表什么?

看到 Reconnecting 1/5、2/5,直到 5/5,说明 Codex 正在尝试重新建立连接。这个提示本身不能说明原因一定是系统代理,也可能与网络中断、代理规则、客户端版本或服务端临时状态有关。

如果浏览器里的 ChatGPT 能正常打开,但 Codex 桌面端反复重试,可以优先核对桌面客户端的网络路径。不同客户端、版本和请求类型可能采用不同连接方式,因此“网页能用”只能帮助缩小排查范围,不能单独证明代理设置就是故障点。

先了解开关性质:respect_system_proxy 在当前 Codex 主项目中仍标为实验功能,目的是让 Codex 自有网络客户端遵循 macOS 或 Windows 的系统代理设置。它不能替代代理服务,也不保证修复所有重连问题;不同版本可用性可能不同。

修改配置前,先检查这 4 项

  1. 代理软件是否运行:确认本机代理已经连接,系统代理开关或自动代理配置处于预期状态。
  2. 系统代理能否正常使用:用其他应用确认系统代理本身可连接,再检查代理规则是否覆盖 Codex 需要访问的服务。
  3. 问题是否只发生在 Codex:用同一网络发起一个简单的新对话,记录重试情况;避免同时更换模型、网络和代理规则。
  4. 客户端是否需要重启或更新:完全退出并重新打开 Codex。若刚好在更新后出现问题,记下版本与发生时间。

这些检查能先排除代理软件未连接、规则未命中等常见情况。不要一开始就卸载重装,也不要一次性改动多个网络设置,后续才容易判断是哪一步起作用。

Windows 与 macOS:设置 respect_system_proxy

这项实验开关当前默认关闭。编辑前先备份配置文件,并查看里面是否已经有 [features] 区块或同名设置。Codex 配置文件通常位于:

WinWindows:%USERPROFILE%\.codex\config.toml。可在文件资源管理器地址栏输入 %USERPROFILE%\.codex\ 打开目录。
MacmacOS:~/.codex/config.toml。在 Finder 中使用“前往文件夹”打开 ~/.codex/。

如果文件中还没有 [features],可以加入:

[features]
respect_system_proxy = true

如果已经有 [features],只在该区块中添加这一行;如果已经存在 respect_system_proxy,修改原值即可。不要重复创建区块或删除其他配置。保存时确认文件仍为 .toml,不要误存成 .txt。

安全提醒:系统代理会影响 Codex 的网络连接路径。只使用你信任的代理配置,不要把带有代理凭据或令牌的完整配置文件发给他人。

重启 Codex 后怎么验证?

  1. 完全退出 Codex 桌面客户端,再重新打开。
  2. 在同一网络下新建一个简单对话,观察首次响应和重连次数。
  3. 重复测试一两次,并记下时间、客户端版本与结果;一次成功不代表所有网络问题都已经解决。
  4. 若情况改善,可以保留设置并继续观察;若没有变化或出现新问题,删除该行或改回 false,再重启确认。

每次只调整一个变量,例如先保持代理规则不变,只测试系统代理开关。这样可以判断变化是否与这项配置相关。

仍然 Reconnecting 5/5?按顺序继续排查

  • 确认代理模式与规则:检查系统代理、自动代理配置或分流规则是否按预期生效。
  • 检查连接兼容性:确认当前网络与代理规则允许 Codex 使用的持续连接方式;单纯能打开网页不一定代表所有请求路径都正常。
  • 核对客户端版本与服务状态:更新到当前可用版本,并在一段时间后复测,排除临时网络或服务异常。
  • 保留可复核信息:记录错误时间和提示文字。分享日志前先遮掉账号标识、令牌、代理地址中的凭据等敏感内容。

如果你希望 Codex 帮忙检查配置,可以先让它说明计划、备份原文件,并且只改 [features].respect_system_proxy。检查完成后再查看改动差异,确认其他设置都保留。

请检查当前用户的 Codex config.toml。
先说明准备修改的位置,并备份原文件。
只添加或更新 [features].respect_system_proxy = true;
如果已有 [features] 区块,不要重复创建;保留其他配置。
完成后展示差异,不要读取、输出或更改代理凭据。

快速结论

Codex 反复重连时,先确认系统代理和规则是否正常,再考虑试用 respect_system_proxy。它属于实验设置,修改前备份,测试无效时及时恢复。定位网络问题时,一次只改一项,结果更容易判断。

还可以继续查看 Codex 位置权限指南 和 Codex 零基础入门指南。