Magpie 是二零二六年九月發佈的開源本機閘道，在 GitHub 累積 23,904 顆星標，以 Go 撰寫、採 MIT 授權。它把 Claude Code、Codex、Gemini CLI 等數十款代理工具的模型設定集中到單一應用，於本機 127.0.0.1:3425 提供三套供應商協議，額度耗盡時自動切換帳號。
Magpie 是什麼？
Magpie 是開源的本機模型閘道，集中管理多款代理工具的模型設定，在 127.0.0.1:3425 提供 OpenAI、Anthropic 與 Gemini 三套協議。
專案由長期投入開源工具的開發者 yetone 主導，首個版本於二零二六年九月二十三日推出。倉庫以 Go 撰寫，程式碼主體約二千九百萬位元組，前端介面另有 JavaScript、HTML 與 CSS 三部分。
名稱取自鳥類喜鵲，官方同時聲明與 Apache Magpie 及 Apache 軟體基金會無關。專案定位寫在 README 首行：Every agent’s model，一個地方管住所有代理的模型。
授權為 MIT，商用與二次分發的限制相對寬鬆。倉庫不開放外部 pull request，功能建議統一走 Discord，由維護者自行實作。
它為何集中管理多個 Agent 的模型？
代理工具各自保存模型設定，格式、金鑰與端點互不相通，付費訂閱通常只在單一工具內生效。集中管理讓同一組供應商資源被所有工具共用。
問題的根源在設定檔的碎片化。Claude Code 讀自己的設定，Codex 讀另一個格式，Gemini CLI 又有一套金鑰與端點規則，同一份付費訂閱往往只能在簽約的那一款工具內使用。
Magpie 的做法是把這些設定搬到應用層。使用者在介面上為每個工具挑選模型，應用再以原子寫入方式改寫該工具設定檔中真正生效的那一項，原有註解、排序與格式保持不變。
設定組（Profile）更進一步，把多個工具的選擇打包成一個名稱，例如預算模式或專注模式，切換時全部工具一起回到該組合。這個設計對同時使用三款以上代理的開發者最有意義。
本機閘道如何運作？
閘道監聽 127.0.0.1:3425，接受 OpenAI、Anthropic 與 Gemini 三種請求格式，並在串流、工具呼叫與推理欄位之間轉譯，代理只需更改端點。
協定轉譯是整個設計的核心。各家代理工具對 API 的要求不同，欄位命名、串流事件與工具呼叫結構都有差異，閘道在中間做格式對照，讓上游模型不必理會下游工具屬於哪個陣營。
接入方式相當直接。使用者把代理工具的 base URL 指向本機位址，金鑰填任何字串即可，之後所有請求都經過閘道再轉往實際供應商。這個做法也適用於任何支援自訂端點的工具。
部署形態不只桌面應用。官方提供選單列程式、獨立視窗、終端介面、網頁介面與命令列五種操作方式，另有 Docker 映像與 Termux 版本，可安裝於伺服器、NAS 或 Android 環境。
路由群組如何處理額度耗盡？
路由群組把多個模型或帳號視為單一目標，依 smart、order、rotate 等模式分配請求。額度用完時群組移到下一個成員，代理不會看到錯誤。
五種模式的差異在分配邏輯。smart 優先使用額度即將重置的訂閱，減少浪費；order 依序使用直到失敗才換下一個；rotate 每輪更換；usage 選用量最少者；pace 則按每小時剩餘額度推算。
同一組訂閱可以掛上多個帳號。Claude、ChatGPT、GitHub Copilot、Gemini Code Assist、Antigravity 與 Grok 等方案都在支援清單內，任一帳號的額度見底後，請求會轉往同組的下一個帳號。
意圖路由是另一個層次。使用者可指定一個小模型閱讀每個新回合，把測試類請求送往能力較強的模型，把簡短提問交給成本較低的模型，路由頁面會即時顯示每次判斷的依據。
代理商亦提供每日預熱功能，在指定時間啟動 Claude 與 ChatGPT 帳號的五小時視窗，或在上一個視窗重置時立即接手，讓可用額度貼近實際工作時段。
隱私遮罩如何保護敏感值？
遮罩功能在本機先把金鑰、密碼與電郵換成占位符，再送出請求，回覆中的占位符會還原成原值，包括串流文字與工具參數。這些值只存在記憶體，不寫入磁碟。
觸發時機在請求離開電腦之前。代理工具常把讀到的 .env、設定檔與含權杖的日誌放進提示詞，遮罩開啟後，這些值在傳出前已被替換，供應商收到的內容不含真實憑證。
辨識方式分兩層。規則層處理可確定者，例如 API 金鑰、私鑰、權杖、電郵，以及校驗碼成立的信用卡號與身分證號；模型層則以一個約 1.6 GB、在 CPU 執行的本機模型找出規則難以覆蓋的姓名、地址與密碼。
還原範圍覆蓋整條回應鏈。同一個值每次都得到相同占位符，因此對話上下文、提示詞快取與推理簽章都保持有效，代理實際執行的指令也會取得真實金鑰。
代價是模型看不到原值。若任務本身與該值相關，例如追查某個權杖為何被拒，就必須把該值列入不遮罩名單。遮罩預設關閉，需在設定的隱私頁手動開啟。
外掛與中介層擴充了什麼？
外掛以 Bun 執行，可自行完成登入、列出模型並發送請求，讓代理把外掛提供的模型當作一般供應商使用。中介層則能在請求與回應之間改寫內容、過濾字詞或拒絕請求。
外掛的形式貼近既有的代理生態。OpenCode 外掛與 pi 套件可直接由 npm 安裝，首次使用時自動下載 Bun 執行環境，社群另有獨立的外掛倉庫供瀏覽。
中介層的權限更靠近底層。onRequest 可取用每次請求的請求體並改寫或拒絕，onEvent 逐個事件檢視串流，onResponse 則在回覆完成後處理，鉤子拋出例外或逾時時請求維持原狀。
官方同時提供數個現成中介層，功能與 New API 的頻道設定對應，涵蓋參數覆寫、模型名稱對映、系統提示注入、敏感詞過濾與 think 標籤清理，且沿用同一套 JSON 結構。
專案數據與社群活躍度呈現什麼訊號？
倉庫自二零二六年九月建立，一個月內累積 23,904 顆星標、1,941 個分支與 135 位貢獻者，提交次數達 4,896 次。版本標籤已達 1,818 個，發佈節奏密集。
發佈頻率是最顯眼的數字。十月二十八日凌晨數小時內，專案連續推出三個版本，換算下來平均每八分鐘就有一個新版本標籤，這種節奏在桌面應用中並不常見。
未結問題為 2,039 項，相對兩萬三千顆星標屬於偏高水位。數量反映了支援矩陣的廣度：清單上列出的代理工具超過七十款，每一款都有自己的設定格式與版本差異。
程式語言分佈亦值得留意。Go 佔約二千九百萬位元組，JavaScript 約一千四百萬位元組，其餘為 HTML、CSS 與少量 Shell 與 C 程式碼，桌面介面另見 QML 與 Objective-C 的痕跡。
導入前要注意哪些風險？
主要風險有三類：版本迭代過快導致行為變動、工具設定被改寫後不易回溯，以及應用會讀取本機既有的登入憑證。團隊導入前應先在單一機器試用，並保留原始設定備份。
版本節奏快意味著行為可能頻繁調整。每日數個版本的專案通常沒有長期支援分支，企業環境若需穩定性，宜固定版本並自行驗證後才升級。
設定改寫雖採原子寫入並保留註解與排序，但仍屬於對既有檔案的實質修改。多機同步與備份功能可降低風險，導入前後各留一份設定快照較為穩妥。
憑證讀取需要明確同意。應用會讀取 Claude Code 與 Codex 的登入檔與系統金鑰圈，以取得訂閱帳號，官方為此提供關閉訂閱帳號探索的選項，亦可以環境變數在單次執行中停用。
遮罩預設關閉亦需注意。未開啟時，提示詞中的機密內容會照原樣送往供應商，與使用原本代理工具沒有差別，團隊若要依賴此功能，必須主動在設定中開啟並檢查記錄頁。
出處連結有哪些？
本文數據整理自專案官方倉庫的說明文件、版本紀錄與統計頁面。原始碼、外掛範例與問題追蹤都在 GitHub 公開，官方網站另提供完整文件與下載。
專案原始碼位於 https://github.com/yetone/magpie，官方網站為 https://usemagpie.ai，文件站另有入門導覽、代理清單、外掛撰寫與遠端連線四類說明。
總結：哪些開發者適合採用 Magpie？
同時使用兩款以上代理工具、持有多個供應商帳號，或需要跨帳號容錯與用量統計的開發者最適合。若只用單一工具與單一方案，直接使用原廠設定更簡單。
專案的價值在於把分散的模型設定收攏成一個可管理的介面。對於每日在 Claude Code、Codex 與 Gemini CLI 之間切換的開發者，統一入口能省下大量重複設定與憑證搬移的時間。
代價是新增一層需要維護的元件。閘道本身要安裝、要更新、要處理版本變動，也要對其讀取憑證與改寫設定的行為建立信任，這些成本在小規模使用時未必划算。
以一個月累積兩萬三千顆星標的成績來看，這類痛點在代理工具普及後確實普遍存在。後續值得觀察的是版本節奏能否放緩，以及未結問題數量是否隨支援矩陣收斂而下降。
