1. 连接失败不是网络问题，是超时与上下文协商机制被误判了很多人在执行codex --help或codex suggest时看到Error: request to https://api.openai.com/v1/chat/completions failed, reason: connect ETIMEDOUT就立刻断定“国内连不上 OpenAI”，然后开始翻找各种中转、代理、镜像方案。我试过 17 种组合，在三个不同 ISP 的办公网、家庭宽带和云服务器上反复验证——真正卡住 CLI 的，从来不是 DNS 解析失败或 TCP 连接被重置，而是 Node.js HTTP 客户端在默认配置下，对 TLS 握手延迟、首字节响应（TTFB）和流式 chunk 分发节奏的容忍阈值，远低于国内真实网络路径的波动特征。举个具体例子：某次实测中，curl -v https://api.openai.com/v1/models能在 820ms 内返回完整 JSON，但codex list却稳定超时。抓包发现，CLI 发起的是带Connection: keep-alive和Transfer-Encoding: chunked的 POST 请求，服务端在 TLS 握手后需约 350ms 初始化推理上下文，再花 120–480ms 返回首个 chunk。而 Codex CLI 默认的timeout是 10s，highWaterMark是 16KB，
国内网络环境下 OpenAI Codex CLI 连接失败？5 种超时与代理配置方案实测有效
发布时间：2026/5/19 23:49:50
1. 连接失败不是网络问题，是超时与上下文协商机制被误判了很多人在执行codex --help或codex suggest时看到Error: request to https://api.openai.com/v1/chat/completions failed, reason: connect ETIMEDOUT就立刻断定“国内连不上 OpenAI”，然后开始翻找各种中转、代理、镜像方案。我试过 17 种组合，在三个不同 ISP 的办公网、家庭宽带和云服务器上反复验证——真正卡住 CLI 的，从来不是 DNS 解析失败或 TCP 连接被重置，而是 Node.js HTTP 客户端在默认配置下，对 TLS 握手延迟、首字节响应（TTFB）和流式 chunk 分发节奏的容忍阈值，远低于国内真实网络路径的波动特征。举个具体例子：某次实测中，curl -v https://api.openai.com/v1/models能在 820ms 内返回完整 JSON，但codex list却稳定超时。抓包发现，CLI 发起的是带Connection: keep-alive和Transfer-Encoding: chunked的 POST 请求，服务端在 TLS 握手后需约 350ms 初始化推理上下文，再花 120–480ms 返回首个 chunk。而 Codex CLI 默认的timeout是 10s，highWaterMark是 16KB，
