magpie: один локальный шлюз к моделям для всех ИИ-агентов

Зоопарк агентов и ключей

Если вы работаете сразу с несколькими ИИ-агентами, картина знакомая. Claude Code в одном конфиге, Codex в другом, OpenCode и Cursor в своих. У каждого свой формат настройки, своё поле под ключ, свой список моделей. Захотели проверить DeepSeek в одном агенте и Kimi в другом, идёте и вставляете ключи в каждый конфиг по отдельности.

Дальше только хуже. Ключи лежат открытым текстом в нескольких местах. Сменить модель у агента означает лезть в файл и править строку. Понять, какая модель сейчас стоит у какого агента, без обхода всех конфигов невозможно. А новые провайдеры и модели выходят каждую неделю, и каждый раз это отдельная настройка в каждом инструменте.

Что делает magpie

magpie (репозиторий yetone/magpie, лицензия MIT) это приложение в меню-баре, которое поднимает локальный шлюз на 127.0.0.1:3425. Один этот адрес одновременно отдаёт три API: OpenAI Chat Completions по пути /v1/chat/completions, OpenAI Responses по /v1/responses и Anthropic Messages по /v1/messages. Плюс поддержку API и каталога Google Gemini.

Смысл в том, что любой агент вы направляете в один и тот же endpoint. Codex ждёт OpenAI-совместимый ответ, Claude Code ждёт Anthropic Messages, и оба получают своё с одного адреса. Внутри magpie вы на одном экране видите каждого агента на машине и модель, которая ему назначена, и меняете её из общего каталога. Идея одной точки входа для разных клиентов близка к тому, о чём я писал в разборе протокола MCP, только здесь речь про сами модели, а не про инструменты.

Список поддерживаемых клиентов широкий: Claude Code, Codex, OpenCode, Gemini CLI, Cursor, Copilot CLI, Goose и ещё больше десятка. Каталог моделей magpie подтягивает из открытого справочника models.dev, оттуда берутся имена, уровни reasoning и перечень вендоров.

Подписки как провайдеры

Самая интересная часть. Вы залогинились в Claude Code, Codex (через аккаунт ChatGPT) или Copilot, и этот вход показывается в magpie как отдельный провайдер. После этого любой другой агент может ходить к его моделям через шлюз, не требуя от вас копировать ключ или токен куда-то ещё.

На практике это значит, что подписку, за которую вы уже платите, видит не только родной клиент. Например, OpenCode или собственный скрипт получают доступ к модели из вашей подписки через тот же локальный адрес. Насколько это укладывается в условия конкретного провайдера и лимиты вашего тарифа, надо смотреть отдельно, к этому вернусь ниже.

Пресеты и локальные модели в одном списке

Для облачных провайдеров в magpie есть готовые пресеты: Anthropic, OpenAI, Gemini, DeepSeek, Kimi, GLM, MiniMax, StepFun, Qwen, Mistral, Groq, xAI, а также агрегаторы OpenRouter, Together, Fireworks, SiliconFlow. Добавляете ключ один раз в шлюзе, и модель становится доступна всем агентам сразу.

Отдельно стоят пресеты Ollama и LM Studio. Это значит, что модели, которые крутятся у вас локально, попадают в тот же каталог, что и облачные, и переключение между ними сводится к выбору строки. Разницу между этими двумя движками я разбирал в статье про Ollama и LM Studio. В связке с magpie удобно держать дешёвую локальную модель для черновой работы и дорогую облачную для сложных задач, а как раскладывать нагрузку между ними, я показывал в материале про маршрутизацию моделей.

Что важно учесть

magpie решает конкретную проблему конкретной аудитории. Если у вас один агент и одна модель, шлюз не даст ничего: вся его ценность в том, чтобы свести несколько клиентов и провайдеров в один контур. Это инструмент для тех, кто уже жонглирует несколькими агентами.

Это десктопное приложение, оно запускается на вашей машине из меню-бара, а не как сервис где-то на сервере. Для командного или продакшен-контура это отдельная инженерная задача, а не готовая коробка.

Использование подписок Claude Code, ChatGPT или Copilot через сторонние агенты упирается в условия провайдеров и лимиты тарифов. Провайдер вправе считать доступ через другой клиент нарушением или упереть вас в rate limit. Прежде чем строить на этом рабочий процесс, читайте условия конкретной подписки.

И последнее: проект молодой и меняется быстро. Число звёзд на GitHub растёт, но фиксировать его точной цифрой нет смысла, как и полагаться на то, что интерфейс и список пресетов завтра будут ровно такими же. Проверяйте актуальное состояние прямо в репозитории.

Что можно сделать уже сейчас

Первое: поставьте magpie из репозитория и запустите, иконка появится в меню-баре. Откройте экран со списком агентов, которых утилита нашла на машине.

Второе: направьте ваших агентов на локальный адрес. Claude Code, Codex и OpenCode переключаете на 127.0.0.1:3425, каждый на свой путь API. После этого их модели вы задаёте уже из magpie, а не в родных конфигах.

Третье: соберите каталог. Залогиньтесь в подписки, которые у вас есть, добавьте один облачный ключ через пресет нужного провайдера и подключите Ollama или LM Studio, если гоняете модели локально.

Четвёртое: назначьте модель каждому агенту и прогоните живую задачу. Попробуйте одну и ту же задачу на локальной и облачной модели, чтобы увидеть разницу в качестве и скорости на своём коде, а не на бенчмарках.

Частые вопросы

Это замена облачным ключам и подпискам?

Нет. magpie это шлюз перед ними. Ключи и подписки остаются вашими, утилита лишь даёт всем агентам единую точку входа и общий каталог, чтобы не настраивать каждого по отдельности.

Куда уходят мои данные при работе через шлюз?

Сам шлюз работает локально на 127.0.0.1. Запросы идут тому провайдеру, чью модель вы выбрали для задачи: облачной модели в облако, локальной модели через Ollama или LM Studio никуда с машины. То есть куда уйдут данные, определяет выбранная модель, а не наличие magpie.

Подойдёт ли это не разработчику?

magpie заточен под тех, кто уже работает с несколькими ИИ-агентами и командной строкой. Если задача проще, например один чат-ассистент для бизнеса, то шлюз избыточен, тут ближе разбор про ИИ-агентов в бизнесе.

Коротко о главном

magpie берёт разрозненный набор агентов и провайдеров и сводит его в один локальный endpoint с общим каталогом моделей. Уже оплаченные подписки становятся провайдерами без переноса ключей, локальные и облачные модели лежат в одном списке, переключение занимает секунды. Ограничения честные: это десктопный инструмент для тех, кто уже пользуется несколькими агентами, а условия провайдеров и лимиты подписок остаются вашей зоной ответственности.

Если ваша компания строит своих ИИ-агентов или хочет свести модели и провайдеров в управляемый контур, с логированием, ролями и предсказуемыми расходами, я помогу спроектировать и внедрить такое решение, посмотрите разработку ИИ-агентов и ИТ-инфраструктуру, а ориентир по бюджету есть на странице цен. Чтобы обсудить вашу задачу, напишите мне в Telegram слово «ШЛЮЗ», разберём, как собрать шлюз под ваш стек.