Codex を CodingPlanX カスタムモデルと連携する

CodingPlanX.ai の API キーを使用して OpenAI Codex CLI を設定する

Codex 統合設定ガイド

CodingPlanX.ai は Claude Code だけでなく、OpenAI Codex CLI もサポートしています。プラン購入後、Claude Code と Codex はプランの利用枠を共有するため、どのツールを使用するか柔軟に選択できます。

Codex CLI のインストール

npm install -g @openai/codex

インストールの確認：

codex --version

最新バージョン：v0.114.0（2026-03-11）、Skills システムや Hooks エンジンなどの新機能をサポート。

利用可能なモデル

CodingPlanX.ai を通じて以下の Codex/GPT モデルを利用できます：

すべてのモデルは Claude Code と CodingPlanX.ai のプラン利用枠を共有します。

設定の概要

Codex CLI では以下の2つのファイルを設定する必要があります：

• ~/.codex/config.toml - サービス設定
• ~/.codex/auth.json - 認証設定

---

Windows の設定

ステップ 1：設定ディレクトリの作成

mkdir %HOMEPATH%\.codex

ステップ 2：config.toml の作成

~/.codex/config.toml に設定ファイルを作成します：

model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

ステップ 3：auth.json の作成

~/.codex/auth.json に認証ファイルを作成します：

{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}

cr_xxxxxxxxxx をあなたの CodingPlanX.ai API キー に置き換えてください。

ステップ 4：環境変数の設定（オプション）

環境変数を通じてキーを提供したい場合は：

# 一時的な設定
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

# 永続的な設定
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)

その後、auth.json の OPENAI_API_KEY を null に設定します。

---

macOS の設定

ステップ 1：設定ディレクトリの作成

mkdir -p ~/.codex

ステップ 2：config.toml の作成

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

ステップ 3：auth.json の作成

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

cr_xxxxxxxxxx をあなたの CodingPlanX.ai API キー に置き換えてください。

ステップ 4：環境変数の設定（オプション）

環境変数を通じてキーを提供したい場合は：

# 一時的な設定
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# 永続的な設定
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

その後、auth.json の OPENAI_API_KEY を null に設定します。

---

Linux の設定

ステップ 1：設定ディレクトリの作成

mkdir -p ~/.codex

ステップ 2：config.toml の作成

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

ステップ 3：auth.json の作成

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

cr_xxxxxxxxxx をあなたの CodingPlanX.ai API キー に置き換えてください。

ステップ 4：環境変数の設定（オプション）

環境変数を通じてキーを提供したい場合は：

# 一時的な設定
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# 永続的な設定（Bash）
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# 永続的な設定（Zsh）
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

その後、auth.json の OPENAI_API_KEY を null に設定します。

---

設定の確認

設定完了後、Codex CLI を実行して確認します：

codex

成功のサイン

• Codex が正常に起動し、サービスに接続できる
• コードが正常に生成され、AI の応答が得られる
• ネットワークリクエストが CodingPlanX.ai プロキシサービスを経由している

よくある質問

設定ファイルが見つからない

問題：Codex が設定ファイルが見つからないと警告する

解決策：

1. 設定ファイルのパスが正しいか確認してください
2. ~/.codex/ ディレクトリが存在することを確認してください
3. config.toml と auth.json ファイルが存在することを確認してください

API キーの認証失敗

問題：環境変数が無効か、API キーが間違っている

解決策：

1. 環境変数 CRS_OAI_KEY が正しく設定されているか確認してください
2. API キーの形式が正しいか確認してください（cr_ で始まる必要があります）
3. キーの有効期限が切れていないか、コンソール にアクセスして確認してください

ネットワーク接続の問題

問題：CodingPlanX.ai サービスに接続できない

解決策：

1. ネットワーク接続が正常か確認してください
2. base_url の設定が https://api.codingplanx.ai になっているか確認してください