网络诊断API 连接错误

Codex CLI 网络问题指南:请求超时、stream disconnected 与登录失败

Codex CLI 的错误可以分成四类:网络连接、账号授权、服务可用性和产品使用。本文先帮你分类,再针对网络类问题给出排查步骤。

作者:机场博客编辑部发布:更新:约 2 分钟阅读

API 连接错误

常见症状

  • 运行后长时间无输出,最终提示请求超时
  • 反复出现 Reconnecting... 提示
  • 出现 stream disconnected before completion
  • 浏览器授权完成后,终端一直停在等待登录
  • 返回 unsupported_country_region_territory 或 401、429 等错误

先试这几步

  1. 查看 OpenAI 状态页
  2. 在运行 codex 的终端设置 HTTPS_PROXY,并设置 NO_PROXY=localhost,127.0.0.1
  3. 固定一个 OpenAI 支持地区的节点,关闭自动切换
  4. 长任务频繁断开时,换用稳定性更高的线路

核心结论

  • 超时且无任何输出:多数是终端未走代理。
  • stream disconnected:流式响应中途被断开,偶发属正常,频发说明线路不稳定。
  • 登录卡住:localhost 回调被代理拦截。
  • 401、429、地区错误不是线路质量问题。

先给错误分类

错误 类别 换节点有用吗
请求超时、无任何输出 网络(未走代理或节点不可用) 可能有用,先查代理配置
stream disconnected before completion 网络(连接中途断开) 有用
频繁 Reconnecting... 网络(线路不稳定) 有用
登录卡在等待 本地配置(回调被拦截) 无用
unsupported_country_region_territory(403) 地区 需换「地区」而非换速度
401 账号授权 无用
429 / 用量限制 用量 无用
5xx 服务端 无用

问题一:请求超时,没有任何输出

Codex CLI 是命令行程序,不读取系统代理。确认三件事:

  1. 环境变量在同一个终端中设置:在 A 窗口设置、在 B 窗口运行是无效的;
  2. 端口号正确:与代理客户端中的 HTTP / 混合端口一致;
  3. 代理本身可用:
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 会自行恢复。

频繁出现:按以下顺序处理:

  1. 关闭自动切换:url-test 类策略组会在任务中途切换节点,导致连接断开。为 OpenAI 相关域名设置手动选择的策略组;
  2. 换节点对比:同一地区换几个节点,观察重连频率;
  3. 看时段:只在晚高峰频繁,说明线路在拥堵时段丢包严重;
  4. 检查本地网络:Wi‑Fi 不稳定也会导致断开,有条件时用有线网络对比;
  5. 换线路类型:仍然频繁时,说明当前线路不适合长任务,参考 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。

资料来源与数据性质

返回上级专题Codex 稳定机场选择指南区分 Codex CLI、IDE 插件与云端任务的网络需求,分析 stream disconnected、请求超时等常见问题,说明 Codex 长任务场景下如何选择稳定的网络服务。