--- title: Codex App | RunAPI description: Codex AppのモデルプロバイダーとしてRunAPIを使用し、Responses互換モデルを選択して接続を検証します。 url: https://runapi.ai/ja/docs/resources/tool-integrations/codex-app.md canonical: https://runapi.ai/ja/docs/resources/tool-integrations/codex-app locale: ja --- > HTML 版: https://runapi.ai/ja/docs/resources/tool-integrations/codex-app > エージェント向けサイトインデックス: https://runapi.ai/llms.txt # Codex App ## 概要 CodexはWindowsおよびmacOS向けのChatGPTデスクトップアプリで利用できます。このガイドでは、ローカルのCodex AppをRunAPIのOpenAI互換Responsesエンドポイントに向け、RunAPIモデルを選択して接続を確認します。 これはレスポンスとコードの生成に使用されるモデルプロバイダーを変更します。RunAPIツールは追加されません。[Hosted MCP](https://runapi.ai/ja/docs/resources/mcp/hosted.md)は独自のクライアントと認証要件を持つ別の統合です。 ## 始める前に * 現在の[ChatGPTデスクトップアプリ][1]をインストールし、サインインして、Codexを少なくとも1回開いてください。 * [認証ガイド](https://runapi.ai/ja/docs/guides/authentication.md)に従い、専用の標準RunAPI APIキーを作成してください。キーをリポジトリにコミットしないでください。 * [モデルカタログ](https://runapi.ai/ja/models)から、Responses APIをサポートするモデルの正確な識別子をコピーしてください。 [1]: https://developers.openai.com/codex/app これらの手順は、ユーザーレベルの設定を読み込むローカル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の[カスタムモデルプロバイダー設定][1]を参照してください。 [1]: https://developers.openai.com/codex/config-advanced#custom-model-providers ## モデルを選択する `YOUR_RUNAPI_MODEL_ID` を[モデルカタログ](https://runapi.ai/ja/models)からコピーした正確な識別子に置き換えてください。Responses API を公開するモデルを選択してください。Chat Completions のみのサポートはこの設定には不十分です。 `model` を変更する場合は、アプリを完全に再起動して新しいタスクを開始してください。既存のタスクは、開始時のモデルとプロバイダーを保持する場合があります。 ## 再起動して確認する 1. ChatGPTデスクトップアプリを完全に終了し、再度開いてください。 2. Codexを開き、リポジトリで新しいタスクを開始してください。 3. `Describe this repository in one sentence.` のような短いプロンプトを送信してください。 4. Codexが正常なレスポンスを返し、RunAPIが選択したモデルに対して `POST /v1/responses` リクエストを記録していることを確認してください。 設定エラーをタスク固有の動作から分離しやすくするため、最初の検証は短くしてください。 ## RunAPI ツールを追加 上記のモデルプロバイダーはCodexの推論をRunAPI経由でルーティングします。MCPは別です：対応クライアントがモデル検出、アカウント情報、サポートされているタスクワークフローのためにRunAPIツールを呼び出せるようにします。 [Hosted MCPガイド](https://runapi.ai/ja/docs/resources/mcp/hosted.md)では、現在サポートされているクライアントと認証要件について説明しています。CodexのHosted MCP認証は検証されていないため、このページではCodexのMCPセットアップ手順を提供していません。モデルプロバイダー設定をMCPサーバーエントリに置き換えないでください。両方の統合は異なる目的を果たします。 ## トラブルシューティング * **Codex が以前のプロバイダーを使い続ける:** ファイルが `~/.codex/config.toml` であることを確認し、重複する `model` または `model_provider` キーを削除して、アプリを完全に再起動し、新しいタスクを開始してください。 * **`RUNAPI_API_KEY` が見つからない:** キーが `~/.codex/.env` にあることを確認してください。ターミナルプロファイルのみへの設定では不十分です。その後、アプリを再起動してください。 * **認証に失敗する:** [認証ガイド](https://runapi.ai/ja/docs/guides/authentication.md)から標準キーを作成またはローテーションしてください。キーを `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 を削除する 1. `~/.codex/config.toml` から RunAPI の `model`、`model_provider`、および `[model_providers.runapi]` の値を削除するか、以前使用していたプロバイダーの値を復元します。 2. 他のローカルツールが使用していない場合は、`~/.codex/.env` から `RUNAPI_API_KEY` を削除します。 3. アプリを完全に再起動し、新しいタスクを開始します。 4. 不要になったら、RunAPI の専用キーを失効させます。 ## 次のステップ 共通のプロトコル動作については [LLM API Quickstart](https://runapi.ai/ja/docs/guides/llm-api/quickstart.md) を、正確なリクエストおよびレスポンスフィールドについては [Responses API Reference](https://runapi.ai/ja/docs/api/openai/responses.md) を参照してください。必要に応じて、[Model Catalog](https://runapi.ai/ja/models)、[Authentication Guide](https://runapi.ai/ja/docs/guides/authentication.md)、または [Hosted MCP](https://runapi.ai/ja/docs/resources/mcp/hosted.md) に進んでください。 --- ## RunAPI のその他の情報 - [ホーム](https://runapi.ai/ja/.md) - [モデルカタログ](https://runapi.ai/ja/models.md) - [料金](https://runapi.ai/ja/pricing.md) - [プロバイダー](https://runapi.ai/ja/models) - [ドキュメント](https://runapi.ai/ja/docs/guides) - [SDK](https://runapi.ai/ja/sdk.md) - [CLI](https://runapi.ai/ja/cli.md) - [MCP Server](https://runapi.ai/ja/mcp.md) - [Claude Code と Cursor](https://runapi.ai/ja/claude-code-vs-cursor.md) - [Cursor API セットアップ](https://runapi.ai/ja/cursor-api-setup.md) - [RunAPI と OpenRouter の比較](https://runapi.ai/ja/openrouter-alternative.md) - [エンタープライズ](https://runapi.ai/ja/contact.md) - [お問い合わせ](https://runapi.ai/ja/contact.md) - [利用規約](https://runapi.ai/ja/terms.md) - [プライバシー](https://runapi.ai/ja/privacy.md) - [エージェント向けサイトインデックス](https://runapi.ai/llms.txt) お問い合わせ: contact@runapi.ai ## 構造化データ ```json [ { "@context": "https://schema.org", "inLanguage": "ja", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ja", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ja/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ja", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/jaicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "TechArticle", "headline": "Codex App", "description": "Codex AppのモデルプロバイダーとしてRunAPIを使用し、Responses互換モデルを選択して接続を検証します。", "url": "https://runapi.ai/ja/docs/resources/tool-integrations/codex-app", "mainEntityOfPage": "https://runapi.ai/ja/docs/resources/tool-integrations/codex-app" } ] ```