在国内用 Codex：CLI、IDE 插件、云端任务的网络配置总览

Codex 对网络环境的核心要求

Codex 是 OpenAI 的 AI 编程代理，它的网络要求比 ChatGPT 网页更高：一是出口必须位于 OpenAI 支持地区；二是终端和编辑器进程也要走代理，而不仅仅是浏览器；三是连接要能稳定维持较长时间，因为一个编程任务可能持续数分钟甚至更久，期间任何断线都可能让任务失败。所以配置 Codex 网络时，重点不在于“能不能打开网页”，而在于“终端里的请求是否经过代理、出口是否固定、线路是否经得起长时间运行”。

Codex 的三种形态

Codex 有多个入口，网络走法各不相同：

三者共享同一个 OpenAI 账号体系：可以用 ChatGPT 账号登录，也可以使用 API Key，可用计划与额度以官方说明为准。如果你主要在 ChatGPT 网页上使用 Codex 云端任务，网络要求与 ChatGPT 相同，可参考 ChatGPT 网络环境与使用完整指南。

地区支持

Codex 遵循 OpenAI 的地区政策。截至 2026 年 10 月，中国大陆和香港不在 ChatGPT 与 OpenAI API 的支持列表内；美国、日本、新加坡等地区在列表中。请以 OpenAI 官方支持地区页面 为准。

推荐节点地区及原因

本站对 Codex 推荐的节点地区与工具信息栏一致：

对 Codex 而言，“稳定”比“快”更重要。编程任务通常包含多轮请求和较长的流式输出，延迟高几十毫秒影响不大，但中途断开一次就可能需要重来。更详细的节点选择逻辑见 Codex 使用什么节点。

终端代理：环境变量与 TUN 模式

Codex CLI 在终端运行，终端通常不读取系统代理。常见的两种解决方式：

# 方式一：设置代理环境变量（7890 为 Clash 系客户端常见默认混合端口，请以自己客户端为准）
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

# 验证终端能否访问 OpenAI API
curl -I https://api.openai.com

Windows PowerShell 中写作：

$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"

方式二是在代理客户端中开启 TUN 模式，在系统层面接管流量。它对 IDE 插件尤其有用：在 macOS 上从程序坞或启动台打开的编辑器，通常不会继承你在 ~/.zshrc 中设置的环境变量，这时 TUN 模式比环境变量更省心。

终端代理的通用写法（git、npm、curl 等）可参考 终端代理设置，Codex CLI 的完整配置步骤见 Codex CLI 代理与网络配置。

IDE 插件的网络设置

Codex 的 IDE 插件在 VS Code 及兼容编辑器中运行，最常见的问题是“终端里 CLI 能用，编辑器里的插件却连不上”。原因在于编辑器进程的环境变量来源不同：

• 从图形界面启动的编辑器：macOS 上从程序坞、启动台或访达打开的应用，通常不会读取 ~/.zshrc 中的环境变量，插件自然拿不到代理设置。
• 从终端启动的编辑器：在已设置代理变量的终端中运行 code .（需先在 VS Code 命令面板中执行安装 code 命令到 PATH 的操作），编辑器及其插件会继承这些变量。
• TUN 模式：在系统层面接管流量，不依赖环境变量，对插件最省心。

如果你同时在 VS Code 中使用其他 AI 插件，TUN 模式加上合理的分流规则，往往比分别配置每个插件更稳定。

云端任务的网络说明

Codex 云端任务在 OpenAI 的服务器上运行：你在网页上选择代码仓库并下达任务，Codex 在云端环境中读取代码、执行命令并给出修改建议或拉取请求。对本地网络而言，这意味着：

• 本地只需要浏览器能稳定访问 chatgpt.com，以及在授权代码仓库时能访问 GitHub；
• 任务执行本身不依赖你的线路，本地断网不会影响已经开始的云端任务，但查看结果时需要网络恢复；
• 云端环境在执行任务时能否访问互联网（例如安装依赖），由环境设置决定，与本地代理无关，具体选项以官方文档为准。

因此，云端任务对本地线路的要求比 CLI 低，适合在网络不太稳定时处理较大的任务。

分流规则：同时覆盖 openai.com 与 chatgpt.com

Codex 使用 ChatGPT 账号登录与使用 API Key 时，请求的服务端点不完全相同，分流规则应同时覆盖两类域名，并指向同一个手动选择的策略组：

rules:
  - DOMAIN-SUFFIX,openai.com,OpenAI
  - DOMAIN-SUFFIX,chatgpt.com,OpenAI
  - DOMAIN-SUFFIX,oaistatic.com,OpenAI
  - DOMAIN-SUFFIX,oaiusercontent.com,OpenAI

OpenAI 为你自建的策略组名称，规则放在 GEOIP、MATCH 等兜底规则之前。开启 TUN 模式后，终端和编辑器的流量同样会按这些规则分流。

登录流程与本地回调

用 ChatGPT 账号登录 Codex CLI 时，CLI 会在本机启动一个临时服务并打开浏览器，你在浏览器中完成授权后，页面会跳回 localhost 上的回调地址，把凭据交给 CLI。这里有两个常见坑：

• 浏览器把 localhost 也发给了代理：如果代理设置没有排除本地地址，回调可能失败。确认系统代理的“绕过列表”包含 localhost 与 127.0.0.1。
• 在远程服务器上登录：服务器没有浏览器，回调无法直接到达。可以用 SSH 端口转发把回调端口映射到本地，或使用 API Key 方式，具体参数以 codex login --help 为准。

长任务的稳定性

Codex 的任务可能持续较长时间，以下做法可以减少中断：

1. 固定节点：为 OpenAI 相关域名使用手动选择的策略组，不使用自动测速或负载均衡组。
2. 避开拥堵时段：大型重构、批量修改尽量不放在晚高峰运行。
3. 保持设备唤醒：电脑休眠或合盖会中断网络连接。
4. 区分沙箱与代理问题：Codex 在沙箱中执行命令时，可能默认限制这些命令的联网能力。如果是“Codex 运行的 npm install 失败”，而不是“Codex 本身连不上”，需要查看官方文档中关于沙箱与网络访问的配置，而不是更换节点。

为什么 AI 编程工具普遍比聊天工具更挑网络，可阅读 为什么 AI 编程工具对网络要求更高。

分层排查：问题出在哪一层

Codex 出现连接问题时，按以下顺序检查：

1. 节点连通：在代理客户端中测试当前节点，确认节点本身可用。
2. 终端是否走代理：在运行 Codex 的同一个终端中执行 echo $HTTPS_PROXY，再执行 curl -I https://api.openai.com。前者为空说明变量没有生效，后者超时说明请求没有经过代理。
3. 出口地区：运行 curl -s https://chatgpt.com/cdn-cgi/trace，查看输出中的 loc= 是否为支持地区。这一步在终端里执行，检查的正是 CLI 的实际出口。
4. 登录状态：确认已完成登录，凭据没有过期；必要时重新执行登录。
5. 任务本身：网络都正常但某个命令失败时，检查是否是沙箱限制了命令联网，而非代理问题。

选择线路时 Codex 用户该看什么

为 Codex 选择线路，侧重点和普通网页浏览不同：

这些条件只能降低中断概率，无法保证任何线路始终不出问题。建议重要的修改及时提交到版本控制中，避免一次中断丢失过多进度。

常见错误与快速处理

学习路径

1. 确定节点：阅读 Codex 使用什么节点，选择受支持地区的稳定节点。
2. 配置终端：按 Codex CLI 代理与网络配置 设置环境变量、完成登录。
3. 通用终端代理：让 git、npm 等工具也走代理，参考 终端代理设置。
4. 排查故障：出现报错时按 Codex 无法连接怎么办 逐项检查。
5. 理解原理：阅读 为什么 AI 编程工具对网络要求更高，了解长连接和流式输出对线路的要求。

本文仅讨论网络环境配置，请在遵守所在地法律法规与 OpenAI 服务条款的前提下使用。