Felo API PlatformFelo API Platform

AI 도구 설정

Magpie

Magpie를 Felo API Platform 모델 진입점으로 설정해 로컬 게이트웨이가 Codex, Claude Code 등 에이전트에 Felo 모델을 제공하도록 합니다.

코딩 에이전트의 모델 목록을 한곳에서 관리하는 메뉴 막대 앱이자 로컬 게이트웨이인 Magpie를 사용 중이고, 그 목록에 Felo API Platform 모델을 추가하려면 이 가이드를 따르세요. Magpie는 127.0.0.1:3425에서 게이트웨이를 실행하고 각 에이전트의 설정을 그쪽으로 바꿔 쓰므로, 에이전트가 Felo key나 URL을 들고 있을 필요가 없습니다.

시작하기 전에

Felo API Platform key 하나면 됩니다. 같은 key로 모델 프로토콜, 에이전트 클라이언트, 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로 쓸 때는 https://openapi.felo.ai/api를 사용하세요.

key를 저장하면 Magpie가 Felo에서 모델 목록을 가져옵니다. 그 모델들은 모든 에이전트의 선택 목록에 felo/<model-id> 형태로 나타납니다.

magpie provider models felo   # Felo 목록 다시 가져오기
magpie models                 # 에이전트가 고를 수 있는 모델, felo/<model> 포함

에이전트에서 Felo 모델 선택하기

magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol

Agents 페이지에서 골라도 됩니다. Felo가 세 가지 프로토콜을 모두 제공하므로 각 에이전트는 원래 프로토콜을 그대로 유지합니다. 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/ 모델을 고른 에이전트에 짧은 질문을 던져 보세요. 답이 오면 에이전트 → Magpie 게이트웨이 → Felo 경로가 모두 연결된 것입니다.

문제 해결

문제확인할 것
felo 아래에 모델이 없음key가 유효한지 확인한 뒤 magpie provider models felo로 목록을 다시 가져오기
Model not foundmagpie models에 나온 그대로 felo/<model-id> 형식으로 쓰기
인증 실패magpie provider key felo <key>로 key 다시 입력
Anthropic 호출 실패base는 /v1 없이 https://openapi.felo.ai/api
Codex가 모델을 무시함Codex를 다시 시작하세요. 모델 목록은 시작할 때 읽습니다

다음 단계