彻底解决 Codex / 编辑器 频繁报错 Reconnecting… 1/5：WebSocket 断流降级、鉴权冲突与实操修复
💡 核心速览：运行 Codex CLI 或 VS Code / Cursor 插件时，频繁遭遇「Reconnecting… 1/5」至 5/5 中断？本文提供清晰极简的速查自救方案：通过 .codex/.env 注入代理、在 config.toml 中强制降级为 HTTP 稳定流、一键重置鉴权凭证与 TUN 模式优化，30 秒快速恢复流畅编码。
Codex 终端或 VS Code 插件报 Reconnecting… 1/5 最终失败，本质是网络中间件掐断了长连接或终端未走代理。此时疯狂回车会导致并发请求堆积触发 429 频次风控。请按下方「30 秒速查表」对号入座，立即可解。
🚨 30 秒速查自救表（对号入座，直达解法）
根因：终端 CLI 默认不走桌面系统代理，直连 OpenAI 超时。
解决：直达【方案一】配置 ~/.codex/.env 注入代理。
根因：代理节点把脆弱的 WebSocket 会话掐断。
解决：直达【方案二】修改 config.toml 强制降级为 HTTP 流。
根因：本地 Token 过期或与历史残留的 API Key 冲突。
解决：直达【方案三】删除 auth.json 重新 codex login。
根因：缺少 .gitignore 导致无关大文件灌爆上下文。
解决：直达【方案四】开启 TUN 模式或输入 /new 开启新会话。
在 ~/.codex/.env 中配置你的实际代理端口（解决命令行不走代理）
许多开发者明明在电脑上开了代理，但命令行终端和 VS Code 插件依然直接断连。这是因为系统桌面代理默认不会自动注入到控制台进程中。 Codex 原生支持在用户目录下的 .env 文件中指定代理，这是最优雅、无需全局改动的方式。
交互式 .env 代理配置生成器（支持自定义端口）
点击匹配你的代理软件，或输入你本地实际监听端口，下方脚本实时同步更新
# Windows PowerShell 一键配置 Codex 代理 (端口: 7897)
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
HTTP_PROXY="http://127.0.0.1:7897"
HTTPS_PROXY="http://127.0.0.1:7897"
ALL_PROXY="socks5://127.0.0.1:7897"
'@ | Set-Content -Path "$HOME\.codex\.env" -Encoding utf8
Write-Host "✅ 已写入 ~/.codex/.env (代理端口: 7897)，请重启终端运行 codex！" -ForegroundColor Green7897 或 7890。6152。mixed-port 或 inbounds 中的监听端口填写。在 config.toml 中禁用 WebSocket，降级为 HTTP 稳定流
Codex 默认使用全双工 WebSocket 通信。国内绝大多数代理节点对长连接的 Ping-Pong 保活机制非常脆弱，一旦超过 15~30 秒无有效数据包就会发送 TCP RST 强行斩断，引发「Reconnecting… 1/5 → 5/5」。 通过在 config.toml 中将通信强制切换为 HTTP Server-Sent Events (SSE)，无论任何代理节点均可稳定穿透，且逐字吐出速度完全一致！
凡是通过 codex login 扫码或浏览器授权登录的用户，请直接使用该配置（必须包含 requires_openai_auth = true 与后端 base_url）：
# 配置文件路径：~/.codex/config.toml
# 【适用人群】：使用官方 ChatGPT Plus / Pro / Team 账号登录 (通过 codex login 授权)
model_provider = "chatgpt_http"
[model_providers.chatgpt_http]
name = "ChatGPT HTTP"
base_url = "https://chatgpt.com/backend-api/codex"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false如果你使用的是 OpenAI 开发者平台绑卡生成的 API Key（非网页订阅），请使用以下配置：
# 配置文件路径：~/.codex/config.toml
# 【适用人群】：使用开发者平台自行购买的 OpenAI API Key (非 ChatGPT 网页订阅)
model_provider = "openai_http"
[model_providers.openai_http]
name = "OpenAI API HTTP"
base_url = "https://api.openai.com/v1"
wire_api = "responses"
supports_websockets = false- Windows:
%USERPROFILE%\.codex\config.toml（即C:\Users\你的用户名\.codex\config.toml） - macOS / Linux:
~/.codex/config.toml
⚠️ 关键步骤：修改保存后，必须完全关闭当前命令行窗口，或在 VS Code 中执行 Ctrl+Shift+P → Developer: Reload Window，否则旧的长连接进程不会重载！
清理废弃冲突凭证，重新发起官方登录
很多开发者曾在本地配置过历史 API Key，或者本地缓存的登录 Token 已过期，导致长连接在握手鉴权阶段被服务器返回 401，客户端误以为是临时网络波动而陷入 5 次无休止重连。
# 1. 彻底清除 Windows 下损坏或过期的 Token 缓存
Remove-Item -Path "$HOME\.codex\auth.json" -Force -ErrorAction SilentlyContinue
# 2. 重新发起官方交互式授权登录
codex login# 1. 彻底清除 macOS / Linux 下损坏或过期的 Token 缓存
rm -f ~/.codex/auth.json
# 2. 重新发起官方交互式授权登录
codex login开启代理 TUN 虚拟网卡 + 锁定固定专线（避免 IP 瞬移）
在 Clash Verge / Sing-box 中开启 TUN 模式，从操作系统网络驱动层无感接管所有控制台流量。
严禁在代理中使用“自动测速 / 负载均衡 / URL-Test”。每次流式分发时出口 IP 漂移，长连接会被网关立即掐断。
项目根目录下配置健全的 .gitignore 排除 node_modules 和构建产物，或输入 /new 开启轻量新对话。
极简日志定位：1 条命令查看真实原因
界面只会笼统提示「Reconnecting… 1/5」，但真实底层报错已完整写入本地日志。执行以下命令即可快速抓取最新诊断信息：
# PowerShell 实时查看运行日志
Get-Content -Path "$HOME\.codex\log\codex-tui.log" -Wait -Tail 30# macOS / Linux 实时查看运行日志
tail -f ~/.codex/log/codex-tui.log| 日志捕获特征 | 本质问题 | 极速解决方案 |
|---|---|---|
| websocket: close 1006 / abnormal | 代理中断 WebSocket | 【方案二】改 config.toml 禁用 WebSocket |
| 401 Unauthorized / invalid_token | 凭证失效或冲突 | 【方案三】删除 auth.json 重新登录 |
| connect: connection refused / timeout | 终端未走代理 | 【方案一】配 .codex/.env 注入代理 |
| Client.Timeout / Read timed out | 上下文超大生成超时 | 在终端输入 /new 开启全新轻量会话 |
常见疑问解答 (FAQ)
问：禁用 WebSocket 改用 HTTP 会导致代码生成变慢吗？
答：完全不会。 HTTP SSE 协议同样是单向流式打字输出，在带宽与首字响应速度上与 WebSocket 没有肉眼可见的差距。因为免去了频繁的 WebSocket 心跳保活与代理丢包重连，在国内复杂网络下实际体验反而更加顺滑稳定。
问：修改了 config.toml 或 .env 后为什么还是提示 Reconnecting？
答：90% 是因为旧进程未退出。 必须完全关闭当前的命令行窗口（或在 VS Code 中执行 Ctrl+Shift+P → Developer: Reload Window）。此外请务必在你的代理软件设置中核对实际监听端口（不同软件默认为 7897 / 7890 / 10808 等，切忌盲目硬编码他人端口），并检查 TOML 文件中的等号两侧有无拼写失误。
问：研发团队多人共用单个账号频繁掉线，如何根治？
答：多人共用同个账号极易触发并发会话冲突。 建议升级 ChatGPT Business (原Team) / Enterprise 企业独立工作区，为每位工程师分配专属席位，享受企业级高优先级长连接集群，彻底杜绝连接挤占断流。
Plus 频次被卡？解锁 ChatGPT Pro 200/500 与 Business 独立配额
普通 Plus 频次限制严重阻断高强度 Coding 灵感。AI集采支持开通 Pro 200 (10x 旗舰) / Pro 500 (25x 顶配) 及企业 Business 空间，各席位额度独立不冲突，支持中国工商银行对公转账与 6% 增值税专用发票。
相关技术排障与常见问题推荐
查看全部问题Selected model is at capacity 解决指南
任务执行中断提示「Selected model is at capacity. Please try a different model」？剖析官方算力挤兑、高峰期区域容量、单会话卡死与账号隐性降权 4 大根因；掌握现场保全指令、官方 4 步应急路径与账号降权 3 套实操恢复方案。
429 限流与使用额度耗尽解决
写代码一半提示「You've reached the current usage cap」或报错 429 Too Many Requests？掌握指数退避重试代码、会话瘦身压缩、轻重任务分流与高并发破解方案。
Codex 命令行与编辑器代理报错
浏览器能正常访问 ChatGPT，但终端运行 codex、Cursor 或 VS Code 插件却报 fetch failed、连接超时或 SSL 证书错误？全面解析终端环境变量与代码工具代理注入命令。