Source: https://aiprimetech.io/ja/learn/use-claude-api-with-codex/ [ホーム](/ja/) / [学習](/ja/learn/) / カスタムプロバイダーを使用するCodex CLI：config.toml、GPTおよびClaudeモデル、IDE拡張機能と問題の解決 # カスタムプロバイダーでCodex CLIを使う：config.toml、GPTとClaudeのモデル、IDE拡張機能、問題の解決方法 Codexが読み取るファイルは ~/.codex/config.tomlで、CLI、 codex exec およびIDE拡張機能で共有されます。このファイルにカスタムプロバイダーを設定すると、Codexの接続先がこのゲートウェイになり、同じ設定でGPTモデルとClaudeモデルを実行できます。現在のCodexバージョンはResponses API（wire_api = "responses"）のみを使用するため、 wire_api = "chat" を使用する古いガイドは、現在では機能しません。 ## Codexをインストール ターミナルコピー ``` # macOS / Linux curl -fsSL https://chatgpt.com/codex/install.sh | sh # or with a package manager npm install -g @openai/codex brew install --cask codex codex --version ``` Windows PowerShellコピー ``` powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" ``` VS Code、Cursor、Windsurf向けのCodex拡張機能は、エディターの拡張機能マーケットプレイスからインストールでき、CLIと同じ ~/.codex/config.toml を使用するため、以下の内容は両方に適用されます。 ## 適切なグループのキーを使用 ゲートウェイのキーは特定のグループに属し、そのグループによってキーで呼び出せるモデルが決まります。GPTモデルの場合は、ダッシュボードの**Codex**グループでキーを作成してください。Claudeモデルの場合は、Claudeの従量課金キーならどれでも使用できます。無制限グループのキーには有効なプランが必要です。有効なプランがないと、すべてのリクエストが次のエラーで失敗します： No active subscription found for this group. ~/.bashrcまたは~/.zshrcコピー ``` export AIPRIME_CODEX_KEY=key_from_the_codex_group # GPT models export AIPRIME_CLAUDE_KEY=key_from_a_claude_group # Claude models ``` Windowsコピー ``` setx AIPRIME_CODEX_KEY "key_from_the_codex_group" setx AIPRIME_CLAUDE_KEY "key_from_a_claude_group" # open a new terminal afterwards ``` ## GPTモデル用のconfig.toml ~/.codex/config.tomlコピー ``` model_provider = "aiprime" model = "gpt-6-astra" model_reasoning_effort = "high" [model_providers.aiprime] name = "AI Prime Tech" base_url = "https://aiprimetech.io/v1" env_key = "AIPRIME_CODEX_KEY" wire_api = "responses" supports_websockets = false ``` | 設定として | 理由 | [model_providers.aiprime] | 予約済みの次の値を除く任意のID： openai, ollama と lmstudio | base_url = "https://aiprimetech.io/v1" | Codexが /responses を末尾に追加します | env_key | キー自体ではなく、キーを格納する環境変数の**名前** | wire_api = "responses" | 現在のCodexが受け付ける唯一の値 | supports_websockets = false | Codexで通常のHTTPストリーミングを使用し続けるため、どのプロキシやVPN経由でも動作します 次の設定を追加しないでください： requires_openai_auth = true または experimental_bearer_token このプロバイダーでは、次の設定を使用すると、 requires_openai_auth = true Codexは次の設定を無視し、 env_key 代わりにChatGPTまたはOpenAIのログイン情報を送信するため、ゲートウェイに拒否されます。 ## ClaudeモデルでCodexを実行 ゲートウェイはClaudeモデル向けのResponses APIリクエストを受け付けて変換するため、CodexでClaudeを使用することもできます。Claudeのキーを使用する別のプロバイダーを追加し、そのプロバイダーに切り替えるためのプロファイルを追加してください。 ~/.codex/config.toml（最初のプロバイダーの下に追加）コピー ``` [model_providers.aiprime_claude] name = "AI Prime Tech (Claude)" base_url = "https://aiprimetech.io/v1" env_key = "AIPRIME_CLAUDE_KEY" wire_api = "responses" supports_websockets = false ``` ~/.codex/claude.config.tomlコピー ``` model_provider = "aiprime_claude" model = "claude-sonnet-5" model_reasoning_effort = "high" ``` ターミナルコピー ``` codex --profile claude codex exec --profile claude "review the last commit for bugs" ``` Codex 0.134.0以降、プロファイルは個別のファイル ~/.codex/.config.tomlとなり、そのキーは最上位に配置します。 [profiles.] 内のテーブルは config.toml で読み取られなくなりました。プロファイルとプロバイダーはユーザー設定でのみ設定できます。プロジェクトの .codex/config.toml は次の設定を無視します： model_provider と model_providers. ## モデルと推論の強度 | モデルID | プロバイダー | 用途 | gpt-6-astra | Codexグループのキー | ゲートウェイで最も強力なGPTモデル。長時間のエージェントタスク向け | gpt-6-sol | Codexグループのキー | 日常的なコーディング向けの、より高速で安価なGPT | gpt-5.6-terra | Codexグループのキー | 軽いタスクと簡単な編集 | claude-sonnet-5 | Claudeのキー | コーディング作業向けの標準的なClaude | claude-opus-5-5 | Claudeのキー | より難しい推論と大規模なリファクタリング | claude-fable-5-1 | Claudeのキー | 最も高性能で、最も高額 model_reasoning_effort が受け付ける値は low, medium, high, xhigh または maxで、モデルによって異なります。次の値は設定しないでください： none。これらのモデルは次のエラーで拒否します： 'none' is not supported. review_model で、次の用途に別のモデルを設定できます： /review 。別のモデルを使用したい場合に設定してください。ダッシュボードには、キーのグループで呼び出せるすべてのモデルが表示されます。 ## IDE拡張機能とcodex exec IDE拡張機能は同じ config.tomlを読み取りますが、 env_key はエディター自身の環境から解決されます。Dockやスタートメニューから起動したエディターでは、次のファイルでエクスポートした変数を参照できません： .bashrc。そのため、Codexは次のエラーで失敗します： Invalid API key 。一方、CLIは動作します。変数をシステム全体で設定するか（Windowsでは setx で設定できます）、ターミナルからエディターを起動してください。例： code .. codex exec は対話型UIを使わずに単一のタスクを実行するため、スクリプトやCIに適しています。同じ設定とプロファイルを使用します： ターミナルコピー ``` codex exec "write unit tests for utils.py" codex exec --profile claude "summarise the changes on this branch" codex login status # which authentication method is active ``` ## リトライとタイムアウト 各プロバイダーには、それぞれ再試行とストリームの設定があります。デフォルトは、リクエストの再試行が4回、ストリームの再接続が5回、ストリームごとのアイドルタイムアウトが5分です。長い推論ターンでは、しばらく出力がない状態になることがあるため、推論の強度が高い場合はアイドルタイムアウトを延長すると効果的です。 ~/.codex/config.tomlコピー ``` [model_providers.aiprime] # ...settings from above... request_max_retries = 6 stream_max_retries = 8 stream_idle_timeout_ms = 600000 ``` ## トラブルシューティング：Codexユーザーが遭遇するエラー 以下は、このゲートウェイでCodexクライアントが実際に出力するエラーを、よく発生する順に並べたものです。 | 表示される内容 | 原因 | 対処方法 | 403 No active subscription found for this group | キーが、有効なプランのない無制限グループに属している | 従量課金グループのキー（GPTの場合はCodex）を使用するか、プランを購入してください | 401 Invalid API key | Codexを実行しているプロセス（多くの場合はIDE）で変数が空になっている、または requires_openai_auth = true によってCodexが別のログイン情報を送信している | echo $AIPRIME_CODEX_KEY。次の設定を削除してください： requires_openai_auth。エディターを再起動してください | 404 Model "..." is not supported by any configured account in this group | モデルがキーのグループに属していない。例：GPTのキーでClaudeモデルを使用している | キーとモデルが一致するように、プロバイダーまたはプロファイルを切り替えてください | 426 WebSocket upgrade required | WebSocketトランスポートが有効だが、接続がアップグレードされていない | supports_websockets = false。また、次の設定を削除してください： responses_websockets_v2 。削除元： [features] | 403 Your API key has expired | キーが有効期限付きで作成されている | ダッシュボードで新しいキーを作成してください | 'none' is not supported | 推論の強度が次の値に設定されている： none | 使用するモデルは、 low 以上 | 404 page not found | base_url に次の内容が含まれている： /v1 重複 | 次の値をそのまま使用してください： https://aiprimetech.io/v1 | 次の項目に関する設定エラー： wire_api アップグレード後 | A wire_api = "chat" 古いガイドに記載された行 | 設定する項目： wire_api = "responses" | Your balance is used up | 残高がない | [チャージ](/ja/topup/) | Concurrency limit exceeded for user | 複数のCodexエージェントまたはウィンドウを同時に実行している | 並列実行数を減らすか、サポートに同時実行数の上限引き上げを依頼してください どちらかに決める前にCodexとClaude Codeを比較したい場合は、こちらをご覧ください [Claude CodeとCodexの比較](/ja/claude-code/vs-codex/). ## よくある質問 Codexの設定ファイルはどこにありますか？ ~/.codex/config.toml（または$CODEX_HOME/config.toml）です。CLI、codex exec、IDE拡張機能はすべてこのファイルを読み込みます。プロジェクトの.codex/config.tomlではプロバイダーを設定できません。 Codex CLIでClaudeモデルを使用できますか？ はい。ClaudeモデルへのResponses APIリクエストを受け付けるゲートウェイ経由で使用できます。Claude用のキーを持つプロバイダーを追加し、modelをclaude-sonnet-5.などのIDに設定してください Codexでwire_api = "chat"はまだ使えますか？ いいえ。Codexの設定リファレンスでは、サポートされる値はresponsesのみとされており、省略した場合もこれがデフォルトになります。 CLIでは動作するのに、CodexのVS Code拡張機能でAPIキーが無効と表示されるのはなぜですか？ env_keyはエディターの環境から読み取られます。変数をシステム全体で設定するか、その変数がエクスポートされているターミナルからエディターを起動してください。 Codexの「このグループに有効なサブスクリプションが見つかりません」とはどういう意味ですか？ そのキーは、有効なプランがないサブスクリプション（無制限）グループに属しています。従量課金グループのキーを使用するか、プランを購入してください。 数分でClaudeの利用を開始 APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。[APIキーを取得](/register) AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。 CodexとGPTのAPIガイド: [CodexのAPIキーとアクセス](/ja/codex-api/) · [OpenAI互換API](/ja/openai-api/) · [Codex CLIのセットアップ](/ja/docs/guides/codex-cli/) · [GPT-6モデルの比較](/ja/blog/gpt-6-models-for-codex/) ## Claude APIのその他のガイド [Claude APIキーの取得方法](/ja/learn/how-to-get-a-claude-api-key/)[Claude API の料金を解説](/ja/learn/claude-api-pricing-explained/)[Claude APIを最も安く利用する方法](/ja/learn/cheapest-way-to-use-claude-api/)[Claude APIでCursorを無制限に利用](/learn/use-claude-api-with-cursor/)[Claude Codeへの無制限アクセス](/ja/learn/use-claude-api-with-claude-code/)[Claude APIゲートウェイとAnthropicへの直接接続の比較](/ja/learn/claude-api-vs-anthropic-direct/)[OpenAI互換API経由でClaudeを使う](/ja/learn/openai-compatible-claude-api/)[Claude モデルを解説：Claude Opus、Sonnet、Haiku、Fable のモデル比較 — すべての Claude API モデル、Anthropic のモデル名と料金（2026）](/ja/learn/claude-api-models-compared/)[暗号資産でClaude APIの料金を支払う](/ja/learn/claude-api-with-crypto-payment/)[ウェイティングリストなしでClaude APIを利用](/ja/learn/claude-api-without-waitlist/)[Claudeのトークン使用量を削減する方法](/ja/learn/how-to-reduce-claude-token-usage/)[Claude APIでClineを無制限に利用](/ja/learn/use-claude-api-with-cline/)[Claude APIでRoo Codeを無制限に利用](/ja/learn/use-claude-api-with-roo-code/)[JetBrains IDEでClaudeを無制限に利用](/ja/learn/use-claude-api-with-jetbrains/)[Claude APIでAiderを無制限に使う](/ja/learn/use-claude-api-with-aider/)[VS CodeでClaudeを無制限に利用](/ja/learn/use-claude-api-with-vscode/)[Claude向けのOpenCode設定：opencode.jsonの設定、モデル、よくあるエラー](/ja/learn/use-claude-api-with-opencode/)[ClaudeでHermesエージェントを無制限に実行する](/ja/learn/run-hermes-agent-with-claude-api/)[ClaudeでOpenClawを無制限に実行](/ja/learn/run-openclaw-with-claude-api/)[Anthropic互換APIとは](/ja/learn/anthropic-compatible-api/)[Claude CodeのAPIキー — ANTHROPIC_API_KEY：取得方法、設定方法、代わりにclaude setup-tokenを使うべき場合](/ja/learn/claude-code-api-key-setup/)[Claude Code APIのコスト — 料金と削減方法](/ja/learn/claude-code-api-costs/)[Claude APIエラーを解説：サーバーエラー500、過負荷529、レート制限429、不正なリクエスト400 — それぞれの解決方法](/ja/learn/claude-api-errors-troubleshooting/)[Claude APIクレジットの購入方法 — Claudeクレジットがどの「Claudeアカウント購入」のオファーよりも優れている理由](/ja/learn/buy-claude-api-credits/)[Claudeの無料API：無料のClaude APIキーはあるのか、2026に実際に無料で使えるものは？](/ja/learn/claude-api-free-trial/)[Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきか](/ja/learn/claude-api-vs-subscription/)[Claudeをn8nに接続する](/ja/learn/use-claude-api-with-n8n/)[LiteLLMからClaudeへのルーティング](/ja/learn/use-claude-api-with-litellm/)[Kilo CodeでClaudeを使う](/ja/learn/use-claude-api-with-kilo-code/)[GitHub CopilotにClaudeを導入する](/ja/learn/use-claude-api-with-github-copilot/)[ゲートウェイ経由でZedをClaudeに接続する](/ja/learn/use-claude-api-with-zed/)[Cherry StudioをClaudeに接続](/ja/learn/use-claude-api-with-cherry-studio/)[LangChainのChatAnthropic：インポート、base_url、ストリーミング、ツール、エラー](/ja/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：インストール、base_urlの設定、ストリーミング、エラー処理](/ja/learn/anthropic-python-sdk/)[Vercel AI SDKでClaudeを使用：createAnthropicのbaseURL、ストリーミング、問題の修正](/ja/learn/use-claude-api-with-vercel-ai-sdk/)[ClaudeでFactory Droidを実行](/ja/learn/use-claude-api-with-factory-droid/)[Claude Code APIの仕組みを解説](/ja/learn/claude-code-api/)[アプリケーションへのClaude APIの統合](/ja/learn/claude-api-integration/)[Claudeを無制限に利用する方法 — 「Claude Codeのクラック版」が存在しない理由](/ja/learn/get-unlimited-claude-usage/)