Auto-generated English stub on 2026-04-24. Replace with a proper translation.

---

title: "Codex CLI「Re-connecting」循环完全指南｜0.50.0 五大实用变通方案" description: "0.50.0 仍未解决的 Codex CLI「Re-connecting」循环根因分析与五个速效变通方案，帮助你用最短时间恢复运行。" date: 2025-11-13 updated: 2025-10-27 keywords: ["Codex CLI", "Re-connecting", "循环重连", "连接错误", "0.50.0", "变通方案", "认证缓存", "MCP", "WSL2", "VS Code 扩展", "故障排查"] tags: ["OpenAI", "Codex CLI", "错误排查", "故障恢复", "WSL2", "MCP"] categories: ["generative-ai/chatgpt", "Codex CLI"]

---

Codex CLI「Re-connecting」循环完全指南｜0.50.0 五大实用变通方案

Codex CLI 完全指南

截至 2025 年 10 月，Codex CLI（v0.50.0）仍持续出现 “Re-connecting...” 循环，相关报告集中在 GitHub Issues #5575、#5679、#5505 等帖子。本文基于一手反馈资料，总结当前故障状态与不同环境下最有效的处置流程。

重点：0.50.0 仍未彻底修复

最新版（0.50.0，2025 年 10 月 25 日发布）依旧存在“Re-connecting”循环。成因具备复合性，涉及 上游连接不稳定、会话恢复逻辑、VS Code 扩展干扰、认证设置冲突、WSL2 / 网络环境 等多个因素。

这不是个案问题。 大量用户都有相同症状，OpenAI 团队仍在持续修复中。

故障表现

GitHub Issue #5679 中常见的症状包括：

典型复现路径

• 启动 Codex CLI 执行任务
• 通常运行 1–3 步后，终端持续显示 “Re-connecting...”
• 即便短暂恢复，几步之后又会回到循环
• 重新登录、重装插件、切换网络都无法根治

高风险用户画像

• 使用 Codex CLI 0.47.x 及更早版本的用户
• WSL2 / Windows 环境尤为多发
• 长时间执行任务的自动化场景
• 同时开启多个 Codex 会话的用户

0.50.0 时点的根因分析

复合因素交织

综合 Issue #5575 及相关线程，可以确认以下主要因素：

1. 上游连接不稳定
2. WebSocket / SSE 中断后，恢复逻辑失败，停留在 “Re-connecting”

3. 多会话并行时会出现全部实例同时挂起（常见于每日一次）

4. VS Code 扩展的干扰

5. Issue #5505 报告扩展端也会重复 “Re-connecting”

6. 扩展版本与配置组合出现兼容性问题

7. 认证设置冲突

8. Issue #3835：OAuth 与 API Key 同时存在时易致行为失控

9. 环境变量残留 API Key 会触发连接错误

10. WSL2 / 网络环境差异

11. WSL2 网络栈的历史 bug
12. VPN、代理、终端安全软件的额外拦截

版本记录与现状

• 0.48.0（2025 年 10 月 23 日）：扩展事件输出、自动压缩、WSL 相关更新
• 0.50.0（2025 年 10 月 25 日）：仍在迭代逐步改善
• 当前结论：上述版本依旧未完全解决“Re-connecting”循环，修复还在推进中

官方处理进展

OpenAI 团队正在 Issue #5575 等讨论中持续给出补丁与进展汇报，建议定期关注。

实用变通方案（按优先级排序）

建议依照 1→5 的顺序依次尝试。方法 1 是社区反馈成功率最高的方案。

方案对照表（先掌握全局）

方法	最适用的场景	所需时间	成功率反馈
方法 1	多个会话一起卡死、任务无法继续	约 2 分钟	极高（Issue #5575）
方法 2	同时使用 OAuth 与 API Key、频繁切换认证	约 5 分钟	较高（Issue #3835）
方法 3	挂载多个 MCP 服务器、SSE 握手不稳定	约 10 分钟	中等（Issue #5619）
方法 4	VS Code 扩展与 CLI 并用时经常出问题	约 3 分钟	中等（Issue #5041）
方法 5	Windows + WSL2 环境出现间歇性断连	约 3 分钟	局部（Issue #5084）

方法 1：全部实例退出 → 单实例重启（最高优先）

Issue #5575 报告中成功案例最多的方案：

# 1) 完全结束所有 Codex 进程（Ctrl+C）
# 2) 等待 60 秒，确认后台进程退出
# 3) 只重新启动一个实例
codex

# 4) 用简短指令测试响应
# 输入 "HELLO" 等简短文本，检验即时响应

成功率最高的常规操作

多会话并行是造成集体挂起的主因。 将所有实例停掉后，只保留一个正在运行的会话，是最可靠的恢复流程。

方法 2：刷新认证缓存

用于规避 Issue #3835 与 Issue #2000 提到的认证冲突：

# 1) 登出
codex logout

# 2) 删除认证缓存文件
rm -f ~/.codex/auth.json

# 3) 暂时禁用环境变量中的 API Key
unset OPENAI_API_KEY

# 4) 重新登录（OAuth：选择 "Sign in with ChatGPT"）
codex

关于认证冲突

~/.codex/auth.json 与环境变量 OPENAI_API_KEY 并存时，会触发 401 错误或连接异常。推荐仅使用 OAuth 登录。

方法 3：排查 MCP（Model Context Protocol）

Issue #5619 与 Issue #5208 指出 MCP 的兼容问题：

切换实验性 MCP 客户端

编辑 ~/.codex/config.toml：

# 切换 true/false，观察差异
experimental_use_rmcp_client = false  # 或 true

暂停问题 MCP 服务器

# 注释掉可能有问题的 MCP 服务器
# [mcp_servers.problematic_server]
# command = "..."

关于 MCP 的既知问题

SSE / HTTP2 协议细节不一致 是近期的主要痛点，特别是在流式握手阶段。

方法 4：绕开 VS Code 扩展干扰

Issue #5041 指出扩展端的网络阻断问题：

1. 临时禁用 VS Code 扩展
2. 仅使用 CLI 模式 执行 codex
3. 若问题消失，再回头检查扩展的版本与配置

既知扩展 Bug

VS Code 扩展可能阻断网络请求。先确保 CLI 单独运行无虞，再逐步恢复扩展功能。

方法 5：重置 WSL2 环境（Windows）

参考 Issue #5084 与 官方 Windows 指南 的建议：

# PowerShell 中执行
wsl --shutdown

# 等待 1 分钟后再启动

关于 Windows 环境

官方更推荐在 WSL2 内运行 Codex CLI。若遇到频繁断线，重置 WSL2 可快速排查网络栈问题。

版本管理与重新部署

更新到最新版

# npm（推荐）
npm install -g @openai/codex@latest

# Homebrew
brew upgrade codex

# 若使用 Cask
brew upgrade --cask codex

确认版本：

codex --version

关注 Homebrew Cask 更新延迟

Issue #5601 显示 Homebrew Cask 更新可能滞后。若版本落后，请直接从 GitHub Releases 获取。

彻底重装（适用于破损环境）

# npm 重新部署
npm uninstall -g @openai/codex
npm install -g @openai/codex@latest

# 如需清空认证
rm -rf ~/.codex

诊断信息提交（0.50.0 新增增强）

在 0.50.0 发布说明 中，/feedback 指令获得了加强，可直接向开发团队提交诊断信息。

# 在 Codex 会话中执行
/feedback

提交内容包括：

• 请求 ID
• 错误日志
• 系统环境信息
• 当前连接状态快照

提 Issue 时建议附上的材料

分享复现日志时，可附上以下信息以便加速修复：

• 发生时间与频率
• 同时运行的会话数量
• 网络路径（VPN / 代理 是否存在）
• IDE / 扩展的使用状况
• codex --version 输出
• /feedback 获取的请求 ID
• 日志文件（~/.codex/log/codex-tui.log）

已知相关问题汇总

Issue #5575：Working / Re-connecting 时的集体挂起

Issue #5575：所有 Codex 实例每日一次集体挂起 的报告（0.50.0 仍出现）。

推荐方案：参考方法 1（全部停掉→等待 60 秒→单实例重启）

Issue #5679：Re-connecting 循环反复出现

Issue #5679：任务执行中突然陷入循环，导致作业中断（2025 年 10 月 26 日报告）。

处置建议：按方法 1–5 依序排查

Issue #5619：MCP 流式连接失败

Issue #5619：HTTP/1.1 与 HTTP/2 混用 导致 SSE 握手失败。

处置建议：参考方法 3（MCP 切换与隔离）

Issue #5041：VS Code 扩展阻断网络

Issue #5041：VS Code 扩展出现网络封堵的 严重 Bug。

处置建议：参考方法 4（停用扩展，确认 CLI 独立运行）

Issue #3216：嵌套 codex exec 导致死循环

Issue #3216：在 Codex 内部再次调用 codex exec 会触发连接循环。

处置建议：避免嵌套执行，改由外部脚本调用

总结

Codex CLI 的 “Re-connecting” 循环在 0.50.0 时点仍未解决。复合因素包括多会话、认证刷新、MCP（SSE/HTTP）协议、扩展干扰等，尚待官方持续修复。

即时处置清单（推荐执行顺序）

1. 全部退出 → 等待 60 秒 → 单实例重启（用 "HELLO" 测试连通性）← 命中率最高
2. 刷新认证：codex logout → rm ~/.codex/auth.json → unset OPENAI_API_KEY → 重新登录
3. MCP 排查：切换 experimental_use_rmcp_client、禁用问题 MCP 服务器
4. 停用 VS Code 扩展，改在 CLI 中复现确认
5. 重置 WSL2：wsl --shutdown → 重开（Windows 强烈建议运行在 WSL2）

方法 1 + 方法 2 组合可解决多数案例

多数用户反馈此组合能在几分钟内恢复正常作业流程。

官方正在推进的长期修复

OpenAI 正在推进以下改进：

• 令牌刷新加固 PR：即便缺少 id_token 也能继续刷新
• resume 会话恢复修复 PR：增强会话恢复逻辑
• 0.50.0 新增增强：
• /feedback 指令收集更多诊断信息
• MCP 错误处理更健壮
• 额外输出请求 ID 以便追踪

最新进展可在 GitHub Pull Requests 查看。

FAQ（常见问题）

0.50.0 是否已经解决了 “Re-connecting” 循环？

尚未。Issues #5575 与 #5679 在 0.50.0 发布后仍有复发记录。上游连接和会话恢复依旧需要加固，官方修复仍在进行中。

可以同时开启多少个 Codex 会话？

社区反馈显示，3 个以上并行会话 很容易触发每日一次的集体挂起。建议关键任务单线程执行，其余任务分散到其他机器或时间段。

/feedback 会向 OpenAI 提交什么信息？

该命令会打包请求 ID、环境指纹与当前连接状态快照。若担心敏感信息，可先检查 ~/.codex/log/codex-tui.log 再决定是否提交。

提交 Issue 时建议附带的信息

若能分享复现日志，请附上下列信息，可以显著提高修复优先级：

• 发生时间与频率
• 并行会话数量
• 网络路径（是否经过 VPN / 代理）
• IDE / 扩展使用状况
• codex --version 输出
• /feedback 提供的请求 ID
• 日志文件（~/.codex/log/codex-tui.log）

建议重点关注的 Issue

• Issue #5575：集体挂起问题
• Issue #5679：Re-connecting 循环
• Issue #5619：MCP / SSE 连接异常
• Issue #5041：VS Code 扩展网络阻断

---

延伸阅读： - Codex CLI 上下文窗口错误速查指南（英文） - Codex CLI 自动审批模式完整指南（含中文） - Codex CLI 网络限制解除全指南（英文）