CODEX CLI

Codex CLI 安装教程：npm 安装、版本检查与首次启动

CLI 的报错信息更直接，适合先验证安装、网络和配置。下面按最短路径完成环境检查、安装与首次启动。

更新于 2026-07-25独立配置导航中文步骤

检查 Node.js 与 npm

先确认终端能找到 Node.js 和 npm。若命令不存在，请先安装当前受支持的 Node.js LTS 版本，并重新打开终端。

node --version
npm --version

使用 npm 全局安装最新版本。若当前账户没有全局目录写入权限，应优先修正 npm 的用户目录配置，而不是反复使用不同安装方式。

npm install -g @openai/codex@latest

安装后先查看版本，再进入一个可测试的项目目录运行 Codex。首次启动时按客户端提示完成登录或凭据配置。

codex --version
cd YOUR_PROJECT
codex

升级可以重复执行最新版本安装命令。若升级后仍显示旧版本，检查终端实际调用的 codex 路径，关闭并重新打开终端后再次验证。

npm install -g @openai/codex@latest
where codex  # Windows
which codex  # macOS / Linux

FAQ

通常是 npm 全局可执行目录没有进入 PATH，先检查 npm prefix 和终端实际 PATH，再重新打开终端。

不是。可以根据工作方式选择其一；排查配置时，CLI 往往更容易看到具体错误。

CODEXZH.TOP CONFIG GUIDE