文档 · 指南

让 Lody 用任意模型

Lody 是一个桌面应用，里面运行 Claude Code、Codex、Pi、dsh、Kimi Code、Grok 和 Bub 等编程 Agent。它通过自己的导入链接添加供应商，并弹出确认框由你确认。magpie 给出这个链接，把 magpie 作为一个名为 Magpie 的自定义供应商交给 Lody，按协议分三个端点，覆盖它支持的所有运行时。确认后，Lody 里的这些 Agent 都能用 magpie 里的任意模型：DeepSeek、GLM、Kimi、Qwen、OpenAI 或 Anthropic Key，以及你登录的 ChatGPT、Copilot 订阅。

把 magpie 加进 Lody

1. 先打开一次 LodyLody 运行过之后，它的主目录 ~/.lody（OSS 版是 ~/.lody-oss）或数据文件夹（macOS 上 ~/Library/Application Support/Lody）才存在，magpie 的 Agent 页才会列出它。Lody OSS 和 Lody Nightly 也认。
2. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
3. 点「添加 magpie」在 Lody 那一行点 添加 magpie，magpie 把导入链接交给 Lody。
4. 在 Lody 里确认Lody 弹出本机供应商的确认框，确认之前什么都不会添加。之后在 Lody 里给各个 Agent 选 Magpie 供应商的模型。

magpie lody add      # 打开 Lody 添加 magpie，在其中确认

这一行不会显示“已添加”：Lody 没有公开的状态接口，magpie 也不会凭一次点击、生成的文件或 Lody 的私有数据去猜。需要时可以再点一次。

链接里有什么

链接的 data 是一段 base64url 编码的 JSON，解开后是这样：

lody://provider/import?v=1&data=
{
  "kind": "custom", "id": "magpie", "name": "Magpie",
  "auth": {"method": "apiKey", "apiKey": "…"},
  "endpoints": [
    {"protocol": "anthropic-messages", "baseUrl": "http://127.0.0.1:3425",
     "targets": ["claude-code"], "modelsUrl": "http://127.0.0.1:3425/v1/models"},
    {"protocol": "openai-responses", "baseUrl": "http://127.0.0.1:3425/v1",
     "targets": ["codex"], "modelsUrl": "http://127.0.0.1:3425/v1/models"},
    {"protocol": "openai-chat", "baseUrl": "http://127.0.0.1:3425/v1",
     "targets": ["pi", "dsh", "kimi-code", "grok", "bub"],
     "modelsUrl": "http://127.0.0.1:3425/v1/models"}
  ]
}

Claude Code 走 Anthropic Messages，地址是网关本身；Codex 走 OpenAI Responses；Pi、dsh、Kimi Code、Grok 和 Bub 走 OpenAI Chat，地址都是网关的 /v1。模型列表都从网关的 /v1/models 获取。

只接受本机地址

Lody 只接受本机回环地址上的 HTTP（127.0.0.1、localhost 或 ::1），Key 也只能是它公开的归属令牌，不接受局域网 Key 或供应商的凭证。所以网关不在本机回环地址上时（例如你把 magpie 的地址改成了局域网地址），magpie 不会打开 Lody，而是直接说明原因。

Linux 上的 Lody

macOS 和 Windows 上，Lody 的应用包和安装程序会自己注册 lody://，magpie 直接打开链接。Linux 上 Lody 的 AppImage 只为自己频道的协议注册默认程序，lody:// 交给桌面数据库，而没跑 update-desktop-database 时没人建它，所以 xdg-open 和浏览器会拒绝这个链接（“failed to open uri”）。因此在 Linux 上，magpie 按 Lody 的桌面入口（ai.lody.desktop、Nightly 和 OSS 版的入口）里的命令直接用链接启动 Lody；已经在运行的 Lody 会接过链接，第二个实例随即退出。找不到 Lody 的入口时，再交给系统打开。

用量与 Key

链接里的 Key 是 Lody 专用的，所以它的请求在 magpie 的用量里单独记为 Lody，和其他 Agent 分开。

常见问题

Lody 里的 Claude Code 能用 DeepSeek 或 GLM 吗？

能。把 magpie 加进 Lody 后，Claude Code 通过 Magpie 供应商的 Anthropic 端点使用 magpie 里的任意模型，包括 DeepSeek 和 GLM；Codex、Pi、Kimi Code 等也一样。

为什么 magpie 说 Lody 只接受本机地址？

Lody 只接受本机回环地址上的 HTTP 供应商。把 magpie 的网关地址设回 127.0.0.1 或 localhost，再点添加 magpie。

Linux 上点了添加 magpie，提示 failed to open uri？

这是 xdg-open 找不到 lody:// 的处理程序。magpie 会按 Lody 的桌面入口直接启动它；如果仍不行，先打开一次 Lody 让它写好桌面入口，再点一次。

为什么 Lody 那一行不显示已添加？

Lody 没有公开的状态接口，magpie 不去猜。确认过一次就已添加，之后在 Lody 的供应商列表里能看到 Magpie。

更多桌面应用用同样的模型：让 Cindy 用任意模型、让 AionUi 用任意模型、让 Shelley 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。