OpenAI Codex を本格的に使うなら、まず最初に入れるのが Codex CLI です。CLI（コマンドラインで動くエージェント）は、Codex の中でも最もパワフルで、長時間タスクや自動化に強い玄関口です。
この記事では、macOS・Windows・Linux それぞれの環境で 5分でセットアップが完了する手順 を、コマンド付きで丁寧に解説します。
⚠️ コマンドの実行はターミナル（Windowsの場合は PowerShell や WSL）で行います。「ターミナルって何？」という方は、まずCodexの全体像から読むことをおすすめします。
答え：公式のインストールは1行です
Codex CLIは、公式の単独インストーラーを使えば1行で入ります。Node.jsは不要です。（2026年10月時点の公式ドキュメント「Codex CLI」より）
| 環境 | 公式のインストールコマンド |
|---|---|
| Mac・Linux（ターミナル） | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
| Windows（PowerShell） | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npmを使う場合 | npm install -g @openai/codex |
| Homebrewを使う場合（Mac） | brew install --cask codex |
迷ったら、いちばん上の2つ（単独インストーラー）を使ってください。公式が最初に案内している方法です。
💡 ターミナルが苦手な方は、CLIではなくデスクトップアプリから始めるのがおすすめです（Codexデスクトップアプリのインストール方法）。
インストール前の確認事項
1. ChatGPTアカウント
CLIは、最初に起動したときに 「Sign in with ChatGPT」（ChatGPTでサインイン） などの方法でログインします。事前に chatgpt.com でアカウントを作っておきましょう（プランの違いは料金プラン解説）。
2. ターミナル
- Mac：標準の「ターミナル」
- Windows：PowerShell（スタートメニューで「PowerShell」と検索）。公式は「新しいPowerShellのウィンドウから実行する」よう案内しています
- Linux：標準のターミナル
3. Node.jsは必要？
公式の単独インストーラーなら不要です。 Node.jsが必要なのは、npm install -g @openai/codex でインストールする場合だけです。
Mac・Linuxでインストールする
ターミナルを開いて、次の1行を貼り付けて実行します。
curl -fsSL https://chatgpt.com/codex/install.sh | sh
アップデートするときも、同じコマンドをもう一度実行します（公式）。
別の方法：Homebrew（Mac）
Homebrew を使っている方は、次のコマンドでも入れられます。
brew install --cask codex
更新は brew upgrade --cask codex です。
別の方法：npm
Node.jsを使っている方は、npmでも入れられます。
npm install -g @openai/codex
Windowsでインストールする
新しいPowerShellのウィンドウを開いて、次の1行を実行します。
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
アップデートするときも、同じコマンドをもう一度実行します（公式）。
💡 WSL2（Windowsの中でLinuxを動かす仕組み）を使っている方は、Ubuntuなどの中で上の「Mac・Linux」の手順を実行します。Linuxでの使い方は CodexをLinuxで使う完全ガイド にまとめています。
インストールできたか確認する
ターミナルを新しく開き直してから、次を実行します。
codex --version
バージョン番号（0.161.0 のような数字）が表示されれば成功です。
command not found と出る場合は、PATH（コマンドの置き場所の登録）が反映されていない可能性があります。まずはターミナルを閉じて開き直してください。詳しくは「codex: command not found の解決方法」をどうぞ。
ログイン（認証）する
最初に1回だけ、ChatGPTアカウントとひもづける必要があります。
codex login
ブラウザが自動で開き、ChatGPTのログイン画面が表示されます。普段ChatGPTを使っているアカウント でログインしてください。
ログインが終わると、ブラウザからCodexにログイン情報が戻され、ターミナルで使えるようになります（公式）。APIキーで使いたい場合は、ログイン画面で別の方法を選ぶこともできます。
初回起動と動作確認
任意のフォルダに移動して、codex を実行してみます：
cd ~/Desktop
mkdir codex-test
cd codex-test
codex
対話モードが起動するので、試しに次のように打ってみます：
> Hello.txt というファイルを作って、中に「こんにちはCodex」と書いて
しばらくすると、Codex が「Hello.txt を作成します」と提案し、承認すると実際にファイルが生成されます。これが成功したら インストールと初期設定は完了 です。
よくあるトラブル
codex: command not found
PATHが通っていません。以下を試します：
- ターミナルを完全に閉じて再起動
- それでも出る場合は、PATHの設定を確認します（command not foundの解決方法）
ブラウザが開けない環境でログインしたい
サーバーなどブラウザが使えない環境では、公式は「デバイスコード認証」（ベータ版）を勧めています。
codex login --device-auth
事前に、ChatGPTのセキュリティ設定（会社のワークスペースなら管理者の設定）でデバイスコードでのログインを有効にしておく必要があります。
「Permission denied」（macOS）
App Store以外のアプリ実行を許可：
- 「システム設定」→「プライバシーとセキュリティ」
- 「このまま開く」を選択
「Rate limit exceeded」
プランの利用上限に達しています。表示されたリセット時刻まで待つか、プランを見直します。詳しくはレート制限の対処法へ。
Windows で「文字化け」
PowerShellではなく Windows Terminal を使うことを強く推奨します。日本語表示が安定します。詳しくは 文字化けの直し方 へ。
それでも解決しないとき
command not foundが消えない → command not foundの完全解決ガイド- インストール自体がエラーで止まる → インストール失敗の対処
- 入ったのに起動しない → 起動しないときの対処
設定ファイルの場所
CLIは設定を ~/.codex/config.toml に保存します（Windowsは %USERPROFILE%\.codex\config.toml）。
ここでは以下を設定できます：
- デフォルトモデル
- 承認スキップの挙動
- カスタムプロンプト
詳しくは Codex CLI の使い方 を参照してください。
アンインストール方法
Homebrewでインストールした場合
brew uninstall --cask codex
npmでインストールした場合
npm uninstall -g @openai/codex
設定ファイルも削除したい場合は：
rm -rf ~/.codex
ここまでの要点を1枚にまとめました。
よくある質問（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 のインストールは、公式の単独インストーラーを使えば1行で完了します（Node.jsは不要）。一度ログインすれば、あとは codex と打つだけでエージェントが起動します。
次は実際の使い方を学びましょう。CLIの使い方完全ガイド で、最初の1ターンから本格的なワークフローまで解説しています。
