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

在使用 Codex Desktop 时,经常出现以下情况:
- 新建会话(New Chat)首次发送消息,连续弹出 5 次 Reconnecting
- 软件刚启动时第一次提问必定重连
- 后续对话完全正常,只有新会话容易触发
- 挂载本地代理(如 127.0.0.1:10808)时特别明显,直连则较少出现
如果你符合以上特征,那么本文的 HTTP/SSE 修复方案 能解决你的问题。
三、适用与不适用场景排查
✅ 适用本方案:
- Codex 可正常登录
- 最终能得到回答,只是新会话首次请求反复 Reconnecting
- 使用了科学上网/本地代理工具
❌ 不适用本方案:
- 完全无法登录或白屏
- 所有请求永久失败
- 代理节点本身无法访问 OpenAI 服务
想了解各套餐的 Codex 使用额度,看 Codex 额度对比。
四、核心原因:为什么 Codex 新会话会一直 Reconnecting?
Codex 默认优先使用 WebSocket 进行流式传输。虽然效率高,但对本地代理非常敏感。WebSocket 握手(Upgrade)、TLS 隧道、长连接保持等环节只要出现一点抖动,就会触发自动重连机制,通常重试约 5 次。
网上很多同类文章的解法是「换个节点」「重试几次」,这些都是在治标。本文的思路不一样:不换节点、不改重试次数,而是彻底放弃 WebSocket,强制使用代理兼容性更好的 HTTP/SSE(Server-Sent Events) 流式响应。
五、详细修复步骤
步骤 1:完全关闭 Codex Desktop
步骤 2:备份配置文件
配置文件路径:
- Windows:
C:\Users\你的用户名\.codex\config.toml - macOS / Linux:
~/.codex/config.toml
如果找不到这个文件,先随便运行一次 codex --version,让 Codex 生成默认配置后再继续。
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 配置示例
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),或更换低延迟节点。
