Codex CLI のインストール

Codex CLI は OpenAI のスタンドアロンインストーラーでインストールします。macOS または Linux では curl -fsSL https://chatgpt.com/codex/install.sh | sh を実行します。Windows では新しい PowerShell ウィンドウから install.ps1 のコマンドを実行します。代わりに npm install -g @openai/codex や brew install --cask codex も使えます。その後、プロジェクトのフォルダーで codex を実行し、Sign in with ChatGPT を選択します。

対象: Codex CLI, macOS, Linux, Windows

このページは英語版ガイドの翻訳です。コマンドとファイル名は変更していません。両者の内容が食い違う場合は、英語版のページと公式ソースが優先されます。

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シェル補完を生成する

よくある質問

どのインストール方法を使えばよいですか?

スタンドアロンインストーラーは OpenAI が最初に挙げている方法で、Node.js は不要です。すでに npm や Homebrew でツールを管理している場合はそちらを使ってください。複数の方法を混在させると、PATH 上に 2 つのコピーができてしまうことがあるので避けてください。

インストーラーに GitHub からダウンロードさせることはできますか?

はい。README によると、CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false を設定すると、インストーラーは releases.openai.com ではなく GitHub Releases を使います。

デバッグのために Codex の動作を確認するにはどうすればよいですか?

codex -c log_dir=./.codex-log を実行してプレーンテキストのログを書き出し、tail -F ./.codex-log/codex-tui.log でその内容を追跡します。

情報源

このページのすべての手順について、公式ソースへのリンクを掲載しています。内容が公式ソースと食い違う場合は公式ソースを優先し、お知らせください。