ドキュメント · プロバイダ

OpenAI を Claude Code・Codex・Gemini CLI・OpenCode で使う

OpenAI は api.openai.com で二つの API、Responses と Chat Completions を提供しています。OpenAI 自身のモデルは Responses で使うのがよく、最新のモデルはそこでしか答えません。OpenAI の API キーを magpie に一度追加すれば、Claude Code・Codex・Gemini CLI・OpenCode などつないだすべてのツールが、magpie のゲートウェイ 127.0.0.1:3425 経由で OpenAI のモデルを使えます。ツールごとに別のモデルを選べます。Codex のリクエストはそのまま OpenAI に送り、ほかのツールのリクエストは途中で magpie が変換します。

このページは platform.openai.com の API キーについてです。ChatGPT Plus や Pro のサブスクリプションは別にサインインします。サブスクを任意のエージェントで を見てください。

OpenAI を追加する

  1. キーを取得platform.openai.com で作ります。sk- で始まります。
  2. プロバイダを追加magpie の プロバイダ で ＋ プロバイダを追加 を押し、OpenAI を選んでキーを貼り付け、保存します。magpie がそのキーで使えるモデルを OpenAI に問い合わせます。
  3. ツールで選ぶエージェント タブで、ツールの行のモデルを押し、gpt-6.1-sol などの OpenAI モデルを選びます。
ターミナル
magpie provider add openai <key>
magpie provider test openai

magpie のモデル ID は プロバイダ/モデル の形なので、OpenAI のモデルは openai/gpt-6.1-sol のようになります。前がプロバイダ、後ろが OpenAI 自身の ID です。キーは magpie の設定に保存され、magpie がシェルから読むことはありません。

OpenCode など magpie が取り込めるアプリで OpenAI をもう設定してあるなら、取り込むときに OpenAI プロバイダとして入ります。

エンドポイント

APIアドレス用途
Responseshttps://api.openai.com/v1OpenAI 自身のモデル（ID が gpt-、codex、または o と数字で始まるもの）：Codex はそのまま、Claude Code・Gemini CLI・OpenCode は変換して
Chat Completionshttps://api.openai.com/v1モデル一覧と、キーで使えるそれ以外のモデル

magpie の OpenAI プロバイダには Anthropic Messages のアドレスがないので、Claude Code のリクエストは常に変換します。OpenAI 自身のモデルは、Chat Completions を話すツールからでも magpie が Responses を先に使います。OpenAI があるモデルは /v1/responses でしか提供していないと答えると、magpie はそちらで問い合わせ直し、それを覚えます。モデルごとに API を自分で決めるには：

ターミナル
magpie model api openai/gpt-5.5 chat
magpie model api openai/gpt-5.5 --reset
magpie model apis openai

Azure OpenAI は別のプロバイダ、Azure OpenAI です。リソースのエンドポイント https://<resource>.openai.azure.com とキーを入れます。magpie は /openai/v1 以下の v1 API で Chat Completions と Responses を使い、キーを api-key ヘッダーで送り、リソースのデプロイをモデルとして並べます。gpt-5-codex のようにモデル名を付けたデプロイも、Responses を先に使います。

モデル一覧

magpie は一覧を OpenAI の https://api.openai.com/v1/models から取得するので、ツールにはそのキーで使えるモデルが並びます。名前・コンテキスト長・推論レベル・価格は models.dev の openai カタログから取ります。OpenAI が出したばかりでレベルがまだわからない推論モデルには、同じ系列の最新の推論モデルのレベルを使います。gpt-6.1-sol には gpt-6-sol のレベルが付きました。ツールに見せるモデルは、プロバイダのモデル一覧かターミナルで選べます。

ターミナル
magpie provider models openai +gpt-6.1-sol +gpt-6-luna +gpt-5.5
magpie provider refresh-every openai 1d

ツールごとの使い方

ターミナル
magpie claude openai/gpt-6.1-sol
magpie codex openai/gpt-6.1-sol
magpie gemini model openai/gpt-6.1-sol
magpie opencode openai/gpt-6.1-sol

magpie が OpenAI のためにすること

ターミナル
magpie provider set openai compaction=native
magpie provider set openai additional-tools=off

推論

OpenAI の Responses API は自分で Web を検索します。Codex や Claude Code のようにツールがモデルに Web 検索を渡すとき、magpie は Responses でモデルに OpenAI 自身の web_search ツールを渡し、検索は OpenAI が行います。

費用・使用量

複数のキーとフェイルオーバー

一つの OpenAI プロバイダに複数のキーを入れられます。その下の 別のキーを追加 を押すか、まとめて貼り付けます。リクエストはオンになっている最初のキーに行き、そのキーが尽きるかレート制限にかかると次のキーが引き継ぎます。二つの組織のキーのように分けておきたいときは、プロバイダをもう一度追加します。二つ目は openai-2 になります。

ターミナル
magpie provider spend-cap openai <key> 20 month
magpie provider key-balance openai <key> 25
magpie provider fallback openai deepseek/deepseek-v4-pro

うまくいかないとき

よくある質問

Claude Code で OpenAI のモデルを使うには？

magpie に OpenAI の API キーを追加し（プロバイダ、プロバイダを追加、OpenAI）、Claude Code の行で gpt-6.1-sol などのモデルを選ぶか、magpie claude openai/gpt-6.1-sol を実行します。OpenAI は Anthropic Messages API を提供していないので、magpie が Claude Code のリクエストを変換して OpenAI の Responses API https://api.openai.com/v1 に送り、返答を戻します。推論の要約は思考として届きます。

Codex で ChatGPT のサインインではなく OpenAI の API キーを使えますか？

使えます。キーを追加して magpie codex openai/gpt-6.1-sol を実行します。Codex は Responses を話すので、リクエストはカスタムツールや推論も含めてそのまま OpenAI に送り、Fast は優先処理として送ります。ChatGPT Plus や Pro のサインインは、サブスクリプションで別に設定します。

OpenCode で GPT モデルを使うには？

magpie でモデルを選ぶか、magpie opencode openai/gpt-6.1-sol を実行します。OpenCode は Chat Completions を話しますが、OpenAI 自身のモデルは Responses を先に使うので、magpie が OpenCode のリクエストをそちらに変換し、返答を戻します。Chat Completions で送りたいモデルには magpie model api openai/gpt-5.5 chat を実行してください。

Gemini CLI で OpenAI を使えますか？

使えます。Gemini CLI は Google の Gemini API を話すので、magpie がリクエストを OpenAI の Responses API に変換し、返答を戻します。ストリーミングとツール呼び出しも含みます。magpie gemini model openai/gpt-6.1-sol を実行してください。

magpie は OpenAI のプロンプトキャッシュを生かせますか？

生かせます。Codex 自身の prompt_cache_key はそのまま使います。キーのない変換リクエストには、セッションか最初のユーザーメッセージからハッシュで作ったキーを付けるので、ツールについては何も明かしません。キーが複数あるときは、キャッシュが温かいあいだ会話は同じキーを使い続けます。

OpenAI が encrypted content could not be verified と言うのはなぜ？

OpenAI が読めるのは、同じキー・組織・アカウントで封印した推論だけです。よそで封印された推論が会話に含まれていると、magpie はそのアイテムを外して問い合わせ直し、その会話について覚えます。

magpie は Azure OpenAI に対応していますか？

対応しています。別のプロバイダ、Azure OpenAI として使います。リソースのエンドポイントとキーを入れると、magpie は /openai/v1 以下の v1 API を使い、キーを api-key ヘッダーで送り、リソースのデプロイをモデルとして並べます。

プロバイダ別：DeepSeek · Kimi と Kimi Code · GLM Coding Plan · Qwen · MiniMax · Anthropic · Gemini · Grok · Mistral · OpenRouter · GitHub Copilot · Ollama

ツールごとのガイド：Claude Code で他のモデル、Codex で他のモデル、Gemini CLI で他のモデル、OpenCode で他のモデル。困ったときは Discord で質問してください。