Codex 总是重连 5 次?代理配置与远程离线排查教程
明明已经登录 Codex,也打开了代理,发一句简单的问题却反复显示「正在重新连接 / Reconnecting」,有时要重试 5 次才开始回答;拿手机查看任务,电脑又显示「设备离线」。这期视频就来解决这类使用痛点。
本文整理自 Redman 的博客原文,保留视频、开源工具和可复制提示词,并按当前脚本补齐操作细节。
更新说明
原文发布于 2026-08-22,本站整理于 2026-09-05。GitHub 当前脚本采用临时代理启动方式,默认端口为 7897,不会自动探测端口或写入 .env。以下将脚本启动与 .env 配置分开说明;具体效果取决于客户端版本和实际网络。
先看视频
这篇解决什么问题
重点排查「浏览器能访问,但 Codex 的连接不稳定」这一类代理问题,适合已经有可用代理、仍反复重连的 Windows 和 macOS 用户。还没有装好客户端,可以先看下载与安装教程。
Codex 的交互涉及持续传输和连接状态。网页访问正常,并不能证明桌面应用使用的连接也走了同一条可用路线。原文的排查思路是:检查本地代理端口与 Codex 启动环境,让支持代理变量的连接使用明确的代理地址。
但「重连 5 次」只是症状,不能仅凭次数断定原因。端口写错、代理软件退出、节点不通、电脑睡眠或服务异常,都可能表现为连接失败。本文是社区排障方法,不承诺所有重连或远程离线都能靠一份配置解决。
TUN 模式和全局规则有什么区别?
TUN 是接管网络流量的一种方式;「规则 / 全局」决定流量如何分流,两者不是同一个开关。TUN 也可以配合规则分流使用,实际行为取决于代理客户端。
如果希望先缩小排查范围,可以从 Codex 的进程代理入手。不要把开启 TUN 当作唯一修复方式,也不要假设它一定会拖慢所有国内访问。
开始前确认代理端口
打开代理客户端的设置,找到 HTTP 端口或 Mixed 混合端口,确认客户端正在运行、节点能正常连接,再记录端口号。
| 项目 | 要确认的内容 |
|---|---|
| HTTP / Mixed 端口 | 支持本文的 http://127.0.0.1:端口号 写法 |
| SOCKS5 端口 | 不能直接当作 HTTP 端口填写;优先启用 HTTP / Mixed |
| 常见示例 | 7890、7897 都只是示例,以你的客户端设置为准 |
| Codex 启动状态 | 保存任务后完全退出旧进程,再用新配置启动 |
仅看到某个端口在监听,还不足以证明它是 HTTP 代理。应结合代理客户端设置确认协议类型。
方法一:Windows 代理启动脚本
适用于通过 Microsoft Store 安装 Codex Desktop 的 Windows 用户。当前仓库提供的是 codex-proxy.cmd 启动脚本。
1. 下载脚本
打开 codex-proxy 仓库,使用 Code → Download ZIP 下载并解压,或者打开仓库中的 codex-proxy.cmd 下载原始文件。使用脚本不需要先 Fork;觉得有帮助,欢迎给项目点 Star。
2. 改成自己的端口
用记事本打开 codex-proxy.cmd。当前默认的两行是:
set "HTTP_PROXY=http://127.0.0.1:7897"
set "HTTPS_PROXY=http://127.0.0.1:7897"
如果你的 HTTP / Mixed 端口是 7890,就把两处 7897 都改成 7890,然后保存。这里 HTTPS_PROXY 的值使用 http://,描述的是本地 HTTP 代理的协议,不是目标网站的协议。
3. 完全退出 Codex,再双击启动
先保存当前工作并完全退出 Codex,保持代理客户端运行,然后双击 codex-proxy.cmd。以后要继续使用这套临时代理设置,也通过该脚本启动。
脚本通过 Windows 软件包信息查找 Codex。若提示找不到 OpenAI.Codex,先确认 Microsoft Store 安装状态;其他安装来源不一定适用这个启动器。
脚本实际做了什么?
当前源码使用 setlocal 设置本次进程的 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY,清空本次进程的 ALL_PROXY,再定位并启动应用。它不会修改 Windows 系统代理,也不会创建或更新 Codex 的 .env 文件。
恢复普通启动方式:完全退出这次通过脚本打开的 Codex,再从原来的快捷方式打开。若你还做过方法二的持久配置,需要另外恢复那部分改动。
方法二:让 Codex 检查并配置 .env
原文还提供了通过提示词辅助配置用户目录 .env 的方法,适合希望先查看修改方案的用户。它与上面的临时启动脚本是两条独立路线,建议先选一种验证,避免同时改多处后难以判断哪一处生效。
先认准目标文件
默认用户目录下的目标是:
| 系统 | 默认位置 |
|---|---|
| Windows | C:\Users\你的Windows用户名\.codex\.env |
| macOS | /Users/你的Mac用户名/.codex/.env,即 ~/.codex/.env |
Windows 可按 Win + R,输入 %USERPROFILE%\.codex 打开默认目录。如果设置过 CODEX_HOME,应先确认当前实例实际使用的目录。
目标文件名是 .env,不是 auth.json,也不是当前项目里的 .codex/.env。原文中的 /Users/~/.codex/.env 不是正确的绝对路径写法。客户端是否读取这份环境文件,需要按实际版本验证;不能只看到文件存在就认定已生效。
可以直接复制的提示词
请帮我排查“不打开 TUN 时 Codex 反复 Reconnecting / 正在重新连接”的问题,按以下步骤操作:
1. 先只读检查当前系统、Codex 的启动方式、本地代理客户端和端口。优先确认 HTTP 或 Mixed 混合端口;不要把 SOCKS5 端口误当作 HTTP 端口,也不要只凭端口号猜测协议。
2. 确认当前 Codex 是否设置了 CODEX_HOME,以及此版本和启动方式是否会读取其中的 .env。默认目录是用户主目录下的 .codex。不能确认时先说明,不要猜测。
3. 检查目标 .env 是否存在。已有文件只修改或追加代理相关变量,保留无关内容;检查已有 ALL_PROXY 等变量是否冲突。不要读取或展示 auth.json、API Key、Cookie 等凭据。
4. 修改前展示目标文件的绝对路径、确认过的代理协议与端口、准备变更的代理行和备份方式。无关配置不必展示,敏感值必须隐藏。目标不是项目目录里的 .codex/.env。
5. 确认 HTTP / Mixed 端口后,准备设置 HTTP_PROXY、HTTPS_PROXY、http_proxy、https_proxy,值为 http://127.0.0.1:实际端口;NO_PROXY 和 no_proxy 的值为 localhost,127.0.0.1,::1。若当前环境变量名称不区分大小写,请说明并按实际系统处理。
6. 如果只有 SOCKS5 端口,先停止写入,告诉我如何在代理客户端开启 HTTP / Mixed;不要自行写入 ALL_PROXY。只有我明确要求 SOCKS5 兜底时,才评估当前版本是否支持并另行展示方案。
7. 等我确认方案后再备份和写入。完成后说明如何完全退出并重启 Codex、如何验证聊天与手机远程连接,以及如何恢复备份。不要替我立即关闭正在工作的 Codex。
这段提示词让 AI 先查环境,再展示具体改动。确认端口、路径与修改内容符合你的情况后,再回复「确认写入」。如果 Codex 当前完全无法响应,可以先用 Windows 脚本恢复连接,或在明确端口和文件位置后手动配置。
HTTP / Mixed 配置示例
假设已确认端口为 7890,代理相关内容可参考下方。合并到已有文件时保留其他内容,不要整份覆盖。
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890
http_proxy=http://127.0.0.1:7890
https_proxy=http://127.0.0.1:7890
NO_PROXY=localhost,127.0.0.1,::1
no_proxy=localhost,127.0.0.1,::1
NO_PROXY 用于让列出的本机地址跳过代理。配置写好后,代理客户端仍需要保持运行;如果以后改了端口,也要同步更新这里。
重启后如何验证
- 保存工作,完全退出 Codex,再按所选方法重新启动。
- 发送一个简单问题,观察是否能正常开始并完成回答;再测试一个稍长的任务,确认不是只恢复了第一条请求。
- 查看代理客户端连接记录,确认测试期间有对应连接通过预期端口。聊天成功并不自动证明所有后台连接都已使用代理。
- 打开手机端,检查电脑在线状态,再进入一个桌面任务查看进度。电脑应保持运行、联网和唤醒。
如果 .env 修改后更差,恢复本次修改前的备份并重启;如果文件是本次新建的,只撤销本次新增代理项,确认没有其他内容后再考虑移除文件。不要删除整个 .codex 目录或登录凭据。
常见问题
| 现象 | 优先检查 |
|---|---|
| 双击脚本提示找不到 Codex | 是否使用 Microsoft Store 安装,软件包是否完整 |
| 仍反复重连 | 实际 HTTP / Mixed 端口、代理是否运行、旧 Codex 进程是否完全退出 |
| 配置后直接无法连接 | 端口是否写错、是否误填 SOCKS5、是否存在旧代理变量冲突 |
| 重启电脑后又失败 | 代理客户端是否启动,端口是否变化,是否仍通过脚本启动 |
| 聊天恢复,手机仍显示离线 | 电脑是否睡眠、两端账号和设备授权状态、网络或防火墙是否拦截 |
| 仅某个节点失败 | 切换到已知可用节点对比,区分节点与本地配置问题 |
手机端连接设置可继续看安卓手机远程操控和手机端协同桌面任务。代理配置解决不了电脑关机、账号不一致等问题。
需要为了修复重连升级 Plus 吗?
先排查网络。订阅额度和连接故障是不同问题,升级套餐不能保证修复端口或代理配置错误。可用套餐、额度和模型以账号页面的实时信息为准。
需要订阅时优先查看官方入口;原视频提到的第三方服务是 AI Plus 123,优惠码 redman,详情见本站服务说明。它不是 OpenAI 官方服务,价格、优惠与售后以当前页面为准;推广链接或优惠码可能为 Redman 带来佣金。
Redman 实测建议
先确认端口,再选一种配置方法,最后分别验证聊天和手机在线状态。把改动限制在可回滚的范围内,后续更换代理软件或端口时,也容易找到该更新的位置。
如果这期内容帮到了你,欢迎给 codex-proxy 点 Star,或订阅 Redman 的 YouTube 频道。
来源与延伸阅读
- Redman 博客原文:Codex 频繁重新连接与远程离线
- 配套视频:Codex 五次重连排查
- codex-proxy README 与当前脚本:本文的 Windows 启动步骤按仓库实际内容整理。
- Codex 桌面 App 下载与安装
- 手机端协同桌面任务
