这四个工具分别是什么
Magpie、CC Switch、LiteLLM、AgentDock 是”让 AI 代理用上合适模型”这条赛道上的四个代表,形态完全不同:Magpie 是本机菜单栏 AI agent 模型网关(Go 编写、MIT 协议,GitHub 约 1.1 万 Star,2026-10-13 查询),CC Switch 是桌面端代理配置切换器,LiteLLM 是自建 LLM API 网关,AgentDock 是服务端 MCP 运行时。选型的第一刀不在功能多少,而在部署位置——贴身管本机代理,还是服务端管团队流量。本文先用各方官方口径核实定位,再给对比表与决策建议。
先立框架:这个赛道的四种形态
结论:比较之前先认形态,同一个词”网关”在四种形态里指的东西不一样。
| 形态 | 代表 | 一句话定位 |
|---|---|---|
| 桌面配置切换器 | CC Switch | 改写各 agent 的配置文件,请求仍由 agent 直连厂商 |
| 本机代理模型网关 | Magpie | 菜单栏应用 + 本地网关,模型层统一接管 |
| 自建 LLM API 网关 | LiteLLM | 服务端统一 API 入口,面向团队与组织 |
| 服务端 Agent 执行网关 | AgentDock | MCP 运行时,管”AI 怎么动手”而非”用哪个模型” |
另有第四种独立小形态——单机隐私优先的本地网关(如 maskit),关注点在隐私与脱敏,不在订阅复用,本文不展开。
四方定位:用官方口径核实
结论:四者没有谁是谁的替代品,官方描述已经把边界划清了。以下定位均出自 2026-10-13 抓取的各方官方 README。
CC Switch(farion1231/cc-switch,约 14.4 万 Star,GitHub API 2026-10-13 查询 143,730):官方 README 自述”The All-in-One Manager for Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode…”,核心是”Switch API providers in one click”——一键切换 API 供应商,同时统一管理 MCP、Skills、Prompts,免手改 JSON/TOML/YAML。Tauri 2 桌面应用,覆盖 Windows/macOS/Linux,官网 ccswitch.io。它是配置层的切换器与管理器,README 未见本地网关层,请求路径仍由各 agent 自己直连(以官方文档为准)。
LiteLLM(BerriAI/litellm,约 6.1 万 Star,GitHub API 2026-10-13 查询 61,151):官方 README 自述”Open Source AI Gateway for 100+ LLMs. Self-hosted. Enterprise-ready.”——用 OpenAI 格式统一调用 100 多家厂商,既能当 Python SDK 嵌进代码,也能把 AI Gateway(Proxy Server)部署成团队级集中服务。定位是服务端 LLM 网关,吃的是”组织内统一接入、用量与预算管理”的场景(细节以官方文档为准)。
AgentDock:开源 MCP 运行时,跑在你自己的服务器或容器里,对 AI 客户端暴露统一 MCP 入口,提供文件、命令、Git、任务编排与可恢复任务等执行能力(详见 AgentDock 是什么)。它根本不在模型层竞争。
Magpie(yetone/magpie,2026-09-23 创建):官方 README 的核心描述——菜单栏切换任意代理的模型,一个本地网关(127.0.0.1:3425)服务所有代理,讲四种协议(OpenAI Chat、OpenAI Responses、Anthropic Messages、Gemini)并互译;已登录的订阅变成所有代理可用的 provider,配额用完静默切换,代理看不到错误。
四方对比大表
结论:订阅复用与”代理无感切换”是 Magpie 独有的组合,其余三家各有各的主场。
| 维度 | Magpie | CC Switch | LiteLLM | AgentDock |
|---|---|---|---|---|
| 形态 | 本机菜单栏应用 + 本地网关 | 桌面配置切换器 | 自建 LLM 网关(SDK + Proxy) | 服务端 MCP 运行时 |
| 部署位置 | 你的电脑;另有 Docker、Termux(README) | 你的电脑(Win/mac/Linux) | 你的服务器/容器 | 服务器/容器 |
| 订阅复用 | 已登录的 Claude/ChatGPT/Copilot/Gemini/Grok 订阅变 provider 给所有 agent(README) | 管理各 agent 的供应商配置(以官方文档为准) | API key 接入为主 | 不在模型层 |
| 切换方式 | 原子改写 agent 配置里的模型字段,原值 stash 可还原 | 一键切换整份供应商配置(官方 README) | — | — |
| 路由策略 | 路由组五种模式 + weight、多账号 failover、daily warm-up(README/reference) | 未见(以官方文档为准) | 有网关级策略(以官方文档为准) | 任务编排、断点恢复(本站定位) |
| 运行形态 | 菜单栏、窗口、TUI、Web UI、CLI(README) | 桌面应用 | 服务、SDK | 服务端 |
| 迭代状态 | 2026-09-23 创建,极快,open issues 600+(GitHub 2026-10-13) | 2025-08 创建,成熟 | 2023-07 创建,成熟 | 见本站系列 |
| 适合谁 | 多代理、多订阅、多账号的个人开发者 | 只想一键换配置的人 | 团队统一 LLM 接入 | 给 AI 装手脚、跑长任务 |
Magpie 独特的三个点
结论:如果只看三个差异,看订阅桥接、原子改写、多形态。
订阅当 provider。 这是 Magpie 最难被替代的一块:Claude 订阅通过驱动真实的本地 claude 二进制、经 MCP 桥接工具接入;ChatGPT plan 的模型给所有其他 agent 用;Copilot、Gemini (Code Assist)、Antigravity、Grok (SuperGrok) 同理,还支持任何 OpenCode auth 插件或 pi 包(README 事实)。LiteLLM 和 CC Switch 都没把这层做进产品定位。
原子改写而不是重写。 Magpie 只改 agent 配置里那一个模型字段,注释、顺序、格式不动,原值存 ~/.config/magpie/stash.json 可还原(reference 文档)。CC Switch 管理整份供应商配置,思路是”替你拿着配置”,两者作用于同一层的不同粒度。
多形态 + 迭代极快。 菜单栏、窗口、TUI、Web UI、CLI 五种形态加 Docker(README),三周到 1.1 万 Star;代价是项目很新(2026-09-23 创建、open issues 600+,GitHub 2026-10-13),README 明确仓库不收 PR、反馈走 Discord,关键工作流建议先小范围验证。
什么时候不需要 Magpie
官方 README 的边界原文写得很直白:如果你只用一个 agent、用厂商自家 plan 且够用,就不需要它。没有第二份订阅、没有中转 key、不跑第二个代理的用户,装它属于给自己加一层排查面。同理,团队要的是服务端统一入口与预算管控,那是 LiteLLM 的主场;要的是让 AI 操作电脑、编排任务,那是 AgentDock 的主场。
选型决策表
| 你的情况 | 选 | 为什么 |
|---|---|---|
| 多个代理 + 多份订阅/账号,要配额接力 | Magpie | 订阅复用 + 路由组,见 路由组实战 |
| 只想给 Claude Code/Codex 一键换供应商 | CC Switch | 切换器本职,最轻 |
| 团队/服务端统一模型入口、管用量 | LiteLLM | 自建 AI Gateway 定位(官方 README) |
| 让 AI 安全执行命令、编排长任务 | AgentDock | MCP 运行时(定位见上节) |
| 本机隐私优先的网关 | maskit | 单机隐私网关(见形态表) |
组合建议
结论:四者不互斥,按层叠着用是合理的终态(工程建议,非官方说法)。
- Magpie 管本机模型层:所有本机代理的模型切换、订阅复用、配额路由(安装见 Magpie 安装与配置教程)。
- AgentDock 管执行层:服务端接入与任务编排,Magpie 不碰这层。
- maskit 管隐私层:对隐私敏感的流量走本地脱敏网关。
- Magpie 与 LiteLLM 可串联:Magpie 支持任何 OpenAI/Anthropic 兼容 URL 作为自定义 provider(reference 文档),把自建 LiteLLM 挂进来后,团队网关与本机订阅池可以混编。个人用量与成本的账,参考 LLM API 中转成本。
常见问题
cc switch 是什么?
CC Switch 是 Claude Code、Codex、Gemini CLI 等 AI 编码代理的桌面配置切换器:一键切换 API 供应商配置,统一管理 MCP、Skills、Prompts,免手改 JSON/TOML/YAML(官方 README,Tauri 2 桌面应用)。它改配置文件,不架网关;需要订阅复用与配额路由时,Magpie 是更重的替代方案。
claude code 网关哪个好?
本机个人用、要多代理多订阅接力,选 Magpie;团队服务端统一接入与用量管理,选 LiteLLM;只要一键切换供应商配置、不要网关层,选 CC Switch;要 AI 执行任务与编排,选 AgentDock。先按部署位置分,再按订阅复用需求分。
litellm proxy 是什么?
LiteLLM Proxy 是 LiteLLM 的自建 AI 网关形态:把 100 多家 LLM 厂商封装成统一 OpenAI 格式的 API,部署成团队或组织的集中服务(官方 README:self-hosted、enterprise-ready)。它管服务端流量,不管你本机 agent 的配置文件——这与 Magpie 的本机定位正好互补。