主题
Mac安装
安装前说明
这篇文档教你在 macOS 上安装 Codex CLI。
Mac 用户可以通过 Node.js 和 npm 安装 Codex CLI。
小白用户建议优先使用 Node.js 官网下载安装包的方式。
如果你已经会使用 Homebrew，也可以使用 Homebrew 安装 Node.js。
安装 Codex CLI 前，需要先安装 Node.js LTS。
Node.js 会一起提供 npm，后面安装 Codex CLI 就要用到 npm。
Node.js 官方下载地址：
text
https://nodejs.org/请下载 LTS 长期支持版，不要随便下载奇怪来源的安装包。
第一步：下载 Node.js
打开浏览器，进入 Node.js 官方网站：
text
https://nodejs.org/进入页面后，选择 LTS 长期支持版。
Mac 用户下载 macOS 对应的安装包。
不要从不认识的网站下载 Node.js 安装包。
第二步：安装 Node.js
打开下载好的 macOS 安装包。
按照安装窗口提示继续操作。
一般点击“继续”“安装”即可。
如果系统提示输入密码，输入你 Mac 的开机密码，然后继续安装。
安装完成后，请关闭已经打开的终端，再重新打开一个新的终端。
这样系统才能识别刚刚安装好的 node 和 npm 命令。
可选方式：使用 Homebrew 安装
如果你已经会使用 Homebrew，可以用 Homebrew 安装 Node.js。
复制下面这行命令，粘贴到终端里，然后按回车：
bash
brew install node这行命令会通过 Homebrew 安装 Node.js。
如果你不知道 Homebrew 是什么，可以跳过这一节，直接使用 Node.js 官网安装包即可。
如果你想通过 Homebrew 安装 Codex，也可以使用下面这行命令：
bash
brew install codex如果你是小白用户，建议优先按照后面的 npm 方式安装，步骤更统一。
第三步：打开终端
点击屏幕右上角搜索图标，输入“终端”，然后打开“终端”。
也可以打开“访达”，进入“应用程序”，再进入“实用工具”，找到“终端”。
后面的命令都在终端里执行。
第四步：检查 Node.js 是否安装成功
复制下面这行命令，粘贴到终端里，然后按回车：
bash
node -v这个命令用来查看 Node.js 版本。
如果看到类似 v20.x.x、v22.x.x 这样的版本号，说明 Node.js 已经安装成功。
如果提示 node 命令不存在，先关闭终端，再重新打开一次。
第五步：检查 npm 是否可用
复制下面这行命令，粘贴到终端里，然后按回车：
bash
npm -v这个命令用来查看 npm 版本。
如果看到版本号，说明 npm 可以正常使用。
如果 node -v 正常，但 npm -v 不正常，可以重新安装 Node.js LTS 长期支持版。
第六步：使用 npm 安装 Codex CLI
确认 node -v 和 npm -v 都能显示版本号后，再安装 Codex CLI。
复制下面这行命令，粘贴到终端里，然后按回车：
bash
npm i -g @openai/codex这行命令的意思是：使用 npm 在 Mac 上安装 Codex CLI。
安装过程可能需要等待一会儿，请不要中途关闭终端。
如果安装很慢，可以先等待几分钟，网络不稳定时会比较慢。
第七步：检查 Codex 是否安装成功
安装完成后，复制下面这行命令，粘贴到终端里，然后按回车：
bash
codex --version这个命令用来查看 Codex CLI 版本。
如果能看到版本号，说明 Codex CLI 已经安装成功。
如果提示 codex 命令不存在，先关闭终端，再重新打开一次。
第八步：第一次启动 Codex
建议先进入你要处理的项目文件夹，再启动 Codex。
如果你暂时不知道怎么进入项目文件夹，可以先让懂电脑的人帮你打开正确目录。
复制下面这行命令，粘贴到终端里，然后按回车：
bash
codex这个命令会启动 Codex。
第一次启动时，终端可能会提示你登录。
按照终端里的提示一步一步操作即可。
常见问题
终端在哪里打开？
点击屏幕右上角搜索图标，输入“终端”，然后打开。
也可以在“应用程序”里的“实用工具”中找到“终端”。
Mac 提示无法打开怎么办？
先确认软件或安装包是否来自官方页面。
如果是系统安全提示，可以按照 macOS 的提示到系统设置里允许打开。
不要打开来源不明的软件。
npm 安装失败怎么办？
先确认 node -v 和 npm -v 是否都能显示版本号。
如果 npm 安装过程中报错，可以关闭终端重新打开后再试。
如果还是失败，可以重新安装 Node.js LTS 长期支持版。
codex 命令不存在怎么办？
先确认安装命令是否执行成功：
bash
npm i -g @openai/codex然后关闭终端，重新打开后再执行：
bash
codex --version如果还是不行，可能是 npm 全局安装目录没有加入 PATH。
Apple Silicon 和 Intel 有什么区别？
这是 Mac 使用的芯片类型不同。
点击屏幕左上角苹果图标，打开“关于本机”。
如果看到 M1、M2、M3、M4 这类字样，一般是 Apple Silicon。
如果看到 Intel 字样，就是 Intel。
安装完成后下一步做什么？
进入你要处理的项目文件夹。
然后执行：
bash
codex启动后按照 Codex 的提示登录并开始使用。