Codex CLIのインストール問題を解決：PATH・サインイン・WSL
インストール後にシェルが codex: command not found と表示する場合、認証の問題ではありません。ターミナルが実行ファイルを見つけられていない状態です。Codexが開き、ブラウザでの認証中に停止する場合、インストールはすでに完了しています。これらを2つの別個の失敗として扱ってください。
1つのコマンドでインストールを確認
新しいターミナルを開き、以下を実行してください:
codex --version
バージョン番号が表示されれば、このシェルがCodexを検出し、実行できることが確認されます。認証が唯一の問題である場合、サインインセクションに進んでください。コマンドが見つからない場合は、Codexを現在使用している環境でインストールしたか確認してください。よくあるミスは、PowerShellでインストールしてWSLでコマンドを探す、または逆のケースです。
インストーラーを実行した環境を確認
macOS、Linux、またはWSLでは、そのシェル内で公式スクリプトを実行してください:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
ネイティブのWindowsでは、WSLウインドウではなくPowerShellを開き、以下を実行してください:
irm https://chatgpt.com/codex/install.ps1 | iex
Node.jsとnpmがすでに入っている場合は、公式にサポートされている別の方法としてnpmパッケージも使えます:
npm install --global @openai/codex
どの方法を使った場合も、完了後はいったんすべてのターミナルを閉じ、新しく開いてcodex --versionを実行してください。インストール方法は一つに絞ります。複数のコピーがあると、PATHの手前に古い実行ファイルが残り、どのバージョンを起動しているのか分かりにくくなります。
スタンドアロンインストーラーは、macOSおよびLinuxでは ~/.local/bin、Windowsでは %LOCALAPPDATA%\Programs\OpenAI\Codex\bin に実行ファイルを配置します。
ファイルが存在するがコマンドが見つからない場合、インストールディレクトリとPATHを比較してください。
macOS、Linux、またはWSLでは:
ls -l ~/.local/bin/codex
printf '%s\n' "$PATH" | tr ':' '\n'
PATHの一覧に ~/.local/bin がない場合は、現在のシェルで export PATH="$HOME/.local/bin:$PATH" を実行し、もう一度テストしてください。動作した後、同じ行を ~/.zshrc または ~/.bashrc に追加してください。
Windows PowerShellでは:
Test-Path "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin\codex.exe"
$env:Path -split ';'
実行ファイルが存在するのにPathの一覧にそのディレクトリがない場合は、Windowsユーザーの Path に %LOCALAPPDATA%\Programs\OpenAI\Codex\bin を追加し、PowerShellを開き直してください。
Windows版とWSL版を混在させない
PowerShellとWSLは別々の実行環境です。デフォルトでは、WSLがWindowsのディレクトリを $PATH に追加するため、Windowsのアプリケーション（例: codex.exe）を起動できることがあります。しかし、Linuxの codex の実行ファイルがWSLにインストールされているとは限りません。WSL内で作業する場合は、Linuxビルドをその環境でインストールしてください。
WSL2をセットアップするには、管理者権限を持つPowerShellまたはWindows Terminalで以下を実行してください:
wsl --install
再起動を求められたらWindowsを再起動してください。Linuxユーザーの初期設定を終えたら、次のコマンドでWSLを起動します:
wsl
Linuxシェル内で、Linuxスクリプトを使用してCodexをインストールしてください:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
新しいWSLシェルを開き、codex --version で確認してください。現在のCodex公式ドキュメントはWSL2を対象としており、WSL1はCodex 0.115以降ではサポートされていません。プロジェクトは /mnt/c/... ではなく、~/code/... のようなWSLホームディレクトリ配下に置くと、ファイルシステムや権限の問題を避けやすくなります。
PowerShellを使い続けるなら、Windows版だけを残してください。WSLを使用する場合は、インストール、実行、プロジェクトファイルをすべてWSL側で行うようにしてください。
ブラウザでのサインインがターミナルに戻らない場合
Codexが起動するが認証が完了しない場合、標準のログインフローを再実行してください:
codex login
ブラウザでChatGPTにサインインすると、認証結果がCodexへ返されます。現在の認証状態を確認するには:
codex login status
リモートまたはヘッドレスマシン、またはローカルコールバックをブロックしている企業ネットワークでは、ブラウザが認証を完了してもターミナルが待機し続けることがあります。その場合、ベータ版のデバイスコードフローを使用してください。個人アカウントでは、まずChatGPTのセキュリティ設定でデバイスコード認証を有効にする必要があります。管理されたワークスペースでは、管理者がこれを許可する必要があります。
codex login --device-auth
アカウントを切り替えたり、不具合が疑われる認証キャッシュを消すには、一度サインアウトしてログインし直します。codex logout は保存された資格情報を削除するため、再度認証する準備ができてからのみ使用してください。
codex logout
codex login
管理されたChatGPTワークスペースは、許可されたログイン方法やワークスペースを制限する場合があります。Codexが個人アカウントを拒否し続ける場合、再インストールする前に組織のポリシーを確認してください。
インストールとサインインのどちらも問題がないように見える場合
バージョン番号と認証状態が正しいにもかかわらずCodexが起動しない場合、診断サマリーを実行してください:
codex doctor --summary
これはローカルのインストール、設定、資格情報、実行環境を確認します。サポートを依頼する際には、オペレーティングシステム、シェル、codex --version の出力、インストール方法、および失敗した診断項目を含めてください。アクセストークンや ~/.codex/auth.json の内容を貼り付けないでください。