AI工具指南OpenAI Codex 使用指南

OpenAI Codex CLI 使用指南:安装、登录与网络配置

Codex CLI 在本地终端中运行,每一轮请求都从你的电脑发出。安装与登录都依赖网络,长任务更依赖稳定的连接。本文按「安装 → 登录 → 代理 → 长任务」的顺序说明。

作者:机场博客编辑部发布:更新:约 2 分钟阅读

OpenAI Codex 使用指南

核心结论

  • Codex CLI 可以通过 npm 安装,安装过程本身也需要能访问 npm 仓库。
  • 支持 ChatGPT 账号登录或 API Key;登录时浏览器会回调到本机 localhost,注意不要被代理拦截。
  • 终端需通过 HTTPS_PROXY 或 TUN 模式走代理。
  • 长任务建议固定节点、避开不稳定线路,并合理拆分任务。

步骤概览

预计用时:15 分钟需要:Node.js、代理客户端
  1. 配置终端代理在终端中设置 HTTPS_PROXY 指向本地代理端口,并将 localhost 加入 NO_PROXY;或开启 TUN 模式。
  2. 安装 Codex CLI使用 npm 全局安装 @openai/codex。
  3. 登录运行 codex,按提示选择使用 ChatGPT 账号登录或使用 API Key。
  4. 运行一个小任务在项目目录中让 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 的一个任务可能包含很多轮请求。网络质量直接决定任务能否一次完成:

  1. 固定节点:在客户端中为 OpenAI 相关域名设置手动选择的策略组,避免任务中途切换出口。
  2. 观察重连提示:偶尔出现 Reconnecting... 属于正常现象,Codex 会自动重试;频繁出现说明线路不适合长任务。
  3. 拆分大任务:特别大的改动可以拆成几个阶段,降低单次中断的影响。
  4. 避开高峰波动:如果只在晚高峰出现问题,考虑使用稳定性更高的线路。

遇到具体报错,按 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 中使用,具体支持情况以官方仓库说明为准。

资料来源与数据性质

返回上级专题Codex 稳定机场选择指南区分 Codex CLI、IDE 插件与云端任务的网络需求,分析 stream disconnected、请求超时等常见问题,说明 Codex 长任务场景下如何选择稳定的网络服务。