Codex 設定

1. OpenAI Codex CLI の概要とシステム要件

OpenAI Codex CLI は OpenAI が提供するローカルのコーディングエージェントです。ターミナルでリポジトリを理解し、コードを変更し、コマンドを実行できます。また、VS Code、Cursor、Windsurf などのエディタと組み合わせて使用できます。

開始前に、次の環境を用意してください。

正常に使用できるターミナル環境
Node.js 16 以上
RouteAPI コンソールで作成した API キー
RouteAPI コンソールで利用可能な OpenAI プロトコルモデル

2. OpenAI Codex CLI のインストール

グローバルインストール

npm install -g @openai/codex

Homebrew を使用している場合は、次の方法でもインストールできます。

brew install --cask codex

インストール確認

codex --version

バージョン番号が出力されれば、インストールは成功です。

3. RouteAPI の設定

Codex のユーザーレベル設定ファイルは、デフォルトで ~/.codex/config.toml です。Windows では通常 %USERPROFILE%\.codex\config.toml に対応します。

3.1 API キー環境変数を設定する

macOS / Linux / WSL の bash、zsh、sh を使用している場合:

export ROUTEAPI_KEY="あなたの RouteAPI キー"

Windows PowerShell を使用している場合:

$env:ROUTEAPI_KEY="あなたの RouteAPI キー"

3.2 `config.toml` に書き込む

model = "あなたのモデル名"
model_provider = "routeapi"

[model_providers.routeapi]
name = "RouteAPI"
base_url = "https://www.routeapi.ai/v1"
env_key = "ROUTEAPI_KEY"
wire_api = "responses"

上記の設定では、次の意味になります。

model: RouteAPI コンソールで利用可能な OpenAI プロトコルモデル名を指定します。
model_provider: 現在のセッションでカスタム routeapi provider を使用することを指定します。
base_url: 固定で https://www.routeapi.ai/v1 を指定します。
env_key: Codex が ROUTEAPI_KEY 環境変数からキーを読み取ることを示します。

3.3 Codex を起動する

codex

より慎重な既定動作で実行したい場合は、config.toml に次の 2 項目を追加できます。

approval_policy = "on-request"
sandbox_mode = "workspace-write"

4. IDE 連携設定

上記の config.toml を設定すると、Codex の IDE 拡張は通常同じ設定をそのまま再利用できます。そのため、エディタ側で RouteAPI のアドレスやキーを重複して入力する必要はありません。

VS Code / Cursor / Windsurf

Codex 公式 IDE 拡張をインストールします。
エディタを再起動します。
プロジェクトを開き、Codex を起動します。
拡張が新しい設定をすぐに読み取らない場合は、ワークスペースを開き直すか、エディタを一度再起動します。

JetBrains IDE

IntelliJ IDEA、PyCharm、WebStorm、GoLand などの JetBrains IDE で Codex を使用する場合は、先に上記の CLI 設定を完了し、その後 IDE 内の Codex ウィザードに従って連携してください。これにより、ターミナルと IDE が同じ RouteAPI 設定を使用し、ツールを切り替えるたびに再設定する必要がなくなります。