文档 · 指南

让 Cindy 用任意模型

Cindy 是一个桌面应用，里面运行 Claude Code、Codex 和 Pi。它的供应商存在自己的数据库里，Key 是加密的，新供应商只能通过它自己的导入链接添加，并由你在 Cindy 里确认。所以 magpie 不往 Cindy 里写任何东西：它给出一个导入链接，把 magpie 作为一个自定义供应商交给 Cindy，三个运行时各有一个端点。之后 Cindy 里的 Claude Code、Codex 和 Pi 都能用 magpie 里的任意模型：DeepSeek、GLM、Kimi、Qwen、OpenAI 或 Anthropic Key，以及你登录的 ChatGPT、Copilot 订阅。

把 magpie 加进 Cindy

1. 先打开一次 CindyCindy 运行过之后，它的数据文件夹才存在（macOS 上是 ~/Library/Application Support/Cindy，国际版是 CindyGlobal），magpie 的 Agent 页才会列出它。
2. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
3. 点「添加 magpie」在 Cindy 那一行点 添加 magpie，magpie 把导入链接交给 Cindy。
4. 在 Cindy 里确认确认之前什么都不会添加。确认后，在 Cindy 里给 Claude Code、Codex 或 Pi 选 Magpie 供应商的模型。

点了没反应，说明这台电脑上没有程序能打开 Cindy 的链接（cindy://），或注册它的程序已经被移走。magpie 会先检查这一点并直接说明原因，而不是什么都不做：先打开一次 Cindy 或重新安装，再点一次。

链接里有什么

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

cindy://provider/import?v=1&data=
{
  "kind": "custom", "name": "Magpie", "id": "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"], "modelsUrl": "http://127.0.0.1:3425/v1/models"}
  ]
}

Claude Code 走 Anthropic Messages 协议，地址是网关本身；Codex 走 OpenAI Responses，Pi 走 OpenAI Chat，地址都是网关的 /v1。三个端点的模型列表都从网关的 /v1/models 获取，所以之后在 magpie 里新增的供应商，Cindy 重新获取模型就能看到。

命令行

magpie cindy add      # 打开 Cindy 添加 magpie，在其中确认

命令会打印它打开的链接。没有程序能打开时，它会说明原因，不会假装成功。

magpie 怎么知道已添加

magpie 以只读方式读取 Cindy 的数据库：登录后每个账号一个 cindy-<账号>.db，登录前是 cindy-local-v1.db。只要其中一个的自定义供应商里有 id 或名称为 magpie 的，或端点里有网关地址的，这一行就显示已添加。Cindy 开着也能读，magpie 从不写它。读不了数据库时，magpie 不会说没添加，而是说不知道。

用量与 Key

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

常见问题

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

能。把 magpie 加进 Cindy 后，Claude Code 通过 Magpie 供应商的 Anthropic 端点使用 magpie 里的任意模型，包括 DeepSeek 和 GLM。

magpie 会改 Cindy 的设置吗？

不会。新供应商只能通过 Cindy 自己的导入链接添加，由你在 Cindy 里确认。magpie 只读取 Cindy 的数据库，用来显示是否已添加。

点「添加 magpie」没反应怎么办？

这台电脑上没有程序能打开 cindy:// 链接，或注册它的程序已不在。先打开一次 Cindy 或重新安装，再点一次；magpie 会说明具体原因。

magpie 的 Agent 页里没有 Cindy。

Cindy 在这台电脑上运行过、有了数据文件夹之后，magpie 才会列出它。先打开一次 Cindy，再回来看。

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