无论您使用的是原生 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 进程(不仅关闭窗口),再重新启动,环境变量才会被重新加载。