跳到正文

Codex 一直 Reconnecting:代理排查 7 步

几分钟判断 Codex 是卡在代理、出口 IP,还是本机设置上。

最常见的 3 个原因

Codex 被告知要用的代理已经不在了。终端里残留的 HTTPS_PROXY、HTTP_PROXY、ALL_PROXY,或者 Codex 主目录里 .env 文件的同名行,可能还指着你已经关掉的本地客户端,比如 127.0.0.1:7890。Codex 只会报它没连上的 OpenAI 地址,看起来像是 OpenAI 或网络故障。

代理地址不是 Codex 能用的格式。Codex 先读 HTTPS_PROXY,再读 ALL_PROXY,不支持 socks5:// 开头的地址。http://账号:密码@主机:端口 这样的 HTTP 代理地址可以用,SOCKS5 的不行。

连接建好了,但回答流式输出到一半被掐断。Codex 用长连接接收回答。代理、防火墙或杀毒软件如果会关掉空闲或时间太长的连接,回答就会在中途中断,Codex 把它报成断流。

看到什么,先查哪里

看到什么,先查哪里
项目可能的原因先查
failed to connect … Connection refused,随后从 WebSockets 回退到 HTTPS代理地址后面没有程序在监听下面第 2、3 步
stream disconnected before completion: error sending request for url到 OpenAI 地址不通:代理地址写错、端口被拦,或本网络必须走代理第 1、4 步
一直 Reconnecting…,但浏览器能上浏览器走系统代理,终端没走(或反过来)第 1 步和配置教程
短回答能完成,长回答才断代理或防火墙有空闲或总时长限制第 6 步

报错原文取自 2026 年 11 月 19 日读到的 openai/codex GitHub issue;「先查」一栏是我们自己排的检查顺序,不是官方清单。

按顺序查 7 项

  1. 第 1 步:看 Codex 拿到哪些代理变量

    在启动 codex 的同一个终端里运行下面的首条命令。HTTPS_PROXY 优先,ALL_PROXY 是后备,NO_PROXY 列出不走代理的地址。桌面应用或编辑器插件里设的代理,终端看不到;反过来也一样。

    预期结果 能看到 Codex 将要尝试的代理地址,或者什么都没有。

  2. 第 2 步:看 Codex 自己的 .env

    Codex 会读主目录里的 .env(默认 ~/.codex,或 CODEX_HOME 指定的目录)。有用户在 openai/codex 的 issue 38885 里反馈,那里一行旧的 HTTPS_PROXY 指向已关闭的本地端口,就造成了本页说的这些症状。用第二条命令打印代理行(会隐藏密码),先备份,再删掉或改正过期的行。

    预期结果 没有代理行,或只有你认得的行。

  3. 第 3 步:确认本地代理真的在运行

    如果变量指向 127.0.0.1 或 localhost,检查这个端口上是否有程序在监听(第三条命令;Windows 用 netstat -ano)。没有就启动你的代理客户端,或者删掉这个变量。

    预期结果 端口上能看到监听的进程。

  4. 第 4 步:不经过 Codex 单独测代理

    把你的真实信息代入,运行第四条命令。返回 HTTP 200 和 JSON,说明代理和出口是通的。超时、407 或连接被重置,说明问题在代理地址、账号密码或网络上,先按下面的几篇教程把代理本身修好。

    预期结果 通过代理访问 ipinfo.io 返回 HTTP 200。

  5. 第 5 步:用 HTTP 代理地址,不用 SOCKS5

    把 HTTPS_PROXY 设成 http://LOGIN:PASSWORD@HOST:PORT。如果你手里只有 socks5:// 的行,改用同一账号的 HTTP 入口。密码里的特殊字符要做 URL 编码。

    预期结果 codex 能启动,首条提示能流式返回。

  6. 第 6 步:排除链路上的时间限制

    分别发一条短提示和一条长提示,再换到不走代理、不开 VPN 的干净网络(比如手机热点)重复一遍。只有走代理时长回答才断,限制就在这条链路上(代理、防火墙、杀毒软件、公司的 TLS 检查)。公司有 TLS 代理的,登录前把 CODEX_CA_CERTIFICATE 指向 PEM 证书文件。

    预期结果 同一条提示在干净网络里能完成。

  7. 第 7 步:看出口 IP 和账号一侧

    代理是通的,登录或请求仍被拒,就看出口国家是否在 OpenAI 支持的国家名单里,再看这个 IP 的信誉。被标记的出口可能失败,干净的固定出口则可能正常。

    预期结果 出口国家在 OpenAI 支持的名单里,IP 没被标记。

第 1 到 4 步用的四条命令

# 1) which proxy variables does Codex see in this shell?
env | grep -i _proxy

# 2) proxy lines saved in Codex's own .env (hide passwords before pasting anywhere)
grep -iE '_proxy' "${CODEX_HOME:-$HOME/.codex}/.env" | sed -E 's#//[^@/]*@#//***@#'

# 3) is a local proxy (for example 127.0.0.1:7890) really listening? (macOS/Linux)
lsof -nP -iTCP:7890 -sTCP:LISTEN

# 4) does the proxy itself work? HTTP proxy URL, same form as HTTPS_PROXY
curl -sS -o /dev/null -w '%{http_code}\n' -x http://LOGIN:PASSWORD@HOST:PORT https://ipinfo.io/json

仅为示例:把 LOGIN、PASSWORD、HOST、PORT 换成你自己的值;7890 只是举例的端口。

症状对不上时

每次一启动 codex 就 Reconnecting

检查 环境里的代理变量和 Codex 主目录里的 .env(第 1、2 步)。

处理 删掉过期的行,或启动它指向的代理,然后重启 codex。

停止条件 如果 .env 是空的、也没有设任何变量,到第 2 步就可以停:代理不是原因。

curl 能通,Codex 不行

检查 Codex 用的是它自己环境里的 HTTPS_PROXY 或 ALL_PROXY,不看浏览器设置;socks5:// 的值会被拒绝。

处理 在启动 codex 的终端里导出 http:// 开头的代理地址。

停止条件 同一个 HTTP 地址在 curl 和 Codex 里都失败,就换个出口测,不要去改 Codex。

只有长回答才断

检查 代理链路上的超时(第 6 步)。

处理 和干净网络对比;自己搭的代理可以调大空闲超时。

停止条件 别一直重启 Codex:同一条链路还会再掐断流。

用 Proxy302 给 Codex 一个稳定的 HTTP 出口

如果你自己的代理总掉线,可以用固定的静态 ISP 地址,选 HTTP 入口(端口 2222),给 Codex 一个稳定出口:每个 IP 1 天 US$0.50、30 天 US$7.99,每个 IP 用购买时选的协议,给 Codex 用就选 HTTP。没有免费试用,最小购买是 1 个 IP 用 1 天。

下单后到「我的资产」,把 HOST、PORT、USERNAME、PASSWORD 填进 HTTPS_PROXY。启动 Codex 之前先用 ipinfo.io 查出口,确认国家在 OpenAI 支持的名单里。任何代理都不能保证账号永远不被限制。

常见问题

Codex 报 stream disconnected before completion 是什么意思?

意思是流式回答在 Codex 收到完成信号之前就结束了。经过代理时,常见原因是代理地址连不上、代理地址格式 Codex 用不了,或者链路会掐断长连接。按第 1 到 6 步排查。

Codex CLI 能用 SOCKS5 代理吗?

不能。Codex 使用 HTTPS_PROXY,其次 ALL_PROXY,会拒绝 socks5:// 开头的地址。请用 HTTP 代理地址,配置教程里有完整写法。

Codex 一直 Reconnecting,浏览器却能上网,为什么?

浏览器走系统代理或扩展,终端程序只看这个终端的环境变量和 Codex 自己的 .env。按第 1、2 步对比一下。

Codex 的 .env 文件在哪?

在 Codex 主目录:默认是 ~/.codex/.env,或 CODEX_HOME 指定的目录。看看里面有没有旧的代理行;不要整份贴到公开的 issue,因为代理地址里可能带密码。

是代理的问题,还是 OpenAI 自己出故障?

在不走代理、不开 VPN 的干净网络里跑同一条提示。那边能完成、走代理才失败,就是代理链路的问题。两边都失败,就查 OpenAI 的状态和你的登录。

延伸阅读

Proxy302 在 GitHub 上公开的同主题配置指南:

参考资料

4
  1. openai/codex issue 38885:CODEX_HOME 里残留的代理配置

    外部网站资料 · 确认日期:

    2026 年 11 月 19 日读到:一位用户把「failed to connect to websocket … Connection refused」、从 WebSockets 回退到 HTTPS,以及「stream disconnected before completion」,追到 Codex 主目录 .env 里指向本地无监听端口的代理行;把该文件从主目录移走后恢复正常。

  2. openai/codex 源码:outbound_proxy.rs

    官方文档 · 确认日期:

    2026 年 11 月 19 日读到:Codex 对 HTTPS 和安全 WebSocket 连接先取 HTTPS_PROXY,再取 ALL_PROXY,遵守 NO_PROXY,并有「不支持的代理协议」错误;所读源码构建 HTTP 客户端时没有 SOCKS 支持。

  3. Codex 认证文档

    官方文档 · 确认日期:

    2026 年 11 月 19 日读到:公司有 TLS 代理时,可用 CODEX_CA_CERTIFICATE 指定 PEM 证书文件,用于登录。

  4. Proxy302 产品信息与价格表

    产品观察 · 确认日期:

    本站产品信息文件,2026 年 11 月 10 日至 19 日核对:静态 ISP 每个 IP 1 天 US$0.50、30 天 US$7.99,HTTP 端口 2222,协议在购买时选择,没有免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。