如何安装 Codex CLI：macOS、Linux、Windows

Codex 是 OpenAI 出的终端编码代理，装好之后在命令行输入 codex，它就能读你的代码、改文件、执行命令，把自然语言需求变成实际改动。这篇文章把安装过程拆成四步：确认系统要求、选安装方式、执行安装、登录账号。每一步都给可以直接复制的命令，照着做就能跑通。

安装前，先确认系统满足要求

Codex CLI 对系统要求不高，但先对照一遍能避免装到一半才发现不兼容。官方支持 macOS、常见 Linux 发行版，以及通过 WSL2 运行的 Windows。

四种安装方式，选一种就行

官方提供了四套安装路径，覆盖不同使用习惯。日常用哪个都行，差别主要在命令和环境依赖上。

如果这些都不想用，也可以直接到 GitHub Releases 页面下载对应平台的压缩包，解压后把二进制文件重命名成 codex 放进 PATH。

第一步，macOS 或 Linux 用官方脚本安装

在终端里执行下面这一行，脚本会下载当前平台的最新版本并完成安装：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安装完成后，重新打开一个终端窗口，让 PATH 生效。

第二步，Windows 用户用 PowerShell 安装

打开 PowerShell，执行下面这行：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

如果你平时在 WSL2 里做开发，也可以在 WSL2 的终端里直接走第一步的 Linux 安装脚本，两条路都能用。

第三步，习惯包管理器就选 npm 或 Homebrew

机器上已经有 Node.js 的话，npm 是最顺手的方式：

npm install -g @openai/codex

macOS 用户也可以走 Homebrew：

brew install --cask codex

第四步，登录你的 ChatGPT 账号

安装完成后，在终端里输入 codex 启动，首次运行会进入登录引导。选择 Sign in with ChatGPT，浏览器会打开授权页面，登录后回到终端就能用了。Plus、Pro、Business、Edu 和 Enterprise 套餐都包含 Codex 的使用额度。

不想用 ChatGPT 账号的话，也可以走 API Key 方式，配置步骤在 OpenAI 官方文档的 Codex 认证页面里。之前写过一篇 无需信用卡订阅 ChatGPT 和 Claude Code 的教程，订阅环节卡住时可以对照着看。

验证安装，跑通第一个任务

先确认版本号能正常输出：

codex --version

然后在你的项目目录里启动 Codex，让它做一次最简单的任务，比如解释代码库：

codex exec "explain this codebase to me"

能返回正常结果，说明安装和登录都通了。之后就可以用 Codex 处理真实任务，比如把 landing page 的构建流程交给它，之前那篇 用 Codex 和 Claude Code 把 Landing Page 制作压到 30 分钟 记录的就是这种用法。

完整流程回顾

整个安装过程可以压缩成四步，任何一步卡住，回到对应小节找命令就行。