Codex反复Reconnecting或超时的根本原因是本地网络延迟与默认配置不匹配,需延长MCP启动超时至60秒、禁用WebSocket改用HTTP协议、验证并配置正确代理端口、修复Windows回调端口冲突,并确保Node.js及Codex版本可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex启动时反复显示“Reconnecting”或直接卡在连接超时,不是账号失效也不是模型崩了,而是本地请求在60秒内没收到响应,系统判定失败并中断握手——此时命令行冻结、对话框空白、历史会话无法加载。
先确认本地环境是否就绪
打开终端,依次执行:node -v → npm -v → codex --version。三者都必须返回版本号,缺一不可。
若任一命令报 command not found,说明 Node.js 未安装或未加入 PATH,Codex 根本无法运行,后续所有配置都无效。
Windows 用户特别注意:PowerShell 能跑 ≠ Git Bash 能跑 ≠ VSCode 内置终端能跑,务必在你实际启动 Codex 的那个终端里验证。
延长 MCP 启动超时时间
第一步:用文本编辑器打开 Codex 配置文件 config.toml。
macOS/Linux 路径:~/.codex/config.toml;Windows 路径:C:\Users\你的用户名\.codex\config.toml。
第二步:在文件末尾新增以下配置块(必须顶格写,不能缩进):
[mcp_servers.codex_apps]<br>startup_timeout_sec = 60
【注意】这段必须放在 [mcp_servers] 下级,不能嵌套在 [model_providers] 或其他段落里;已有同名段落则直接修改数值即可。 默认30秒对国内代理链路明显不足,60秒才能覆盖 TLS 握手 + 上下文初始化 + 首 chunk 返回全过程。
强制禁用 WebSocket 改走 HTTP
方法一:修改配置文件
在 config.toml 最顶部(任何 [xxx] 段落之前)写入:model_provider = "openai_http"。
然后在任意空白处添加完整段落:
[model_providers.openai_http]<br>name = "OpenAI HTTP only"<br>wire_api = "responses"<br>supports_websockets = false
【关键】model_provider = "openai_http" 必须顶格书写,缩进会导致解析失败,配置完全不生效。
方法二:用环境变量绕过配置
在启动 Codex 前,执行:
export HTTPS_PROXY="http://127.0.0.1:7890"<br>export HTTP_PROXY="http://127.0.0.1:7890"
这一步只对当前终端会话有效;如需长期生效,请将两行追加到 ~/.zshrc(macOS/Linux)或 ~/.bashrc(Linux),然后执行 source ~/.zshrc。
验证代理端口是否真正监听
① 打开终端,运行:
Windows:netstat -ano | findstr :7890
macOS/Linux:lsof -i :7890
确认输出中包含 LISTENING 或 LISTEN 状态。
② 若无输出,说明代理工具(Clash、Stash、Surge 等)根本没在监听该端口——请打开代理客户端,检查 HTTP/Socks5 端口设置,确保已启用且端口号与配置一致。
③ 运行测试命令:curl -x http://127.0.0.1:7890 https://api.openai.com/v1/models -I --max-time 10。
只要返回 HTTP 状态码(如 HTTP/2 401 或 HTTP/2 200),即证明代理链路通畅;若提示 Connection refused,说明代理未运行或端口错误。
修复 Windows 登录回调端口冲突
管理员身份打开 PowerShell,执行:netsh interface ipv4 show excludedportrange protocol=tcp。
重点查看输出中是否含 1359–1458 区间——Codex 默认用 1455 端口启动本地回调服务,一旦落入该区间,就会触发 os error 10013,导致监听失败→无法接收浏览器回调→登录超时。
若确认被排除,立即执行:net stop winnat → net start winnat。
重启 WinNAT 服务后,系统会重新分配排除端口,1455 大概率被释放。
完成后无需重启电脑,直接重试 codex login 即可生效。


















