OpenAI Codex CLI 使用指南:安装、登录与网络配置
Codex CLI 在本地终端中运行,每一轮请求都从你的电脑发出。安装与登录都依赖网络,长任务更依赖稳定的连接。本文按「安装 → 登录 → 代理 → 长任务」的顺序说明。
核心结论
- Codex CLI 可以通过 npm 安装,安装过程本身也需要能访问 npm 仓库。
- 支持 ChatGPT 账号登录或 API Key;登录时浏览器会回调到本机 localhost,注意不要被代理拦截。
- 终端需通过
HTTPS_PROXY或 TUN 模式走代理。 - 长任务建议固定节点、避开不稳定线路,并合理拆分任务。
- 配置终端代理在终端中设置 HTTPS_PROXY 指向本地代理端口,并将 localhost 加入 NO_PROXY;或开启 TUN 模式。
- 安装 Codex CLI使用 npm 全局安装 @openai/codex。
- 登录运行 codex,按提示选择使用 ChatGPT 账号登录或使用 API Key。
- 运行一个小任务在项目目录中让 Codex 完成一个小任务,确认请求与流式输出正常。
先弄清 Codex 的几种形态
| 形态 | 运行位置 | 本地网络要求 |
|---|---|---|
| Codex CLI | 本地终端 | 高:每一轮请求都从本地发出 |
| IDE 插件 | 本地编辑器 | 高:与 CLI 类似 |
| 云端任务 | OpenAI 云端 | 低:只需提交与查看 |
本文主要讨论 Codex CLI。各形态的网络需求对比见 Codex 稳定机场。
第一步:先让终端走代理
安装和登录都需要访问境外服务,所以先配置代理,再安装。
# 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"
端口号以你的代理客户端为准。也可以直接开启 TUN 模式,见 为终端 AI 工具配置代理。
第二步:安装
npm install -g @openai/codex
codex --version
能输出版本号说明安装成功。其他安装方式(例如包管理器或直接下载二进制文件)见官方仓库说明。
第三步:登录
首次运行 codex 会提示登录,常见两种方式:
- 使用 ChatGPT 账号登录:终端会打开浏览器完成授权,授权后浏览器跳回本机的一个 localhost 地址,把凭证交给 CLI;
- 使用 API Key:按 API 计费,适合有 OpenAI 开发者账号的用户。
如果浏览器授权成功但终端一直停在等待登录,最常见的原因是 localhost 回调被代理拦截。确认
NO_PROXY中包含localhost与127.0.0.1,或在代理客户端中检查本地地址是否被设置为直连。
第四步:运行任务
进入项目目录后运行 codex,用自然语言描述任务即可。Codex 会规划步骤、读取文件、执行命令并修改代码。执行命令前的审批方式和沙箱权限可以在配置中调整,具体选项以官方文档为准。
长任务的稳定性建议
Codex 的一个任务可能包含很多轮请求。网络质量直接决定任务能否一次完成:
- 固定节点:在客户端中为 OpenAI 相关域名设置手动选择的策略组,避免任务中途切换出口。
- 观察重连提示:偶尔出现
Reconnecting...属于正常现象,Codex 会自动重试;频繁出现说明线路不适合长任务。 - 拆分大任务:特别大的改动可以拆成几个阶段,降低单次中断的影响。
- 避开高峰波动:如果只在晚高峰出现问题,考虑使用稳定性更高的线路。
遇到具体报错,按 Codex CLI 网络问题指南 排查。
使用前确认
Codex 的可用地区与 OpenAI 其他服务一致,以官方支持国家和地区列表为准。账号订阅档位决定了可用额度,额度用尽时会出现用量限制提示,这与网络无关。
常见问题
Codex CLI 和 ChatGPT 网页里的 Codex 有什么区别?
Codex CLI 在你的电脑上运行,读取本地代码并在本地执行命令,每一轮模型请求都从本机发出;网页中的 Codex 云端任务在 OpenAI 的云端环境执行,本地网络只负责提交和查看结果。
安装 Codex CLI 时 npm 下载很慢怎么办?
先确认终端已经走代理(设置 HTTPS_PROXY 或开启 TUN 模式),或者为 npm 配置可信的镜像源。安装完成后再按本文配置运行时代理。
Codex CLI 支持哪些系统?
支持 macOS、Linux,Windows 上可以直接使用或在 WSL 中使用,具体支持情况以官方仓库说明为准。
资料来源与数据性质
- 官方资料OpenAI Codex 官方仓库
- 官方资料OpenAI 支持的国家和地区