OpenAI Codex を本格的に使うなら、まず最初に入れるのが Codex CLI です。CLI（コマンドラインで動くエージェント）は、Codex の中でも最もパワフルで、長時間タスクや自動化に強い玄関口です。
この記事では、macOS・Windows・Linux それぞれの環境で 5分でセットアップが完了する手順 を、コマンド付きで丁寧に解説します。
⚠️ コマンドの実行はターミナル（Windowsの場合は PowerShell や WSL）で行います。「ターミナルって何？」という方は、まずCodexの全体像から読むことをおすすめします。
インストール前の確認事項
1. ChatGPTアカウントが必要
CLIは ChatGPTアカウントでログインして使う 方式です。事前に chatgpt.com でアカウントを作成しておいてください。プランは Free/Go/Plus/Pro 何でも構いません（料金プラン解説）。
2. Node.js（推奨：18以上）
CLIは Node.js 製です。多くのインストール方法で Node.js が必要になります。
node -v
# v18.0.0 以上ならOK
3. ターミナル
- Mac：標準の「ターミナル」or「iTerm2」
- Windows：「PowerShell」または「Windows Terminal」（推奨）/ WSL2 ならさらに快適
- Linux：標準のターミナルでOK
Mac でインストールする3つの方法
方法A：Homebrew（最も簡単・推奨）
Homebrew が入っていれば1行で完了します。
brew install openai-codex
入っていない場合は、まず Homebrew をインストールします：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
その後、上のコマンドで Codex CLI を入れます。
方法B：npm 経由
Node.js が入っていれば npm でもインストールできます。
npm install -g @openai/codex
-g（グローバル）オプションで、どのフォルダからでも codex コマンドが叩けるようになります。
方法C：公式インストーラ
GitHub のリリースページ から .pkg ファイルをダウンロードして実行。GUIインストーラに従うだけ。
Windows でインストールする方法
方法A：PowerShell + npm（推奨）
PowerShell を管理者権限で開き：
npm install -g @openai/codex
Node.jsが未インストールの場合は、先に nodejs.org から LTS版をダウンロードしてインストールします。
方法B：WSL2 + Linuxインストール手順
エンジニアの方はこちらが快適。WSL2 を有効にして Ubuntu などをインストール後、Linux 手順（下記）で進めます。
# WSL2を有効化（PowerShell管理者権限）
wsl --install
再起動後、Ubuntu 内で Linux 手順を実行。
方法C：公式 `.msi` インストーラ
GitHub のリリースから .msi ファイルをダウンロードして実行。エンジニア未経験の方はこれが一番つまずきにくいです。
Linux でインストールする方法
ディストリビューションによって異なりますが、最も汎用的なのは npm 経由：
# Node.js（未インストールなら）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# Codex CLI
sudo npm install -g @openai/codex
sudo を避けたい場合は、nvm（Node Version Manager）を使うのが安全：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
npm install -g @openai/codex
インストールできたか確認する
ターミナルで以下を実行：
codex --version
バージョン番号が表示されれば成功です。
codex 1.x.x
command not found と出る場合は、PATHが通っていない可能性があります。ターミナルを一度閉じて再起動 すると解消することが多いです。
ログイン（認証）する
最初に1回だけ、ChatGPTアカウントとひもづける必要があります。
codex login
ブラウザが自動で開き、ChatGPTのログイン画面が表示されます。普段ChatGPTを使っているアカウント でログインしてください。
ログイン後、ターミナルに戻ると以下のように表示されます：
✅ Logged in as your-email@example.com (ChatGPT Plus)
初回起動と動作確認
任意のフォルダに移動して、codex を実行してみます：
cd ~/Desktop
mkdir codex-test
cd codex-test
codex
対話モードが起動するので、試しに次のように打ってみます：
> Hello.txt というファイルを作って、中に「こんにちはCodex」と書いて
しばらくすると、Codex が「Hello.txt を作成します」と提案し、承認すると実際にファイルが生成されます。これが成功したら インストールと初期設定は完了 です。
よくあるトラブル
`codex: command not found`
PATHが通っていません。以下を試します：
- ターミナルを完全に閉じて再起動
npmでインストールした場合はnpm config get prefixでパスを確認し、~/.bashrcや~/.zshrcに追加- Homebrewでインストールした場合は
brew doctor
ログインで「Browser did not open」
ターミナルだけでログインするモードもあります：
codex login --no-browser
表示されるURLを手動でブラウザにコピペします。
「Permission denied」（macOS）
App Store以外のアプリ実行を許可：
- 「システム設定」→「プライバシーとセキュリティ」
- 「このまま開く」を選択
「Rate limit exceeded」
プランのレート制限に当たっています。5時間後に再試行、または プランをアップグレード。
Windows で「文字化け」
PowerShellではなく Windows Terminal を使うことを強く推奨します。日本語表示が安定します。
設定ファイルの場所
CLIは設定を ~/.codex/config.toml に保存します（Windowsは %USERPROFILE%\.codex\config.toml）。
ここでは以下を設定できます：
- デフォルトモデル
- 承認スキップの挙動
- カスタムプロンプト
.codexignoreのグローバル設定
詳しくは Codex CLI の使い方 を参照してください。
アンインストール方法
Homebrewでインストールした場合
brew uninstall openai-codex
npmでインストールした場合
npm uninstall -g @openai/codex
設定ファイルも削除したい場合は：
rm -rf ~/.codex
よくある質問（FAQ）
Q. APIキーは必要ですか？
A. 不要です。CLIは ChatGPT アカウントでログインする方式なので、APIキーの管理は不要です。これがAPI直接利用との大きな違いです。
Q. 複数のPCで同じCodexを使えますか？
A. はい、各PCでログインすれば 同じアカウントの利用枠を共有 できます。タスク履歴も連携されます。
Q. CLIとVS Code拡張は併用できますか？
A. 全く問題なく併用可能です。同じプロジェクトを CLI と VS Code 拡張で交互に触ることもできます。
Q. 古いバージョンに戻したい
A. npm なら npm install -g @openai/codex@<バージョン> で特定バージョンを指定できます。
Q. オフラインで使えますか？
A. 使えません。Codex は OpenAI のサーバーと常時通信するため、インターネット接続が必須です。
まとめ
Codex CLI のインストールは、Homebrew や npm を使えば1コマンドで完了 します。一度ログインすれば、あとは codex と打つだけでエージェントが起動します。
次は実際の使い方を学びましょう。CLIの使い方完全ガイド で、最初の1ターンから本格的なワークフローまで解説しています。