Codex CLI：APIキーとカスタムプロバイダーの設定

このガイドを使って、ローカルのCodex CLIでの作業をAI Prime Techに接続します。ゲートウェイアカウント、利用するCodexグループの有効なキー、そのキーで利用できるモデルが必要です。まずは Codex APIの概要 をご覧ください。まだアクセスの種類を選んでいる場合は、こちらから始めてください。

1。キーとグループを確認する

ダッシュボードでキーを作成します。前払いのGPTアクセスで使用するのは Codex グループです。時間制のCodexアクセスが提供されている場合は、そのプランに表示されているグループと利用条件に従ってください。Claudeへのアクセスは別扱いです。使用するキーで利用可能なモデル一覧を確認してください。

現在のターミナルでキーを設定します。プレースホルダーはローカルで置き換え、キーをリポジトリにコミットしないでください。

PowerShell

$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

bashまたはzsh

export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

環境変数を設定する前に起動したターミナルやエディターが変数を認識できない場合は、再起動してください。これらの例では、現在のプロセスとその子プロセスに対して変数を設定します。

2。プロバイダーを設定する

この設定をユーザーレベルの設定ファイルに統合してください： ~/.codex/config.toml。Windowsでの対応するパスは %USERPROFILE%\.codex\config.tomlです。プロバイダーの認証情報はユーザー設定に保存してください。リポジトリ内の次のファイルには保存しないでください： .codex/config.toml.

model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

プロバイダーIDには、次のような値を使用し、 aiprimetech 次の設定値を model_provider 対応するテーブルに一致させてください。現在のCodexはResponsesプロトコルを使用します。ベースURLはゲートウェイの /v1 ルートです。Codexがリクエストパスを追加します。この設定ではHTTP/SSEトランスポートを使用します。

3。接続を確認する

次のコマンドを実行します： codex doctor これでCLI設定を確認できます。次を起動し、 codex続いて次を使用します： /status これでプロバイダーとモデルを確認できます。大規模なリポジトリ作業を許可する前に、短い回答を求めてください。AI Prime Techの使用状況ページにリクエストが表示されることを確認してください。

Codexとは別に、キーのモデル一覧を確認できます：

Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

返されたカタログに使用するモデルが含まれていてもリクエストが失敗する場合は、実際のエラーと現在のグループの利用可否を確認してください。IDが一覧に載っているだけでは、推論テストが成功したことにはなりません。

必要に応じてCLIプロファイルを用意する

特定のCLIセッションでのみこのプロバイダーを選択するには、上記の設定を次のファイルに保存し、 ~/.codex/aiprimetech.config.toml 次のコマンドで起動します：

codex --profile aiprimetech

Codex 0.134.0以降では、CLIプロファイルに個別のファイルを使用します。以前の [profiles.aiprimetech] の例は、現在のプロファイル形式ではありません。IDE拡張機能はユーザーレベルの設定を使用します。CLIのプロファイル切り替えがIDEにも適用されたと思い込まず、再起動後に有効なプロバイダーを確認してください。

モデルを選ぶ

使用するモデルは、 gpt-6.1-sol をコーディングの出発点として、 gpt-6-astra を難易度の高いタスクに、または gpt-6-luna を範囲を絞った作業に使ってください。 gpt-6-sol は、既存のSolワークフロー用の別のIDです。参照： モデルの詳細 と 比較方法.

トラブルシューティング

Claudeとホスト型Codexの機能

ゲートウェイのResponses変換を介してClaudeを使用する場合は、次の手順に従ってください： CodexでClaudeを使用する 互換性のあるClaudeグループのキーを使用してください。上記のGPTの例は、Codexグループでのアクセス用です。

ゲートウェイへのアクセスには、ChatGPTワークスペースの利用権やCodexクラウドへのアクセスは含まれません。参照： サインイン方法の比較 各製品の適用範囲を確認してください。

参考資料

• OpenAI：ゲートウェイ経由でプロバイダーの認証情報を使用する
• OpenAI：設定リファレンス
• OpenAI：高度な設定とプロファイル