AI 工具設定
Magpie
把 Magpie 設定為 Felo API Platform 的模型入口,讓本機閘道向 Codex、Claude Code 等 agent 提供 Felo 模型。
如果你正在使用 Magpie(把各個程式設計 Agent 指向同一份模型清單的選單列應用程式與本機閘道),並希望這份清單包含 Felo API Platform 的模型,請使用本指南。Magpie 在 127.0.0.1:3425 上執行閘道,並改寫每個 Agent 的設定讓它指向閘道,因此 Agent 端不需要持有 Felo key 或 Felo 位址。
開始之前
你需要一個 Felo API Platform key。同一個 key 可用於模型協定、Agent 用戶端、Search、Web Fetch、PPT、Mindmap、LiveDocs、X Search、YouTube Subtitling、Landing Page 和 SuperAgent API。
export FELO_API_KEY="YOUR_API_KEY"如果還沒安裝 Magpie:
curl -fsSL https://usemagpie.ai/install.sh | sh新增 Felo 作為 provider
Felo 用一個 key 同時提供 Chat Completions、Responses 和 Anthropic Messages。把 Magpie 能用到的 base 都填上:
magpie provider add felo \
url=https://openapi.felo.ai/api/v1 \
responses=https://openapi.felo.ai/api/v1 \
anthropic=https://openapi.felo.ai/api \
key="$FELO_API_KEY"在應用程式介面裡,Providers → Add provider 填的是同一組資訊:名稱 felo、key,以及 OpenAI-compatible base https://openapi.felo.ai/api/v1;如果選 Anthropic-compatible provider,base 使用 https://openapi.felo.ai/api。
存好 key 後,Magpie 會向 Felo 取得模型清單;這些模型會以 felo/<model-id> 的形式出現在每個 Agent 的選擇器裡。
magpie provider models felo # 重新取得 Felo 的模型清單
magpie models # Agent 可選的模型,含 felo/<model>在 Agent 裡選用 Felo 模型
magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol也可以在 Agents 頁面直接選。因為 Felo 同時支援三種協定,每個 Agent 都能維持自己的原生協定——Claude Code 繼續走 Anthropic Messages,Codex 繼續走 Responses——最後都落到 Felo。
用戶端欄位
| 欄位 | 值 |
|---|---|
| Provider 名稱 / id | felo |
| OpenAI Chat Completions base | https://openapi.felo.ai/api/v1 |
| OpenAI Responses base | https://openapi.felo.ai/api/v1 |
| Anthropic Messages base | https://openapi.felo.ai/api |
| API key | 你的 FELO_API_KEY |
| 模型 | felo/claude-sonnet-5-5 |
驗證設定
magpie provider test feloMagpie 會依每種協定各送出一個小請求並回報延遲。接著用選了 felo/ 模型的 Agent 問一個簡短問題;能收到回覆,就代表 Agent → Magpie 閘道 → Felo 整條鏈路已經通了。
疑難排解
| 問題 | 檢查什麼 |
|---|---|
felo 底下沒有模型 | 先確認 key 有效,再執行 magpie provider models felo 取得清單 |
出現 Model not found | 模型名稱要和 magpie models 印出的完全一致,形如 felo/<model-id> |
| 認證失敗 | 用 magpie provider key felo <key> 重新填入 key |
| Anthropic 呼叫失敗 | base 必須是 https://openapi.felo.ai/api,不帶 /v1 |
| Codex 不認這個模型 | 重新啟動 Codex;它在啟動時讀取模型清單 |