彻底解决 Codex “正在重新连接 5/5” 频繁卡死问题

无论您使用的是原生 Codex 订阅,还是通过中转 API 或代理环境接入,只要主 Agent 或 Sub-Agent 反复卡在 “正在重新连接 5/5” 提示,均可按以下方案针对性排查与修复。

方案一:原生 Codex 订阅用户 → 禁用 WebSocket

原生订阅下,WebSocket 连接不稳定是导致重试超时的常见原因。通过强制 Codex 改用 HTTP 轮询方式可有效规避。

操作步骤:
在 Codex 配置文件中,将 model_provider 修改为 openai_http,并显式关闭 WebSocket 支持。参考修正后的配置片段:

approvals_reviewer = "user" 

model_provider = "openai_http"


[model_providers]


[sandbox_workspace_write] 

network_access = true


[model_providers.openai_http]

name = "OpenAI"

wire_api = "responses"

requires_openai_auth = true

supports_websockets = false   # 关键开关

保存配置后,重启 Codex 即可生效。

方案二:中转 API / 代理环境 → 排查系统代理设置

中转或代理环境下,网络流量可能未正确经过本地代理端口,导致连接反复超时。请按以下流程修复:

1. 定位当前代理端口

使用以下指令,让 Codex 自动检测并配置代理(示例端口为 7890,若您的实际端口不同,请替换为该指令中的数字):

帮我定位本机当前正在使用的代理端口,并把代理信息写入 ~/.codex/.env。将下面示例里的 7890 替换成实际代理端口(若端口相同则无需替换),写入完成后告诉我修改了哪个文件。

HTTP_PROXY="http://127.0.0.1:7890"  

HTTPS_PROXY="http://127.0.0.1:7890"  

ALL_PROXY="http://127.0.0.1:7890"  

NO_PROXY="localhost,127.0.0.1,::1" 

2. 重启 Codex 使配置生效

务必完全退出 Codex 进程(不仅关闭窗口),再重新启动,环境变量才会被重新加载。