Magpie — менеджер моделей для ваших агентов: одна панель, один локальный шлюз и 53 поддерживаемых агента. Разбираем, как поставить его за 15 минут, добавить провайдера и переключить модель, не правя конфиги руками.
Коротко: Magpie (MIT, проект yetone) ставит на вашу машину локальный шлюз на 127.0.0.1:3425, который говорит на API OpenAI, Anthropic и Gemini и переводит запросы между ними. Провайдера вы добавляете один раз — и модель появляется в списке у каждого агента: Claude Code, Codex, Gemini CLI, OpenCode, Cursor CLI, Goose и ещё четырёх десятков. Ниже — установка, провайдеры, роутинг-группы и учёт расхода.
Каждый кодинг-агент держит выбранную модель в своём файле и в своём формате: Claude Code — в ~/.claude/settings.json, Codex — в ~/.codex/config.toml, OpenCode — в opencode.json. Пока агент один, это терпимо. Как только их два-три, начинается рутина, знакомая всем, кто работает с несколькими инструментами:
Magpie ставит между агентами и провайдерами один локальный слой. Провайдеры и ключи живут в Magpie, агенты видят каталог моделей вида провайдер/модель, а переключение — это одна правка в конфиге агента, которую Magpie делает сам.
~/.config/magpie/stash.json и возвращаются, если вы переключите агент обратно на «родную» модель.провайдер/модель, и добавив провайдера один раз, вы видите его модели во всех агентах.claude/…, codex/…, copilot/… появляется в других агентах.magpie tui), браузер (magpie web), CLI и отдельный режим «только шлюз» (magpie serve).curl -fsSL https://usemagpie.ai/install.sh | sh # альтернативы: go install github.com/yetone/magpie@latest
magpie presets # вендоры, релеи, локальные magpie provider add deepseek sk-... magpie provider add ollama
magpie models # каталог, который видят агенты magpie claude deepseek/deepseek-chat
magpie providers # кто на какой модели и что подключено
libgtk-3-dev и libwebkit2gtk-4.1-dev, а в Termux используется сборка без графики — для неё подойдут magpie tui или magpie web.| Команда | Что делает | Когда нужна |
|---|---|---|
| magpie presets / providers | Список известных провайдеров и уже подключённых | На старте и при проверке |
| magpie provider add | Добавляет провайдера (пресету хватит ключа) | Основная настройка |
| magpie provider models | Выбирает, какие модели провайдера показывать агентам | Большие каталоги |
| magpie provider test | Один маленький запрос по каждому API с замером задержки | Проверка ключа |
| magpie | Записывает выбранную модель в конфиг агента | Смена модели из терминала |
| magpie group add … | Собирает роутинг-группу из моделей и аккаунтов | Лимиты и квоты |
Magpie не переизобретает настройки: он правит те файлы, которые агенты и так читают. Ниже — часть списка из официального reference (всего в таблице 53 агента, и показаны только те, что установлены на вашей машине).
| Агент | Файл конфига | Что переключается |
|---|---|---|
| Claude Code | ~/.claude/settings.json | провайдер, модель, opus/sonnet/haiku |
| Codex | ~/.codex/config.toml | провайдер, модель, effort |
| Gemini CLI | ~/.gemini/settings.json, ~/.gemini/.env | авторизация, модель |
| OpenCode | ~/.config/opencode/opencode.json(c) | модель и «малая» модель |
| Goose | ~/.config/goose/config.yaml | модель |
| Cursor CLI | ~/.cursor/cli-config.json | модель |
| Copilot CLI | ~/.copilot/settings.json | модель |
| Crush | ~/.config/crush/crush.json | большая и малая модели |
| Devin | ~/.config/devin/config.json | модель |
| Hermes Agent | ~/.hermes/config.yaml | модель |
| ZCode (Z.ai) | ~/.zcode/v2/config.json | провайдер (модели Magpie в списке ZCode) |
| Qwen Code | ~/.qwen/settings.json | модель |
Роутинг-группа — это несколько моделей или аккаунтов, которые агент выбирает как одну сущность group/имя. Запрос идёт по ключам и аккаунтам участников вместе, а способ выбора задаётся параметром routing:
smart — по умолчанию: из подписок с запасом квоты первой берётся та, чей лимит обновится раньше;order — строго по порядку: пока первая модель отвечает, остальные не трогаются;rotate — каждая следующая реплика уходит следующему участнику;usage — сначала менее использованные;pace — по недельному темпу: выбирается аккаунт, у которого осталось больше недельного запаса на час до обновления лимита.magpie groups # ваши группы и найденные автоматически magpie group add "Opus anywhere" \ models=claude/claude-opus-5-5,copilot/claude-opus-5.5 \ routing=order stays=session magpie claude group/opus-anywhere
Отдельный сценарий — учёт лимитов у провайдеров-подписок: Magpie знает про недельные и пятичасовые окна подписок (в том числе Z.ai, MiniMax Coding Plan и OpenCode Go) и учитывает их при выборе участника группы. Если один аккаунт исчерпан, агент не увидит ошибки — запрос просто уйдёт к следующему.
Все настройки лежат локально: провайдеры и ключи — в ~/.config/magpie/providers.json (права 0600), вытесненные значения конфигов — в stash.json, плагины и их авторизации — рядом. Пути уважают XDG_CONFIG_HOME и XDG_CACHE_HOME.
Из телеметрии — одно событие в сутки в PostHog со случайным идентификатором (файл install-id), версией, системой и архитектурой, плюс обезличенный список того, с какими агентами, провайдерами и моделями Magpie используется — по внутренним идентификаторам самого Magpie. Это открыто описано в документации, а не спрятано в FAQ.
Сам Magpie бесплатный и открытый (MIT): платите вы только провайдерам, подпискам и за своё железо. Внутри есть учёт расхода: по умолчанию цена берётся из каталога models.dev, для релеев и своих эндпоинтов её можно задать вручную четырьмя числами — вход, выход, чтение и запись кэша, доллары за миллион токенов.
magpie model price relay-a/gpt-5.5 0.12,0.60,0.01,0.15 magpie model price relay-a/gpt-5.5 # что учтено и откуда цена
Для читателей из России важнее другой вопрос — чем платить за провайдера. Открытые модели (DeepSeek, Kimi, GLM, Qwen) и локальный запуск здесь удобнее зарубежных подписок: у первых платёж проходит через посредников, второй вообще не требует платежей, если модель влезает в ваше железо.
| Сценарий | Что нужно | Материалы Qantcore |
|---|---|---|
| Codex на DeepSeek или Kimi | Ключ вендора или релея + доступ к API | гайд выше |
| Локальные модели без платежей | Ollama и достаточный объём памяти | гайд по локальным LLM |
| Подписка на открытые модели | Оплата через посредника | OpenCode Go: оплата из РФ |
| Зарубежные облака | Ключ и рабочий доступ к API | обзоры агентов и моделей |
claude, поэтому Claude Code должен быть установлен и залогинен.magpie tui), браузерный интерфейс (magpie web) и режим «только шлюз» (magpie serve); для сервера или NAS публикуется Docker-образ ghcr.io/yetone/magpie с веб-панелью на порту 3430, а в Termux используется сборка без GUI.