ドキュメント · ガイド

Vercel AI Gateway を Claude Code・Codex などのエージェントで使う

Vercel AI Gateway は 1 つのキーで各社のモデルを 提供元/モデル の ID で提供します。magpie の vercel プリセットはそれを Claude Code・Codex・OpenCode などにつなぎ、3 つの API が設定済みなのでアドレスの入力は不要です。

追加する

キーを作る。Vercel ダッシュボードの AI Gateway → API Keys で作成します。
追加する。アプリで Vercel AI Gateway を選び、APIキーにキーを貼り付けるか、CLI で追加します。

ターミナル

magpie provider add vercel 
magpie provider test vercel

プリセットは Chat Completions と Responses を https://ai-gateway.vercel.sh/v1、Anthropic Messages を https://ai-gateway.vercel.sh に向けています。Vercel のドキュメントでは、どの API でもすべてのモデルが使えます。

エージェントで使う

モデル ID は vercel/<Vercel のモデル ID> で、Vercel の ID 自体に提供元が入っています。

ターミナル

magpie claude vercel/anthropic/claude-sonnet-4.6
magpie codex vercel/openai/gpt-5.5

Claude のモデルは、エージェントがどの API で話しても Vercel の Anthropic Messages に送ります。両方を提供する中継は Chat で cache_control を落とし、毎ターンがキャッシュなしで課金され、思考も同様に影響を受けたためです。ほかのモデルはエージェント自身の API で送ります。Codex は Responses、Chat クライアントは Chat Completions です。

モデル一覧

Vercel の /v1/models は各行の種類を返し、magpie はそれで分けます。

チャットモデルはエージェントのモデル選択に出ます。コンテキスト長は Vercel の context_window から取ります。
画像・動画モデルは magpie の画像・動画生成に、埋め込み・リランクモデルは /v1/embeddings と /v1/rerank に、音声合成・文字起こしモデルは /v1/audio に使います。
評価モデル（typesafe-ai/jev など）とリアルタイム音声はチャットに答えないので一覧から外します。
-batch の ID は Vercel のバッチ API 専用で同期リクエストは受け付けないため、これも外します。

補足

Vercel AI Gateway は中継です。OpenRouter や提供元自身のアカウントと一緒にルーティンググループに入れれば、1 つが失敗しても次のメンバーが答えます。
Vercel の課金とクレジットは Vercel ダッシュボードで確認します。magpie の使用量にはリクエストごとのトークンが記録されます。

よくある質問

magpie は Vercel AI Gateway に対応していますか？

対応しています。vercel プリセットに AI Gateway のキーを入れると、Chat Completions・Responses・Anthropic Messages が設定され、モデル ID は vercel/<提供元>/<モデル> です。

Vercel の Claude を Claude Code で使うとキャッシュは効きますか？

効きます。Claude のモデルは必ず Vercel の Anthropic Messages に cache_control をそのまま送るので、Chat でキャッシュを失うことはありません。

Codex で Vercel AI Gateway を使えますか？

使えます。Codex の Responses を magpie が Vercel の /v1 Responses API に送ります。モデルは vercel/<提供元>/<モデル> です。

一覧に出ないモデルがあるのはなぜ？

magpie は Vercel の種類で分けます。評価モデル・リアルタイム音声・-batch の ID は同期チャットに答えないのでエージェントの一覧に出さず、画像・動画・埋め込み・音声モデルはそれぞれの API に回します。