--- title: Magpie | RunAPI description: Magpie に RunAPI を追加し、Claude Code または Codex で使うモデルを選択します。 url: https://runapi.ai/ja/docs/resources/tool-integrations/magpie.md canonical: https://runapi.ai/ja/docs/resources/tool-integrations/magpie locale: ja --- > HTML 版: https://runapi.ai/ja/docs/resources/tool-integrations/magpie > エージェント向けサイトインデックス: https://runapi.ai/llms.txt # Magpie ## インストールと準備 [Magpie][1] から最新の安定版をインストールします。プラットフォーム別のインストール方法は[公式リファレンス][2]に従ってください。Claude Code または Codex は別途インストールします。 [1]: https://usemagpie.ai [2]: https://github.com/yetone/magpie/blob/main/docs/reference.md [認証ガイド](https://runapi.ai/ja/docs/guides/authentication.md)に従って専用の標準 API キーを作成します。[モデルカタログ](https://runapi.ai/ja/models)からモデル ID と対応プロトコルを確認してコピーします。プロバイダーを変更する前に、エージェントの設定をバックアップしてください。 ## OpenAI 互換プロバイダーの追加 Chat Completions に対応するモデルには、この方式を使います。コマンド実行前に両方のプレースホルダーを置き換えてください。`url=` のベース URL は `/v1` で終わり、Magpie が `/chat/completions` を追加します。 ```shell magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` ## Anthropic 互換プロバイダーの追加 Anthropic Messages に対応するモデルには、この方式を使います。`anthropic=` のベース URL に `/v1` は含めません。Magpie が `/v1/messages` を追加します。 ```shell magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` 最初はどちらか一方を選んでください。Magpie は同じキーを使う 2 つ目のプロバイダーを拒否します。両方のプロバイダーを保持するには、それぞれに異なる専用の RunAPI キーを作成してください。RunAPI キーはリポジトリの外で Magpie に保管してください。 ## エージェントへのモデルの割り当て Magpie を起動し、ゲートウェイを実行したままにします。Agents 画面で Claude Code または Codex を選択し、RunAPI プロバイダー配下のモデルを選びます。CLI でも同じ選択ができます。選んだプロバイダーとモデル ID を使い、コマンドを 1 つ実行してください。 ```shell magpie serve ``` 別のターミナルでモデルを選択します。 ```shell magpie models magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID ``` Anthropic 方式では、`runapi-chat` を `runapi-anthropic` に置き換えます。Magpie はローカルで `provider/model` を使い、元のモデル ID を RunAPI に転送します。エージェントは `127.0.0.1:3425` の Magpie に接続し、RunAPI キーは不要です。Codex はローカルの Responses インターフェースを使いますが、これは RunAPI が Responses リクエストを受け取ることを意味しません。これらのプロバイダー設定は、RunAPI 側で Chat Completions または Messages を選択します。 ## 設定の確認 これらのコマンドでプロバイダーと選択したモデルを確認し、新しいエージェントセッションを開始して短いプロンプトを送信します。 ```shell magpie version magpie providers magpie claude magpie codex ``` RunAPI の使用記録で、想定するモデルとリクエストを確認してください。エージェントが正常に応答しただけでは、どのプロバイダーが処理したかは確定できません。Magpie の Test models、Detect APIs、プロバイダーテストは推論リクエストを送信する場合があります。 設定とローカルルートは Linux 上の Magpie 0.1.1307 と Claude Code 2.1.295 で確認しました。両方のプロバイダー設定で、ローカルフィクスチャの固定応答が返されました。このガイドでは、実際の RunAPI 推論および Codex の推論はテストしていません。エージェントの作業に使う前に、選択したモデルのプロトコルとツール対応を確認してください。 ## トラブルシューティング そのキーのプロバイダーがすでに追加されていると Magpie が通知した場合は、そのプロバイダーを再利用するか、2 つ目の方式に別の専用キーを使ってください。このエラーはローカルで再現済みです。 ローカルフィクスチャの実行では、設定したサーバーを停止すると `no model list` と `connection refused` が再現しました。アドレスとサーバーの稼働状況を確認し、正確なモデル ID を指定して `models=` を使ってください。エージェントがローカルゲートウェイを使っている間は、Magpie を実行したままにしてください。 Claude Code はフィクスチャの ID に対して `unrecognized_model` を報告しましたが、フィクスチャの応答は返されました。この警告が表示されたら、元のモデル ID と Claude Code のモデル設定を確認してください。フィクスチャではコンテキスト上限、ツール呼び出し、モデルの品質は検証していません。 ## 以前の設定への復元 プロバイダーを削除する前にエージェントを復元してください。これらのコマンドで各エージェントが以前の設定に戻ります。 ```shell magpie claude default magpie codex default magpie provider rm runapi-chat magpie provider rm runapi-anthropic ``` 追加したプロバイダーだけを削除してください。専用の RunAPI キーが不要になった場合は失効させてください。ほかにも手動で設定を変更した場合は、バックアップを復元してください。 ## 次のステップ RunAPI の公開プロトコルの例は [LLM API クイックスタート](https://runapi.ai/ja/docs/guides/llm-api/quickstart.md)、対応モデルは[モデルカタログ](https://runapi.ai/ja/models)を参照してください。Magpie の公式リファレンスには Grok Build 連携も掲載されていますが、このガイドでは Grok Build はテストしていません。 --- ## 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) - [x402](https://runapi.ai/ja/x402.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": "Magpie", "description": "Magpie に RunAPI を追加し、Claude Code または Codex で使うモデルを選択します。", "url": "https://runapi.ai/ja/docs/resources/tool-integrations/magpie", "mainEntityOfPage": "https://runapi.ai/ja/docs/resources/tool-integrations/magpie" } ] ```