本文讲的是 OpenAI 官方 Codex CLI 的安装路径。页面上的核心包名是 @openai/codex，不要把搜索结果里的相似项目直接当成官方工具。
1. 检查 Node.js 和 npm
Codex CLI 通过 npm 安装。打开终端，分别运行：
node --version
npm --version两条命令都能返回版本号，再继续下一步。如果提示“找不到命令”，先安装 Node.js，并重新打开终端。Windows 修改 PATH 后，旧终端通常不会立即读取新环境。
2. 安装 Codex CLI
使用 npm 的全局安装参数：
npm install -g @openai/codex安装完成后，检查命令是否能被找到：
codex --help如果能看到帮助信息，说明命令已经安装到当前用户可以调用的位置。若提示命令不存在，先运行 npm prefix -g，再检查 npm 的全局命令目录是否加入 PATH。
3. 在项目目录启动
先进入准备处理的项目目录，再运行：
cd your-project
codex首次启动会进入登录流程。完成登录后，先让 Codex 说明它看到的目录和准备执行的操作，再决定是否继续。
4. 安装后的基础检查
codex --help能正常返回帮助。- 在目标项目目录中启动，而不是在包含大量无关文件的上级目录启动。
- 让版本控制工具保留一个可回退的状态，再开始修改。
- 涉及账号、权限或计费时，回到 OpenAI 官方页面核对当前规则。