Magpie

如果你在用 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。

客户端字段

验证配置

magpie provider test felo

Magpie 会按每种协议各发一个小请求并报告延迟。然后用选中 felo/ 模型的 Agent 问一个简短问题；能收到回复，就说明 Agent → Magpie 网关 → Felo 整条链路已经通了。

故障排查

下一步

• 快速开始
• LLM API 参考
• 模型与价格
• 故障排查