Codex CLIを入れようとして インストールが途中で失敗する——初心者がつまずきやすいポイントです。原因はNode.js・権限・ネットワークなどに絞られるので、順に確認すれば解決できます。
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。
インストール失敗の主な原因
- Node.jsが入っていない／古い（npmインストールの場合）
- 権限（permission）エラー
- ネットワーク・プロキシの問題
- 古いキャッシュの干渉
順に対処法を見ていきます。
原因①：Node.jsが入っていない／古い
npmでインストールする場合、Node.jsが必要です。
node -v # v18.0.0 以上が必要
npm -v
command not found と出たら、Node.js未インストール。nodejs.org から LTS版 をインストールしてください。
バージョンが古い場合もアップデートを。nvm を使うと複数バージョンを管理できて便利です。
Node.jsを入れたくない場合は、Homebrew（Mac）や公式インストーラ を使えばNode.js不要でインストールできます。詳しくは CLIインストール手順。
原因②：権限（permission）エラー
EACCES や permission denied と出る場合、グローバルインストールの権限不足です。
Mac / Linux の解決法
おすすめ：nvmを使う（sudoが不要になり安全）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc # または ~/.zshrc
nvm install 20
npm install -g @openai/codex
または npm のグローバルパスを変更：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @openai/codex
sudo npm install -g は手軽ですが、権限まわりのトラブルの元になりやすいので、できれば上記の方法を推奨します。
Windows の解決法
- PowerShellを管理者として実行 して再試行
- それでもダメなら、Node.jsを再インストール（インストーラがPATHと権限を整える）
原因③：ネットワーク・プロキシの問題
インストール中にダウンロードが止まる・タイムアウトする場合。
- VPNをオフにする
- 企業ネットワークならプロキシ設定が必要 → ネットワークエラーの対処 を参照
- 別回線（テザリング等）で試す
npmのレジストリ接続を確認：
npm ping
原因④：古いキャッシュの干渉
過去のインストールの残骸が邪魔をすることがあります。
npm cache clean --force
npm install -g @openai/codex
インストール後の確認
codex --version
バージョンが表示されれば成功。command not found と出る場合は、インストールは成功していてPATHの問題です → command not foundの解決 へ。
どうしてもnpmで入らないとき
Macなら Homebrew
brew install openai-codex
Node.js不要で、PATHも自動設定されるので最も簡単です。
公式インストーラ
GitHubのリリースページ から、OS用のインストーラ（.pkg / .msi）をダウンロードして実行。GUIで進められ、初心者向き。
そもそもCLIを使わない選択肢
CLIのインストールが難しければ、インストール不要の Web版 や VS Code拡張 でCodexは十分使えます。無理にCLIにこだわる必要はありません。
OS別まとめ
| OS | おすすめインストール法 |
|---|---|
| Mac | Homebrew（最も簡単） |
| Windows | 公式 .msi インストーラ or WSL2 |
| Linux | nvm + npm |
よくある質問（FAQ）
Q. Node.jsは絶対に必要ですか？
A. npmで入れる場合は必要。Homebrewや公式インストーラなら不要 です。
Q. sudoを使ってもいいですか？
A. 動きはしますが、権限トラブルの原因になりやすいので、nvmやprefix変更を推奨します。
Q. インストールは成功したのに `codex` が動きません
A. PATHの問題です。command not foundの解決 を参照してください。
Q. 会社のPCでインストールできません
A. 権限制限やプロキシが原因のことが多いです。情シスに相談するか、Web版で回避を。
Q. インストールが難しすぎます
A. 無理せず Web版 や VS Code拡張 を使いましょう。Codexはどの入り口でも同じエージェントが使えます。
まとめ
Codexのインストール失敗は、Node.js・権限・ネットワーク・キャッシュ のいずれかが原因。Macなら Homebrew、Windowsなら 公式インストーラ を使うと、つまずきにくくなります。
どうしても難しければ、インストール不要の Web版 や VS Code拡張 で回避できます。他のトラブルは トラブルシューティング総合ガイド を参照してください。
