文档 · 指南

让 Alma 用任意模型

Alma 是一个桌面 AI 对话应用，供应商和设置都在应用里，不在 magpie 能改的文件里。magpie 通过 Alma 运行时的本地 API 加一个名为 magpie 的供应商并设成默认模型，Alma 就能用 DeepSeek、GLM、Kimi、Qwen、Claude 或 ChatGPT 订阅等 magpie 里的任意模型。

接入 Alma

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 打开 Almamagpie 只能通过运行中的 Alma 改它的设置。Alma 没开时，magpie 会提示：打开 Alma 再试一次。
  3. 在 Agent 页给 Alma 选模型选一个 via magpie 的模型，它就成为 Alma 的默认模型。
终端
magpie alma deepseek/deepseek-v4-pro

通过 Alma 的本地 API

Alma 运行时在 http://localhost:23001 提供本地 API，magpie 用的就是它：

终端
GET  /api/providers              Alma 的供应商
POST /api/providers              magpie 的供应商
PUT  /api/providers/:id/models   它的模型列表
GET  /api/settings, PUT it back  chat.defaultModel, imageGen.model

magpie 的供应商类型是 openai，地址是网关的 /v1，用 magpie 给 Alma 的专用 Key。Alma 的请求只带 AI SDK 的 User-Agent，网关靠这把 Key 认出它们来自 Alma。默认模型写在 chat.defaultModel，格式是 供应商id:模型；Alma 只接受整份设置，所以 magpie 把其余设置原样写回。

模型和思考等级

Alma 按 models.dev 的模型 id 推断模型能力，而 magpie 的 id（比如 codex/gpt-5.5）不在 models.dev 里，这样的模型会显示成不支持思考。所以 magpie 给每个模型附上能力说明：会推理的模型写明 Alma 认识的思考等级，已知时还有上下文窗口、输出上限和是否支持图片。你在 Alma 的模型选项里自己设过的（比如工具调用）保留你的设置。magpie 里的模型有增删，Alma 打开时会同步过去。

图片生成

如果 magpie 配了图片模型，而 Alma 的图片生成模型是自动（没选），你给 Alma 选 magpie 的模型时，magpie 也会把它设成 Alma 的图片生成模型。你自己选过的图片模型不会被改。

切回

切回时，如果 Alma 的默认模型是 magpie 的，就清空它，交给 Alma 自己选；magpie 的图片生成模型改回自动；然后删掉 magpie 的供应商。如果 Alma 已经卸载，magpie 记下这件事，等 Alma 重新安装并运行时再把供应商删掉。

终端
magpie alma default

常见问题

Alma 能用 DeepSeek、GLM 或 ChatGPT 订阅吗？

能。打开 Alma，在 magpie 的 Agent 页给 Alma 选一个 via magpie 的模型，magpie 会加一个 magpie 供应商并设成默认模型。

提示“Alma isn't running”怎么办？

Alma 的设置只能通过它运行时的本地 API 修改。打开 Alma 再试一次。

为什么 Alma 里的模型能选思考等级？

magpie 给每个模型附上能力说明，告诉 Alma 它会不会推理、有哪些思考等级、上下文窗口多大。

切回后 Alma 会怎样？

magpie 的供应商被删掉，默认模型如果是 magpie 的就清空，由 Alma 自己选；图片生成模型改回自动。

更多桌面应用用同样的模型：让 Kun 用任意模型、通过 magpie 在 Cherry Studio 里用所有模型、让 OpenHanako 用任意模型、让 OpenPencil 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。