Magpie 与 cc-switch 对比

两者都能切换 Claude Code、Codex 或 Gemini CLI 所用的模型。区别在于切换配置之后发生什么:cc-switch 让 Agent 直接连到供应商,Magpie 则让它连到一个会翻译 API 的本机网关。就是这一点区别,决定了每个工具实际能用上哪些供应商。

先说结论

关键区别

cc-switchAgent → 供应商接口
它把接口地址和 key 写进每个工具的配置,所以供应商必须说该工具的协议;设置里有一个 API Format 选项来对应。
MagpieAgent → Magpie → 供应商
所有 Agent 都指向 127.0.0.1:3425 这一个本机地址,从同一个模型目录里选模型。Magpie 在请求发出时做协议转换,流式输出和工具调用都包括在内。

所以两者的分野在供应商覆盖面,而不在界面:切换器能到达多远,取决于每个 Agent 自己支持哪些 API;网关能到达多远,只取决于它能对接哪些供应商。

并排对比

项目Magpiecc-switch
它是什么菜单栏应用 + 本机 API 网关 + TUI/CLI跨平台桌面切换器
切换原理写入 Agent 的 provider/model 字段,再通过网关转发请求把接口地址和 key 写进各工具的配置文件
API 转换支持——OpenAI Chat Completions、OpenAI Responses、Anthropic Messages没有网关;供应商必须匹配 Agent 的协议(API Format 设置)
支持的 Agent29 个(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——后者改用一个本机网关来完成切换。

继续阅读

非官方指南。usemagpie.co 是 Magpie(yetone 的开源项目)的第三方指南。请从官方仓库下载安装包,并到 cc-switch 的项目主页阅读它自己的文档。本站与这两个项目都没有隶属关系。