開発者向けリソース

Codex App

Codex AppのモデルプロバイダーとしてRunAPIを使用し、Responses互換モデルを選択して接続を検証します。

概要

CodexはWindowsおよびmacOS向けのChatGPTデスクトップアプリで利用できます。このガイドでは、ローカルのCodex AppをRunAPIのOpenAI互換Responsesエンドポイントに向け、RunAPIモデルを選択して接続を確認します。

これはレスポンスとコードの生成に使用されるモデルプロバイダーを変更します。RunAPIツールは追加されません。Hosted MCPは独自のクライアントと認証要件を持つ別の統合です。

始める前に

現在のChatGPTデスクトップアプリをインストールし、サインインして、Codexを少なくとも1回開いてください。
認証ガイドに従い、専用の標準RunAPI APIキーを作成してください。キーをリポジトリにコミットしないでください。
モデルカタログから、Responses APIをサポートするモデルの正確な識別子をコピーしてください。

これらの手順は、ユーザーレベルの設定を読み込むローカルCodexクライアントを設定します。ホストされたCodexクラウドタスクは設定しません。

APIキーを保存する

デスクトップアプリはシェルから環境変数を継承しない場合があります。 ~/.codex/.envを作成または編集し、キーを独立した行に追加してください：

DOTENV

export RUNAPI_API_KEY=YOUR_RUNAPI_API_KEY

このファイルはリポジトリの外に保管してください。macOS および Linux では、ユーザーアカウントのみにアクセスを制限してください:

SHELL

chmod 600 ~/.codex/.env

RunAPIを設定する

ユーザーレベルの~/.codex/config.tomlを開いてください。以下の値を既存のファイルにマージしてください。関係のない設定を置き換えたり、既存のトップレベルキーを2つ目追加したりしないでください：

TOML

model = "YOUR_RUNAPI_MODEL_ID"
model_provider = "runapi"

[model_providers.runapi]
name = "RunAPI"
base_url = "https://runapi.ai/v1"
env_key = "RUNAPI_API_KEY"
wire_api = "responses"

プロバイダーと認証の設定はユーザーレベルで行う必要があります。Codex はプロジェクトの .codex/config.toml 内の model_provider と model_providers を無視します。TOML には環境変数名のみが格納され、API キーは ~/.codex/.env に保持されます。

base_urlはAPIルートであり、操作URLではありません。wire_api = "responses"の場合、CodexはPOST /v1/responsesを送信します。プロバイダーコントラクトについてはOpenAIのカスタムモデルプロバイダー設定を参照してください。

モデルを選択する

YOUR_RUNAPI_MODEL_ID をモデルカタログからコピーした正確な識別子に置き換えてください。Responses API を公開するモデルを選択してください。Chat Completions のみのサポートはこの設定には不十分です。

model を変更する場合は、アプリを完全に再起動して新しいタスクを開始してください。既存のタスクは、開始時のモデルとプロバイダーを保持する場合があります。

再起動して確認する

ChatGPTデスクトップアプリを完全に終了し、再度開いてください。
Codexを開き、リポジトリで新しいタスクを開始してください。
Describe this repository in one sentence. のような短いプロンプトを送信してください。
Codexが正常なレスポンスを返し、RunAPIが選択したモデルに対して POST /v1/responses リクエストを記録していることを確認してください。

設定エラーをタスク固有の動作から分離しやすくするため、最初の検証は短くしてください。

RunAPI ツールを追加

上記のモデルプロバイダーはCodexの推論をRunAPI経由でルーティングします。MCPは別です：対応クライアントがモデル検出、アカウント情報、サポートされているタスクワークフローのためにRunAPIツールを呼び出せるようにします。

Hosted MCPガイドでは、現在サポートされているクライアントと認証要件について説明しています。CodexのHosted MCP認証は検証されていないため、このページではCodexのMCPセットアップ手順を提供していません。モデルプロバイダー設定をMCPサーバーエントリに置き換えないでください。両方の統合は異なる目的を果たします。

トラブルシューティング

Codex が以前のプロバイダーを使い続ける: ファイルが ~/.codex/config.toml であることを確認し、重複する model または model_provider キーを削除して、アプリを完全に再起動し、新しいタスクを開始してください。
RUNAPI_API_KEY が見つからない: キーが ~/.codex/.env にあることを確認してください。ターミナルプロファイルのみへの設定では不十分です。その後、アプリを再起動してください。
認証に失敗する: 認証ガイドから標準キーを作成またはローテーションしてください。キーを config.toml やサポートログに貼り付けないでください。
リクエストが 404 を返す: base_url を https://runapi.ai/v1 に設定してください。https://runapi.ai/v1/responses ではありません。
モデルが利用できないかフィールドを拒否する: 識別子を再度正確にコピーし、モデルが Responses API および要求された機能をサポートしていることを確認してください。
Codex が別のモデルを選択する: 信頼されたプロジェクトの .codex/config.toml ファイルに model のオーバーライドがないか確認してください。プロジェクト設定はモデルを選択できますが、ユーザーレベルのプロバイダーを置き換えることはできません。
CLI は動作するがアプリが失敗する: ~/.codex/.env を確認し、アプリを完全に再起動してください。GUI アプリケーションはシェルによってのみエクスポートされた変数を読み込まない場合があります。
クラウドタスクが RunAPI を使用しない: このローカル設定はローカルの Codex クライアントに適用されます。ホストされたクラウドタスクはお使いのコンピューターのファイルを読み込みません。

RunAPI を削除する

~/.codex/config.toml から RunAPI の model、model_provider、および [model_providers.runapi] の値を削除するか、以前使用していたプロバイダーの値を復元します。
他のローカルツールが使用していない場合は、~/.codex/.env から RUNAPI_API_KEY を削除します。
アプリを完全に再起動し、新しいタスクを開始します。
不要になったら、RunAPI の専用キーを失効させます。

次のステップ

共通のプロトコル動作については LLM API Quickstart を、正確なリクエストおよびレスポンスフィールドについては Responses API Reference を参照してください。必要に応じて、Model Catalog、Authentication Guide、または Hosted MCP に進んでください。