ガイド一覧へ戻る
コーディングエージェント·2026年9月17日·読了6分

Codex CLIをインストール:セットアップ、サインイン、最初のタスク

インストール方法を1つ選び、実行ファイルを確認してサインインし、カスタムプロバイダー設定を追加する前に小さなプロジェクトタスクから始めます。

最終確認日:。

Codex CLIをインストールし、実行ファイルを確認してサインインし、プロジェクトディレクトリで小さなタスクから始めます。 公式インストーラーは現在、macOS、Linux、Windowsに対応しています。npmとHomebrewも引き続き利用できます。以下から1つの方法を選択してください。動作するインストールが最初のステップです。アカウントアクセスとAPI課金は別の選択肢です。

1. インストール方法を1つ選ぶ

これらのコマンドは公式Codex CLIインストールガイドに基づいています。エージェントを実行する環境向けのインストーラーを使用してください。Windowsの実行ファイルをインストールしても、WSL内に別のLinux版はインストールされません。また、ノートパソコンにインストールしても、後で接続するリモートサーバーにはインストールされません。

macOSまたはLinux:公式スタンドアロンインストーラー
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows:公式スタンドアロンインストーラー
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

すでにパッケージマネージャーで開発ツールを管理している場合は、両方のインストーラーを実行せず、その代替手段を使用してください:

方法インストール更新
npmnpm install -g @openai/codexnpm install -g @openai/codex
Homebrewbrew install --cask codexbrew upgrade --cask codex
スタンドアロンOS用のインストーラーを実行同じインストーラーをもう一度実行

npmの方法には、動作するnpmのインストールが必要です。まず npm --versionを確認してください。Nodeのツールを別途必要としない場合は、スタンドアロン版が便利です。管理対象のマシンでは、管理者がサポートするインストール方法を使用し、後の更新を予測可能にしてください。

2. 実行される実行ファイルを確認

コマンドが見つからない場合は、インストール後に新しいターミナルを起動してください。macOSまたはLinuxでは、command -v codexによりシェルが選択した実行ファイルが表示されます。PowerShellではGet-Command codexを使用します。再インストールする前に、そのパスを選択したインストール方法と比較してください。2つのコピーがインストールされていると、一方を更新しながら、もう一方を起動し続けることがあります。

確認、サインイン、最初のタスクの実行
codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

例のプロジェクトパスを自分のものに置き換えてください。最後のコマンドでは、最初の説明のために読み取り専用サンドボックスを使用します。これは、エージェントに変更を依頼する前に、正しいリポジトリとモデルアクセスを確認できる有用な初期チェックです。利用可能なフラグを確認するには、インストール済みCLIのヘルプまたはコマンドリファレンスを使用してください。

3. 適切なアカウント経路を選ぶ

codex loginでアカウントのサインインフローが開始されます。完了する前に、ブラウザのアカウントとワークスペースを確認してください。OpenAI APIを直接課金する場合、文書化された代替方法では、標準入力からPlatformキーを受け取ります:

任意:OpenAI Platform API認証
# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

このAPIコマンドはOpenAI Platformキー用です。サードパーティーゲートウェイの完全なセットアップではありません。カスタムプロバイダーには、独自の設定、エンドポイント、認証情報の取得元、対応モデルが必要です。認証ドキュメントでは各経路を説明し、当社のCodex APIキーガイドではプロバイダー設定の詳細を扱っています。

4. 最初の応答を有用な最初のタスクに変える

  1. 関連するソースとテストの場所を尋ね、リポジトリと照合してください。
  2. 小さな変更を1つ選び、期待する動作を明記してください。
  3. クリーンなブランチまたはチェックポイントを使用し、その変更に適した権限を選択してください。
  4. Codexに関連するチェックを実行させ、その後、差分と説明を確認してください。

たとえば、失敗しているテスト1つ、または小さなドキュメント修正から始めてください。最初のタスクをアプリケーション全体の書き換えにしないでください。インストール、認証情報、ローカル依存関係、タスクの品質を一度に評価するのが難しくなります。短いループが機能したら、プロジェクトの指示を追加し、範囲を広げてください。

セットアップが止まったら、該当する層を修正

「コマンドが見つかりません」は、インストールまたはPATHを示します。401は認証を示します。モデルエラーは、選択したプロバイダーとモデルを示します。制限の警告は、利用量または課金を示します。動作している層は維持し、必要に応じて401チェックリストまたは利用上限ガイドに従ってください。実行ファイルを再インストールしても、アカウントの残高は補充されません。

ローカルのCodex作業でKunavoを評価するには、アカウントを作成し、Codex統合に従ってください。Responses互換のプロバイダー設定を使用します。大きなプロジェクトで新しい課金経路に依存する前に、小さなタスクを1つ確認してください。

よくある質問

Codex CLIをインストールするには?

お使いのOS向けの公式スタンドアロンインストーラー、またはnpmやHomebrewの代替手段を使用してください。必要に応じて新しいターミナルを開き、codex --versionを確認してから、プロジェクトディレクトリでCodexを起動し、認証方法を選択します。

npm install -g @openai/codexはまだサポートされていますか?

はい。2026年9月17日に確認した公式インストールドキュメントには、スタンドアロンインストーラーやHomebrewと並んでnpmも記載されています。インストール方法は1つだけ選び、競合するコピーを避けるため、その方法の更新手順を使用してください。

CodexのインストールにChatGPTのサブスクリプションは必要ですか?

インストールとモデルへのアクセスは別です。利用可能なChatGPTサインイン方法を選ぶか、対応するローカル作業向けに別請求のAPIアクセスを使用してください。支払い方法を決める前に、現在のアカウントオプションを確認してください。CLIをインストールしても、モデルクレジットは追加されません。

WindowsにCodexをインストールできますか?

はい。OpenAIはWindows用のスタンドアロンインストーラーを提供しています。代わりにWSL内で作業する場合は、その環境内にLinux版をインストールして実行し、プロジェクトパスと環境変数が別になることに注意してください。

公式インストールドキュメントとローカルCLIヘルプの確認日:2026年9月17日。