Codex 网络环境完整指南：CLI、IDE 插件与云端任务的连接要求

先说结论：Codex 的三层网络条件

直接回答开头的问题：Codex 能不能用，取决于三层条件是否同时成立。第一层是地区，出口必须位于 OpenAI 官方支持的国家或地区；第二层是程序是否走代理，Codex CLI 与 IDE 插件运行在终端和编辑器里，通常不受系统代理控制；第三层是线路稳定性，Codex 的任务往往持续几分钟甚至更久，依赖一条不中断的流式连接。

很多人卡在第二层：浏览器里 ChatGPT 一切正常，终端里的 Codex 却一直超时。这不是账号问题，也不一定是节点问题，而是终端的请求根本没有进入代理。

重要中国大陆与中国香港不在 OpenAI 官方支持地区列表中。地区支持会随官方政策调整，本文所有地区相关表述均以官方支持地区列表为准，请遵守服务条款与当地法律法规。

Codex 的几种形态与网络差异

Codex 是 OpenAI 面向编程场景的 AI 工具，常见形态包括命令行工具、IDE 插件和在云端执行的任务。它们连接 OpenAI 的方式不同，排查时要先确认自己用的是哪一种。

云端任务在 OpenAI 的环境中执行，本地网络只影响你提交任务和查看结果的过程；而 CLI 与 IDE 插件的每一次对话、每一段流式输出，都直接依赖本机网络。

第一层：地区与账号

Codex 的可用性与 ChatGPT 账号、OpenAI 平台账号相关联。网络层面需要注意：

• 出口地区：请求从哪个地区发出，由当前节点的出口 IP 决定。节点名称不一定与实际归属一致，必要时核实 IP 归属地。
• 地区一致性：浏览器登录、终端请求、API 调用最好使用同一地区出口，避免账号在短时间内出现在多个地区。
• 登录方式：可以使用 ChatGPT 账号登录，也可以使用 API Key。前者走浏览器授权流程，后者直接在请求中携带密钥，两者的额度与计费以官方说明为准。

注意API Key 等同于账号凭据，不要写进公开仓库、截图或分享给他人。只在本机环境变量或官方推荐的方式中保存。

第二层：让 Codex 的请求进入代理

Codex CLI

Codex CLI 可以通过 npm 安装（npm install -g @openai/codex），其他安装方式以官方文档为准。它运行在终端中，有两种让它走代理的方式：

1. 设置环境变量：HTTPS_PROXY、HTTP_PROXY 指向代理客户端的混合端口，NO_PROXY 排除本地地址。端口以客户端显示的混合端口为准，例如 http://127.0.0.1:7897。
2. 开启 TUN 模式：代理客户端在网络层接管所有程序的流量，无需逐个配置。

macOS / Linux 的临时写法：

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

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"

持久化配置、WSL 与远程服务器等场景，见 Codex CLI 代理设置教程。

登录回调：最容易被忽略的一步

使用 ChatGPT 账号登录 Codex CLI 时，流程大致是：终端启动一个本地监听端口，打开浏览器完成授权，授权结果再由浏览器回调到本地端口。这个过程有两个常见故障点：

• 浏览器访问 localhost 被代理接管：某些浏览器插件或全局代理设置会把本地地址也转发出去，回调就失败了。确保本地地址直连，NO_PROXY 中包含 localhost 与 127.0.0.1。
• 防火墙或安全软件拦截本地端口：表现为浏览器提示授权成功，终端却一直等待。

在没有图形界面的远程服务器上登录，可以使用 API Key，或者通过 SSH 端口转发把回调端口转到本机，具体端口以终端提示的回调地址为准。

IDE 插件

IDE 插件运行在编辑器进程中。部分编辑器有自己的代理设置项，但插件是否遵循取决于具体实现。如果设置了编辑器代理仍然连接失败，最稳妥的做法是开启 TUN 模式，让编辑器的全部流量都经过代理。

第三层：线路与稳定性

Codex 的典型工作方式是：读取代码、规划修改、执行命令、再根据结果继续推理。整个过程依赖持续的流式连接，因此对线路的要求与刷网页不同：

如果你正在挑选适合编程场景的服务，Codex 稳定机场推荐 按 CLI 与长连接稳定性给出了选择思路。

容易混淆的问题：沙箱联网与代理

Codex CLI 在执行命令时会使用沙箱机制来限制可访问的文件和网络。默认配置下，Codex 代你执行的命令（例如安装依赖、拉取远程资源）可能无法联网。这与 Codex 自身连接 OpenAI 是两回事：

• Codex 本身连不上：表现为无法对话、请求超时，属于代理或线路问题；
• Codex 能对话，但执行的命令联网失败：多数与沙箱的网络权限有关，按官方文档中关于沙箱与审批模式的说明调整。

区分这两种情况，可以避免在代理设置上反复折腾。

五分钟自检：按顺序定位问题

遇到「Codex 用不了」时，按下面的顺序检查，每一步都能排除一类原因：

1. 浏览器能否打开 ChatGPT。打不开说明节点或地区有问题，先解决节点，再看终端。
2. 同一终端能否连通 OpenAI。执行 curl -I https://api.openai.com/v1/models，返回 401 等状态码说明网络已通；超时说明终端没有走代理。
3. 环境变量是否在当前终端生效。macOS / Linux 执行 env | grep -i proxy，Windows PowerShell 执行 Get-ChildItem Env:*proxy*，确认变量存在且端口正确。
4. TUN 模式对照。临时开启 TUN 再试一次，若恢复正常，说明问题出在环境变量或程序不读取变量。
5. 登录状态。网络通但仍报认证错误，重新执行登录流程，或检查 API Key 是否有效。
6. 线路稳定性。能连上但经常中断，多数是晚高峰丢包或节点在任务中途被切换。

提示排查时一次只改一个变量。同时更换节点、修改环境变量、重装 CLI，即使问题解决了也不知道真正的原因，下次还会再遇到。

团队与公司网络中的额外情况

在公司或学校网络中使用 Codex，还可能遇到以下情况：

• 网络本身有出口代理：此时 HTTPS_PROXY 应指向公司代理，是否允许访问 OpenAI 以单位规定为准；
• HTTPS 流量检查：安全设备替换了证书，终端会出现证书校验错误，需要由网络管理员提供受信任的证书配置；
• 安全软件拦截本地端口：影响登录回调，需要在安全软件中放行，或改用 API Key 登录。

这些情况与个人代理配置无关，自行绕过可能违反单位规定，建议先与管理员沟通。

常见错误与对应处理

具体报错的逐项排查，可以参考 Codex 无法连接怎么办。

推荐配置清单

• 节点位于 OpenAI 官方支持地区，且已核实出口 IP 归属
• 为 AI 编程工具单独建立手动选择的策略组，固定一个节点
• 终端已设置 HTTPS_PROXY / HTTP_PROXY / NO_PROXY，或已开启 TUN
• 浏览器、终端与 IDE 使用同一地区出口
• API Key 只保存在本机安全位置
• 在晚高峰实际跑过一次较长任务，确认没有中断

Codex 对网络的要求可以归结为一句话：让终端可靠地走进代理，再给它一条长时间不掉线的线路。做到这两点，大部分「Codex 连不上」的问题都不会出现。