Appearance
Codex 桌面端新会话 5 次 Reconnecting 怎么办?HTTP/SSE 完美修复方案(2026最新)
摘要:Codex Desktop 新建会话时频繁出现 5 次 Reconnecting?本文提供最彻底的 HTTP/SSE 降级解决方案,通过修改
config.toml强制关闭 WebSocket,只需 2 分钟即可解决代理环境下首次提问反复重连的问题。
📚 本文目录(点击跳转)
- 一、结论先行:快速修复
- 二、问题现象:Codex 新会话 5 次 Reconnecting
- 三、适用场景排查
- 四、核心原因分析
- 五、保姆级修复步骤
- 六、完整 config.toml 配置示例
- 七、核心配置项原理解析
- 八、配置验证与测试方法
- 九、常见问题解答(FAQ)
一、结论先行(最快修复)
Codex 桌面端新会话 5 次 Reconnecting 是很多用户在使用代理时遇到的常见问题。核心解决办法:在 config.toml 中新增一个强制走 HTTP/SSE 协议的 OpenAI Provider,并设为默认。
直接复制以下配置即可解决:
toml
model_provider = "openai_http"
[model_providers.openai_http]
name = "OpenAI HTTP only"
wire_api = "responses"
supports_websockets = false
requires_openai_auth = true注意:切换后历史对话列表可能只显示新 Provider 下的记录,属于正常现象。
二、问题现象:你遇到的是这个情况吗?

在使用 Codex Desktop 时,经常出现以下情况:
- 新建会话(New Chat)首次发送消息,连续弹出 5 次 Reconnecting
- 软件刚启动时第一次提问必定重连
- 后续对话完全正常,只有新会话容易触发
- 挂载本地代理(如 127.0.0.1:10808)时特别明显,直连则较少出现
如果你符合以上特征,那么本文的 HTTP/SSE 修复方案 能彻底解决你的问题。
三、适用与不适用场景排查
✅ 适用本方案:
- Codex 可正常登录
- 最终能得到回答,只是新会话首次请求反复 Reconnecting
- 使用了科学上网/本地代理工具
❌ 不适用本方案:
- 完全无法登录或白屏
- 所有请求永久失败
- 代理节点本身无法访问 OpenAI 服务
四、核心原因:为什么 Codex 新会话会一直 Reconnecting?
Codex 默认优先使用 WebSocket 进行流式传输。虽然效率高,但对本地代理非常敏感。WebSocket 握手(Upgrade)、TLS 隧道、长连接保持等环节只要出现一点抖动,就会触发自动重连机制,通常重试约 5 次。
最佳解决思路:不修改重试次数,而是彻底放弃 WebSocket,强制使用代理兼容性更好的 HTTP/SSE(Server-Sent Events) 流式响应。
五、保姆级修复步骤
步骤 1:完全关闭 Codex Desktop
步骤 2:备份配置文件
配置文件路径通常为: C:\Users\你的用户名\.codex\config.toml
PowerShell 备份命令:
powershell
Copy-Item "$env:USERPROFILE\.codex\config.toml" "$env:USERPROFILE\.codex\config.toml.bak"

步骤 3:编辑 config.toml
将顶部
model_provider修改为:tomlmodel_provider = "openai_http"
在文件最底部追加以下内容:
toml[model_providers.openai_http] name = "OpenAI HTTP only" wire_api = "responses" supports_websockets = false requires_openai_auth = true
步骤 4:保存并重启 Codex Desktop
六、完整 config.toml 配置示例
toml
model_provider = "openai_http"
model = "gpt-5.5"
model_reasoning_effort = "high"
[windows]
sandbox = "elevated"
# HTTP/SSE 专用 Provider(解决新会话 Reconnecting)
[model_providers.openai_http]
name = "OpenAI HTTP only"
wire_api = "responses"
supports_websockets = false
requires_openai_auth = true七、核心配置项原理解析
| 配置参数 | 作用解析 |
|---|---|
model_provider = "openai_http" | 设置默认使用 HTTP 协议 Provider |
supports_websockets = false | 最关键:禁用 WebSocket,强制走 HTTP/SSE |
requires_openai_auth = true | 继续使用网页登录态,无需 API Key |
wire_api = "responses" | 保持使用先进的 Responses API |
八、配置验证与测试方法
命令行验证:
bashcodex debug models
打开 Codex → 新建会话 → 输入 “你好呀”

- 观察是否不再出现反复 Reconnecting
九、常见问题解答(FAQ)
Q1:Codex 桌面端新会话 5 次 Reconnecting 最常见原因是什么?
A:本地代理对 WebSocket 协议升级支持不佳导致的握手失败。
Q2:改用 HTTP/SSE 会影响模型回答质量吗?
A:完全不会,仅改变传输协议,模型能力和上下文保持不变。
Q3:需要申请 OpenAI API Key 吗?
A:不需要,requires_openai_auth = true 会继续使用你的网页登录授权。
Q4:改完后闪退怎么办?
A:大概率 TOML 格式错误,用备份文件恢复即可。
Q5:还是偶尔重连怎么办?
A:继续优化代理客户端内核(如切换 Sing-box),或更换低延迟节点。
