ARTICLE · 1100791
我把所有 AI 工具,都接到了同一根水管上
前段时间我把用了很久的 CC Switch 退役了,换成一套新链路:本地 Magpie 网关 + 云端 CPA。今天把整套架构拆开讲一遍。

一、起点:工具太多,管不过来了
我日常用的Harness工具不少:OpenAICodex、Hermes、Gemini。每个都有自己的配置文件和 Key 管理方式,换个模型要挨个改,Key 散落在各处。
我想要一根“水管”:所有工具只管往这根水管里发请求,后面走哪个模型、用什么 Key、怎么路由,统一管。
二、本地这一头:Magpie 网关
Magpie 常驻本地,监听 127.0.0.1:3425,所有 Agent 的请求都指向它。它干三件事:
1. 协议互转:OpenAI、Anthropic、Gemini 的格式在本地双向翻译,各工具无感。
2. 一键切模型:菜单栏/TUI 点一下,所有工具的底层模型一起换,还能按工作区保存配置。
3. 路由组:把云端 CPA 设为主通道,支持多模型降级和轮换。
另外,已登录的 Claude Code / Codex 本地凭证可以直接复用为 Provider,不用到处填 Key。
三、云端这一头:CPA 统一分发
Magpie 通过 HTTPS 直连云端的 CPA 网关,部署在海外 VPS 容器里。
CPA 是中枢:对外只暴露一套 OpenAI 兼容接口,真实 Key 全收在云端;下面挂 OpenAI、Claude、Gemini、xAI、DeepSeek 等多个上游,做负载和智能分发;改配置热重载,不用重启容器,服务不间断。
四、出口:独享住宅 IP
CPA 出站统一走独享静态住宅代理。IP 固定、独享带宽,不与他人共享 IP 池,用起来稳定。
五、最末端:模型
请求最后落到各家官方模型:Claude、OpenAI、Gemini,以及 DeepSeek、Kimi、GLM 等国内模型。该干活干活。
六、一句话总结
本地 Magpie 管“怎么接”,云端 CPA 管“走哪条路”,住宅出口保“稳定到达”。三层分工,工具侧零改造,加新工具就是改一行配置的事。