Felo API PlatformFelo API Platform

AI ツール設定

Magpie

Magpie を Felo API Platform のモデル入口として設定し、ローカルゲートウェイから Codex や Claude Code などのエージェントに Felo モデルを提供します。

コーディング Agent のモデル一覧を一元管理するメニューバーアプリ兼ローカルゲートウェイ、Magpie を使っていて、その一覧に Felo API Platform のモデルを加えたいときにこのガイドを使ってください。Magpie は 127.0.0.1:3425 でゲートウェイを動かし、各 Agent の設定をそこへ向くように書き換えます。Agent 側が Felo の key や URL を持つ必要はありません。

始める前に

Felo API Platform の key が 1 つあれば十分です。同じ 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 は 1 つの 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 にする場合は 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 は 3 つのプロトコルをすべて提供するため、各 Agent は元のプロトコルのまま使えます。Claude Code は Anthropic Messages、Codex は Responses のまま、どちらも Felo に届きます。

クライアントの項目

項目値
Provider 名 / idfelo
OpenAI Chat Completions basehttps://openapi.felo.ai/api/v1
OpenAI Responses basehttps://openapi.felo.ai/api/v1
Anthropic Messages basehttps://openapi.felo.ai/api
API keyあなたの FELO_API_KEY
モデルfelo/claude-sonnet-5-5

設定を確認する

magpie provider test felo

Magpie がプロトコルごとに小さなリクエストを送り、レイテンシーを報告します。そのあと 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 は /v1 を付けない https://openapi.felo.ai/api
Codex がモデルを認識しないCodex を再起動する。モデル一覧は起動時に読まれる

次のステップ