核心结论
Codex 能否稳定使用取决于三点:终端或编辑器本身走代理(设置 HTTPS_PROXY 或开启 TUN 模式)、出口地区在 OpenAI 支持范围内且 IP 信誉良好、线路低丢包且任务期间不切换节点。浏览器能打开 ChatGPT 不代表 Codex CLI 也能连上。
Codex 连不上,先看这三个条件
OpenAI Codex 是 OpenAI 的 AI 编程代理,目前主要有三种形态:Codex CLI(终端工具)、IDE 插件(在 VS Code 等编辑器中使用)以及 ChatGPT 中的云端 Codex。它们都依赖稳定访问 OpenAI 服务,网络上要同时满足:
- 程序本身走代理:云端 Codex 在浏览器里运行,跟随系统代理即可;Codex CLI 和 IDE 插件运行在本地进程中,未必会使用系统代理。
- 出口地区受支持:以 OpenAI 官方公布的支持国家和地区列表为准,中国大陆和中国香港都不在支持范围内。
- 连接足够稳定:一次代码任务可能持续数分钟、包含多轮请求和流式输出,丢包或中途切换节点都会导致任务失败。
一句话判断:云端 Codex 能用只说明浏览器网络正常;Codex CLI 能不能用,要看终端的网络。
三种形态的网络差异
| 形态 | 运行位置 | 是否自动走系统代理 | 主要风险点 |
|---|---|---|---|
| 云端 Codex(ChatGPT 内) | 浏览器 | 是 | 地区限制、人机验证、IP 信誉 |
| Codex CLI | 本地终端 | 通常不会 | 终端未走代理、长任务断流 |
| IDE 插件 | 编辑器进程 | 视编辑器代理设置而定 | 编辑器代理配置、登录回调 |
第一步:安装并登录 Codex CLI
Codex CLI 可以通过 npm 安装(需要先安装 Node.js):
npm i -g @openai/codex
codex
首次运行时可以选择使用 ChatGPT 账号登录,或者使用 OpenAI API Key。选择 ChatGPT 账号登录时,CLI 会打开浏览器完成授权,再把结果回调给本地终端。如果 npm 下载本身很慢,说明安装阶段也需要走代理,可以先完成下一步的环境变量设置再安装。
第二步:让终端和编辑器走代理
先在客户端里确认本地代理端口。以 Clash Verge Rev 为例,混合端口默认通常是 7897,具体可参考 Clash Verge 使用教程。
Windows(PowerShell)
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:NO_PROXY = "localhost,127.0.0.1"
codex
macOS / Linux(zsh 或 bash)
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1
codex
多数命令行工具会读取这些环境变量,但也有例外。NO_PROXY 的作用是让本地回调地址不经过代理,避免登录授权后终端收不到结果。如果设置环境变量后依然连不上,或者某个工具明显忽略了代理设置,更省心的办法是在客户端中开启 TUN 模式,由虚拟网卡接管全部流量。
IDE 插件则需要检查编辑器自身的代理设置(例如 VS Code 的 http.proxy 配置项),或者同样依靠 TUN 模式解决。
第三步:验证 OpenAI 服务是否连通
在已设置代理的终端里执行:
curl -I https://api.openai.com/v1/models
- 返回
HTTP/2 401之类的状态行:网络已连通,401 只是因为没有携带 API Key; - 长时间无响应或
Connection timed out:终端没有走代理,或节点不可用,可参考节点超时解决方法; - 返回
403并提示地区不受支持:出口 IP 所在地区不在支持范围内,详见 Region Not Supported 报错解析。
第四步:选择适合 Codex 的节点
Codex 对节点的要求和 Claude Code 网络环境 类似,稳定性比峰值速度更重要:
| 指标 | 建议 | 原因 |
|---|---|---|
| 地区 | OpenAI 支持地区,如美国、日本、新加坡 | 香港节点无法使用 |
| IP 质量 | 原生 IP 或信誉良好的数据中心 IP | 滥用过的共享 IP 易触发验证 |
| 丢包率 | 越低越好,晚高峰也要稳定 | 丢包直接导致流式输出中断 |
| 节点策略 | 手动固定,不用自动测速组 | 中途切换会改变出口地区 |
| 线路 | IEPL / IPLC 专线或优质中转 | 晚高峰更稳,见线路怎么选 |
如果现有订阅在晚高峰经常断流,可以参考 AI 稳定机场推荐 中的筛选方法。在本站收录的品牌中,目前只有二猫云的 Codex 经过实测可用(美国、日本、新加坡节点,专线丢包 0.3%);光速云家宽实测丢包 0.2%、ChatGPT 实测可用,但 Codex 暂无测试数据,选择前请以自己的实测为准。更多品牌的 AI 实测情况见 AI 机场排行榜。
常见问题排查
登录授权后终端一直等待
通常是浏览器与终端出口不一致,或者本地回调被代理拦截。确认已设置 NO_PROXY,并让浏览器和终端使用同一个节点后重新登录。
任务执行到一半报错或卡住
优先排查三件事:
- 客户端是否开启了“自动选择 / URL 测试”类代理组;
- 当前是否处于晚高峰,节点丢包是否明显升高;
- 同一台电脑上是否在进行大流量下载,挤占了带宽。
云端 Codex 页面打不开
云端 Codex 在 ChatGPT 网页中使用,排查思路与 ChatGPT 一致,可直接参考 ChatGPT 网络环境指南。需要注意的是,云端 Codex 的代码任务在 OpenAI 的云端环境中执行,本地网络只影响页面加载、提交任务和查看结果,不会影响任务本身的运行速度。
提示额度用尽或请求过多
如果报错内容与使用额度、请求频率有关(例如出现 429 状态码或“达到使用上限”一类提示),通常不是网络问题,而是账号套餐额度或 API 调用频率受限。此时更换节点并不能解决,应等待额度重置、调整调用频率,或检查 API 账户余额,具体规则以 OpenAI 官方说明为准。
让长任务更稳定的小技巧
Codex 的一次任务往往要读取多个文件、执行命令并多轮生成代码,持续时间明显长于普通对话。除了选好节点,下面几项设置也能减少中途失败:
- 分流规则中固定 OpenAI 域名:在客户端规则中让 OpenAI 相关域名走一个手动选择的代理组,其他流量照常分流,避免被自动测速组“顺手”切走。
- 避开网络高峰执行大任务:晚上八点到十一点是多数线路的拥堵时段,重构类大任务可以放在白天执行。
- 拆分任务:把一个大需求拆成几个小步骤,单次请求时间越短,受网络波动影响越小,失败后重试的成本也更低。
- 保持客户端与内核更新:旧版客户端在长连接处理上可能存在已知问题,定期更新可以减少莫名断流。
- 有线优先:条件允许时使用有线网络,家用无线信号不稳定同样会造成丢包。
使用建议
- 为 AI 编程单独准备一个固定的稳定节点,不和下载、视频共用自动切换策略;
- API Key 等同于付费凭证,不要写进公开仓库或分享给他人;
- 请遵守所在地法律法规以及 OpenAI 的使用条款与支持地区政策。
常见问题
Codex CLI 用什么账号登录?
Codex CLI 支持两种方式,一是用 ChatGPT 账号登录(会打开浏览器完成授权,使用额度与订阅计划相关),二是使用 OpenAI API Key 按量计费。具体可用的套餐与额度以 OpenAI 官方说明为准。
浏览器能打开 ChatGPT,为什么 Codex CLI 提示连接失败?
浏览器会读取系统代理,而多数终端程序默认不会。需要在终端里设置 HTTPS_PROXY 与 HTTP_PROXY 环境变量,或者在客户端中开启 TUN 模式,让命令行流量也经过代理。
Codex 任务执行到一半断开怎么办?
长任务期间会持续流式传输,最常见的原因是线路丢包或客户端自动测速切换了节点。建议手动固定一个支持地区的稳定节点,晚高峰优先使用专线或优质中转线路。
Codex 适合选哪个地区的节点?
只在 OpenAI 支持的国家和地区中选择,优先延迟较低且 IP 纯净的地区,例如美国、日本、新加坡。香港节点不在 OpenAI 支持范围内,不要用于 Codex。
本文最后更新于 。网络服务与 AI 平台政策变化较快,如发现信息过时,欢迎通过联系我们反馈。