用 magpie 把 Codex 接到任意模型

模型通常散落各处：API key 一份，ChatGPT / Claude / Copilot 登录又一份，每个编程 Agent 还有自己的选择器。按 magpie 官网 和 Get started，magpie 的工作是把供应商收进一个本机应用，并改写每个 Agent 自己的配置。

本文核对方式（2026-10-06）： 重读官方文档，并保留 2026-09-24 的截图。没有做对比跑分，也没有做端到端的网关连通测试。

词条：magpie。相关：Codex CLI、Claude Code。

magpie 用来做什么

来自 README 与 Get started：

• 本机网关 127.0.0.1:3425，接受 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini，含流式与工具调用。
• 一份 Agents 列表。点模型时只改该 Agent 配置里 magpie 需要的键（原子写入，注释和顺序保留）。
• 在 magpie 里登录的订阅（当前文档列出的 Claude、ChatGPT、Cursor、Grok、Copilot、Devin 等）会变成其他 Agent 也能用的供应商。文档写明这条路径不复制一份 key。
• Ollama 与 LM Studio：不需要 API key。
• 粘贴的密钥存在 ~/.config/magpie/providers.json。文档写明 magpie 不从 shell 环境变量读 key。

对 Codex，入门指南写明 magpie 会写 ~/.codex/config.toml（[model_providers.magpie]）和 ~/.codex/magpie-models.json，并且不改 ChatGPT 登录。

安装并确认

只有在这台机器上准备使用 magpie 时才安装：

curl -fsSL https://usemagpie.ai/install.sh | sh

然后在新终端里：

magpie help
magpie ls
magpie presets

预期结果：magpie ls 列出 magpie 找到的 Agent，magpie presets 列出供应商预设。这两步都不需要付费 API key。

若本机已有 Ollama 或 LM Studio，入门指南写明可以免 key 添加。README 示例：

magpie provider add ollama

排查：

• 提示找不到命令：重开终端，或按安装脚本打印的 PATH 说明检查。PATH 里没有 CLI，并不能证明桌面应用没装。
• Agent 列表为空：先安装 Codex（或你要用的 Agent），再跑一次 magpie ls。
• 不要把生产 API key 写进教程。不要把旧截图里别人的 OpenRouter 模型数量当成现货。

把 Codex 指到一个模型

安装 magpie 并至少有一个供应商之后：

1. 打开 Providers，添加预设、订阅磁贴，或 Ollama / LM Studio。
2. 打开 Agents，点 Codex 行，选 provider/model。
3. 完全退出 Codex，或新开 codex 会话。文档写明正在跑的会话会沿用启动时的模型。

README 中的 CLI 等价命令（sk-… 形式需要真实 key；除非你打算向该厂商付费，否则跳过）：

magpie codex moonshot/kimi-k2.5

2026-09-24 截图（未重新截取）：Codex 自己的选择器里出现第三方模型。

Providers 面板（2026-09-24 截图）

下图是 2026-09-24 的取证。当前文档仍把供应商和订阅磁贴放在同一份 Providers 列表。不要把旧图里的「OpenRouter 24 个模型」当成现货清单。

网关怎么接上

Codex 讲 OpenAI Responses API，Claude Code 讲 Anthropic Messages，Gemini CLI 用 Google 的格式。magpie 文档中的网关接收这些形状，再转发给真正提供该模型的供应商。

和 Codex Router 对比：Router 偏向 Codex 额度不够时的路径；magpie 是面向多个 Agent 的本机网关。若你已经在用 Codex Router，magpie 不会自动替换它。先选定一套接线，另一套留作回退，直到你测过一次真实会话。

关于 Codex 模型列表为什么重要，见把模型导入 Codex。

限制和恢复

• 走网关模型时 magpie 必须在跑（入门指南中的 magpie tray 或 magpie serve）。Agent 用自己的厂商登录时不必经过 magpie。
• 换模型不会改变已经打开的会话。
• 复用订阅会碰到本机凭证文件。把付费计划接到别的 Agent 前，先看 magpie README 的读写范围和厂商条款。
• 网关监听回环地址，同一台机器上的其他进程仍可能连上该端口。
• 用 magpie default，或改回原生模型来恢复。

一句话： magpie 是本机模型切换器和协议网关。用 magpie ls 确认安装。把订阅转发和第三方 key 当成另一步，并受条款约束。

资料（2026-10-06）：usemagpie.ai、Get started、GitHub README。