Magpie 设置

安装与准备

从 Magpie 官方网站安装客户端。准备 WuDi API Key，先用模型列表核对可用 ID。本文使用自定义 API Key 提供商，不涉及其他账号的订阅登录。

新增提供商

在当前版本的模型 / Provider 管理页面点击添加，选择自定义提供商。根据目标协议填写：

字段	OpenAI 兼容	Anthropic 兼容
名称	WuDi API	WuDi API Claude
Base URL	https://wudiapi.com/v1	https://wudiapi.com
API Key	WuDi Key	WuDi Key
模型	当前支持该协议的 ID	当前支持 Messages 的 Claude ID

首次建议使用 OpenAI 兼容模式验证文本。不要把两个协议的地址混在同一 Provider 中。

获取与选择模型

如果界面提供模型获取按钮，先尝试抓取；没有自动列表时手动添加精确 ID。保存后在 Agent 的模型选择器中选中该提供商与模型，开启新会话发送短问题。

如果使用配置导入功能，导入后仍需检查是否保留了旧平台地址、Key 或模型。导入完成并不自动保证接入 WuDi。

验证与凭据

在 WuDi 日志核对请求。Magpie 的自定义提供商配置可能位于本机 ~/.config/magpie/providers.json；分享配置前先移除凭据。使用独立 Key 便于后续撤销。

排错与恢复

无模型：核对令牌权限与模型 ID。401：检查 Key 是否完整、是否写在正确 Provider 中。协议报错：确认选的是 OpenAI 还是 Anthropic。恢复时在 Agent 中切回原 Provider，再删除 WuDi 配置。

参考：Magpie 官方接入指南。