Codex CLI 安装

Codex CLI 是运行在本地终端里的 Codex 形态，适合习惯命令行、需要在已有项目里快速读代码、改文件、运行测试的开发者。

::: tip 来源核对 安装命令以 openai/codex GitHub README 和 OpenAI Codex CLI 文档 为准。本文记录的是 2026-05-29 核对到的常用方式。 :::

macOS / Linux 安装

官方提供了安装脚本：

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

如果你更习惯包管理器，也可以使用 npm：

npm install -g @openai/codex

macOS 用户也可以使用 Homebrew：

brew install --cask codex

Windows 安装

Windows 可以在 PowerShell 中运行官方安装脚本：

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

如果你的机器已经安装 Node.js，也可以使用 npm：

npm install -g @openai/codex

安装后验证

安装完成后，打开新的终端窗口，运行：

codex --version

如果可以看到版本号，说明命令已经加入系统路径。接下来可以运行：

codex

首次运行会进入登录或认证流程。下一步参考：Codex CLI 首次运行。

常见问题

提示找不到 codex 命令怎么办？

先关闭并重新打开终端。如果仍然找不到，检查安装目录是否已经加入 PATH。

npm 安装失败怎么办？

检查 Node.js 和 npm 是否可用，或切换为官方安装脚本。公司网络环境下可能需要配置代理。

桌面 App 和 CLI 都要装吗？

不一定。桌面 App 更适合图形化操作，CLI 更适合终端工作流。两者可以同时安装。