从这一课开始正式动手。很多人卡在第一步不是“不会用”而是“环境没搞对”。本课我们把安装这件事一次讲透并用三种方式装好 Codex CLI。一、系统要求在安装前先确认你的环境满足要求操作系统Codex 支持主流平台macOS / Windows / Linux。不同平台的安装命令略有差异本课以通用方式为主。软件依赖Node.jsCLI 通过 npm 分发时需要它很多安装方式都依赖 Node 环境GitCodex 要读写你的代码仓库、执行版本管理操作Git 是基础依赖。环境自检的完整决策路径如下报错通过报错通过报错通过开始环境自检执行 node -vnode 正常输出前往 Node.js 官网安装指引执行 npm -vnpm 正常输出前往 npm 安装指引执行 git --versiongit 正常输出前往 Git 官网安装指引全部通过进入 npm 安装方式安装前建议先做一次完整的环境自检依次执行下面三条命令node-v# 预期输出示例v20.11.0npm-v# 预期输出示例10.2.4git--version# 预期输出示例git version 2.43.0版本号不要求与示例完全一致只要每条命令都能正常输出版本号即可。如果运行node、npm或git时提示 “command not found” 或 “不是内部或外部命令”说明对应工具尚未安装或未加入PATH请先到对应官网完成安装并重新打开终端后再执行上面的自检命令。二、方式一npm 安装这是最常用的跨平台方式以全局安装为例npminstall-gopenai/codex安装完成后用下面的命令确认是否成功codex--version如果能打印出 Codex 的版本号说明安装成功。三、方式二Homebrew 安装macOSmacOS 用户也可以用 Homebrew 安装好处是便于后续的升级管理brewinstallcodex四、方式三二进制文件安装如果你的环境不方便使用包管理器也可以直接下载官方发布的二进制文件从官方发布页下载对应平台的压缩包解压后把可执行文件放到PATH中如/usr/local/bin赋予执行权限然后运行codex --version验证。五、验证安装是否成功安装不是终点验证才是。运行下面两个命令codex--version# 查看版本号codex--help# 查看可用命令只要这两条都能正常输出就说明 CLI 已经就绪可以进入下一课的认证配置了。如果安装或验证过程中遇到问题可参考常见安装问题排查。六、三种安装方式对比三种方式各有适用场景先看一张总览表再决定用哪种对比项npmHomebrewmacOS二进制文件适用平台macOS / Windows / LinuxmacOSmacOS / Windows / Linux安装命令npm install -g openai/codexbrew install codex手动下载解压并放入PATH升级方式npm update -g openai/codexbrew upgrade codex重新下载新版压缩包替换卸载方式npm uninstall -g openai/codexbrew uninstall codex删除可执行文件及关联目录优点跨平台、命令统一、与 Node 生态集成好升级/卸载由包管理器统一管理最省心不依赖 Node 与包管理器环境最干净缺点依赖 Node.js 环境全局目录偶有权限问题仅限 macOS且需先装好 Homebrew升级与卸载需手动处理易遗漏推荐场景多数用户首选尤其是已在使用 Node 的开发者macOS 用户且习惯用 Homebrew 管理软件无 Node 环境、或想完全隔离依赖的场景小结一下日常开发推荐npm跨平台且命令统一macOS 用户若已重度使用 Homebrew选Homebrew最省心追求纯净环境、不想装 Node 的直接上二进制文件。六、常见安装问题排查 {#六常见安装问题排查}安装或验证过程中遇到报错不要慌先根据现象对照下表定位错误现象可能原因解决命令或操作步骤npm install -g openai/codex提示EACCES/permission denied全局目录权限不足npm 没有写入权限优先使用用户级全局目录npm config set prefix ~/.npm-global将~/.npm-global/bin加入PATH后重新打开终端macOS/Linux 确需系统级安装时用sudo npm install -g openai/codexbrew install codex卡住或提示curl: (6) Could not resolve hostHomebrew 源不可达、网络受限或 DNS 解析失败切换到国内镜像源或检查代理brew update后重试也可临时使用HOMEBREW_INSTALL_FROM_API1 brew install codex或改用 npm 方式安装下载二进制文件后运行提示Permission denied文件未赋予执行权限Linux/macOS 执行chmod x /usr/local/bin/codex再运行codex --version下载的二进制文件提示cannot execute binary file或无法启动平台/架构不符或文件下载不完整重新核对系统类型uname -m并下载与 macOS/Linux/Windows 对应架构的压缩包解压后替换原文件codex命令提示command not found/ “不是内部或外部命令”可执行文件未加入PATH或安装目录不在系统搜索路径中确认安装路径已写入PATHWindows 检查环境变量并在新终端重开macOS/Linux 可执行export PATH$PATH:/usr/local/bin后重试codex --version能拦截但codex --help报错或命令提示 Node 版本过低Node.js 版本不满足 Codex 最低要求运行node -v确认版本升级到受支持的 LTS 版本后重新安装npm 方式可用npm install -g openai/codexlatest七、下一步预告CLI 已经就绪下一课我们将进入认证配置让 Codex 真正连上你的账号。主要会做这几件事登录 OpenAI 账号确保你有一个可用的 OpenAI 账号并已登录获取 API Key在 OpenAI 平台后台创建并复制你的 API Key妥善保存运行codex login在终端执行认证命令按提示完成授权绑定。建议你现在就提前准备好 OpenAI 账号与 API Key并确认账号内有可用的额度或已绑定支付方式这样下一课就能一路顺畅跑通认证流程。小结安装前先确认Node.js 与 Git环境。三种安装方式npm、Homebrew、二进制文件。装完务必用codex --version验证。下一课我们安装桌面端、完成认证配置并把订阅计划讲明白——尤其是很多中国用户关心的支付方案。本文是《OpenAI Codex 从零基础到精通》第 3 课。