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 | shFelo を 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-solAgents ページから選んでもかまいません。Felo は 3 つのプロトコルをすべて提供するため、各 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 は /v1 を付けない https://openapi.felo.ai/api |
| Codex がモデルを認識しない | Codex を再起動する。モデル一覧は起動時に読まれる |