magpie
magpie
magpie 是一個桌面應用,讓 Claude Code、Codex、OpenCode、Gemini CLI 等程式設計智慧體共用同一個服務商。匯入上上之钥的 Key 後,每個工具都會走它原生支援的介面:Claude Code 用 Anthropic Messages,Codex 用 OpenAI Responses,其他工具用 Chat Completions。匯入時 magpie 會自動讀取可用模型。
最快的方式是在控制台 API 金鑰頁面點選 Key 右側的匯入 magpie,一鍵寫入所有介面地址和金鑰。
第一步:安裝 magpie
開啟 magpie 官網,下載對應系統的安裝包(支援 macOS、Windows、Linux),版本需要 0.1.8 或更新; 按系統完成安裝: macOS:把 magpie 拖進應用程式(Applications)資料夾; Windows:執行安裝程式; Linux:按安裝包說明安裝,安裝後會生成桌面啟動項; 安裝後至少開啟一次 magpie。
magpie 需要先開啟一次才會向系統註冊 magpie:// 連結。沒開啟過就點一鍵匯入,瀏覽器會沒有反應,或者提示「magpie 未安裝或版本過舊」。
第二步:一鍵匯入 Key
登入控制台,進入 API 金鑰頁面。還沒有 Key 的話先點建立金鑰; 在要使用的 Key 右側點選匯入 magpie(也可以點使用金鑰,在彈窗裡點一鍵匯入到 magpie); 在彈出的列表裡選擇你要用的工具(Claude Code、Codex、Gemini CLI、OpenCode、Pi、Hermes Agent、Grok Build 等); 瀏覽器詢問是否開啟 magpie 時選擇允許 / 開啟; magpie 彈出確認視窗,會列出服務商名稱、Key 將發往的地址和模型列表。核對地址是本站(https://upupkey.com)後點擊 Add 儲存。
網頁會接著提示下一步:在 magpie 的「Agents」頁為剛才選的工具選擇模型,並給出可直接使用的模型名(例如 zerotoken/claude-sonnet-5-5)。magpie 只需匯入一次,其他工具也可以在「Agents」頁選同一個服務商。
匯入連結裡的 Key 只會交給你本機的 magpie,不會經過 magpie 的伺服器。
匯入後,magpie 會按 Key 所屬分組拿到這些介面:
同一個服務商重複匯入時,確認按鈕會變成 Replace,會覆蓋之前的配置。更換 Key 或分組之後,直接重新匯入一次即可。
第三步:在程式設計工具中使用
在 magpie 裡為 Claude Code、Codex 等工具選擇剛匯入的上上之钥服務商和模型,然後在終端里正常啟動:
在需要「服務商/模型」格式的工具裡,模型寫成服務商 ID/模型名。服務商 ID 是名稱轉成小寫、空格和符號換成短橫線,例如名稱為 ZeroToken 時 ID 是 zerotoken,可以在 magpie 的服務商詳情裡檢視。
用 Claude 分組跑 Codex
Claude 分組的 Key 也能在 Codex 中使用,magpie 會把 Codex 的請求直接發到本站的 /v1/responses,模型選 claude-sonnet-5-5 等 Claude 模型即可。
如果你在這項功能上線前就匯入過,Codex 可能仍然用不了 Claude 模型。請在 magpie 裡刪除這個服務商,再從控制台重新一鍵匯入一次。
手動新增
在 magpie 中新建服務商,按下表填寫:
magpie 只接受 https 地址。地址填錯(例如 Anthropic 地址多加了 /v1)會出現 /v1/v1/... 的 404 錯誤。