常见症状
- 运行后长时间无输出,最终提示请求超时
- 反复出现
Reconnecting...提示 - 出现
stream disconnected before completion - 浏览器授权完成后,终端一直停在等待登录
- 返回
unsupported_country_region_territory或 401、429 等错误
先试这几步
- 查看 OpenAI 状态页
- 在运行 codex 的终端设置
HTTPS_PROXY,并设置NO_PROXY=localhost,127.0.0.1 - 固定一个 OpenAI 支持地区的节点,关闭自动切换
- 长任务频繁断开时,换用稳定性更高的线路
核心结论
- 超时且无任何输出:多数是终端未走代理。
- stream disconnected:流式响应中途被断开,偶发属正常,频发说明线路不稳定。
- 登录卡住:localhost 回调被代理拦截。
- 401、429、地区错误不是线路质量问题。
先给错误分类
| 错误 | 类别 | 换节点有用吗 |
|---|---|---|
| 请求超时、无任何输出 | 网络(未走代理或节点不可用) | 可能有用,先查代理配置 |
stream disconnected before completion |
网络(连接中途断开) | 有用 |
频繁 Reconnecting... |
网络(线路不稳定) | 有用 |
| 登录卡在等待 | 本地配置(回调被拦截) | 无用 |
unsupported_country_region_territory(403) |
地区 | 需换「地区」而非换速度 |
401 |
账号授权 | 无用 |
429 / 用量限制 |
用量 | 无用 |
5xx |
服务端 | 无用 |
问题一:请求超时,没有任何输出
Codex CLI 是命令行程序,不读取系统代理。确认三件事:
- 环境变量在同一个终端中设置:在 A 窗口设置、在 B 窗口运行是无效的;
- 端口号正确:与代理客户端中的 HTTP / 混合端口一致;
- 代理本身可用:
export HTTPS_PROXY=http://127.0.0.1:7897
curl -I https://api.openai.com
curl 能返回响应头,说明网络通了;curl 也超时,说明问题在代理客户端或节点,参考 机场节点全部超时。
不想每次设置环境变量,可以开启 TUN 模式,见 为终端 AI 工具配置代理。
问题二:stream disconnected 与反复重连
Codex 的模型响应以流式方式返回。如果连接在响应完成之前被关闭,就会出现 stream disconnected before completion,Codex 随后会自动重连重试。
偶尔出现:属于正常现象,Codex 会自行恢复。
频繁出现:按以下顺序处理:
- 关闭自动切换:
url-test类策略组会在任务中途切换节点,导致连接断开。为 OpenAI 相关域名设置手动选择的策略组; - 换节点对比:同一地区换几个节点,观察重连频率;
- 看时段:只在晚高峰频繁,说明线路在拥堵时段丢包严重;
- 检查本地网络:Wi‑Fi 不稳定也会导致断开,有条件时用有线网络对比;
- 换线路类型:仍然频繁时,说明当前线路不适合长任务,参考 Codex 稳定机场。
问题三:登录卡住
使用 ChatGPT 账号登录时,浏览器授权完成后会跳转到本机的 localhost 地址,把凭证交给 CLI。下列情况会导致回调失败:
- 环境变量
HTTP_PROXY生效,但没有设置NO_PROXY,CLI 内部访问 localhost 也走了代理; - 浏览器代理扩展把 localhost 请求转发到了代理。
处理:
export NO_PROXY=localhost,127.0.0.1
然后重新执行登录。浏览器侧检查代理扩展的「不代理的地址列表」是否包含 localhost。
问题四:地区不受支持
返回 unsupported_country_region_territory 或类似地区提示,说明请求出口不在 OpenAI 支持范围内。处理方法是换到 官方支持地区 的落地节点。注意先确认请求真的走了代理——未走代理时,出口就是你的本地网络。
问题五:账号与用量
401:重新登录,或检查 API Key 是否正确、是否被撤销;429:触发速率或用量限制,等待重置或调整订阅/计费方案;- 这两类问题与机场无关,换节点不会改变结果。
求助时提供的信息
- Codex CLI 版本(
codex --version)、操作系统; - 完整的错误原文(去除凭证信息);
- 是否设置了代理环境变量、是否使用 TUN 模式;
curl -I https://api.openai.com的结果;- 问题出现的时段与频率。
常见问题
Codex CLI 提示 stream disconnected before completion 怎么办?
偶尔出现时 Codex 会自动重试,通常无需处理。如果频繁出现,先固定一个稳定节点并关闭自动切换;仍然频繁时,说明当前线路不适合长时间流式连接,可以换用稳定性更高的线路。
Codex 登录后终端一直显示等待怎么办?
浏览器授权后会回调到本机 localhost。请确认 NO_PROXY 包含 localhost 和 127.0.0.1,并检查代理客户端没有把本地地址转发到代理。
401 错误是网络问题吗?
不是。401 表示认证失败,例如 API Key 无效或登录已过期。重新登录或检查 API Key。