Codex network_error 网络错误解决方法使用 Codex 时遇到network_error通常不是代码本身的问题而是本机到接口服务之间的网络链路有一段不通。比较常见的场景是执行codex登录、拉取模型列表、提交任务时卡住最后提示 network_error或者在公司网络、代理环境、服务器终端里能访问网页但 Codex 命令行就是连不上。排查这类问题不要一上来重装 Codex。建议先确认三件事当前终端有没有走代理、DNS 是否能解析、接口地址是否能建立 TLS 连接。下面按我平时排错的顺序整理一遍。一、常见错误现象不同版本的 Codex 输出略有差异但大致会出现下面几类提示### token云桥中转 0029.org ### network_error failed to fetch request failed connection timeout TLS handshake failed ECONNRESET ENOTFOUND api.openai.com如果是在 Windows 的 PowerShell、macOS 终端、Linux 服务器里运行表现可能不一样。比如本地浏览器能打开网页但终端没有继承代理配置或者服务器只允许访问内网直接请求外部接口会超时。二、先判断是不是网络链路问题1. 检查 Codex 版本和当前环境先确认命令本身可用避免把安装问题误判成网络问题codex --version node -v npm -v如果codex --version都无法正常输出先处理安装路径、Node 版本或包管理器问题。只有 Codex 能启动但请求时报network_error才继续往网络方向查。2. 测试 DNS 解析很多服务器环境里DNS 配置不稳定会导致偶发ENOTFOUNDnslookup api.openai.com # Linux/macOS 也可以用 dig api.openai.com如果解析失败先换 DNS。Linux 可以临时测试cat /etc/resolv.conf # 临时写入公共 DNS注意这会影响当前机器解析 sudo sh -c echo nameserver 1.1.1.1 /etc/resolv.conf sudo sh -c echo nameserver 8.8.8.8 /etc/resolv.conf生产服务器不要随便长期改/etc/resolv.conf有些系统会被 NetworkManager 或 systemd-resolved 自动覆盖建议按系统网络配置规范处理。3. 测试接口连通性用curl看能不能连到接口。这里不要求返回成功业务结果只看是否能建立连接curl -I https://api.openai.com/v1/models如果返回401反而说明网络基本通了只是没有带认证信息。比较需要关注的是超时、连接被重置、TLS 失败curl: (6) Could not resolve host curl: (7) Failed to connect curl: (35) SSL connect error curl: (56) Recv failure: Connection reset by peer这些基本都指向 DNS、代理、防火墙、证书或出口网络问题。三、逐步修复 network_error1. 配置终端代理浏览器能访问不代表终端能访问。Codex 走的是命令行环境变量先检查当前代理echo $HTTP_PROXY echo $HTTPS_PROXY echo $ALL_PROXYmacOS/Linux 临时配置示例export HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890 export ALL_PROXYsocks5://127.0.0.1:7890Windows PowerShell 示例$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890端口要按你本机代理工具实际监听端口填写不一定是 7890。配置后重新执行curl -I https://api.openai.com/v1/models codex --version如果curl仍然不通先不要纠结 Codex说明底层网络还没处理好。2. 清理错误的代理变量有时 network_error 不是没代理而是代理变量写错了。例如之前配置了一个已经不存在的代理端口Codex 每次都往错误地址发请求。macOS/Linux 清理unset HTTP_PROXY unset HTTPS_PROXY unset ALL_PROXY unset http_proxy unset https_proxy unset all_proxyWindows PowerShell 清理Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue Remove-Item Env:ALL_PROXY -ErrorAction SilentlyContinue清理后再按需要重新设置正确代理。3. 检查 API Key 和基础地址如果你使用了自定义接口地址或中转服务要确认环境变量没有写错。常见变量包括echo $OPENAI_API_KEY echo $OPENAI_BASE_URLWindows PowerShellecho $env:OPENAI_API_KEY echo $env:OPENAI_BASE_URLOPENAI_BASE_URL末尾是否多了空格、路径是否重复、协议是否写错都会导致请求异常。比如有些人把/v1写了两次最后请求路径变成/v1/v1/models表现也可能像网络失败。如果你所在网络长期访问不稳定或者团队里多台机器都要接入实践中我会优先考虑稳定的 API 中转方案比如 token云桥AI中转站 0029.org。关键是把基础地址、密钥权限、模型名称这几项核对清楚别只看能不能打开网页。4. 处理 IPv6 导致的连接异常部分网络环境下 DNS 会优先返回 IPv6但实际 IPv6 出口不可用表现为连接超时。可以用下面命令观察curl -4 -I https://api.openai.com/v1/models curl -6 -I https://api.openai.com/v1/models如果-4正常、-6超时可以临时禁用 IPv6或调整系统优先使用 IPv4。服务器上不建议盲目关 IPv6先确认业务是否依赖。5. 公司网络或服务器防火墙限制公司内网、云服务器安全组、出口网关都可能限制外连。可以测试 443 端口nc -vz api.openai.com 443 # 没有 nc 时可以用 telnet telnet api.openai.com 443如果 443 都连不上需要找网络出口规则而不是继续改 Codex 配置。云服务器还要检查安全组、NAT 网关、代理网关是否允许出站访问。四、修复后的验证方式网络修好后不要只跑一次 Codex 就结束。建议按下面顺序验证# 1. DNS 是否正常 nslookup api.openai.com # 2. HTTPS 是否能建立连接 curl -I https://api.openai.com/v1/models # 3. 带 Key 测试接口 curl https://api.openai.com/v1/models \ -H Authorization: Bearer $OPENAI_API_KEY # 4. 再执行 Codex codex如果第三步返回模型列表或权限相关 JSON说明网络和认证已经基本正常。若 Codex 仍然报network_error再检查 Codex 自身配置文件、版本兼容和环境变量是否被不同 shell 覆盖。五、避免再次出现 network_error代理端口变更后同步更新终端环境变量不要只改代理软件界面。服务器部署时把 DNS、代理、API Key、Base URL 写进明确的启动脚本或环境配置里。不要在多个地方重复配置OPENAI_BASE_URL容易出现本地和 CI 环境不一致。遇到超时先用curl验证链路别直接重装 Codex。团队环境建议统一出口方式减少每个人本机配置不同导致的排错成本。总结Codex 的network_error大多数是 DNS、代理、TLS、IPv6、出口防火墙或接口地址配置引起的。排查时先用nslookup、curl、nc确认底层网络再检查代理变量和 API 配置。只要按链路一层层验证通常能很快定位到问题点。