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

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

Ollama は pull したモデルを http://localhost:11434 で OpenAI Chat Completions と Anthropic Messages の二つの API で提供します。Ollama Cloud はクラウドのモデルを ollama.com で同じように提供し、API キーで使います。どちらかを magpie に一度追加すれば、Claude Code・Codex・Gemini CLI・OpenCode などつないだすべてのツールが、magpie のゲートウェイ 127.0.0.1:3425 経由で使えます。ツールごとに別のモデルを選べます。

Ollama を追加する

  1. モデルを pull するOllama で qwen3 などのモデルを pull し、サーバーを動かしたままにします。
  2. プロバイダを追加するmagpie の プロバイダ タブで ＋ プロバイダを追加 を押し、このマシン上 から Ollama を選びます。キーは要りません。magpie がサーバーにモデルを問い合わせ、ollama/… として表示されます。
  3. ツールに割り当てるエージェント タブでツールの行のモデルをクリックし、Ollama のモデルを選びます。
ターミナル
ollama pull qwen3
magpie provider add ollama
magpie provider test ollama

magpie のモデル ID は プロバイダ/モデル の形なので、qwen3 として pull したモデルは ollama/qwen3 になります。タグも ID に残り、ollama/qwen3:8b のようになります。ターミナル UI で追加すると、サーバーのアドレスを聞かれます。LM Studio・oMLX・vLLM・llama.cpp のサーバーは ローカルモデル を見てください。

別のポート・別のマシン

Ollama が別のポートで待ち受けている場合や、GPU マシンや NAS など別のマシンで動いている場合は、プロバイダの編集画面で サーバーアドレス を変えます。変わるのはスキーム・ホスト・ポートだけで、各 API のパスはそのままです。スキームは省略でき、その場合は http になります。アドレスと一緒に貼ったパス（/v1 など）は取り除かれます。

ターミナル
magpie provider set ollama address=192.168.1.20:11434
magpie provider set ollama address=     # 既定に戻す

Ollama Cloud

  1. キーを作るollama.com/settings/keys で作成します。
  2. プロバイダを追加するプロバイダ タブで ＋ プロバイダを追加 を押し、Ollama Cloud を選んでキーを貼り付け、保存します。magpie がそのキーで使えるモデルを Ollama Cloud に問い合わせます。
  3. ツールに割り当てるツールの行で deepseek-v4-pro などの Ollama Cloud のモデルを選びます。
ターミナル
magpie provider add ollama-cloud <key>
magpie claude ollama-cloud/deepseek-v4-pro

モデル名・推論レベル・価格は models.dev の ollama-cloud カタログから取ります。キーは magpie の設定に保存されます。

エンドポイント

プロバイダChat CompletionsAnthropic Messages
Ollamahttp://localhost:11434/v1http://localhost:11434
Ollama Cloudhttps://ollama.com/v1https://ollama.com

ツールが話す API を Ollama が提供していれば、リクエストはその API にそのまま渡ります。magpie はどちらにも Responses のエンドポイントを使わないので、変換が要るときは Chat Completions を使います。Responses を優先するのは OpenAI 自身のモデルだけ、Messages を優先するのは Claude のモデルだけです。

モデル一覧

magpie は Chat Completions のベース URL から一覧を取ります。http://localhost:11434/v1/models、Ollama Cloud なら https://ollama.com/v1/models です。Ollama にあるモデルが magpie に表示されます。新しく pull したら、プロバイダの編集画面で モデルを取得 を押すか、magpie provider refresh ollama を実行します。ツールに見せるモデルは、プロバイダのモデル一覧かターミナルで選べます。

ターミナル
magpie provider refresh ollama
magpie provider models ollama +qwen3

Ollama 0.35.0 以降（クラウドモデルは 0.40.5 以降）は、Nimble・Clef・Tev などの判定モデルも提供します。magpie は Ollama の /api/tags も読み、判定モデルと示されたものをそのプロバイダの インテントルーティング 用の判定モデルにします。ツールのモデルにはなりません。古い Ollama では一覧に出ません。

ツールごとの使い方

ターミナル
magpie claude ollama/qwen3
magpie codex ollama/qwen3
magpie gemini model ollama/qwen3
magpie opencode ollama/qwen3

ツールの中でも、Claude Code と Codex の /model に magpie のモデルが並ぶので、ローカルモデルとクラウドのモデルをそこで切り替えられます。ツール本来のモデルに戻すには magpie claude default か magpie codex default を実行します。

コンテキストウィンドウと num_ctx

エージェントは、モデルが受け付けるリクエストの長さを前提に会話を組み立てます。Claude Code は知らないモデルを 200K とみなし、Codex は伝えられたウィンドウの 90% で会話を圧縮します。magpie は Ollama のチャットモデルのウィンドウを読まないので、実際の値を伝えてください。プロバイダの編集画面の 詳細設定 にある コンテキストウィンドウ で、全モデルにも個別のモデルにも設定できます。magpie がそれをエージェントに伝えます。

ターミナル
magpie provider set ollama context=32k
magpie provider set ollama context.qwen3=128k

推論

ターミナル
magpie model efforts ollama/qwen3 low,medium,high
magpie model efforts ollama/qwen3 off

ツール呼び出し

Claude Code と OpenCode のツール呼び出しは、ツールが書いたとおりに Ollama へ届きます。Codex と Gemini CLI では、ツールの定義、モデルからの呼び出し、その結果を magpie が Chat Completions に変換して戻します。ストリーミングの返答でも同じです。

プライバシーマスク

magpie の プライバシーマスク は、リクエストがゲートウェイを出る前にキーやトークンなどの秘密をプレースホルダーに置き換えます。ローカルの Ollama へのリクエストも同じです。モデルが自分のマシンやネットワーク内で動いているなら、編集画面で リクエストをマスクしない をオンにするか、magpie provider set ollama unmasked=yes を実行します。

使用量と費用

ターミナル
magpie model price ollama/qwen3 0,0,0,0
magpie provider set ollama free=yes
magpie provider quota-rest ollama-cloud 7d
magpie provider fallback ollama-cloud ollama/qwen3

magpie を Ollama サーバーとして使う

カスタムモデルを Ollama サーバーとしてしか受け付けないアプリがあります。VS Code の Copilot の Ollama プロバイダ、Visual Studio の Copilot BYOK、Zed の Ollama プロバイダ、そして ollama CLI です。これらを magpie のゲートウェイ http://127.0.0.1:3425 に向ければ、Ollama のものだけでなく、すべてのプロバイダの magpie のモデルが見えます。

うまくいかないとき

よくある質問

Claude Code で Ollama のローカルモデルを使うには？

magpie に Ollama を追加し（プロバイダ → プロバイダを追加 → このマシン上の Ollama）、Claude Code の行でそのモデルを選ぶか、magpie claude ollama/qwen3 を実行します。Claude Code のリクエストは magpie のゲートウェイを通り、http://localhost:11434 にある Ollama の Anthropic Messages API へそのまま届きます。

Codex で Ollama は使えますか？

使えます。Codex は Responses API しか話さないので、magpie がリクエストを Chat Completions に変換して Ollama に送り、返答を元に戻します。ツール呼び出しも含みます。magpie codex ollama/qwen3 を実行してください。

Gemini CLI や OpenCode でも Ollama は使えますか？

使えます。Gemini CLI は Google の API を話すので、magpie がリクエストを Ollama の Chat Completions に変換し、返答を元に戻します。OpenCode は Chat Completions を話すので、リクエストはそのまま Ollama に届きます。magpie gemini model ollama/qwen3 か magpie opencode ollama/qwen3 を実行してください。

Ollama の qwen3-coder を Claude Code で使うには？

Ollama で pull してから、magpie のプロバイダ編集画面で「モデルを取得」を押し（または magpie provider refresh ollama を実行し）、Claude Code の行で選びます。magpie での ID は ollama/ に Ollama が表示する名前（タグ込み）を続けたものです。コンテキストウィンドウも設定してください。Claude Code は知らないモデルを 200K とみなします。

別のマシンの Ollama を使えますか？

使えます。プロバイダのサーバーアドレスをそのマシンに変えます。たとえば magpie provider set ollama address=192.168.1.20:11434 です。自分のネットワーク内のサーバーには、設定やシステムのプロキシを通さず直接つなぎます。

Ollama Cloud にも対応していますか？

対応しています。ollama.com/settings/keys で作ったキーで Ollama Cloud を追加すると、magpie はそのキーで使えるモデルを一覧にし、models.dev の価格で計算し、アカウントのプランに含まれる枠と購入したクレジットを表示します。

ローカルの Ollama に API キーは要りますか？

要りません。Ollama のプリセットはキーなしで使えます。Ollama Cloud にはキーが要ります。

LM Studio・oMLX・vLLM・llama.cpp など他のローカルサーバーは ローカルモデル を見てください。ローカルモデルにリクエストを分類させてルーティングを決めるには インテントルーティング を見てください。

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

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