ARTICLE · 1203009
笔记:CC switch平替软件 Magpie 使用教程
笔记:CC switch平替软件 Magpie 使用教程1.1 背景和简介 由于诸多限制，许多国内开发者难以直接访问Claude官方模型。而Claude Code凭借其出色的harness工程，强大的tools calling能力以及高效的workflow，深受开发者青睐。 为了突破模型provider的限制，让开发者能灵活接入第三方api，CC switch应运而生。在一定程度上解决了模型接入与配置管理的问题。 但随着工具生态不断发展，开发者的需求不再局限于provider切换。如何管理不同的provider订阅也成为值得关注的问题。最近，Magpie突然闯进了所有人的视野之中。几天之内，github star冲到9k+，并且完美解决了上述提到的问题，并在cc switch定位的基础上，更上一层楼。 本文将从实际使用出发，介绍Magpie的基础、进阶使用和基本原理。 1.2 基础使用 
如上图，在打开 Magpie之后，它自动检测到了我所订阅的AI服务，并提示我可以在Claude Code中使用。并可以切换访问的模型。 而它的功能绝不仅限于此。例如，你可以用它快速获取其他agent产品的npm安装包，再也不需要向AI询问或搜索。 
1.3 基本原理 Magpie是如何实现如此丝滑的进行provider的切换？ 其本质是因为，他成为了你电脑后台的实时API Gateway (API网关），而且支持AI的四种主流接口（OpenAI格式，Anthropic格式等）。统一度量衡，横扫中原。将provider与agent之间解除互相捆绑的关系。当Agent发送请求时，不再直接调用provider api，而是发送请求到Magpie，由Magpie进行决定实际调用的provider。 
1.4 高级使用方法 1.4.1 多种路由策略 上文，我们说明了Magpie如何实现对模型provider的调用管理。而它的功能不绝于此。当你的Magpie检测到大于2个的provider的时候，你可以选择路由策略： 比如，选择smart路由策略时，优先调用在未来几天额度最先进行reset的模型，以免浪费额度；更多地，比如order、rotate、usage、pace等功能都可以进行选取，来实现特定的路由策略，以满足日常使用需求。 1.4.2 可视化功能 Magpie的另一个特色，即是它将token的额度消耗做成了可视化界面。 如图，它把我codex订阅的剩余额度，做成了一个走势。以及直接展示了成功调用次数，缓存命中率，token数量，用量热力图等等，非常直观。如下图所示。 
1.4.3 上下文观测 只要是经过Magpie路由后的对话，他都会保留你的提示词，并加以分析。比如，你的提示词有多少是工具定义，多少是系统提示词等等。更令人叹为观止的是，它能够帮你检测你的用法是不是最省额度的最佳配置，帮我省钱的来了。 
1.4.4 会话管理 
2.1 快速上手 功能看够了，如何上手呢？ 1. 快速安装 或在官方网站下载安装包：
除了具备 CC Switch 的 Provider 管理与快速切换等核心功能外，Magpie 更强大的地方在于其统一代理与跨 Agent 模型接入能力。
例如，假设你订阅了智谱GLM的Coding Plan，原本只能通过官方支持的Z Code等工具使用。借助 Magpie，你可以将 GLM 的模型服务配置到本地代理中，再接入你熟悉的 Agent，无需局限于原有的工具。
更令人惊喜的是，Magpie还提供了一套直观、完善的可视化数据统计面板。它能够详细记录每一次AI Coding会话的资源消耗，包括Token使用量、模型调用情况及相关用量数据，甚至连tools calling的调用次数、常用Skills的使用频率等信息也能进行统计与展示，所有数据一目了然。
curl -fsSL https://usemagpie.ai/install.sh | shhttps://usemagpie.ai/zh/
2. 安装过后打开软件即可。
他会自主识别设备上的provider订阅。进入主界面后，即可查看和管理不同provider，并根据需要快速切换。
如果有额外需求，可以在插件功能中进行查看。
