使用 Codex 时,如果请求一直重连,等了好几次才开始回复,可以先检查本地代理配置。

最近看到一则社区分享:作者在更新后遇到反复重连,配置本地代理后,连接恢复正常,等待时间也缩短了。这里把操作方法简单整理一下,作为遇到类似问题时的一条排查思路。1

配置方法

原帖提供的方法是在 Windows 用户目录下的 .codex 文件夹中创建 .env 文件,例如:

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

写入以下内容,注意使用英文半角引号:

HTTP_PROXY="http://127.0.0.1:10809"
HTTPS_PROXY="http://127.0.0.1:10809"
ALL_PROXY="socks5://127.0.0.1:10809"

端口要以自己的代理软件设置为准。 上面的 10809 只是原帖示例,不能直接当作所有人的默认端口。

  • HTTP_PROXY 和 HTTPS_PROXY 填本地 HTTP 代理地址。
  • ALL_PROXY 示例使用 SOCKS5,应填代理软件实际提供的 SOCKS5 地址。
  • 如果 HTTP 与 SOCKS5 使用不同端口,应分别填写;只有支持两种协议的混合端口,才适合照示例填同一个端口。

保存后,确认文件名是 .env,而不是 .env.txt,再完全退出并重新打开所使用的 Codex 客户端,观察重连是否减少。

关于原因和效果

原帖将问题归因于 WebSocket 连接失败,并描述了“重连五次后才降级到 HTTP”的现象。这属于作者当时的排查结论,不能仅凭截图确定所有重连问题都有相同原因。

OpenAI 官方配置参考确实包含 Responses API 的 WebSocket 传输支持选项,但这不能证明上述重试次数或 .env 方法适用于所有客户端版本。2

截至 2026 年 10 月 2 日,本文查阅的官方配置文档未确认 ~/.codex/.env 是所有 Codex 客户端通用的代理配置入口;上述步骤按社区经验整理,尚未在本文中实测。

如果配置后没有改善,可以继续检查代理是否启动、端口是否正确,以及当前客户端是否读取了这些环境变量。原帖提到的“响应变快”也应理解为其使用环境下的观察,不能保证每个人都有相同效果。


  1. 用户提供的社区帖子截图,标题为《Codex重连5次,最后一次才连通解决方法》。截图未提供原帖链接、明确发布日期或客户端版本。 ↩︎

  2. OpenAI 官方文档:Configuration Reference,参见 model_providers.<id>.supports_websockets。查阅日期:2026-10-02。 ↩︎