Codex CLI 代理配置教程:连接失败、stream disconnected 怎么解决(Windows / macOS / Linux)
Codex CLI 报 stream disconnected、登录失败、请求超时?本文讲清 Codex 稳定机场的选择标准,并给出 Windows、macOS、Linux 终端代理与 TUN 模式的完整配置步骤和排错方法。
⚡ 要点速览
- 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 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 稳定
¥25 /月 · 150GB/月 8.8 分
- Claude :部分节点
- Codex :稳定可用
- ChatGPT :稳定可用
- Gemini :稳定可用
- ChatGPT、Codex 与 GitHub 访问稳定,长连接不易断
- 海外办公平台(Google Workspace、Notion、Slack)体验好
- 150G 流量适合中高频用户
宇宙云
五年老牌 · IEPL 专线综合旗舰
¥8 /月 · 60GB/月 9.6 分
- 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 不对香港地区提供服务,请使用美国、日本、新加坡等节点。
相关推荐
AI 编程工具怎么用?Cursor、GitHub Copilot、Codex、Claude Code 官网下载与网络配置
2026 主流 AI 编程工具对比:Cursor、GitHub Copilot、OpenAI Codex、Claude Code 的官网下载链接、安装方式与适合人群,以及国内开发者的代理 / TUN 网络配置和适合写代码的稳定机场推荐。
能用 ChatGPT、Claude、Gemini 的机场推荐:20 家机场 AI 解锁实测对比(2026)
2026 AI 机场推荐:实测 20 家机场对 ChatGPT、Claude、Codex、Gemini 的解锁情况,一张表看清哪些机场能稳定用 AI,附 Claude 全解锁机场、AI 选机场标准与常见问题。
AI 用户机场「一主一备」方案:主力机场 + AI 专用机场怎么搭配
重度 AI 用户的机场搭配方案:为什么要一主一备、主力机场和 AI 专用机场分别怎么选、Clash 分流规则怎么写,附 4 套按预算的机场组合推荐。
便宜又能用 AI 的机场推荐:20 元以内稳定使用 ChatGPT 的机场(2026)
预算 20 元以内也能稳定用 AI:按价格排序的便宜 AI 机场推荐,实测 ChatGPT、Codex、Gemini、Claude 可用性,附学生党省钱方案与优惠码。