文档 · 供应商

Ollama 接入 Claude Code、Codex、Gemini CLI 和 OpenCode

Ollama 在 http://localhost:11434 上用两种接口提供你拉取的模型：OpenAI Chat Completions 和 Anthropic Messages。Ollama Cloud 在 ollama.com 上以同样的方式提供云端模型，需要 API Key。把其中任意一个添加到 magpie 一次，Claude Code、Codex、Gemini CLI、OpenCode 以及你接入的其他工具，就都能通过 magpie 的本地网关 127.0.0.1:3425 使用它们，每个工具各用各的模型。

添加 Ollama

  1. 拉取模型在 Ollama 里拉取一个模型，比如 qwen3，并保持服务运行。
  2. 添加供应商在 magpie 的 供应商 页点 ＋ 添加供应商，在 本机 下选 Ollama。不需要 Key。magpie 会向服务询问有哪些模型，它们显示为 ollama/…。
  3. 给工具选模型在 Agent 页点工具那一行的模型，选一个 Ollama 模型。
终端
ollama pull qwen3
magpie provider add ollama
magpie provider test ollama

magpie 里的模型 ID 写作 供应商/模型，所以拉取的 qwen3 就是 ollama/qwen3。标签也留在 ID 里，比如 ollama/qwen3:8b。在终端界面里添加时，magpie 会问你服务器地址。LM Studio、oMLX、vLLM 和 llama.cpp 的服务见 本地模型。

换端口或换电脑

如果 Ollama 监听的是别的端口，或者跑在另一台电脑上（比如 GPU 主机或 NAS），在供应商编辑页修改 服务器地址。只有协议、主机和端口会变，每个接口的路径保持不变。协议可以省略，默认按 http；地址后面带的路径（比如 /v1）会被去掉。

终端
magpie provider set ollama address=192.168.1.20:11434
magpie provider set ollama address=     # 恢复默认地址

Ollama Cloud

  1. 创建 Key在 ollama.com/settings/keys 创建一个。
  2. 添加供应商在 供应商 页点 ＋ 添加供应商，选 Ollama Cloud，粘贴 Key 并保存。magpie 会向 Ollama Cloud 询问这个 Key 能用哪些模型。
  3. 给工具选模型在工具那一行选一个 Ollama Cloud 模型，比如 deepseek-v4-pro。
终端
magpie provider add ollama-cloud <key>
magpie claude ollama-cloud/deepseek-v4-pro

模型名称、推理档位和价格来自 models.dev 的 ollama-cloud 目录。Key 保存在 magpie 的设置里。

接口地址

供应商Chat CompletionsAnthropic Messages
Ollamahttp://localhost:11434/v1http://localhost:11434
Ollama Cloudhttps://ollama.com/v1https://ollama.com

工具说的接口 Ollama 本身就支持时，请求直接交给那个接口。两者在 magpie 里都没有 Responses 接口，所以需要翻译时，magpie 用 Chat Completions：只有 OpenAI 自家的模型优先用 Responses，只有 Claude 模型优先用 Messages。

模型列表

magpie 从 Chat Completions 的地址获取模型列表：http://localhost:11434/v1/models，Ollama Cloud 则是 https://ollama.com/v1/models。Ollama 里有了某个模型，magpie 里才会出现它。拉取新模型后，在供应商编辑页点 获取模型，或运行 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 的 本地脱敏 会在请求离开网关前把 Key、Token 等敏感信息换成占位符，发给本地 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 命令行。把它们指向 magpie 的网关 http://127.0.0.1:3425，就能看到 magpie 的模型，而且是所有供应商的，不只是 Ollama 的。

常见报错

常见问题

Claude Code 怎么用 Ollama 的本地模型？

在 magpie 里添加 Ollama（供应商 → 添加供应商 → 本机下的 Ollama），然后在 Claude Code 那一行选它的模型，或者运行 magpie claude ollama/qwen3。Claude Code 的请求经过 magpie 网关，原样发到 Ollama 在 http://localhost:11434 的 Anthropic Messages 接口。

Codex 能用 Ollama 吗？

能。Codex 只会说 Responses 接口，magpie 会把它的请求转成 Chat Completions 发给 Ollama，再把回复转回来，工具调用也一样。运行 magpie codex ollama/qwen3 即可。

Gemini CLI 和 OpenCode 能用 Ollama 吗？

能。Gemini CLI 说的是 Google 的接口，magpie 把它的请求翻译成 Ollama 的 Chat Completions，再把回复翻译回去。OpenCode 本身说 Chat Completions，请求原样发给 Ollama。运行 magpie gemini model ollama/qwen3 或 magpie opencode ollama/qwen3。

怎么在 Claude Code 里用 Ollama 的 qwen3-coder？

先在 Ollama 里拉取它，再在 magpie 的供应商编辑页点「获取模型」（或运行 magpie provider refresh ollama），然后在 Claude Code 那一行选中它。它在 magpie 里的 ID 是 ollama/ 加上 Ollama 列出的名字，标签也算在内。记得同时设好它的上下文窗口：Claude Code 会把不认识的模型当作 200K。

magpie 能用另一台电脑上的 Ollama 吗？

能。把供应商的服务器地址改成那台电脑，比如 magpie provider set ollama address=192.168.1.20:11434。局域网里的服务器会直接连接，不走设置或系统里的代理。

magpie 支持 Ollama Cloud 吗？

支持。用 ollama.com/settings/keys 上创建的 Key 添加 Ollama Cloud，magpie 会列出这个 Key 能用的模型，按 models.dev 的价格计费，并显示账户套餐内的额度和你购买的余额。

本地 Ollama 需要 API Key 吗？

不需要，Ollama 预设不用 Key。Ollama Cloud 需要。

LM Studio、oMLX、vLLM、llama.cpp 等其他本地服务见 本地模型。想让本地模型给每个请求分类、决定路由，见 意图路由。

按供应商：DeepSeek · Kimi 与 Kimi Code · GLM 编程套餐 · 通义千问 · MiniMax · Gemini · Grok · Mistral · OpenRouter · GitHub Copilot

各个工具的指南：Claude Code 接入其他模型、Codex 接入其他模型、Gemini CLI 接入其他模型、OpenCode 接入其他模型。遇到问题可以在 Discord 提问。