跳到正文

Codex CLI 代理配置教程:连接失败、stream disconnected 怎么解决(Windows / macOS / Linux)

Codex CLI 报 stream disconnected、登录失败、请求超时?本文讲清 Codex 稳定机场的选择标准,并给出 Windows、macOS、Linux 终端代理与 TUN 模式的完整配置步骤和排错方法。

作者 发布 更新 阅读约 2 分钟

⚡ 要点速览

  • Codex CLI 运行在终端,默认不走系统代理,必须设置 HTTPS_PROXY 或开启 TUN 模式。
  • Codex 稳定机场看三点:OpenAI 支持地区节点、低丢包专线、长连接不被重置。
  • 用 curl 访问 api.openai.com 返回 401 说明网络已通,问题在账号或配置。
  • 长任务频繁中断,优先换 IEPL / IPLC 专线节点,而不是换更快的节点。

Codex 是 OpenAI 面向开发者的编程智能体,有命令行(Codex CLI)、IDE 插件和云端任务三种用法。在国内使用时,最常见的问题不是打不开,而是跑到一半断掉。

这篇文章分两部分:先讲 Codex 稳定机场怎么选,再手把手配置终端代理。

Codex 为什么比网页版 ChatGPT 更挑网络

网页版 ChatGPT 的每次请求都很短,偶尔丢一个包,刷新一下就好。Codex 不一样:

  • 一个任务可能持续几分钟到几十分钟;
  • 期间需要持续接收模型的流式输出;
  • 中途连接被重置,任务就会报 stream disconnected 之类的错误。

所以 Codex 稳定机场 的核心指标是「长连接稳定」,而不是测速软件里的峰值速度。

Codex 长任务完成率(30 分钟任务 × 20 次) 越高越好 · 单位 %
IEPL 专线 100 ★ IPLC 专线 95 BGP 中转 85 公网直连 60

不同线路类型下 Codex CLI 长任务一次性跑完的比例,样本为本站测试环境,仅供参考。

查看原始数据
节点 / 项目Codex 长任务完成率(30 分钟任务 × 20 次)(%)
IEPL 专线100
IPLC 专线95
BGP 中转85
公网直连60

第一步:确认网络能通

在配置 Codex 之前,先用 curl 确认终端能访问 OpenAI:

curl -I https://api.openai.com/v1/models
  • 返回 HTTP/2 401:网络是通的(401 只是因为没带 API Key)。
  • 卡住或超时:终端没有走代理,继续往下看。

第二步:为终端设置代理

先在客户端(如 Clash Verge Rev)设置页找到 混合端口,Clash Verge Rev 默认是 7897,旧版 Clash 常见 7890。下面以 7897 为例。

Windows(PowerShell)

$env:HTTP_PROXY  = "http://127.0.0.1:7897"
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
codex

想永久生效,可以把这两行写进 PowerShell 配置文件(执行 notepad $PROFILE 打开)。

macOS / Linux

export http_proxy=http://127.0.0.1:7897
export https_proxy=http://127.0.0.1:7897
export all_proxy=socks5://127.0.0.1:7897
codex

想永久生效,把上面三行追加到 ~/.zshrc 或 ~/.bashrc。

第三步:常见报错排查

报错 / 现象 可能原因 解决办法
stream disconnected 节点丢包或长连接被重置 换专线节点;关闭「自动选择最快节点」
登录页打不开 / 回调失败 浏览器与终端走了不同出口 使用同一节点或开启 TUN
unsupported_country_region_territory 节点地区不受支持 换美国 / 日本 / 新加坡节点
请求超时 终端没走代理 检查环境变量与端口

Codex 稳定机场推荐

可信云的线路偏向办公场景优化,在我们的 Codex 长任务与 GitHub 测试中表现最稳,适合每天用 Codex 写代码的开发者。

想要专线速度与更多节点,宇宙云的 IEPL 专线同样适合长任务,年付折合 8 元/月起,性价比更高。

更多机场的 Codex 支持情况见 Codex 稳定机场专题。

本文提到的机场

可信云

办公学习 · ChatGPT 与 GitHub 稳定

#10

¥25 /月 · 150GB/月 8.8 分

企业级内网专线 不限时
  • Claude :部分节点
  • Codex :稳定可用
  • ChatGPT :稳定可用
  • Gemini :稳定可用
  • ChatGPT、Codex 与 GitHub 访问稳定,长连接不易断
  • 海外办公平台(Google Workspace、Notion、Slack)体验好
  • 150G 流量适合中高频用户
访问官网 ↗

宇宙云

五年老牌 · IEPL 专线综合旗舰

#1

¥8 /月 · 60GB/月 9.6 分

IEPL 专线 70+ 节点 不限时 码 YUZHOU553
  • Claude :稳定可用
  • Codex :稳定可用
  • ChatGPT :稳定可用
  • Gemini :稳定可用
  • 运营五年的老牌机场,长期稳定性有口碑
  • 全线 IEPL 专线,晚高峰速度波动小
  • 70+ 节点,Netflix、Disney+ 与 ChatGPT、Claude、Gemini 全解锁
访问官网 ↗

常见问题

Codex CLI 一直卡在登录界面怎么办?

Codex 登录时会打开浏览器完成授权并回调到本机端口。确保浏览器和终端使用同一个代理节点,并且没有其他程序占用回调端口。

设置了 HTTPS_PROXY 还是连不上?

先确认端口号与客户端里的混合端口一致,再用 curl -I https://api.openai.com 测试。如果 curl 能通而 Codex 不通,尝试改用 TUN 模式。

Codex 适合用香港节点吗?

不适合。OpenAI 不对香港地区提供服务,请使用美国、日本、新加坡等节点。

机场一哥

长期付费使用并横向对比数十家机场,日常重度使用 Claude、Codex 与 ChatGPT 写代码和做研究。所有推荐都基于自己掏钱的连续测试。

相关推荐