Connection error 和超时：本地网络清单

用 AI 编程工具 Codex 开工，终端刚发起任务就被甩回一句 Connection error，请求根本没跑起来——与任务中途断开的 stream disconnected 不同，这类报错发生在连接建立之前或之初，病灶几乎都在本机与本地网络。公司网、代理、TLS 证书、杀毒软件是四类最常见的拦截者，症状相似、处理各异，逐项排查比盲目重装高效得多。这篇给一份按序打勾的本地网络清单，再教你用 curl 把问题先挡在工具之外。

先分清两种报错：连不上与连着断

Connection error 与超时是两类信号，处理方向不同。Connection error 多是请求压根没能建立连接：本地端口被拦、域名解析失败、证书握手被掐，都属于这一类。超时则是连接建立了、响应迟迟不来，或者响应中途停住直到计时器到点。判断办法很朴素：看报错是秒回还是久等——秒回多为本地拦截，本地根本没让请求出门；久等之后才报错，则偏向链路中间或远端。分清这一步，后面的排查方向就定了：本地拦截按下面清单逐项过，链路问题才需要往上一层的排查走。

清单前两项：公司网与代理

公司网络是本地拦截的第一高发地。企业出口普遍走代理：一是环境变量层面，HTTP_PROXY 与 HTTPS_PROXY 指向的代理若没有放行 Codex 的接口域名，请求会直接失败；二是设备层面，出口的流量审计设备与长连接、流式响应相性不佳，握手阶段的异常也时有发生。判断是否公司网的锅，最干净的办法是换网络对照：同一台机器连手机热点再跑一次，好了就是办公网环境问题，代理相关的环境变量与白名单配置见代理配置专项一篇。另外注意区分时机：如果是任务中途才断而非开头就报错，那属于长连接被掐的另一类问题，见stream disconnected 排查一篇，两篇清单配合使用。

清单后两项：TLS 证书与杀软

第三项查证书。企业代理若做 HTTPS 解密，会用自签证书替换原始证书，本机不信任这张自签证书时，TLS 握手直接失败，表现同样是 Connection error。特征也明确：浏览器访问正常——浏览器装了企业根证书；命令行工具报错——它没走同一套信任库。处理方向是让命令行环境信任企业证书，具体做法在代理配置专项一篇有展开。第四项查杀毒软件与防火墙：安全软件的网络防护功能有时会把不认识的命令行进程拦下来，表现为请求被无声丢弃或直接拒绝。临时退出安全软件再测一次，若立刻恢复，就去它的信任列表里把终端与 Codex 加进去，长期开着拦截硬扛没有意义。

curl 直测：把网络问题与工具问题切开

清单过完仍有疑点时，用 curl 直测隔离变量。向 Codex 使用的接口域名发一个最简单的请求，看返回的是正常应答、证书报错还是连接拒绝：正常应答说明本地到服务端的通路是好的，问题在工具配置或凭据侧，登录失效一类报错的分辨与处理见401 处理一篇；证书报错对上第三项；连接拒绝或解析失败对上代理与 DNS。curl 走的是与多数命令行工具相同的系统网络栈，它的结果能代表这条路通不通，一句话把网络问题与工具问题切开。企业网特征也顺手记两条：同一栋楼里同事集体报错、报错时间集中在工作时段、换热点立愈——三条中两条，基本可以按公司网问题整理材料上报 IT。想让清单更贴合自己的环境，可以让 DeepSeek 把本文四项清单扩成带勾选框的排查表，填入你的系统与网络环境，再用豆包查一查你所用安全软件的网络防护怎么临时关闭，实测一次对照结果最直观。

Connection error 本地网络清单

• 先分清：秒回报错偏本地拦截，久等报错偏链路远端
• 第一项公司网代理：换热点对照，查环境变量与白名单
• 第二项 TLS 证书：浏览器正常而命令行报错是特征
• 第三项杀软防火墙：临时退出实测，恢复即加信任列表
• curl 直测接口域名，网络问题与工具问题一刀切开

Connection error 怎么办速查

• 重装 Codex 能解决吗？：多数不能。该报错病灶在本地网络环境而非工具本身，先按清单排查网络侧，重装属于最后手段，装完问题照旧的概率很高。
• 家庭网络也会遇到吗？：会。路由器的安全功能、本机代理类工具的残留路由、过期的系统证书都可能拦截请求，排查思路相同，只是高发程度低于企业网。
• 换网络就好了，接下来怎么办？：锁定办公网环境后，把 curl 直测的结果一起交给 IT，说明被拦的域名与报错类型，申请代理放行，比自己反复折腾终端配置更快更稳。