1. インストールする
いずれか 1 つの方法を選んでください。
macOS または 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(Node.js がある任意の OS)
npm install -g @openai/codex
Homebrew(macOS)
brew install --cask codex
README によると、スタンドアロンインストーラーは releases.openai.com/codex からダウンロードし、利用できない場合は GitHub Releases にフォールバックします。GitHub Releases を強制的に使うには、次のようにします。
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
2. インストールを確認する
PATH を再読み込みするために新しいターミナルを開き、次のコマンドを実行します。
codex --version
バージョン番号が表示されれば成功です。「command not found」と表示される場合は、こちらの解決方法に従ってください。
3. サインインする
プロジェクトのフォルダーに移動して Codex を起動します。
cd path/to/your/project
codex
Sign in with ChatGPT(ChatGPT でサインイン)を選択します。ブラウザーが開き、サインインが完了すると認証情報が CLI に引き渡されます。codex login を直接実行することもできます。代わりに API キーを使う場合は、次のようにします。
printenv OPENAI_API_KEY | codex login --with-api-key
どの方法が有効になっているかは codex login status で確認できます。SSH 経由で作業している場合やヘッドレスサーバーを使っている場合は、codex login --device-auth を使ってください。その他のサインイン方法もあります。
4. 最初のプロンプトを実行する
Tell me about this project
続いて、最初の本格的なタスクに進みましょう。
知っておくと便利なコマンド
| コマンド | 機能 |
|---|---|
codex | 現在のフォルダーで対話型セッションを開始する |
codex resume | このリポジトリの最近のチャットを再開する |
codex exec "..." | 非対話型で実行する(スクリプトや CI 向け) |
codex --search | この実行でライブ Web 検索を使う |
codex mcp add ... | MCP サーバーを接続する |
codex login status | 有効なサインイン方法を表示する |
codex completion | シェル補完を生成する |