Codex客户端反复重连的处理教程：关闭 Responses WebSocket

# Codex 反复 Reconnecting 的处理教程：关闭 Responses WebSocket

## 问题现象

在部分代理网络中，Codex 客户端可以正常完成文本对话，但开始任务时经常出现：

```text
Reconnecting... 1/5
Reconnecting... 2/5
Reconnecting... 3/5
Reconnecting... 4/5
Reconnecting... 5/5
```

等待一段时间后，Codex 又能继续回答。这通常说明基础 HTTPS 请求可以完成，但 WebSocket 长连接不够稳定。

本文介绍一种影响较小的处理方式：保留 Codex 默认 provider，只关闭 Responses WebSocket，让客户端改用普通 HTTPS/SSE 流式传输。

> 注意：本文使用的是版本相关的功能开关。Codex 更新后，开关可能被改名、忽略或不再需要。

## 适用场景

本方法适合以下情况：

- 普通文本对话最终可以成功，但开始响应前经常重连。
- 浏览器中的 ChatGPT 正常，Codex 客户端更容易断线。
- 代理支持 HTTPS，但 WebSocket 或长连接不稳定。
- 希望保留默认登录、任务记录和内置工具路由。

本方法不一定能解决：

- 代理软件完全没有运行。
- 代理端口填写错误。
- 图片生成接口、文件下载接口等独立 HTTPS 请求本身超时。
- OpenAI 服务正在发生故障。

## 第一步：找到配置文件

Codex 用户级配置文件通常位于：

Windows：

```text
C:\Users\你的用户名\.codex\config.toml
```

macOS 或 Linux：

```text
~/.codex/config.toml
```

官方配置参考：<https://developers.openai.com/codex/config-reference>

## 第二步：备份配置文件

修改前必须先备份，方便在出现异常时恢复。
复制一下config.toml到其他地方

## 第三步：修改 `[features]` 配置

打开 `config.toml`，找到已有的 `[features]` 段。

如果文件中已经存在：

```toml
[features]
js_repl = false
```

在同一个配置段中加入两个开关：

```toml
[features]
js_repl = false
responses_websockets = false
responses_websockets_v2 = false
```

如果文件中没有 `[features]`，可以在文件末尾新增：

```toml
[features]
responses_websockets = false
responses_websockets_v2 = false
```

## 第四步：彻底重启 Codex

保存文件后：

1. 结束正在运行的 Codex 任务。
2. 从系统托盘彻底退出 Codex。
3. 确认任务管理器中没有残留的 Codex 主进程。
4. 保持代理软件运行。
5. 重新打开 Codex。

仅关闭窗口不一定会重新加载配置。

## 第五步：验证效果

重新打开 Codex 后，可以依次测试：

1. 发送一个简单文本问题。
2. 执行一个需要几十秒的任务。
3. 再测试图片生成或其他长耗时工具。

如果文本任务不再固定重连 5 次，说明 WebSocket 开关已经产生效果。

需要注意：图片生成通常使用独立的 HTTPS 接口。即使聊天重连消失，生图仍可能因为代理节点不稳定、长请求超时或结果回传失败而报网络错误。

## 关闭 WebSocket 的影响

关闭后，Codex 会优先使用普通 HTTPS/SSE 流式传输。

可能出现的变化：

- 首次响应或连续交互可能稍慢。
- 流式输出、打断回答和实时状态更新可能不如 WebSocket 灵敏。
- 每轮请求的连接开销可能略高。
- 网络切换后的恢复方式可能有所不同。

通常不会受到影响：

- 模型能力和回答质量。
- 账号登录状态。
- 原有任务记录和任务分组。
- 代码执行、文件操作及大部分工具。
- 默认 provider 和内置工具的服务路由。

## 图片生成仍然失败怎么办

如果文本对话稳定，但图片生成仍然报网络错误，可以继续检查：

1. 使用TUN代理模式，代理整台机器的流量
## 如何恢复 WebSocket

删除以下两行：

```toml
responses_websockets = false
responses_websockets_v2 = false
```

保存后彻底退出并重新打开 Codex。

## 总结

当 Codex 在代理网络下反复显示 `Reconnecting... 1/5` 到 `5/5`，但最终仍能完成文本回答时，可以尝试保留默认 provider，并在 `[features]` 中关闭 Responses WebSocket：

```toml
[features]
responses_websockets = false
responses_websockets_v2 = false
```

这种方式不会切换 provider，对任务记录和内置工具的影响通常较小。它主要解决 Codex 主响应通道的 WebSocket 重连问题；如果生图仍失败，则应继续排查代理线路和长耗时 HTTPS 请求的稳定性。