文档 · 指南

让 Zed 用任意模型

Zed 的 Agent 面板使用设置里的语言模型供应商。magpie 把自己作为 OpenAI 兼容供应商加进 Zed，于是 Zed 的 Agent 能用你在 magpie 里的任何模型：DeepSeek、Kimi、GLM、Qwen、OpenAI Key，或 ChatGPT、Copilot 订阅，不用往 Zed 里贴 Key。

Zed 的设置在 macOS 和 Linux 上是 ~/.config/zed/settings.json（设置了 $XDG_CONFIG_HOME 时在其下），Windows 上在 %APPDATA%\Zed。magpie 添加 language_models.openai_compatible.magpie，写入网关地址和 magpie 的模型，并把 agent.default_model 设成你选的模型。Zed 运行中就会读到改动。网关把每个请求翻译给该模型的供应商，工具调用和推理都保留。

接入 Zed

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Zed 那一行选模型在 Agent 页，给 Zed 一行选一个模型。
  3. 打开 Zed 的 Agent 面板这个模型就是面板的默认模型，magpie 的模型也在面板的模型选择器里，位于 magpie 下。
终端
magpie zed deepseek/deepseek-v4-pro    # Zed 的 Agent 用 DeepSeek
magpie zed                             # 查看 Zed 当前的模型

API Key

Zed 把 OpenAI 兼容供应商的 Key 存在系统凭据库里，按供应商地址区分，而不是 settings.json。magpie 替你在那里存一个 Zed 专用的 Key：macOS 上是钥匙串，Linux 上是 Secret Service，Windows 上是凭据管理器。如果 Zed 仍然要求填 API Key，重启 Zed 即可。

模型和思考

每个模型都带上上下文窗口和回复上限，Zed 知道何时压缩上下文，也标明能否看图。会思考的模型写入 reasoning_effort high，或它支持的最高档，于是 Zed 会显示思考开关和档位。你自己在 settings.json 里给某个模型设的档位（包括 none），magpie 重写列表时会保留。如果 Zed 通过你自己的代理访问网关，magpie 会保留那个地址。

切回

在 Zed 那一行选 Zed 自己的模型、把这一行从 magpie 移除，或运行 magpie zed default。magpie 会恢复你原来的默认模型和供应商设置。

常见问题

Zed 能用我的 ChatGPT 订阅吗？

能。在 magpie 里登录 ChatGPT，在 Zed 那一行选一个 GPT 模型。Zed 把请求发给 magpie，由 magpie 使用订阅。

Zed 要我给 magpie 填 API Key。

magpie 已把 Key 存进系统凭据库。重启 Zed，让它读到。

为什么某个模型在 Zed 里没有思考开关？

这个模型不思考。会思考的模型，magpie 会设置 reasoning_effort，Zed 就会显示开关。

这会改动 Zed 的编辑预测吗？

不会。magpie 只设置 Agent 面板的默认模型并添加一个供应商，编辑预测保持原样。

更多 Agent 用同样的模型：OpenCode 接入其他模型、Claude Code 接入其他模型、让 Droid 用任意模型、让 Crush 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。