本地网关 · 一键切换
用 magpie 接入 Monk
Claude Code · Codex · OpenCode 等几十个工具一键切到 Monk
1. 概述
magpie 是一个免费开源（MIT 协议）的本地 AI 网关，装在你自己的电脑上（Mac / Windows / Linux）。把 Monk 添加成它的「服务商」之后，就能在 magpie 里点一下，把 Claude Code、Codex、OpenCode、Gemini CLI 等工具切到 Monk 的模型，不用自己改配置文件。
Monk 只提供 OpenAI 兼容接口，而 Claude Code 用的是 Anthropic 协议、Codex 用的是 Responses 协议。magpie 会在中间自动转换协议，所以这些原本连不上 Monk 的工具也能用了。
magpie 是第三方开发者的开源项目，不是 Monk 的产品。它本身的问题请到它的 GitHub 反馈；连上 Monk 之后的用量、额度、报错，照常找 Monk。
2. 前置条件
- 一把有效的
sk-monk-*Key（购买后发到邮箱）。 - magpie 0.1.8 或更新版本（下面的「一键添加」需要）。
- 电脑能访问
https://monk.party/v1。
3. 安装 magpie
到 usemagpie.ai 下载安装包（Mac 是菜单栏应用）。习惯用终端的话，也可以运行：
curl -fsSL https://usemagpie.ai/install.sh | sh
已经装过的，确认版本在 0.1.8 以上；magpie 会在后台自动更新。
4. 一键添加 Monk（推荐）
把你的 Key 粘贴到下面，点「添加到 magpie」。magpie 会弹出确认窗口，显示服务商名称、地址和模型，你点「Add」才会保存。
Key 应该以 sk-monk- 开头，请检查一下。
Key 只在你的浏览器里拼进链接，直接交给你电脑上的 magpie，不会发给 Monk 或任何网站。magpie 把它保存在你自己电脑的 ~/.config/magpie/providers.json。
点按钮没反应，一般是 magpie 没装、没打开，或者版本太旧。也可以在终端里运行这一行（效果一样）：
5. 或者手动添加
- 打开 magpie，进入 Providers 标签页，点 ＋ Add provider。
- 选 Custom · any compatible URL，按下表填写。
- 保存后，magpie 会自动读到 Monk 的 4 个模型。
只填 OpenAI 兼容地址就够了，Anthropic 那一栏不要填 Monk 的地址。
6. 把工具切到 Monk
在 magpie 的 Agents 标签页，点某个工具那一行的模型，选 monk/… 开头的模型就行。magpie 只改那个工具配置里和模型有关的几项，其他设置原样保留。
monk/monk-codingmonk/monkmonk/monk-fast也可以用终端。比如让 Claude Code 用 Monk 写代码：
magpie claude monk/monk-coding
- Claude Code：切换后新开一个
claude会话生效。只想临时用一次、不改平时的设置，就运行claude-magpie。 - Codex：在 Agents 里选好模型后，要重启 Codex，新的会话才会用 Monk。
- OpenCode：模型会显示成
magpie/monk/monk-coding这样的名字。 - 换回去：在 Agents 里选回工具原来的模型（比如 Claude Code 的 opus、sonnet），magpie 会恢复原来的配置。
7. 验证配置
在终端运行下面这行，magpie 会给 Monk 发一个很小的请求，并显示延迟：
magpie provider test monk
然后在 Claude Code 或 Codex 里发一句「你好」。有回复就说明通了，几分钟后可以在 查询用量 里看到这次调用。
8. 故障排查
- 401 / Invalid API key：Key 填错或已过期。换 Key 用
magpie provider key monk sk-monk-…。 - 模型列表是空的：通常也是 Key 不对。修好 Key 后运行
magpie provider refresh monk重新读取。 - 提示模型不可用：Monk 只接受
monk、monk-fast、monk-coding、monk-free这 4 个模型名，不要在 magpie 里手动输入 gpt-4o、claude 之类的名字。 - 工具还在用原来的模型：切换只对新会话生效，关掉重开一次；Codex 要重启整个应用。
- 「添加到 magpie」按钮没反应：先打开 magpie 再点；还不行就用上面的终端命令。
9. 注意事项
- 带 Key 的「添加」链接只在你自己的浏览器里生成，不要把它或终端命令截图发给别人。
- 用量和额度按 Monk 的规则计算，和你直接调用 Monk 一样，在「查询用量」里看。
- magpie 默认每天上报一次匿名使用统计（不含对话内容），不想上报可以在 Settings → Privacy 里关掉。
- magpie 的「隐私脱敏」可以在请求发出前把密码、Key 等敏感信息换成占位符，默认关闭，在 Settings → Privacy 里打开。