Codex远程服务器频繁重连？终极排查与清理app-server进程指南

最近在使用 VS Code 远程开发时，Codex 扩展表现出明显的不稳定性。典型症状包括：对话过程中突然弹出“reconnected”提示、刚一打开就长时间转圈加载、Codex 面板完全卡死连退出登录都点不动，而通过浏览器直接访问 ChatGPT 官网却一切正常，服务器代理层面也未发现明显问题。

起初很容易归咎于账号、API 密钥、模型或某个配置项出错，但逐一排查后才发现，这次故障的根源并非 Claude 配置缺陷，也不是简单的“能不能打开 ChatGPT 官网”。

先说结论：问题主要出在 Codex VS Code 扩展自身的后台进程与长连接机制。Codex 在 VS Code Remote 环境中并不是直接依赖浏览器工作，它会在远程服务器上启动一个后台进程：

codex app-server

整体通信链路大致如下：

VS Code Codex Panel → Codex App Server → ChatGPT/Codex Backend

因此，浏览器能顺利打开 ChatGPT 官网只能说明浏览器那条链路畅通，并不能代表 VS Code 扩展内部的 Codex 长连接也同样稳定。

在实际排查中，我观察到了两类关键异常。

第一类是 Codex 与后端的通信长连接被直接断开，日志中会出现类似：

stream disconnected before completion https://chatgpt.com/backend-api/codex/responses

这说明 Codex 与 OpenAI 后端之间的 WebSocket 或长连接被异常中断。

第二类是本地扩展进程反复报错：

worker_rpc_response_error method=stable-metadata workerId=git

这个错误并非来自 OpenAI 后端，而是 Codex 扩展在尝试读取当前工作区的 Git 元数据时持续失败（比如检测是否为 Git 仓库、分支、commit 信息、文件变更等）。这类问题通常不会直接切断模型回复，但会不断消耗扩展宿主资源，导致面板卡顿、持续转圈、CPU 占用升高等现象。

真正有效的处理办法是：先彻底清理残留的 Codex 后台进程，再重载 VS Code 窗口。

在远程服务器的终端中执行以下命令，终止所有现有的 codex app-server 进程：

pkill -f '/openai.chatgpt-.*/codex app-server'

接着回到 VS Code，按下 Ctrl + Shift + P（或对应快捷键）调出命令面板，输入并执行：

Developer: Reload Window

中文界面下可能显示为“开发人员: 重新加载窗口”。这个操作不会重启服务器，也不会删除任何文件，它仅仅是刷新当前窗口并重新加载所有扩展宿主，让 Codex 启动一个全新的、干净的 codex app-server 实例。

操作结束后，原本重复堆积的 codex app-server 进程只剩下一个，Codex 面板也随之恢复正常，各项交互重新变得流畅。

为什么会出现多个 app-server 共存呢？正常情况下，一个 VS Code 窗口只需要一个 codex app-server。但在 VS Code Remote 连接中断重连、扩展崩溃或多次 Reload 窗口时，旧进程很可能没有彻底退出，导致多个实例并行运行。这就会引发一连串问题：Codex 面板一直加载、反复重连、退出登录无响应、多个进程争抢读写 .codex 状态文件，甚至导致 CPU 占用异常升高。

所以，当 Codex 出现面板卡死、转圈等问题时，优先清理后台 app-server 进程是一个直接且高效的处理思路。