開發者資源

Magpie

將 RunAPI 新增到 Magpie，併為 Claude Code 或 Codex 選擇模型。

檢視 Markdown

安裝與準備

安裝 Magpie 的最新穩定版。各平臺的安裝方法請參閱官方參考文件。另行安裝 Claude Code 或 Codex。

按照身份驗證指南建立專用的標準 API 金鑰。從模型目錄複製模型 ID 及其支援的協議。更換提供商前，備份代理配置。

新增相容 OpenAI 的提供商

支援 Chat Completions 的模型使用此分支。執行命令前替換兩個佔位符。url= 基礎地址以 /v1 結尾；Magpie 會追加 /chat/completions。

SHELL

magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID

新增相容 Anthropic 的提供商

支援 Anthropic Messages 的模型使用此分支。anthropic= 基礎地址不含 /v1；Magpie 會追加 /v1/messages。

SHELL

magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID

先選擇一個分支。Magpie 會拒絕使用相同金鑰新增第二個提供商。如需保留兩個提供商，請分別建立不同的 RunAPI 專用金鑰。將 RunAPI 金鑰儲存在 Magpie 中，不要存入程式碼倉庫。

為代理分配模型

啟動 Magpie 並保持閘道器執行。在 Agents 介面選擇 Claude Code 或 Codex，再選擇 RunAPI 提供商下的模型。CLI 也提供相同的選擇功能。使用所選提供商和模型 ID 執行一條命令。

SHELL

magpie serve

在另一個終端中選擇模型。

SHELL

magpie models
magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID
magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID

對於 Anthropic 分支，將 runapi-chat 替換為 runapi-anthropic。Magpie 在本地使用 provider/model，並將原始模型 ID 轉發給 RunAPI。代理透過 127.0.0.1:3425 連線 Magpie，無需 RunAPI 金鑰。Codex 使用本地 Responses 介面，這並不意味著 RunAPI 收到的是 Responses 請求。這兩個提供商分支在 RunAPI 端分別選擇 Chat Completions 或 Messages。

驗證配置

使用以下命令檢查提供商和所選模型，然後啟動新的代理會話併傳送簡短提示詞。

SHELL

magpie version
magpie providers
magpie claude
magpie codex

在 RunAPI 用量記錄中確認預期的模型和請求。僅憑代理成功響應，無法確定實際處理請求的提供商。Magpie 的 Test models、Detect APIs 和提供商測試可能傳送推理請求。

已在 Linux 上使用 Magpie 0.1.1307 和 Claude Code 2.1.295 檢查配置及本地路由。兩個提供商分支均返回了固定的本地 fixture 響應。本指南未測試真實 RunAPI 推理或 Codex 推理。用於代理任務前，請檢查所選模型的協議和工具支援。

疑難排解

如果 Magpie 提示該金鑰已新增提供商，請複用該提供商，或為第二個分支使用不同的專用金鑰。此錯誤已在本地復現。

在本地 fixture 測試中，停止配置的伺服器後，復現了 no model list 和 connection refused。請檢查地址和伺服器可用性，再透過 models= 指定準確的模型 ID。代理使用本地閘道器期間，請保持 Magpie 執行。

Claude Code 對 fixture ID 報告了 unrecognized_model，但仍返回了 fixture 響應。如果出現此警告，請檢查原始模型 ID 和 Claude Code 的模型配置。fixture 未驗證上下文限制、工具呼叫或模型質量。

恢復原有配置

移除提供商前，先恢復代理配置。以下命令將各代理恢復到之前的配置。

SHELL

magpie claude default
magpie codex default
magpie provider rm runapi-chat
magpie provider rm runapi-anthropic

僅移除自己新增的提供商。不再需要專用 RunAPI 金鑰時，請撤銷這些金鑰。如果還手動更改了其他配置，請恢復備份。

後續步驟

參閱 LLM API 快速入門，瞭解 RunAPI 公開協議示例，並在模型目錄檢視支援的模型。Magpie 官方參考文件還列出了 Grok Build 整合；本指南未測試 Grok Build。