Magpie
Magpie に RunAPI を追加し、Claude Code または Codex で使うモデルを選択します。
インストールと準備
認証ガイドに従って専用の標準 API キーを作成します。モデルカタログからモデル ID と対応プロトコルを確認してコピーします。プロバイダーを変更する前に、エージェントの設定をバックアップしてください。
OpenAI 互換プロバイダーの追加
Chat Completions
に対応するモデルには、この方式を使います。コマンド実行前に両方のプレースホルダーを置き換えてください。url= のベース URL は
/v1 で終わり、Magpie が /chat/completions を追加します。
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 を追加します。
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 つ実行してください。
magpie serve
別のターミナルでモデルを選択します。
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 を選択します。
設定の確認
これらのコマンドでプロバイダーと選択したモデルを確認し、新しいエージェントセッションを開始して短いプロンプトを送信します。
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
のモデル設定を確認してください。フィクスチャではコンテキスト上限、ツール呼び出し、モデルの品質は検証していません。
以前の設定への復元
プロバイダーを削除する前にエージェントを復元してください。これらのコマンドで各エージェントが以前の設定に戻ります。
magpie claude default
magpie codex default
magpie provider rm runapi-chat
magpie provider rm runapi-anthropic
追加したプロバイダーだけを削除してください。専用の RunAPI キーが不要になった場合は失効させてください。ほかにも手動で設定を変更した場合は、バックアップを復元してください。
次のステップ
RunAPI の公開プロトコルの例は LLM API クイックスタート、対応モデルはモデルカタログを参照してください。Magpie の公式リファレンスには Grok Build 連携も掲載されていますが、このガイドでは Grok Build はテストしていません。