magpie для команды: gateway-key, общий доступ по локальной сети и синхронизация (ноябрь 2026)
Как пользоваться magpie в команде или на нескольких компьютерах? По состоянию на 2026-11-10, по официальному справочнику magpie: на компьютере, где работает шлюз, включите «Settings → Network and sharing → Share on local network» и создайте ключ шлюза для каждого коллеги или компьютера (magpie gateway-key add); у каждого ключа может быть свой лимит и свой список моделей, а запрос с другой машины без включённого ключа шлюза получает 401. Если на другом компьютере тоже работает magpie, добавьте этот компьютер там как Remote magpie. Чтобы переехать на новый компьютер или держать несколько в одном состоянии, используйте magpie backup и magpie restore либо «Settings → Sync and backup». Ключи шлюза — это не API-ключи, сохранённые у провайдеров: с QCode команде нужен один ключ QCode, и он хранится на компьютере со шлюзом.
Обновлено 2026-11-10
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре способа делить один magpie
Ключ на каждого, со своим лимитом и моделями
Включите «Settings → Network and sharing → Share on local network», затем откройте Gateway → Gateway keys → Add gateway key. В терминале — magpie gateway-key add / list / limit / models. Ключи шлюза отдельны от API-ключей провайдеров, а те остаются только на компьютере со шлюзом.
Другой компьютер обращается к этому шлюзу
Если на другом компьютере тоже работает magpie, выберите в его окне добавления «Another computer's magpie» и укажите адрес этого компьютера и ключ шлюза. Его собственный magpie по-прежнему настраивает его агентов, а провайдеры, группы маршрутизации и расход берутся с общего.
На сервере или NAS
Официальный образ — ghcr.io/yetone/magpie; 3425 — шлюз для агентов, 3430 — веб-интерфейс, а MAGPIE_WEB_KEY сохраняет ключ интерфейса после перезапуска. Любой запрос извне контейнера, включая запросы самого хоста, должен нести включённый ключ шлюза.
Шифрование парольной фразой, на сервере только шифртекст
magpie backup создаёт резервную копию, зашифрованную парольной фразой, а magpie restore восстанавливает её на другом компьютере; «Settings → Sync and backup» работает через WebDAV, S3 или приватный репозиторий GitHub и каждые 3 минуты, пока работает шлюз, приводит все машины к одному состоянию.
Что значит делить magpie с командой
Коллеги получают ключи шлюза, а не API-ключ вашего провайдера. По состоянию на 2026-11-10 официальный справочник magpie пишет, что шлюз выдаёт клиентам ключи шлюза (gateway keys) отдельно от API-ключей провайдеров. Ключ провайдера (например, ваш ключ QCode cr_) хранится только на компьютере со шлюзом; вы создаёте именованный ключ шлюза для каждого коллеги или компьютера, а их инструмент направляет base URL на адрес вашего шлюза и использует этот ключ шлюза как API-ключ: клиент, совместимый с Anthropic, берёт сам адрес, а клиент, совместимый с OpenAI, добавляет к нему /v1 (примеры на официальной странице Docker — http://192.168.1.20:3425 и http://192.168.1.20:3425/v1); ID моделей записываются как «провайдер/модель». Запросам через loopback ключ шлюза не нужен; после включения общего доступа по локальной сети запросы с других машин должны нести включённый ключ, и опубликованный порт Docker, и дистрибутив WSL за NAT тоже считаются удалёнными.
Ключи шлюза: где они в интерфейсе и какие команды
По состоянию на 2026-11-10 путь в справочнике — «Settings → Network and sharing → Share on local network», и только после этого появляется Gateway → Gateway keys → Add gateway key; автор в ответе в issue #1496 пишет то же самое: после включения общего доступа на странице Gateway появляются Gateway keys, а Add gateway key создаёт сколько угодно именованных ключей. Команды терминала — как в официальном тексте: magpie gateway-key add team-a создаёт ключ (новый ключ выводится один раз), magpie gateway-key list показывает id, имена, включённость и замаскированные ключи, magpie gateway-key limit team-a week --tokens 2m --cost 5 задаёт недельный лимит, а magpie gateway-key models team-a qcode/* разрешает только модели провайдера qcode (шаблон — «провайдер/модель» или «провайдер/*», а all означает все модели). Коллега с ключом может открыть в браузере адрес, по которому он подключается к шлюзу, с добавкой /me, ввести свой ключ и увидеть свои лимиты, расход за сегодня, за 7 и 30 дней, доступные ему модели и готовую настройку для Claude Code и Codex.
Хронология
Issue #28 (синхронизация всех настроек через WebDAV): автор ответил, что первый шаг вышел в v0.1.28 — зашифрованные резервная копия и восстановление командами magpie backup и magpie restore.
Issue #28 закрыт: автор написал, что в v0.1.76 в настройках появился раздел «Sync and backup» с синхронизацией через WebDAV, а другие компьютеры подключаются с той же парольной фразой.
Issue #1496 (несколько API-ключей на шлюзе и учёт токенов по ключам) закрыт: автор ответил, что именно это делают ключи шлюза — у каждого свой лимит и список моделей, а расход считается по ключу.
Что описано официально и что ещё открыто
Что указано в официальной документации
1. Удалённый запрос передаёт включённый ключ шлюза как Bearer, x-api-key, x-goog-api-key или ?key=; через loopback проходит любой токен. 2. Лимит задаётся в токенах, в оценочной стоимости в долларах США или в обоих, за день, неделю или месяц либо каждые N дней или N часов; у ключа может быть до пяти лимитов, после исчерпания запросы этого ключа получают 429, а другие ключи не затронуты; стоимость оценивается по ценам страницы Usage, а запросы с этого компьютера без ключа шлюза не лимитируются. 3. Каждый ключ можно отдельно переименовать, отключить, перевыпустить (rotate) или удалить, и удаление отзывает удалённый доступ; при перевыпуске сохраняются имя, включённость, лимиты и история расхода. 4. Резервная копия шифруется на вашей машине (AES-256-GCM, ключ выводится из парольной фразы через PBKDF2-SHA256), и без парольной фразы в ней ничего не прочитать; файл, созданный magpie backup --no-keys, не содержит API-ключей, а при восстановлении на целевом компьютере остаются уже имеющиеся ключи шлюза. 5. Синхронизация идёт каждые 3 минуты, пока работает шлюз, сервер хранит только шифртекст, а для синхронизации через GitHub нужен приватный репозиторий. 6. Если на одном компьютере вернуть синхронизированную модель агента назад, этот компьютер оставляет своё значение: раздел «Settings → Sync» показывает его в списке «Kept on this computer», а «Follow the others» снова берёт синхронизированное значение.
Что ещё открыто на GitHub
По состоянию на 2026-11-10 issue #2269 всё ещё открыт. Его заголовок говорит, что нечитаемый settings.json попадает в резервную копию и синхронизацию как набор значений по умолчанию и затирает настройки на всех машинах, куда его возвращают. 2026-10-15 автор ответил, что это исправлено: после исправления нечитаемый settings.json останавливает резервное копирование, экспорт из интерфейса и синхронизацию с ошибкой, ничего не шифруется и не отправляется, а статус синхронизации показывает эту ошибку; исправление выходит в следующем релизе, и до тех пор issue остаётся открытым. Автор также написал, что не проверял случай, когда settings.json держит открытым другая программа Windows, и не проверял исправление на настоящем сервере WebDAV, S3 или GitHub.
Коллеги обращаются к шлюзу напрямую или у них тоже свой magpie
Их инструмент обращается к этому шлюзу напрямую
Подходит, когда коллеге нужны только Claude Code, Codex или другой инструмент, в котором можно указать base URL. Дайте ему ключ шлюза: клиент, совместимый с Anthropic, берёт сам адрес шлюза, клиент, совместимый с OpenAI, добавляет /v1, ID моделей записываются как «провайдер/модель», а GET /v1/models выдаёт их список. У каждого ключа свой лимит и список моделей, расход считается по ключу.
На другом компьютере тоже работает magpie
Добавьте общий как Remote magpie; пример из справочника — magpie provider add remote-magpie sk-magpie-… url=http://192.168.1.20:3425 id=office, где sk-magpie-… заменяется созданным ключом шлюза, а адрес — вашим. magpie того компьютера по-прежнему сам прописывает конфигурацию своих агентов, а провайдеры, группы маршрутизации (office/group/…) и расход берутся с общего; лимиты, которые общий magpie задал этому ключу, видны и на странице Usage другого компьютера.
Для команды и нескольких компьютеров: пять шагов
1. На компьютере, где будет работать шлюз, установите magpie и добавьте QCode (три адреса и ссылка импорта — на /magpie-claude-code-guide). 2. Включите «Settings → Network and sharing → Share on local network» и в Gateway → Gateway keys создайте по ключу на каждого коллегу; в терминале: magpie gateway-key add team-a; magpie gateway-key limit team-a week --tokens 2m --cost 5; magpie gateway-key models team-a qcode/* (qcode — id провайдера, который magpie даёт QCode при добавлении). 3. Коллеги указывают в своём инструменте адрес вашего компьютера в локальной сети (официальный пример — http://192.168.1.20:3425, для клиента, совместимого с OpenAI, плюс /v1), а в качестве API-ключа — ключ шлюза; коллега, у которого тоже работает magpie, вместо этого использует вариант Remote magpie выше. 4. Переезд или копия: magpie backup (парольная фраза запрашивается дважды), затем magpie restore magpie.magpie-backup на новом компьютере; копия без API-ключей — magpie backup --no-keys ~/b.magpie-backup. Чтобы держать несколько компьютеров в одном состоянии, используйте «Settings → Sync and backup». 5. Сервер — в вопросе про Docker ниже; Windows и WSL — на /magpie-wsl-windows-setup, ошибки — на /magpie-errors-and-fixes, переход с CC Switch — на /magpie-migrate-from-cc-switch.
Команде нужен один ключ QCode — на компьютере со шлюзом
По состоянию на 2026-11-10 статья QCode про magpie даёт три адреса: anthropic — https://api.qcode.cc/api, chat — https://api.qcode.cc/openai/v1, responses — https://api.qcode.cc/openai; одно нажатие «Импорт в magpie» в консоли настраивает и Claude, и GPT. Один API-ключ QCode обслуживает оба совместимых интерфейса — Anthropic и OpenAI, оплата по токенам, цены по моделям — на /models. Для команды: ключ QCode остаётся внутри magpie, а коллеги получают ключи шлюза, а не ключ QCode; вся команда через шлюз делит лимит и число параллельных запросов этого ключа (у ключа личного тарифа их 5, в тарифе «Максимальный» — 10), а расход виден в разделе «Статистика использования» консоли QCode. Чтобы контролировать квоту и расход по людям, используйте «Командный тариф»: по одному суб-ключу на участника, у каждого своя квота; см. /claude-code-team-shared-keys. Не хотите месячный тариф? «Разовые пакеты» начинаются с $4: разовый объём, который нужно израсходовать за 7 дней. Если у вас уже есть личный тариф и квоты не хватает, докупите бустер-пакет.
Частые вопросы
Как дать коллеге пользоваться magpie?
На своём компьютере включите «Settings → Network and sharing → Share on local network», создайте для коллеги ключ шлюза (magpie gateway-key add с именем) и попросите его направить base URL своего инструмента на адрес вашего шлюза в локальной сети, указав этот ключ шлюза как API-ключ. Ключ вашего провайдера остаётся внутри magpie и никому не передаётся. Если у коллеги тоже работает magpie, он добавляет ваш как Remote magpie. Установка и добавление QCode — на /magpie-claude-code-guide.
Можно ли в magpie ограничить расход каждого человека?
Да. У каждого ключа шлюза может быть свой лимит: токены, оценочная стоимость или и то и другое, за день, неделю или месяц либо каждые N дней или N часов, до пяти лимитов, а также разрешённый список моделей; после исчерпания этот ключ получает 429, а остальных это не затрагивает. В issue #1496 автор объясняет, что расход считается по ключу: Usage → Overview → Gateway keys суммирует токены и стоимость по ключам, Usage → Requests умеет фильтровать по ключу, а в экспортированном CSV есть столбцы caller_key_id и caller_key_name. Коллега может открыть адрес шлюза с /me, ввести свой ключ и увидеть свои лимиты и расход.
Как синхронизировать настройки magpie между компьютерами?
Двумя способами. Разово: magpie backup создаёт резервную копию, зашифрованную парольной фразой, а magpie restore magpie.magpie-backup восстанавливает её на другом компьютере. Постоянно: «Settings → Sync and backup» через WebDAV, S3 или приватный репозиторий GitHub обновляет каждую машину каждые 3 минуты, пока работает шлюз, а сервер хранит только шифртекст; в issue #28 автор написал, что синхронизация через WebDAV появилась в v0.1.76 и что другие компьютеры подключаются с той же парольной фразой. Issue #2269 о синхронизации по состоянию на 2026-11-10 ещё открыт, и автор ответил, что исправление выходит в следующем релизе; см. выше.
magpie по локальной сети или удалённо возвращает 401 — что делать?
Передайте с запросом включённый ключ шлюза. После включения общего доступа по локальной сети (или когда шлюз выставлен в сеть) запросы с других машин должны нести включённый ключ шлюза, иначе получают 401; через loopback ключ не нужен. Создайте ключ для этого коллеги или компьютера командой magpie gateway-key add и укажите его в их инструменте как API-ключ; если magpie работает в Docker, добавьте перед командой docker exec magpie. Точный текст ошибки 401 и другие ошибки — на /magpie-errors-and-fixes.
Если команда делит magpie, получит ли каждый API-ключ?
Каждый получает ключ шлюза. API-ключ вашего провайдера (например, ключ QCode cr_) хранится только на компьютере со шлюзом; ключ шлюза можно в любой момент отключить, перевыпустить или удалить, удаление отзывает удалённый доступ этого ключа, а при перевыпуске сохраняются имя, лимиты и история расхода. Если ключ и квоту по людям нужно разделить и на стороне QCode, см. /claude-code-team-shared-keys: в «Командном тарифе» у каждого участника свой суб-ключ со своей квотой.
Можно ли установить magpie на сервер?
Да. Официальный образ Docker — ghcr.io/yetone/magpie (linux/amd64 и linux/arm64): 3425 — шлюз, 3430 — веб-интерфейс, а переменная окружения MAGPIE_WEB_KEY сохраняет ключ интерфейса после перезапуска; ключ для каждого клиента создаётся в Gateway → Gateway keys в веб-интерфейсе или командой docker exec magpie magpie gateway-key add "Docker client". В контейнере общий доступ по локальной сети включать не нужно, а любой запрос извне контейнера должен нести включённый ключ шлюза. Без контейнера команда magpie daemon install ставит magpie serve фоновой службой (пользовательская служба systemd в Linux, launchd в macOS); в Windows команда magpie autostart on запускает magpie при входе в систему, и он обслуживает шлюз.
Источники
Прочитано 2026-11-10: docs/reference.md в репозитории yetone/magpie на GitHub (разделы о ключах шлюза, Remote magpie, резервном копировании и синхронизации, фоновой службе); страница Docker на usemagpie.ai; ответы автора yetone в issue #28 (закрыт 2026-09-25), #1496 (закрыт 2026-10-12) и #2269 (открыт). QCode: статья о magpie, страница эндпоинтов, кнопка «Импорт в magpie» в консоли, руководство по общим ключам для команды и проверка терминальной версии magpie 2026-11-10. ID моделей — по /models.
Один ключ QCode — у каждого коллеги свой ключ шлюза
Храните ключ QCode в magpie на компьютере со шлюзом и раздайте коллегам их ключи шлюза; один ключ обслуживает интерфейсы, совместимые с Anthropic и OpenAI, оплата по токенам, цены по моделям — на /models.
Читайте также
Разовые пакеты
Разовая квота на 7 дней без подписки; новые пакеты добавляются к тому же ключу
Настройка magpie для Claude Code: локальный шлюз для Claude Code и Codex (2026-11)
Настройка magpie: команды установки и удаления, три способа добавить провайдера, выбор моделей для Claude Code и Codex и три адреса QCode.
Общие ключи Claude Code для команды
Суб-API-ключ на каждого, дневная квота на ключ, расход через qot_, отзыв при уходе и сравнение с местами, Claude Code и ежемесячными кредитами API в Anthropic Team. Проверено 2026-10-27.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Утверждения на этой странице проверены 2026-11-10 по справочнику magpie, странице Docker и связанным issue; приоритет у официальных страниц. Проверенная версия: проверка QCode 2026-11-10 проводилась на magpie 0.1.3533; magpie выпускает релизы несколько раз в день, поэтому названия меню и команды зависят от установленной версии. Доступность моделей QCode — по /models.