选好配置工具,
一步步连上你的模型。
Magpie 和 CC Switch 是两种平级的接入方式。选你正在使用的一个,下面只显示它的操作步骤。
把 AI 通道 配置导入 Magpie
选择模型类型,获取配置后打开 Magpie。供应商页会显示确认表单,核对名称、接口地址和密钥,点 Add / 添加。
登录后获取你的专属导入配置。
下图以 Claude 供应商为例;你实际导入的模型类型与接口以刚生成的配置为准。
界面示意按 Magpie 开源界面还原 · 示例数据1核对后在 Magpie 点「添加 / Add」。若同名配置已存在,按钮会显示「替换 / Replace」。 同一配置已存在时,按钮会变为 Replace / 替换。确认需要更新后再继续。导入后若模型为空,在供应商页点「获取模型」;接口地址和密钥以本页实际生成值为准。
连接目标工具,再重新启动
在 Agents / 工具 页找到目标工具,打开该行右端的接入开关,再点击模型值,搜索并选择刚导入的模型。下图以 Claude Code 为例。
界面示意按 Magpie 开源界面还原 · 示例数据1–3Agent → Claude Code 的模型下拉框 → 本站供应商下的模型。选择后会接入 Magpie。 模型名称仅为示例,以你的密钥实际获取的列表为准。Claude Desktop 的操作不同:接入后点「全部 N 个模型」勾选模型菜单,重新打开 Claude Desktop 后,在客户端内选择模型。请按下方专用教程操作。
配置完成后,重新打开目标客户端,再新建会话测试。如果配置期间又打开过客户端,请再次完整退出后重开。终端版退出旧进程后重新运行;编辑器插件重新加载编辑器窗口。
保持 Magpie 在菜单栏 / 系统托盘运行。关闭它的配置窗口可以;退出 Magpie 会停止本机网关,目标工具将无法请求模型。
常见问题
Magpie 和 CC Switch 必须都安装吗?
不用,选择你使用的一个即可。本页点选后只显示对应教程。如果另一管理器正在接管同一工具,先停止它对该工具的代理或接管,再退出另一管理器,避免配置被覆盖。
Magpie 支持一键导入吗?
支持。官方从 0.1.8 起提供 magpie://import 导入链接。建议安装最新版本,在本页获取配置后打开 Magpie,核对供应商名称、接口地址和密钥,再点 Add / 添加。
已经在用 CC Switch,能迁移到 Magpie 吗?
Magpie 支持读取 CC Switch 等工具的已有配置。也可以用本页添加当前账号的接入配置。配置同一个工具时,建议选择一个管理器负责切换,避免互相覆盖。
可以在 Claude Code 或 Codex 里使用 DeepSeek 吗?
可以。本站 DeepSeek 接入已验证 Anthropic Messages、OpenAI Responses 和 Chat Completions。本页根据当前站点开放的协议生成配置;导入后到 Magpie 的 Agents 页,为对应工具选择 DeepSeek 模型并新建会话。
为什么要按模型类型分别导入?
本站不同模型类型使用对应的密钥和接口能力。分别添加可以避免选到当前密钥无权使用的模型。受工具限制的模型不会出现在导入列表中。
Magpie 支持直接接入 NewAPI 吗?
支持直接接入 NewAPI 的兼容 API。一键导入的是供应商地址、当前模型类型的密钥和协议配置,随后获取模型列表;这不等于登录 NewAPI 后自动导入整个账号的全部令牌、渠道或分组。本站已自动填好推理地址。
配置前后要退出什么程序?
先完整退出准备配置的目标客户端,再导入和切换配置,完成后重新打开客户端并新建会话。macOS 使用应用菜单退出或 Command + Q,关闭窗口不等于退出;Windows 从系统托盘退出。终端版退出旧进程后重开,编辑器插件重新加载编辑器窗口。使用 Magpie 时保持 Magpie 运行。
点击导入没有反应怎么办?
先安装并启动一次 Magpie,再允许浏览器打开应用。仍无反应时,复制导入链接到浏览器地址栏打开;终端版可用 magpie import 命令导入。链接含个人密钥,请勿分享。
Magpie 显示的费用就是实际扣费吗?
实际扣费以 AI 通道 的价格页和用量记录为准。输入、输出和缓存分别计价,Magpie 的本地费用估算不能替代本站账单。