问题排查 Codex 专题
Codex 无法连接怎么办：CLI 超时、登录授权失败、云端任务打不开的排查
Codex 无法连接的排查：区分本地 CLI 超时或 fetch failed、登录授权时浏览器与终端出口不一致、云端任务页面打不开三种情况，对应终端代理未配置、节点地区、规则覆盖的原因与处理。
Codex 连不上要先分清是本地 CLI 还是云端任务。两者原因完全不同。
按形态分类
| 现象 | 形态 | 原因 |
|---|---|---|
| 终端提示 timeout、fetch failed、ECONNREFUSED | CLI | 终端未走代理 |
| 登录时浏览器授权后终端仍未登录 | CLI | 浏览器与终端出口不一致 |
| 任务中途断开 | CLI | 节点抖动或自动切换 |
| chatgpt.com 中 Codex 页面打不开 | 云端 | 与 ChatGPT 网页同源 |
| 提示地区不可用 | 两者 | 节点地区不支持 |
CLI 超时或连接被拒
终端程序不读系统代理。先验证：
curl -I https://api.openai.com超时说明终端没走代理。三种解决：
- 环境变量：
export HTTPS_PROXY=http://127.0.0.1:7897（Windows PowerShell 用$env:HTTPS_PROXY = "..."），端口以客户端为准。 - TUN 模式：客户端开启后终端自动走代理，见 Clash Verge TUN 模式。
- 规则确认：规则模式下 openai.com 相关域名命中代理。
ECONNREFUSED 通常是端口写错或客户端未运行。完整配置见 Codex 网络环境。
登录授权失败
Codex CLI 登录会打开浏览器完成 ChatGPT 授权，然后回调终端。浏览器走系统代理、终端走环境变量，两者必须指向同一客户端与同一节点。浏览器直连或走了另一个代理，授权就失败。
处理：确认系统代理已开，环境变量端口与客户端一致，同一策略组同一节点，重新执行登录。
任务中途断开
长连接对抖动敏感。公网中转线路晚高峰抖动、策略组自动切换出口 IP 都会导致断开。
- 换专线节点，见 AI 稳定线路怎么选。
- openai.com 域名策略组改为手动选择，固定节点。
云端任务打不开
与 ChatGPT 网页同源：香港节点不可用，规则要覆盖 chatgpt.com、openai.com、oaistatic.com。排查见 ChatGPT 打不开。
选服务
Codex CLI 需要专线与固定节点，见 Codex 机场推荐。API 层面的错误见 API 连接失败。
常见问题
- Codex 网页能用，CLI 连不上？
- 终端不读系统代理。设置 HTTPS_PROXY 环境变量或开启 TUN 模式后重试。
- Codex CLI 登录时浏览器授权失败？
- 浏览器与终端走了不同出口。确认两者使用同一客户端、同一节点，重新登录。
- Codex 任务跑到一半断了？
- 长连接抖动或策略组自动切换节点。换专线节点，策略组改为手动选择固定。