Codex CLI の接続設定

デスクトップ版は Codex App の設定を参照してください。

事前準備

AIMirrorX コンソールで API キーを作成し、Responses・ストリーミング・ツール呼び出しに対応するモデルとチャネルを確認してください。Chat Completions のみ対応するモデルでは、この設定を直接利用できません。

このガイドは Codex CLI のカスタム API Provider を設定します。モデルの利用権限と料金はアカウントに依存します。以下のモデル ID は置き換え用の値です。

1. Codex CLI のインストール

Node.js のインストール後、ターミナルで実行します。

npm install -g @openai/codex
codex --version

インストール済みの場合は次に進みます。必要な環境は公式 CLI ドキュメントを参照してください。Windows のネイティブ環境または WSL を利用できます。WSL で起動する場合、設定ファイルと環境変数も WSL 内に設定してください。

2. API キーの設定

Codex を起動するターミナルで設定します。macOS・Linux・WSL：

export AIMIRRORX_API_KEY="YOUR_AIMIRRORX_API_KEY"

Windows PowerShell：

$env:AIMIRRORX_API_KEY = "YOUR_AIMIRRORX_API_KEY"

YOUR_AIMIRRORX_API_KEY を自分の AIMirrorX キーに置き換えてください。この設定は現在のターミナルとその子プロセスにのみ有効です。新しいターミナルでは再設定が必要です。実際のキーをプロジェクト設定や Git に保存しないでください。

3. config.toml の設定

~/.codex/config.toml を開きます。Windows PowerShell では $HOME\.codex\config.toml です。CODEX_HOME を設定している場合は、そのディレクトリ内の config.toml を使用します。

model = "YOUR_RESPONSES_MODEL_ID"
model_provider = "aimirrorx"

[model_providers.aimirrorx]
name = "AIMirrorX"
base_url = "https://api.aimirrorx.com/v1"
env_key = "AIMIRRORX_API_KEY"
wire_api = "responses"
requires_openai_auth = false

YOUR_RESPONSES_MODEL_ID を、アカウントで利用できる Responses 対応モデル ID に置き換えてください。モデル一覧の確認例：

curl https://api.aimirrorx.com/v1/models \
  -H "Authorization: Bearer $AIMIRRORX_API_KEY"

一覧にあることだけでは Responses やツール呼び出しへの対応は保証されません。モデルの説明も確認してください。

既存設定に統合する場合、同じキーやテーブルを重複させず、他の設定を保持してください。トップレベルの model と model_provider は TOML のテーブル見出しより前に置きます。この方法では auth.json の編集は不要です。

4. 起動と確認

API キーを設定したターミナルでプロジェクトに移動します。

cd /path/to/your/project
codex

「このディレクトリのプロジェクトを要約して」のような簡単な依頼で確認し、モデルと Provider を確認してから開発に進みます。設定変更後は既存の Codex セッションを再起動してください。

よくある問題

関連ドキュメント

• AIMirrorX のプロトコルと URL
• Codex カスタム Provider
• 設定リファレンス
• 認証