Magpie 与 cc-switch 对比
两者都能切换 Claude Code、Codex 或 Gemini CLI 所用的模型。区别在于切换配置之后发生什么:cc-switch 让 Agent 直接连到供应商,Magpie 则让它连到一个会翻译 API 的本机网关。就是这一点区别,决定了每个工具实际能用上哪些供应商。
先说结论
- cc-switch 是成熟的桌面切换器:预设、一键切换、按项目的快照、约十个 Agent、庞大的社区,已经发布了一年多。
- Magpie 是切换器外加一个网关:它运行在
127.0.0.1:3425,同时支持 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 三种 API,并在它们之间互译——所以 Agent 也能用上它原生不支持协议的供应商。29 个 Agent,26+ 个供应商预设,另有 TUI 和 CLI。 - 如果你只会把 Claude Code 指向兼容 Anthropic 的供应商,cc-switch 就够用,而且更久经考验。如果你想让 Codex 用 DeepSeek,或者让 Claude Code 用只有 OpenAI 风格接口的供应商,网关正是为此而生。
关键区别
它把接口地址和 key 写进每个工具的配置,所以供应商必须说该工具的协议;设置里有一个 API Format 选项来对应。
所有 Agent 都指向 127.0.0.1:3425 这一个本机地址,从同一个模型目录里选模型。Magpie 在请求发出时做协议转换,流式输出和工具调用都包括在内。
所以两者的分野在供应商覆盖面,而不在界面:切换器能到达多远,取决于每个 Agent 自己支持哪些 API;网关能到达多远,只取决于它能对接哪些供应商。
并排对比
| 项目 | Magpie | cc-switch |
|---|---|---|
| 它是什么 | 菜单栏应用 + 本机 API 网关 + TUI/CLI | 跨平台桌面切换器 |
| 切换原理 | 写入 Agent 的 provider/model 字段,再通过网关转发请求 | 把接口地址和 key 写进各工具的配置文件 |
| API 转换 | 支持——OpenAI Chat Completions、OpenAI Responses、Anthropic Messages | 没有网关;供应商必须匹配 Agent 的协议(API Format 设置) |
| 支持的 Agent | 29 个(Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、Cursor CLI、Copilot CLI、Crush、Goose、Cline、Qoder、Kimi Code、Devin、Grok Build……) | 约十个工具(Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Grok Build、Hermes Agent……) |
| 供应商 | 26+ 个预设(DeepSeek、Kimi、GLM、Qwen、MiniMax、OpenRouter、Ollama、LM Studio……)+ 自定义 base URL + 插件 | 预设(Kimi、GLM、Claude、OpenRouter……)加自定义供应商 |
| 订阅复用 | 登录 Claude Code、Codex/ChatGPT 或 Copilot,该登录就成为一个供应商,所有 Agent 都能用;其他套餐可用 OpenCode 插件 | Codex OAuth 反向代理(v3.13.0+),可在 Claude Code 里使用 ChatGPT 账号 |
| Profile / 快照 | 保存一个 Profile,一步切回所有 Agent | 按工具划分的项目与快照槽位,每次切换前自动保存 |
| 配置安全 | 只改单个键;注释、键顺序和缩进原样保留;原子写入 | 写入工具自己的配置文件;切换前快照 |
| 界面 | 菜单栏面板、普通窗口、magpie tui、纯 CLI | 桌面 GUI |
| 体积 | 桌面版不到 15 MB,纯终端版约 7 MB | 桌面应用 |
| 成本统计 | 按供应商/模型的实际价格 + 每个 Agent 的用量台账 | 文档中未提及 |
| 成熟度 | 2026 年 9 月发布——非常新 | v3.20,自 2025 年 8 月起开发 |
| 许可证 | MIT,免费 | 开源,免费 |
Agent 与供应商清单来自两个项目的公开文档;功能对比截至 2026 年 9 月,两个项目的更新都很快。
该选哪个?
选 cc-switch,如果……
- 你在兼容 Anthropic 的接口(官方 Claude、Kimi、GLM)之间切换,并且想要图形界面
- 你想要按项目的快照,让每个仓库保留自己的配置
- 你看重一个有一年多发布历史和庞大社区的项目
- 你习惯读中文文档——它的文档以中文为主
选 Magpie,如果……
- 你想让 Codex 用 DeepSeek,或者让 Claude Code 用只有 OpenAI 风格 API 的供应商
- 你已经在付 Claude 或 ChatGPT 的订阅,想让每个 Agent 都用上这些模型
- 你常待在终端里,想要 TUI 或 CLI
- 你想按模型看清每个 Agent 花了多少钱
怎么上手
不管选哪个,步骤都很短。Magpie 的整套设置就是一次安装加一个供应商:
# 1. 安装 Magpie
curl -fsSL https://usemagpie.ai/install.sh | sh
# 2. 添加供应商(预设只需要 key)
magpie provider add deepseek sk-…
# 3. 把 Claude Code 指向它
magpie claude deepseek/deepseek-flash
然后可以在菜单栏里给每个 Agent 选模型,也可以用 magpie claude、magpie codex 这类命令,或在应用的 Agents 页面里指定具体模型。完整步骤见安装与配置指南(英文)。
能同时用两个吗?
两个都可以装,但没法真正同时用:它们改的是同一批文件——~/.claude/settings.json、~/.codex/config.toml——谁最后写入,Agent 用的就是谁的设置。拿来并排试用没问题;长期这样用不是好主意,因为在一个工具里切换会悄悄覆盖另一个的设置。
如果你想保留 cc-switch 的按项目快照,同时让 Magpie 提供网关,就要先定下由哪一个负责这些配置文件,另一个保持关闭。
常见问题
Magpie 算 cc-switch 的替代品吗?
部分算。两者都能切换 Agent 使用的模型,所以在配置切换上有重叠。Magpie 额外在 127.0.0.1:3425 运行一个本机网关,在 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 三种 API 之间互译,所以 Agent 也能用上它原生不支持协议的供应商。
谁支持的 Agent 更多?
Magpie 列出 29 个 Agent,包括 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、Cursor CLI、Copilot CLI、Crush、Goose、Cline、Qoder、Kimi Code、Devin 和 Grok Build。CC Switch 自述是一个应用管理约十个工具。Magpie 只显示本机实际安装的 Agent,所以你看到的数量取决于你的机器。
cc-switch 能在 Claude Code 里用 Kimi 或 GLM 吗?
能,前提是厂商提供兼容 Anthropic 的接口,Kimi 和 GLM 都提供——CC Switch 会把接口地址和 key 写进 Claude Code 的配置。Magpie 则让请求走自己的网关,这也让只有 OpenAI 兼容 API 的供应商同样能被 Claude Code 使用。
Magpie 和 cc-switch 一样免费吗?
两者都免费开源。Magpie 采用 MIT 协议;CC Switch 同样是开源桌面应用。两者都不对切换模型收费——你只需要付模型供应商的钱。
能同时使用 Magpie 和 cc-switch 吗?
它们写的是同一批配置文件,同时运行就意味着两个应用在改 ~/.claude/settings.json 和 ~/.codex/config.toml。选一个作为你切换模型的工具;两个都装来逐个评估是可以的。
ccswitch 和 cc-switch 是同一个工具吗?
是同一个。有人写作 cc-switch、CC Switch、cc switch 或 ccswitch,指的都是同一个项目:用桌面应用把供应商和模型写进 Claude Code、Codex、Gemini CLI 等 Agent 的配置里。本页对比的就是它和 Magpie——后者改用一个本机网关来完成切换。