o文档
接入指南 / Magpie
配置管理

Magpie 接入

通过本地网关，为多个编程 Agent 统一管理模型与提供商。

安装与准备#

Magpie 在本机运行网关，管理多个 Agent 的模型连接。先从 官方网站 下载适合系统的版本，完成安装并打开一次。

i
由 Magpie 管理工具时，工具配置可能指向本机网关。请保持 Magpie 运行；要恢复直连，请在 Magpie 中恢复工具原来的模型配置。

添加供应商#

  1. 打开 Providers → Add provider，选择自定义（Custom）。
  2. 名称填 custom，按下面的协议填写地址，并在客户端内粘贴自己的 API Key。
  3. 保存后获取模型列表；如未自动获取，手动添加控制台中可用的完整模型 ID。
字段填写内容
名称custom
OpenAI 兼容地址https://api.onewonconnect.com/v1
Anthropic 兼容地址https://api.onewonconnect.com
API Keysk-你的Key

只填写当前账号已开通的接口协议。若有单独的 Responses 基础地址字段，也填到 /v1，由客户端补充接口路径。

选择 Agent 模型#

回到 Agent 列表，为已安装的 Claude Code、Codex 或其他受支持工具选择 custom 下的模型，再启动一个新会话，让工具读取更新后的配置。

Gemini CLI、OpenCode、Cursor CLI 等工具是否可由 Magpie 托管，以当前 Magpie 版本的 Agent 列表为准。选择网关模型不等于网关已提供各工具的原生协议；需要转换时由 Magpie 处理。

验证与排查#

保存后，选择 custom 提供商和账号中可用的模型，在 目标 Agent 中发送一条短消息。然后到 控制台核对使用记录，确认请求使用了预期的 Key。

认证失败时检查 Key；模型错误时核对模型 ID；接口错误时检查协议和最终请求路径。能拉取模型列表不代表工具调用、图片或 Agent 的全部能力都可用。

若工具无法连接本地地址，先确认 Magpie 网关在运行；若只有某个模型失败，检查该模型支持的接口及工具调用能力。

相关文档Magpie 官方上手指南 ↗
接入文档