安装 Codex CLI

在 macOS、Windows、Linux 上安装 Codex CLI 并验证，随后再接入 StoryClaw。

Codex CLI 提供独立安装脚本，自带运行时，不强制要求 Node.js。

系统要求

项目	要求	说明
macOS	12（Monterey）或更高	Apple Silicon 与 Intel 均支持
Windows	10 / 11	原生支持仍是实验性的，WSL2 更成熟
Linux	基于 glibc 的发行版（Ubuntu 22.04+、Debian 11+、Fedora 34+）	—
Node.js	建议 22 或更高	只有用 npm 安装时才涉及

在终端里运行：

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

也可以用 Homebrew：

brew install --cask codex

在 PowerShell 里运行：

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

如果执行策略拦截了脚本，改用下面的「用 npm 安装」。

Codex 会读写 Git 仓库，建议装上 Git for Windows——它同时提供 Git Bash，能避开原生命令行大部分路径相关的怪问题。原生 Windows 支持目前仍是实验性的，如果反复出问题，改在 WSL2 里按 Linux 步骤安装。

在终端里运行：

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

如果你已经有稳定的 Node.js 环境，或者独立安装脚本在你机器上受阻，npm 是官方的备选路径：

npm install -g @openai/codex

需要 Node.js 22 或更高。推荐用 nvm 装（免 sudo，避开权限错误）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @openai/codex

Windows 可以直接从 nodejs.org 安装 Node.js。不要用 sudo npm install -g，容易搞出权限和安全问题。

在终端里运行：

codex --version

显示版本号即表示安装成功。如果提示 command not found，先开一个新终端——安装脚本会更新 PATH，而已经打开的会话仍用着旧值。

装好后 Codex 仍然连的是 OpenAI，继续看配置 Codex CLI 把它切到 StoryClaw。

现象	解决办法
刚装完就提示 `codex: command not found`	开一个新终端。安装脚本更新了 `PATH`，更早打开的会话仍用旧值。
`npm install -g` 报 `EACCES` 或其他权限错误	修正 npm 的全局安装路径，或改用 nvm 管理 Node.js。不要用 `sudo npm install -g`。
`node --version` 显示低于 22	执行 `nvm install 22 && nvm use 22`，或改用自带运行时的独立安装脚本。
PowerShell 拒绝执行安装脚本	按上面的写法带上 `-ExecutionPolicy ByPass`，或改用 npm 安装。
下载失败或卡住	强制走 GitHub Releases 镜像：`curl -fsSL https://chatgpt.com/codex/install.sh \| CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh`