Codex CLI 教程：安装、登录与终端代理设置（2026）

Codex CLI 是什么，为什么需要机场

Codex CLI 是 OpenAI 推出的开源命令行工具，你在终端里描述需求，它读取当前目录的代码、调用模型生成修改方案、在你确认后直接改文件或运行命令。它与网页版 ChatGPT 最大的差别是运行环境：一个在浏览器里，一个在终端里。这个差别直接决定了网络配置方式。

国内使用 Codex CLI 需要机场的原因有三层。第一，Codex CLI 的请求全部发往 OpenAI 的 API 域名，这些域名在国内无法直连。第二，OpenAI 会根据请求的出口 IP 判断地区，不在官方支持地区列表内的请求会被拒绝；支持哪些地区以 OpenAI 官方页面为准，列表会调整。第三，Codex CLI 不是浏览器，它用的是 Node.js 的网络栈，默认不读系统代理设置，机场客户端开着、浏览器能上 ChatGPT，不代表终端里的 Codex 能连上。很多「安装成功但一直超时」的问题都卡在这一步。

与同类工具相比，Codex CLI 的网络行为和 Claude Code 几乎一样，都是终端代理问题；与 Cursor 则不同，Cursor 是桌面应用，有自己的代理设置界面。如果你同时用这几个工具，本文的终端代理部分可以通用。

装 Codex CLI 之前要确认的三件事

Codex CLI 通过 npm 安装，安装过程本身就要访问 npm 仓库，国内直连通常能成功但速度慢，偶尔会因为某些依赖包的下载源超时而失败。建议安装前就把终端代理设好，一步到位。

准备步骤：

1. 确认机场客户端正在运行，并且至少有一个美国或日本节点可用。节点可用性可以先在浏览器里打开 ChatGPT 网页验证。
2. 在客户端里找到本地 HTTP 代理端口。Clash Verge Rev 在「设置 → 端口设置」里，默认混合端口 7890；sing-box、v2rayN、Shadowrocket 的端口各不相同，以各自设置页为准。
3. 确认 Node.js 版本满足 Codex CLI 的要求，具体版本号以 Codex CLI 的 GitHub 仓库说明为准，我们不在这里写死。
4. 在终端里设置代理环境变量（见下一节），然后再执行 npm 安装命令。

安装命令以官方仓库 README 为准，通常是 npm 全局安装一个包，安装完在终端输入 codex 即可启动。如果安装过程中出现 ETIMEDOUT 或 ECONNRESET，基本都是代理没生效，回到第 4 步检查。

给 Codex CLI 配终端代理：临时设置与长期生效

这是本文最核心的部分。Codex CLI 运行在 Node.js 环境里，它会读取标准的代理环境变量。设置方法：

# macOS / Linux（zsh、bash）
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1

# Windows PowerShell
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:HTTP_PROXY = "http://127.0.0.1:7890"

# Windows CMD
set HTTPS_PROXY=http://127.0.0.1:7890
set HTTP_PROXY=http://127.0.0.1:7890

设置完在同一个终端窗口里运行 codex，流量就会经本地端口进入机场客户端，再由客户端按规则选择节点。几点需要注意：

• 端口以客户端为准。7890 只是 Clash 系的默认值。端口写错是最常见的失败原因，表现为立刻报连接被拒绝（ECONNREFUSED）。
• 环境变量只在当前终端会话有效。新开一个终端窗口要重新设置。想长期生效，把 export 行写进 ~/.zshrc 或 ~/.bashrc；Windows 可以在系统环境变量里添加。
• NO_PROXY 要包含 localhost。Codex CLI 用 ChatGPT 账号登录时，授权回调会访问本机端口，如果这个请求也被送进代理就会失败。
• 大小写。Node.js 同时识别大写和小写的 https_proxy，但有的工具只认其中一种，两种都设最保险。

另一种方式：TUN 模式

如果不想每次设环境变量，可以在客户端里开启 TUN（增强）模式。TUN 会接管系统全部流量，终端里的任何程序都自动走代理，不需要任何环境变量。代价是所有流量都经过客户端的规则判断，规则不完善时可能把本该直连的国内流量也送出去。TUN 的开启方法与注意点见 TUN 模式教程，开启后出现「有代理反而没网」的情况参考 TUN 模式无网络排查。

验证链路

设置好后先不要急着启动 codex，用 curl 验证一下：

curl -I https://api.openai.com

返回任何 HTTP 状态码（包括 401、403、404）都说明代理链路已经通了，Codex 连不上就不是代理问题；如果长时间无响应或报 Connection refused，先解决代理再往下走。

ChatGPT 账号登录还是 API Key：网络上有什么不同

Codex CLI 支持两种身份验证方式，网络要求不同。

ChatGPT 账号登录

启动 codex 后选择用 ChatGPT 账号登录，它会打开浏览器跳到 OpenAI 的授权页面，你在浏览器里确认后，授权结果通过回调发回本机的一个临时端口。这个流程涉及两个程序：浏览器和终端。两者必须走同一地区的节点。如果浏览器的 OpenAI 流量走美国节点，终端走日本节点，OpenAI 可能把它判定为异常登录，授权失败或登录后很快失效。

最简单的办法是在客户端里把 openai.com、chatgpt.com、oaistatic.com、oaiusercontent.com 等域名统一归入一个「AI 服务」策略组，指向固定的美国节点。这样浏览器和终端的请求都由同一条规则处理，自然一致。规则配置方法见 规则分流教程。

ChatGPT 账号登录方式要求账号有有效的付费订阅，具体哪些套餐包含 Codex 使用额度，以 OpenAI 官方页面为准。

API Key 方式

如果你有 OpenAI API 账号，可以把 API Key 设为环境变量后直接使用，不经过浏览器授权。这种方式对浏览器没有要求，只要终端能访问 api.openai.com 即可，适合在服务器或远程开发环境里使用。费用按 API 用量计算，与 ChatGPT 订阅是两套计费，细节以官方页面为准。

两种方式的共同点是出口节点都要在支持地区内。如果你的 ChatGPT 账号本身是用某个地区注册的，后续使用 Codex 时继续用同一地区的节点，减少风控触发。ChatGPT 账号注册与地区问题的详细讨论见 ChatGPT 网络指南。

节点选择：稳定性优先于延迟

Codex CLI 的网络行为与网页聊天不同：它会一次性发送大量上下文（可能包含多个代码文件），然后以流式方式接收较长的回复，单次请求可能持续几十秒到几分钟。这意味着节点的稳定性和长连接保持能力比延迟重要。一个延迟 180ms 但从不掉线的美国专线节点，体验好于延迟 50ms 但晚高峰频繁重连的中转节点。

选定节点后在策略组里手动固定，不要用自动测速。自动切换会导致一个会话中途换出口 IP，OpenAI 可能直接断开当前请求。关于专线和中转的区别见 IEPL 与 IPLC 对比。

Codex CLI 报错速查

跑 Codex CLI 选哪些机场

Codex CLI 依赖 OpenAI 服务，因此机场选择标准与 ChatGPT 一致：品牌资料有 AI 标注、专线为主、能按月买。下表列出品牌资料有 AI 标注的 12 家，按本站综合评分排序，「AI 标注」一列直接取自品牌资料：只有速界明确写了 ChatGPT，其余 11 家写的是「常见 AI 工具（未指明平台）」。AI 可用性均为品牌资料标注，建议先月付验证。各家美国、日本节点的情况以官网和 测速页 的 2026-08-11 测速截图所列地区为准。

针对编程场景的几点补充：

• 速界是唯一明确标注 ChatGPT 的，¥25/月 150GB，VLESS + IEPL + 自研客户端，流量对 Codex 的 5–15GB 月用量绰绰有余；2024 年起运营、风险「中」，先月付。
• 光速云2020 年起运营，IEPL + 企业级内网专线、自研客户端，标注常见 AI 工具；入门 59GB 对只用 Codex 的个人开发者够用，但 ¥7.5/月是年付折算价，建议先在月付机场验证。
• U1S1¥20/月 120GB，VLESS + IEPL + 自研客户端，2023 年起运营、风险「低」，标注常见 AI 工具，是月付里最均衡的选择；SOGO 云¥25/月 150GB 规格更高但是 2026 年新品牌，只建议月付。
• 二猫云¥20/月 130GB，VLESS + IEPL，没有自研客户端但对会用 Clash 的开发者不是问题，标注常见 AI 工具。
• 多台开发机或团队共用时，设备数本站 17 家都以官网为准，买前向客服确认。

更多针对 OpenAI 服务的机场对比见 ChatGPT 机场推荐与 AI 解锁榜。

流量估算与长期使用建议

Codex CLI 的流量比网页版 ChatGPT 大，因为每次请求都会携带代码上下文。按我们对同类工具的一般理解，日常开发每天几十次交互，每月流量在 5–15GB 之间；处理大型仓库、让它批量重构时会更多。100GB 以上的套餐基本不用考虑流量问题。估算方法见 每月需要多少流量。

长期使用的几条建议：把代理环境变量写进 shell 配置文件，避免每次手动设置；在客户端里用独立策略组管理 AI 域名，固定美国节点；账号注册地区与日常使用地区保持一致；遇到 429 先等额度重置，不要立刻换节点重试，频繁换 IP 反而更容易被标记。如果你也用 Claude Code，Claude Code 使用教程里的代理设置与本文完全一致，两个工具可以共用同一套环境变量。

常见问题