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 でインストールする場合のみ関係します |
macOS
ターミナルで実行します。
curl -fsSL https://chatgpt.com/codex/install.sh | shHomebrew も利用できます。
brew install --cask codexWindows
PowerShell で実行します。
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"実行ポリシーによってスクリプトがブロックされる場合は、下の「npm でインストールする」に切り替えてください。
Codex は Git リポジトリを読み書きするため、Git for Windows の導入を推奨します——Git Bash も同時に入り、ネイティブシェルのパス関連の問題を大部分回避できます。Windows のネイティブ対応は現在も実験的です。問題が続く場合は WSL2 内で Linux の手順に従ってインストールしてください。
Linux
ターミナルで実行します。
curl -fsSL https://chatgpt.com/codex/install.sh | shnpm でインストールする
安定した Node.js 環境が既にある場合や、スタンドアロンインストーラーが使えない場合は、npm が公式の代替手段です。
npm install -g @openai/codexNode.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/codexWindows では 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 |