Windows 实测：通过 .env 为 Codex减少频繁重连与流式输出中断

首先大家要明白文中为避免和谐写的**是啥
在 Windows 上使用 Codex 时，如果经常遇到下面这些情况，可以优先尝试本文的方法：

正在重新连接 1/5...
正在重新连接 2/5...

或者在生成代码、长文本、设计稿时中途报错：

stream disconnected before completion
Transport error: network error
error decoding response body

本文只介绍一种处理方式：

在 Codex 的用户配置目录中创建 .env 文件，明确告诉 Codex 使用哪个本地转发端口。

这个方法不需要修改系统级网络设置，影响范围比 TUN 模式更小，也比较容易恢复原状。

---

一、先理解：这个方法解决的是什么问题？

****工具已经开启，并不代表每个应用都一定会稳定走**工具。

浏览器通常能够很好地识别系统**，但桌面客户端、命令行工具或其内部网络组件，可能存在以下情况：

• 没有正确读取系统**；
• 部分请求走**，部分请求没有走**；
• 普通请求可以完成，但持续时间较长的流式连接不稳定；
• **软件切换节点或网络波动后，客户端没有及时恢复连接。

Codex 生成内容时需要持续接收服务端返回的数据。连接链路不稳定时，就容易出现反复重连或生成到一半中断。

在 .env 文件中写入**环境变量，相当于给 Codex 一个更明确的网络出口：

Codex
  ↓
127.0.0.1:你的本地**端口
  ↓
**软件
  ↓
外部网络

这样可以减少 Codex 依赖“系统**自动识别”时出现的遗漏。

二、开始前：找到你自己的**端口

打开你正在使用的**软件

在设置界面中找到：

• HTTP 端口；或者
• 支持 HTTP **的 Mixed Port / 混合端口。

请记下这个端口号。

本文不会写死某个端口，因为每个人的**软件和配置都可能不同。后面出现：

<你的**端口>

时，请替换成你自己软件中显示的实际端口。

[!WARNING]
不要把 SOCKS 端口直接当成 HTTP 端口填写。本文模板使用的是：

http://127.0.0.1:<你的**端口>

因此应填写 HTTP 端口，或明确支持 HTTP **的混合端口。

---

三、手动创建 .env 配置文件

第一步：打开 Codex 用户配置目录

按下：

Win + R

在“运行”窗口中输入：

%USERPROFILE%\.codex

然后按回车。

通常会打开下面这个目录：

C:\Users\你的用户名\.codex

如果你已经正常使用过 Codex，通常可以在其中看到类似文件：

auth.json

如果 .codex 文件夹不存在，可以手动新建一个名称为：

.codex

的文件夹。

---

第二步：新建 .env 文件

在 .codex 文件夹空白处：

1. 鼠标右键；
2. 选择“新建”；
3. 选择“文本文档”；
4. 将文件完整重命名为：

.env

文件最终路径必须是：

C:\Users\你的用户名\.codex\.env

---

第三步：确认文件不是 .env.txt

这是 Windows 用户最容易踩的坑。

Windows 默认可能隐藏已知文件类型的扩展名。你看到的文件名虽然像是：

.env

实际却可能是：

.env.txt

Codex 无法按预期读取这个文件。

建议在文件资源管理器中开启：

查看 → 显示 → 文件扩展名

然后再次确认文件完整名称确实是：

.env

而不是：

.env.txt

---

第四步：写入**配置

使用记事本打开 .env 文件，写入以下内容：

HTTP_PROXY="http://127.0.0.1:<你的**端口>"
HTTPS_PROXY="http://127.0.0.1:<你的**端口>"
NO_PROXY="localhost,127.0.0.1,::1"

将两处：

<你的**端口>

替换为你刚才查到的实际端口号。

保存文件。

---

四、为什么要写这三行？

HTTP_PROXY

HTTP_PROXY="http://127.0.0.1:<你的**端口>"

告诉 Codex：处理 HTTP 请求时，使用本机软件提供的端口。

HTTPS_PROXY

HTTPS_PROXY="http://127.0.0.1:<你的**端口>"

告诉 Codex：处理 HTTPS 请求时，也通过这个本机**端口建立连接。

这里写成：

http://127.0.0.1:...

是正常的。

它表示 Codex 通过 HTTP 协议连接你电脑上的本地软件，并不代表访问外部网站时会把 HTTPS 降级成 HTTP。

NO_PROXY

NO_PROXY="localhost,127.0.0.1,::1"

表示访问本机服务时，不要绕行**。

这对开发环境很重要。例如你访问：

localhost
127.0.0.1

上的本地服务时，通常不希望请求先进入**软件。

---

五、彻底退出并重新启动 Codex

保存 .env 文件后，不要只关闭窗口。

建议执行以下操作：

1. 完全退出 Codex；
2. 检查 Windows 系统托盘中是否仍有 Codex 图标；
3. 如果仍然存在，右键选择退出；
4. 重新打开 Codex；
5. 新建一个对话进行测试；
6. 再尝试生成一段较长的内容，观察是否还会中途断开。

如果配置生效，通常会看到：

• 启动后反复 Reconnecting... 的情况减少；
• 流式输出更加稳定；
• 长内容生成中途报网络错误的概率下降。

---

六、推荐：用 PowerShell 一键创建，避免 .env.txt 问题

手动创建文件时，Windows 的隐藏扩展名很容易造成误判。

更稳妥的方式是使用 PowerShell，让脚本自动询问你的**端口并生成 .env 文件。

操作步骤

1. 打开开始菜单；
2. 搜索并打开 PowerShell；
3. 复制下面的完整脚本；
4. 按回车执行；
5. 根据提示输入你自己的 HTTP 端口或 Mixed Port。

$proxyPort = Read-Host "请输入**软件中的 HTTP 端口或 Mixed Port"

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null

@"
HTTP_PROXY="http://127.0.0.1:$proxyPort"
HTTPS_PROXY="http://127.0.0.1:$proxyPort"
NO_PROXY="localhost,127.0.0.1,::1"
"@ | Set-Content -Encoding utf8 "$env:USERPROFILE\.codex\.env"

Write-Host ""
Write-Host "已生成配置文件：$env:USERPROFILE\.codex\.env"
Write-Host "请彻底退出 Codex 后重新打开。"

执行完成后，再彻底退出并重新启动 Codex。

---

七、可选检查：确认本地**端口确实可用

如果配置后仍然没有效果，可以先确认**软件是否真的在本机监听这个端口。

在 PowerShell 中执行：

$proxyPort = Read-Host "请输入你写入 .env 的**端口"
Test-NetConnection -ComputerName 127.0.0.1 -Port $proxyPort

重点查看：

TcpTestSucceeded

如果显示：

True

说明这个本地端口能够连接。

如果显示：

False

通常说明：

• **软件没有启动；
• 端口号填写错误；
• 你填的是另一个协议的端口；
• **软件配置已经改变。

---

八、最终目录结构

配置完成后，目录大致如下：

C:\Users\你的用户名\.codex\
├── auth.json
└── .env

.env 内容如下：

HTTP_PROXY="http://127.0.0.1:<你的**端口>"
HTTPS_PROXY="http://127.0.0.1:<你的**端口>"
NO_PROXY="localhost,127.0.0.1,::1"

---

九、仍然频繁断连时，按顺序排查

1. 文件路径是否正确？

必须是：

C:\Users\你的用户名\.codex\.env

不要放到桌面，也不要放到 Codex 安装目录。

2. 文件名是否正确？

必须是：

.env

不能是：

.env.txt

3. 端口是否正确？

确认填写的是当前**软件正在使用的：

HTTP 端口

或支持 HTTP **的：

Mixed Port

4. **软件是否已经启动？

.env 只是告诉 Codex 去连接本机某个端口。

如果**软件没有运行，这个端口无人监听，Codex 反而无法联网。

5. 是否彻底重启 Codex？

修改 .env 后，需要让 Codex 进程重新启动，才能重新读取配置。

6. 当前**节点是否稳定？

如果本地端口已经连通，但仍然频繁断开，问题可能出在：

• 当前**节点质量；
• 本地网络波动；
• 客户端自身异常；
• 服务端临时故障。

.env 能解决的是“Codex 没有稳定使用指定本地**”的问题，不是所有网络问题。

---

十、是否还需要开启 TUN 模式？

可以先不开。

.env 和 TUN 模式解决问题的层级不同：

方法	作用范围	特点
.codex\.env	Codex 应用级	更精准，影响较小，便于排查
系统**	系统或部分应用	简单，但不同应用识别情况不一致
TUN 模式	更底层的系统流量	覆盖更广，但影响范围也更大

对于 Codex 频繁重连问题，建议优先尝试 .env。

如果 .env 已经生效，就没有必要仅仅为了 Codex 强行开启 TUN 模式。

---

十一、如何恢复原状？

这个方法很容易撤销。

打开：

C:\Users\你的用户名\.codex

删除：

.env

或者将它重命名为：

.env.bak

然后彻底退出并重新启动 Codex。

---

十二、安全提醒

建议**地址只使用本机回环地址：

127.0.0.1

不要随意改成来源不明的公网**地址。

另外，不要将下面这些文件直接发给别人：

auth.json
.env

尤其是 auth.json，其中可能包含与登录状态相关的敏感信息。

分享截图时，也建议检查是否暴露了用户名、账号信息或其他隐私内容。

---

十三、最简操作总结

在下面这个位置创建文件：

C:\Users\你的用户名\.codex\.env

写入：

HTTP_PROXY="http://127.0.0.1:<你的**端口>"
HTTPS_PROXY="http://127.0.0.1:<你的**端口>"
NO_PROXY="localhost,127.0.0.1,::1"

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

如果你的问题来自 Codex 没有稳定使用本地端口，这个方法通常比单纯依赖系统更直接，也比一上来开启 TUN 模式更有针对性。