让 Claude Code、Codex、Gemini CLI 用上任意模型

Magpie 是什么？

Magpie 是一个很小的桌面应用加命令行工具，常驻在菜单栏，界面只有一屏： 列出你电脑上所有的 AI 编程 Agent，以及每一个当前用的是哪个模型。 点一下数值，选一个模型，整个应用就这么简单。

在这一屏背后，它跑着一个 本机网关，地址是 127.0.0.1:3425。这个网关同时会说 OpenAI Chat Completions、 OpenAI Responses 和 Anthropic Messages 三种协议，并在它们之间互译 —— 流式输出、工具调用、思考过程都包含在内 —— 所以一个 Agent 也能用上它原生不支持的供应商。

因为所有模型都写成 供应商/模型 的形式，并且统一从这一个入口出去， 你的 Agent 里不会留存任何厂商密钥或厂商地址 —— 它们永远只指向 http://127.0.0.1:3425/v1。

所有 Agent，所有模型

Magpie 读写的是每个 Agent 自己的配置文件，所以切换模型不会影响文件里的其他内容。 只有本机已安装或已配置过的 Agent，才会显示在应用里。

支持的 Agent（29 个）

• Claude Code~/.claude/settings.json
• Codex~/.codex/config.toml
• Gemini CLI~/.gemini/settings.json
• OpenCodeopencode.json(c)
• Claude DesktopconfigLibrary
• OpenChamberpreferences.json
• MiMo Codemimocode.json(c)
• Pi~/.pi/agent/settings.json
• OmO~/.omo/agent/settings.json
• Goose~/.config/goose/config.yaml
• Cursor CLI~/.cursor/cli-config.json
• Copilot CLI~/.copilot/settings.json
• Crush~/.config/crush/crush.json
• DeepSeek Harness~/.dsh/config.yaml
• Command Code~/.commandcode/settings.json
• fx~/.fx/settings.json
• omp~/.omp/agent/config.yml
• Devin~/.config/devin/config.json
• Hermes Agent~/.hermes/config.yaml
• Kimi Code~/.kimi/config.toml
• Droid~/.factory/settings.json
• Cline CLIproviders.json
• Qoder~/.qoder/settings.json
• Qoder CN~/.qoder-cn/settings.json
• Grok Build~/.grok/config.toml
• ZCode~/.zcode/v2/config.json
• WorkBuddy~/.workbuddy/models.json
• OpenHanakoprovider-catalog.json
• Alma本机 API :23001

表格里给的是各家配置文件的默认位置。OpenCode、MiMo Code、Pi、OmO、Goose、Crush、omp、Hermes Agent 这几个 Agent 的模型要写成 供应商/模型 形式，其余只填模型名即可。

支持的模型供应商（26 家以上）

预设分为厂商、中转站、本地服务三类。绝大部分预设只需要填 key； 自定义接口需要名称、base URL，可选填模型列表。

• DeepSeek厂商
• Kimimoonshot
• GLMzhipu
• Qwen通义千问
• MiniMax厂商
• StepFun阶跃星辰
• 百度千帆Token Plan
• 腾讯云Token Plan
• 华为云 MaaS厂商
• 火山方舟厂商
• Anthropic厂商
• OpenAI厂商
• Gemini厂商
• Mistral厂商
• xAI厂商
• Groq厂商
• OpenRouter中转
• Together中转
• Fireworks中转
• 硅基流动SiliconFlow
• NVIDIA NIM中转
• ModelScope魔搭
• AiHubMix中转
• 302.AI中转
• Ollama本地
• LM Studio本地

常见组合

三步跑起来

1. 安装 Magpie

   下载对应平台的桌面应用，或者直接用终端安装脚本。

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

   安装脚本会把 magpie 命令放进 ~/.local/bin， macOS 上应用放进 /Applications。 完整说明见 安装教程。

2. 添加模型供应商

   预设只要填 key，本地服务连 key 都不用。

   # 添加供应商
   magpie provider add deepseek sk-…
   magpie provider add moonshot sk-…
   magpie provider add ollama # 本地，无需 key
   
   # 看当前配置了什么
   magpie providers

3. 把 Agent 指向模型

   Magpie 只改写你切换的那一个键，配置文件里的注释和键顺序会原样保留。

   magpie claude moonshot/kimi-k3
   magpie codex deepseek/deepseek-v4-pro
   magpie gemini zhipu/glm-5.3
   
   magpie ls # 列出每个 Agent 及其模型

习惯待在终端？magpie tui 可以在命令行里打开整个界面。 供应商增删、自定义中转、模型套餐价的设置方法见 配置指南。

为什么大家选 Magpie

中文教程

下面这些是大家问得最多的用法，我们正在按这个顺序一篇篇补齐。 每篇都会写清楚改的是哪个配置文件、执行哪几条命令、怎么回滚。

• Claude Code 接 Kimi供应商预设、模型别名、回滚
• Claude Code 接 GLMAnthropic 兼容端点配置
• Claude Code 接 DeepSeek成本最低的常用组合
• Codex 接 DeepSeekResponses API 与 reasoning effort
• Gemini CLI 接 GLM认证方式与模型切换
• 把 Claude 订阅共享给 OpenCode订阅即供应商
• 用 Ollama / LM Studio 跑本地模型不联网、不花 key
• 用 Profiles 一次性切换所有 Agent保存、查看、恢复
• 接入自定义中转站base URL、key、暴露哪些模型
• 理解模型计费与用量台账magpie model price 四个数字怎么填

在教程补齐之前，配置方法可以直接看 配置指南， 里面有每个 Agent 的配置文件路径和全部常用命令。

和同类工具比

常见问题