Настройка AI tools

Magpie

Настройте Magpie как точку доступа к моделям Felo API Platform, чтобы локальный шлюз отдавал их Codex, Claude Code и другим агентам.

Это руководство для тех, кто использует Magpie — приложение в строке меню с локальным шлюзом, которое сводит модели всех провайдеров в один список для кодирующих агентов, — и хочет добавить в этот список модели Felo API Platform. Magpie запускает шлюз на 127.0.0.1:3425 и переписывает конфигурацию каждого агента так, чтобы запросы шли через него, поэтому агенту не нужны ни ключ Felo, ни его адрес.

Перед началом

Достаточно одного ключа Felo API Platform. Тот же ключ работает с протоколами моделей, агентскими клиентами и API Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page и SuperAgent.

export FELO_API_KEY="YOUR_API_KEY"

Если Magpie ещё не установлен:

curl -fsSL https://usemagpie.ai/install.sh | sh

Добавление Felo как provider

Один ключ Felo открывает Chat Completions, Responses и Anthropic Messages. Передайте Magpie все адреса, которые он может использовать:

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, ключ и OpenAI-compatible base https://openapi.felo.ai/api/v1. Для Anthropic-compatible provider используйте https://openapi.felo.ai/api.

После сохранения ключа 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.

Поля клиента

Поле	Значение
Имя / id provider	`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 felo

Magpie отправит по одному небольшому запросу на каждый протокол и покажет задержку. Затем задайте агенту с выбранной моделью felo/ короткий вопрос: если ответ пришёл, путь агент → шлюз Magpie → Felo работает.

Устранение неполадок

Проблема	Что проверить
Под `felo` нет моделей	Проверьте ключ и повторите `magpie provider models felo`
Ошибка `Model not found`	Указывайте `felo/<model-id>` ровно так, как его печатает `magpie models`
Ошибка аутентификации	Введите ключ заново: `magpie provider key felo <key>`
Не проходят вызовы Anthropic	Base должен быть `https://openapi.felo.ai/api`, без `/v1`
Codex не видит модель	Перезапустите Codex: список моделей читается при старте