Magpie CLI
magpie
Magpie — приложение и локальный шлюз, которые подключают к Claude Code, Codex, Gemini CLI и OpenCode любые модели и переключают их из меню
- 20 402 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает файлы входа Claude Code и Codex и связку ключей, чтобы предложить подписки другим агентам, а ключи провайдеров хранит в `providers.json`
- Весь трафик агентов идет через локальный шлюз, а расширения и обработчики запросов на JavaScript видят и могут переписать промпты и ответы
- Правит конфиги установленных агентов, а мост подписки Claude запускает локальный `claude` с флагом `--dangerously-skip-permissions`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/magpieОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает файлы входа Claude Code и Codex и связку ключей, чтобы предложить подписки другим агентам, а ключи провайдеров хранит в `providers.json`
- Весь трафик агентов идет через локальный шлюз, а расширения и обработчики запросов на JavaScript видят и могут переписать промпты и ответы
- Правит конфиги установленных агентов, а мост подписки Claude запускает локальный `claude` с флагом `--dangerously-skip-permissions`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Magpie хранит ключи провайдеров и входы в подписки в одном месте и назначает модель каждому установленному агенту. Приложение, написанное на Go, работает как значок в строке меню, окно, терминальный интерфейс `magpie tui`, веб-интерфейс `magpie web` или набор команд: `magpie claude deepseek/deepseek-v4-pro` включает Claude Code на DeepSeek, `magpie codex moonshot/kimi-k2.5` переводит Codex на Kimi. Magpie правит нужное значение в собственном конфиге агента и не трогает комментарии и порядок строк. Профили запоминают настройку всех агентов под одним именем, а Gemini CLI, OpenCode, Goose, Cline, Cursor CLI и еще несколько десятков агентов подключаются так же. Все запросы идут через локальный шлюз по адресу `127.0.0.1:3425`. Он понимает форматы OpenAI Chat, OpenAI Responses, Anthropic Messages и Gemini и переводит их друг в друга вместе с потоковой выдачей, вызовами инструментов и рассуждениями. Агент, который принимает базовый адрес, подключается к шлюзу переменной `OPENAI_BASE_URL` или `ANTHROPIC_BASE_URL`. Группа маршрутизации объединяет несколько моделей и аккаунтов под одним именем вроде `group/daily-coding`, а режимы `smart`, `order`, `rotate`, `usage` и `pace` решают, кто отвечает следующим. Когда лимит одного аккаунта кончается, шлюз без ошибки переходит к следующему. Magpie также читает входы, в которых агенты уже авторизованы, и предлагает подписки Claude, ChatGPT, Copilot, Gemini и Grok как провайдеров для остальных агентов. Страницы использования показывают расход токенов, цену по прайсу, остаток лимитов (`magpie quota`) и сессии агентов. Расширения на Bun добавляют провайдеров из пакетов OpenCode и Pi, а также обработчики запросов. Библиотека записывает инструкции, MCP-серверы, скиллы и субагентов в файлы каждого агента и затем удаляет только то, что записала сама.
Для кого. Для разработчиков, которые пользуются несколькими агентами, провайдерами или аккаунтами и устали править конфиги каждого агента вручную и терять сессию, когда кончается лимит.
Подходит, если
- Нужно запустить Claude Code на DeepSeek или Kimi, а Codex на другой модели и менять их, не открывая конфиги
- У вас несколько аккаунтов подписки, и при исчерпании лимита работа должна идти дальше на следующем
- Модели надо распределять по ходу работы: тесты уходят на сильную модель, быстрые вопросы на дешевую (маршрутизация по намерению)
- Нужен один счет расхода и остатков по ключам, подпискам и агентам, который показывает `magpie quota`
- Один ключ и один набор групп должны обслуживать ноутбук, сервер и NAS: для этого есть общий доступ в локальной сети и образ Docker
Не подходит, если
- Вы работаете с одним агентом на тарифе его вендора, и этого хватает: сам автор пишет, что такому пользователю Magpie не нужен
- Нужно только переключать профили провайдеров с управлением MCP и скиллами в простом приложении: для этого в каталоге есть CC Switch
- Нужен узкий шлюз только для Claude Code с маршрутизацией по условиям и журналом: этим занят Claude Code Router
- Политика компании запрещает программам читать файлы входа других агентов и связки ключей
Пример запроса к агенту
Поставь magpie, добавь провайдера DeepSeek по моему ключу и переключи Claude Code на deepseek-v4-pro, а Codex оставь как естьОграничения
- Лицензия MIT. Репозиторий не принимает запросы на слияние: править код могут только сопровождающие, а пожелания авторы просят оставлять в Discord.
- Сборки для macOS подписаны и проходят нотаризацию Apple, сборки для Windows и Linux пока не подписаны, и Windows SmartScreen может спросить подтверждение при первом запуске. Приложение обновляется само: скачивает новую версию в фоне и ставит при перезапуске.
- Раз в сутки выпущенная сборка отправляет анонимный сигнал: случайный идентификатор, версию, систему и сведения о том, с какими агентами, провайдерами и моделями он используется, по собственным идентификаторам программы. Для партнеров, показанных первыми в окне добавления провайдера, считаются показы, открытия и добавления, а переходы по их ссылкам идут через `usemagpie.ai/go`. Часть отправки отключают в настройках приватности, все сразу выключает `DO_NOT_TRACK=1`.
- Ключи провайдеров лежат в файле `providers.json` в папке `~/.config/magpie` с правами 0600, а входы в подписки в `logins.json`. Резервная копия в репозитории GitHub шифруется.
- Доступность из России зависит от выбранного провайдера: подписки Claude, ChatGPT и Copilot работают, только если доступны их серверы. Установщик и обновление принимают `--proxy` и `--mirror` для сетей без доступа к GitHub.
Как отключить. Перед первым переключением сохраните текущую настройку командой `magpie save before`, позже вернете ее командой `magpie use before`. Значения, которые программа заменила в конфигах агентов, лежат в `stash.json` и восстанавливаются при переключении обратно. Фоновую службу снимает `magpie daemon uninstall`. Чтобы убрать данные, удалите папку `~/.config/magpie` и кэш `~/.cache/magpie`.
Частые вопросы
Как запустить Claude Code на другой модели через Magpie?
Добавьте провайдера: `magpie provider add deepseek sk-…`, где для готового пресета нужен только ключ. Затем выполните `magpie claude deepseek/deepseek-v4-pro`. Magpie изменит нужное значение в конфиге Claude Code, и новый сеанс запустится на выбранной модели. Работающие сеансы остаются на прежней модели, потому что агент читает конфиг при старте.
Что делают режимы группы маршрутизации?
`smart` берет подписку с остатком лимита, которая обновится раньше всех. `order` идет по списку, пока модель не перестанет отвечать. `rotate` переходит к следующему участнику на каждом ходе. `usage` берет наименее использованного, а `pace` выбирает аккаунт, у которого остаток недели в пересчете на час до сброса самый большой. Беседа остается на том аккаунте, который ответил первым, пока кэш запросов у вендора стоит сохранять.
Как Magpie находит подписки, в которые я вошел?
Он читает входы агентов: файлы Claude Code и Codex и связку ключей на macOS. Чтобы запретить это, выключите в настройках приватности пункт про подписки или выполните `magpie accounts discovery off`. Для одного запуска хватит переменной `MAGPIE_NO_ACCOUNTS=1`. Провайдеры с ключом API работают при любом варианте.
Можно ли запустить Magpie на сервере или в Docker?
Да. Команда `magpie daemon install` ставит `magpie serve` службой systemd или launchd, а образ `ghcr.io/yetone/magpie` запускает его на сервере или NAS с управлением из веб-интерфейса. Ноутбук может пользоваться провайдерами и группами другого Magpie и при этом настраивает своих агентов сам.
Как дать доступ к шлюзу другим компьютерам в сети?
Включите общий доступ в локальной сети и выдайте каждому клиенту отдельный именованный ключ шлюза с суточным, недельным или месячным пределом токенов и стоимости. Ключи для вызывающих сторон лежат в файле `caller-keys.json`. Для доступа по HTTPS указывают сертификат и ключ параметрами `--tls-cert` и `--tls-key`.
Что такое промежуточные обработчики запросов в шлюзе?
Это расширения на JavaScript, которые видят то, что агент отправляет и получает обратно. Функция `onRequest` может переписать запрос или отклонить его, `onEvent` видит каждое событие потока, а `onResponse` весь ответ. Если обработчик падает или работает слишком долго, запрос остается прежним. Готовые наборы называются `param-override`, `model-map`, `system-prompt`, `word-guard` и `think-tags`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл для обмена сообщениями между Claude Code, Codex, Gemini CLI и другими консольными агентами через общую локальную базу SQLite на bash
Прокси от ai-forever, который отдает GigaChat через API OpenAI, Anthropic и Gemini, чтобы запускать на нем Claude Code, Codex и Gemini CLI
MCP-сервер, через который Claude Code, Codex и другие агенты зовут Gemini, GPT, Grok и локальные модели для ревью, отладки и консенсуса
Самостоятельно разворачиваемая система для команды AI-агентов: оргструктура, задачи, бюджеты и контроль работы Claude Code, Codex и OpenClaw
CLI на Go, который настраивает уже установленные у вас ИИ-агенты: дает им общую память, рабочий процесс и детерминированные шаги, не подменяя сами агенты
botmux связывает Lark и Feishu с Claude Code, Codex, Gemini CLI и OpenCode: каждое сообщение запускает отдельную сессию агента с живыми карточками
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Magpie (эта запись) | нет | 20 402 | |
| CC Switch | нет | 147 989 | десктопное приложение для переключения профилей провайдеров с общей панелью MCP, промптов и скиллов |
| Claude Code Router | нет | 37 825 | локальный шлюз для агентов с маршрутизацией по условиям, повтором при ошибке и журналом запросов |
| cc-fleet | нет | 185 | подключает сторонние модели только к оркестрации Claude Code, запуская настоящие процессы claude |
Коротко о README
Главная страница репозитория начинается с вопроса, нужен ли вам Magpie, и трех шагов запуска: установка, добавление провайдера, выбор модели. Дальше идут список из шестидесяти с лишним поддерживаемых агентов, схема работы шлюза и разделы о провайдерах, подписках, группах маршрутизации, расширениях, расходах, общем доступе и библиотеке. Отдельные страницы описывают каждую подсистему: сопоставление агентов, мост подписки Claude, провайдеров, синхронизацию и резервные копии. Справочник на сто восемьдесят килобайт перечисляет все команды, настройки и файлы. Есть также руководство по стандартам кода и описание устройства для тех, кто собирает проект сам.