# OpenAI Codex CLI インストールガイド - Windows、macOS、LinuxでターミナルAIプログラミングアシスタントをインストールし、New APIと連携します。サンドボックスポリシーとアトミックパッチ編集をサポート。











































































<Callout type="info" title="プロジェクト紹介">
  Codex CLIは、OpenAIが提供するコーディングエージェントで、お使いのコンピューター上でローカルに実行できます。

  * 公式サイト：[https://chatgpt.com/codex](https://chatgpt.com/codex)
  * プロジェクトサイト：[https://github.com/openai/codex](https://github.com/openai/codex)
</Callout>

## デモンストレーション

<img alt="introduce-01.webp" src={__img0} placeholder="blur" />

### 機能

| **機能カテゴリ**            | **機能**                                                                                                                 |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| ターミナルベースのコーディングアシスタント | Codex CLIは、コマンドラインでコードを編集し、パッチを生成し、コマンドを実行するためのターミナルベースの対話型コーディングアシスタントです。                                             |
| ツール駆動型アーキテクチャ         | `apply_patch`、`shell`、`update_plan`、`multi_tool_use`などのツールを提供し、リポジトリファイルと操作を制御された方法で変更します。                             |
| アトミックパッチ編集            | 専用のパッチ形式を使用して`apply_patch`を介してファイルをアトミックに追加/更新/削除し、監査とロールバックを容易にします。                                                   |
| サンドボックスと承認            | サンドボックスポリシー（例：`workspace-write`、`read-only`）と承認モード（`on-request`、`on-failure`、`never`）をサポートし、書き込みおよびネットワークアクセス権限を制御します。 |
| 計画追跡                  | `update_plan`はステップをリストアップし、ステータスを追跡するために使用され、明確な進捗を維持するために常に1つの`in_progress`ステップのみを要求します。                              |
| インタラクション規範            | 重要な操作の前に短い導入説明を送信し、友好的で簡潔なトーンを保ち、進捗状況の更新を提供します。                                                                        |
| セキュリティ制約              | 厳格なルール（無関係なファイルを勝手に変更しない、著作権ヘッダーを追加しない、破壊的なコマンドを実行しない）に従い、機密性の高い操作にはユーザーの承認が必要です。                                      |
| テストとフォーマット            | 変更後に適切なテストとフォーマットツールを実行することを推奨しますが、現在のタスクとは無関係な問題の修正は担当しません。                                                           |
| 出力とスタイル               | 最終出力はCLIレンダリング仕様（例：`**`の見出し、バッククォートでパス/コマンドを示す）に従い、スキャンしやすい簡潔な構造を維持します。                                                |
| 並列実行                  | `multi_tool_use.parallel`を介して複数のツールを並列実行し、効率を向上させます。                                                                   |

## AIモデル設定方法

### Windows版の図解ガイド

#### 1. ターミナルを開く

<img alt="windows_open_terminal" src={__img1} placeholder="blur" />

#### 2. WSLをインストールする

Windowsで最高のパフォーマンスを得るには、Windows Subsystem for Linux (WSL2) をインストールして使用してください。

<Callout type="info" title="WSL2をインストールし、Windowsコンピューターを再起動する">
  ```powershell
  wsl --install
  ```

  インストール完了後、Windowsコンピューターを再起動してください。
</Callout>

<Callout type="warn" title="Windowsでの注意事項">
  * CMDではなくPowerShellを使用することをお勧めします
  * 権限の問題が発生した場合は、管理者として実行してみてください
  * 一部のウイルス対策ソフトウェアが誤検知する可能性があるため、ホワイトリストに追加する必要があります
</Callout>

<img alt="windows-img-03.webp" src={__img2} placeholder="blur" />

<Callout type="info" title="Node Version Manager (NVM) をダウンロードする">
  ```bash
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
  ```
</Callout>

<img alt="windows-img-04.webp" src={__img3} placeholder="blur" />

<Callout type="info" title="NVMでNode.js 22をインストールする">
  タブバーで新しいPowerShellウィンドウを開き、WSLを開きます：

  ```bash
  wsl
  ```

  Node.jsをインストールします（バージョン番号は時間とともに変化するため、[OpenAI公式サイト](https://developers.openai.com/codex/windows)の要件に従って対応するバージョンをインストールしてください）：

  ```bash
  nvm install 22
  ```
</Callout>

<img alt="windows-img-05.webp" src={__img4} placeholder="blur" />

#### 3. Codex CLIをインストールする

<Callout type="info" title="Codex CLIをインストールする">
  ```bash
  npm i -g @openai/codex
  ```

  このコマンドは、npm公式リポジトリからCodex CLIの最新バージョンをダウンロードしてインストールします。
</Callout>

<img alt="windows-img-06.webp" src={__img5} placeholder="blur" />

#### 4. 設定ファイルを変更する

<Callout type="info" title="ワンクリックでCodex CLI設定ファイルを変更する">
  ```powershell
  iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.ps1')
  ```
</Callout>

<img alt="windows-configure" src={__img6} placeholder="blur" />

#### 5. Codex CLIの使用を開始する

これでCodex CLIを使い始めることができます！

<Callout type="info" title="Codex CLIを起動する">
  WSL2を起動します：

  ```bash
  wsl
  ```

  Codex CLIを直接起動します：

  ```bash
  codex
  ```

  特定のプロジェクトで使用する場合：

  ```bash
  cd mnt/c/path/to/your/project
  codex
  ```

  Enterキーを押してCodex CLIを起動します。
</Callout>

<img alt="windows-img-09.webp" src={__img7} placeholder="blur" />

<img alt="windows-img-10.webp" src={__img8} placeholder="blur" />

> Codex CLIの権限を設定します：1. Codexがファイルを直接変更することを許可する；2. Codexがファイルを変更するには手動での承認が必要

<Callout type="info" title="モデルを選択する">
  ```bash
  /model
  ```
</Callout>

<img alt="windows-img-11.webp" src={__img9} placeholder="blur" />

<img alt="windows-img-12.webp" src={__img10} placeholder="blur" />

<img alt="windows-img-13.webp" src={__img11} placeholder="blur" />

<img alt="windows-img-14.webp" src={__img12} placeholder="blur" />

> 注意：インターフェースアドレスを変更した後、すべてのモデル（公式プリセットモデルを含む）は、設定された、合法的に承認された独自のまたは組織のアクセスポイントを呼び出します。ご自身でデプロイしたNew APIを使用するか、サービスプロバイダーが合法的なアップストリーム承認とコンプライアンス義務を負うNew APIサービスであることを確認してください。出所不明のAPIアドレスやキーを本番環境に接続しないでください。

### macOS版の図解ガイド

#### 1. Homebrewをインストールする（既にインストール済みの場合はスキップ）

HomebrewはmacOSに不足しているパッケージのマネージャーです。

公式サイト：[https://brew.sh](https://brew.sh)

<img alt="macos-img-01.webp" src={__img13} placeholder="blur" />

<Callout type="info" title="Homebrewをインストールする">
  ```bash
  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  ```
</Callout>

<img alt="macos-img-02.webp" src={__img14} placeholder="blur" />

<img alt="macos-img-03.webp" src={__img15} placeholder="blur" />

<img alt="macos-img-04.webp" src={__img16} placeholder="blur" />

#### 2. Node.js環境をインストールする

<Callout type="info" title="Node.js環境のインストール手順">
  Homebrewを更新します：

  ```bash
  brew update
  ```

  Node.jsをインストールします：

  ```bash
  brew install node
  ```
</Callout>

<Callout type="warn" title="macOSでの注意事項">
  * 権限の問題が発生した場合は、`sudo`を使用する必要があるかもしれません
  * 初回実行時にはシステム環境設定で許可が必要な場合があります
  * TerminalまたはiTerm2を使用することをお勧めします
</Callout>

<img alt="macos-img-05.webp" src={__img17} placeholder="blur" />

<img alt="macos-img-06.webp" src={__img18} placeholder="blur" />

<Callout type="info" title="インストールが成功したか確認する">
  インストール完了後、ターミナルを開き、以下のコマンドを入力してください：

  ```bash
  node --version
  npm --version
  ```

  バージョン番号が表示されれば、インストールは成功です。
</Callout>

#### 3. Codex CLIをインストールする

<Callout type="info" title="Codex CLIをインストールする">
  ターミナルを開き、以下のコマンドを実行してください：

  ```bash
  # Codex CLIをグローバルにインストールする
  npm install -g @openai/codex
  ```

  権限の問題が発生した場合は、sudoを使用できます：

  ```bash
  sudo npm install -g @openai/codex
  ```
</Callout>

<img alt="macos-img-07.webp" src={__img19} placeholder="blur" />

<Callout type="info" title="Codex CLIのインストールを確認する">
  インストール完了後、以下のコマンドを入力してインストールが成功したか確認してください：

  ```bash
  codex --version
  ```

  バージョン番号が表示されれば、おめでとうございます！Codex CLIは正常にインストールされました。
</Callout>

#### 4. 設定ファイルを変更する

<Callout type="info" title="ワンクリックでCodex CLI設定ファイルを変更する">
  ```bash
  curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.sh | bash
  ```
</Callout>

<img alt="macos-configure" src={__img20} placeholder="blur" />

#### 5. Codex CLIの使用を開始する

これでCodex CLIを使い始めることができます！

<Callout type="info" title="Codex CLIを起動する">
  Codex CLIを直接起動します：

  ```bash
  codex
  ```

  特定のプロジェクトで使用する場合：

  ```bash
  cd /path/to/your/project
  codex
  ```

  Enterキーを押してCodex CLIを起動します。
</Callout>

<img alt="macos-img-09.webp" src={__img21} placeholder="blur" />

<img alt="macos-img-10.webp" src={__img22} placeholder="blur" />

> Codex CLIの権限を設定します：1. Codexがファイルを直接変更することを許可する；2. Codexがファイルを変更するには手動での承認が必要

<img alt="macos-img-11.webp" src={__img23} placeholder="blur" />

<img alt="macos-img-12.webp" src={__img24} placeholder="blur" />

<img alt="macos-img-13.webp" src={__img25} placeholder="blur" />

<img alt="macos-img-14.webp" src={__img26} placeholder="blur" />

> 注意：インターフェースアドレスを変更した後、すべてのモデル（公式プリセットモデルを含む）は、設定された、合法的に承認された独自のまたは組織のアクセスポイントを呼び出します。

#### 6. macOSのよくある問題解決

<Callout type="info" title="インストール時に権限エラーが表示される">
  以下の解決策を試してください：

  * `sudo`を使用してインストールする：`sudo npm install -g @openai/codex`
  * または、`npm`がユーザーディレクトリを使用するように設定する：`npm config set prefix ~/.npm-global`
</Callout>

<Callout type="info" title="macOSのセキュリティ設定が実行をブロックする">
  システムがCodex CLIの実行をブロックする場合：

  * 「システム環境設定」→「セキュリティとプライバシー」を開く
  * 「それでも開く」または「許可」をクリックする
  * またはTerminalで実行する：`sudo spctl --master-disable`
</Callout>

### Linux版の図解ガイド

#### 1. Node.js環境をインストールする

Codex CLIはNode.js環境で動作します。

<Callout type="info" title="Node.js環境のインストール手順">
  NodeSourceリポジトリを追加します：

  ```bash
  sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  ```

  Node.jsをインストールします：

  ```bash
  sudo apt-get install -y nodejs
  ```
</Callout>

<Callout type="warn" title="Linuxでの注意事項">
  * 一部のディストリビューションでは追加の依存関係のインストールが必要な場合があります
  * 権限の問題が発生した場合は、sudoを使用してください
  * npmのグローバルディレクトリにユーザーが書き込み権限を持っていることを確認してください
</Callout>

<img alt="linux-img-01.webp" src={__img27} placeholder="blur" />

<img alt="linux-img-02.webp" src={__img28} placeholder="blur" />

<Callout type="info" title="インストールが成功したか確認する">
  インストール完了後、ターミナルを開き、以下のコマンドを入力してください：

  ```bash
  node --version
  npm --version
  ```

  バージョン番号が表示されれば、インストールは成功です。
</Callout>

#### 2. Codex CLIをインストールする

<Callout type="info" title="Codex CLIをインストールする">
  ターミナルを開き、以下のコマンドを実行してください：

  ```bash
  # Codex CLIをグローバルにインストールする
  npm install -g @openai/codex
  ```

  権限の問題が発生した場合は、sudoを使用できます：

  ```bash
  sudo npm install -g @openai/codex
  ```
</Callout>

<img alt="linux-img-03.webp" src={__img29} placeholder="blur" />

<Callout type="info" title="Codex CLIのインストールを確認する">
  インストール完了後、以下のコマンドを入力してインストールが成功したか確認してください：

  ```bash
  codex --version
  ```

  バージョン番号が表示されれば、おめでとうございます！Codex CLIは正常にインストールされました。
</Callout>

#### 3. 設定ファイルを変更する

<Callout type="info" title="ワンクリックでCodex CLI設定ファイルを変更する">
  ```bash
  curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/codex-cli-setup.sh | bash
  ```
</Callout>

<img alt="macos-configure" src={__img30} placeholder="blur" />

#### 4. Codex CLIの使用を開始する

これでCodex CLIを使い始めることができます！

<Callout type="info" title="Codex CLIを起動する">
  Codex CLIを直接起動します：

  ```bash
  codex
  ```

  特定のプロジェクトで使用する場合：

  ```bash
  # プロジェクトディレクトリに移動する
  cd /path/to/your/project

  # Codex CLIを起動する
  codex
  ```

  Enterキーを押してCodex CLIを起動します。
</Callout>

<img alt="linux-img-05.webp" src={__img31} placeholder="blur" />

<img alt="linux-img-06.webp" src={__img32} placeholder="blur" />

> Codex CLIの権限を設定します：1. Codexがファイルを直接変更することを許可する；2. Codexがファイルを変更するには手動での承認が必要

<img alt="linux-img-07.webp" src={__img33} placeholder="blur" />

<img alt="linux-img-08.webp" src={__img34} placeholder="blur" />

<img alt="linux-img-09.webp" src={__img35} placeholder="blur" />

<img alt="linux-img-10.webp" src={__img36} placeholder="blur" />

> 注意：インターフェースアドレスを変更した後、すべてのモデル（公式プリセットモデルを含む）は、設定された、合法的に承認された独自のまたは組織のアクセスポイントを呼び出します。

#### 5. Linuxのよくある問題解決

<Callout type="info" title="インストール時に権限エラーが表示される">
  以下の解決策を試してください：

  * `sudo`を使用してインストールする：`sudo npm install -g @openai/codex`
  * または、`npm`がユーザーディレクトリを使用するように設定する：`npm config set prefix ~/.npm-global`
  * そしてPATHに追加する：`export PATH=~/.npm-global/bin:$PATH`
</Callout>

<Callout type="info" title="依存ライブラリが不足している">
  一部のLinuxディストリビューションでは追加の依存関係のインストールが必要です：

  ```bash
  # Ubuntu/Debian
  sudo apt install build-essential

  # CentOS/RHEL
  sudo dnf groupinstall "Development Tools"
  ```
</Callout>