Mac 安装 Codex CLI：从环境准备到第一次运行

TL;DR：Mac 安装 Codex CLI 的最短路径

确认 macOS 终端可以使用 Node.js，安装 Codex CLI，完成登录，然后在一个可以回滚的项目副本中运行第一项小任务。涉及版本、账号能力和使用限制的内容，以 OpenAI Codex 官方资料 为准。

第一步：检查 Mac 的 Node.js 环境

打开“终端”，运行：

node --version
npm --version

如果两个命令都能返回版本号，可以继续。若没有 Node.js，先从 Node.js 官方渠道安装 LTS 版本，重新打开终端后再次检查。

第二步：安装并确认 Codex CLI

npm install -g @openai/codex
codex --help

不要把密钥、Cookie 或完整 Session 写进项目文件。安装后先查看帮助信息，确认当前终端找到的是刚安装的命令。

第三步：登录并运行一个小任务

codex login
cd ~/Documents/your-project
codex "阅读项目结构，先给出实现一个小功能的计划，不要修改文件"

第一次任务建议只要求读取、解释或生成计划。确认输出符合预期，再让 Codex 修改单个模块并运行已有测试。

常见报错与解决

| 现象 | 优先检查 | 处理方式 | | --- | --- | --- | | command not found | npm 全局目录是否在 PATH | 重新打开终端并检查 npm prefix | | 登录页面无法打开 | 浏览器和终端会话 | 使用官方登录入口，完成后回到终端 | | 项目没有权限修改 | 当前目录权限与沙盒确认 | 换到自己的项目副本，先查看 diff | | 安装依赖失败 | Node 版本与网络 | 先单独运行 npm 的安装命令，记录完整错误 |

FAQ：Mac 用户还会遇到什么问题？

MacBook Intel 和 Apple 芯片的步骤一样吗？

大部分 CLI 使用步骤一致，差异主要出现在 Node.js 和原生依赖的安装方式。遇到原生模块报错时，要记录芯片架构和 Node.js 版本。

第一次可以直接让 Codex 重构项目吗？

不建议。先让它读取项目并给出计划，建立可回滚的分支和测试基线，再拆成小任务执行。

去哪里查看官方更新？

可以查看 OpenAI Developers 的 Codex 学习资料，版本和功能以官方页面为准。