安裝 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`