Настройка magpie для Claude Code: установите локальный шлюз и выберите модели (ноябрь 2026)
По состоянию на 2026-11-10 официальная документация magpie (usemagpie.ai) описывает подключение Claude Code в три шага: выполните команду установки и запустите magpie; добавьте провайдера в разделе Providers со своим API-ключом; затем выполните magpie claude с именем вида провайдер/модель — новая модель применяется со следующей сессии (для Codex — magpie codex и перезапуск приложения Codex). magpie (yetone/magpie) — локальный шлюз на вашем компьютере по адресу 127.0.0.1:3425, который переводит запросы между четырьмя API: OpenAI Chat и Responses, Anthropic Messages и Gemini. Он распространяется под лицензией MIT и не связан с Apache Magpie. Три адреса QCode и команды — ниже.
Обновлено 2026-11-10
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре факта из официальных источников
Открытый код под лицензией MIT, автор yetone
Репозиторий yetone/magpie использует лицензию MIT (Copyright (c) 2026 yetone). В конце README сказано: magpie не связан с Apache Magpie и с Apache Software Foundation.
Адрес локального шлюза
Шлюз работает с четырьмя API — OpenAI Chat и Responses, Anthropic Messages и Gemini — и переводит запросы между ними, включая потоковую выдачу, вызовы инструментов и рассуждения.
Платформы и варианты
В README сказано, что он работает на macOS, Windows и Linux (приложение в строке меню, окно, TUI, веб-интерфейс и CLI), в Docker и в Termux.
Где хранятся ключи
Ключи хранятся в ~/.config/magpie/providers.json и доступны только вам. magpie никогда не читает ключи из переменных окружения оболочки: используется ровно то, что вы добавили.
Что такое magpie?
По состоянию на 2026-11-10 документация magpie описывает его как единое место, где вы выбираете модель для каждого из своих агентов. Вы добавляете провайдеров, которые у вас есть, выбираете модель для каждого агента, и magpie записывает её в собственный конфигурационный файл этого агента. За этим стоит небольшой шлюз на вашем компьютере по адресу 127.0.0.1:3425: он работает с API OpenAI, Anthropic и Gemini и переводит запросы между ними, поэтому агент, понимающий только Anthropic Messages, например Claude Code, тоже может использовать GPT или китайские модели. Автор — yetone, сайт — usemagpie.ai, репозиторий — yetone/magpie.
Команды установки и удаления
По состоянию на 2026-11-10 официальная команда установки — curl -fsSL https://usemagpie.ai/install.sh | sh. Она кладёт команду magpie в ~/.local/bin, а приложение — в /Applications на Mac или в меню приложений Linux; подойдёт и go install github.com/yetone/magpie@latest. В Windows скачайте из последнего релиза magpie-windows-amd64.exe (для ARM — magpie-windows-arm64.exe); magpie.exe принимает те же команды, а magpie-cli-windows-amd64.exe — сборка только для терминала. Есть и Docker-образ ghcr.io/yetone/magpie — см. официальную документацию по Docker. Для удаления выполните curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall: magpie сначала отключает каждого агента и возвращает его прежние настройки; ваши настройки и провайдеры в ~/.config/magpie остаются, а --purge удаляет и их.
Хронология
Репозиторий yetone/magpie создан на GitHub.
Документация QCode завершила проверку magpie с Claude Code и Codex и опубликовала статью о настройке magpie на docs.qcode.cc.
QCode заново проверил подключение на терминальной сборке magpie того же дня: QCode добавился одной командой magpie provider add, а provider test получил ответ по всем трём адресам. В тот же день сверены README, официальная документация (разделы Get started и Add to magpie, страница Docker, страницы моделей Claude Code и Codex), справочник и релизы на GitHub; по документации, magpie выходит несколько раз в день.
Что написано в документации и что остаётся открытым
Указано в официальной документации
① Когда модель работает через magpie, шлюз запущен вместе с приложением. ② Запущенная сессия остаётся на модели, с которой стартовала: агенты читают конфигурацию при запуске, поэтому новая модель применяется со следующей сессии, а Codex нужно ещё и перезапустить. ③ Выбор модели меняет в конфигурации агента только те ключи, которые нужны magpie; комментарии, порядок и отступы сохраняются, запись атомарна. ④ Claude Code: magpie записывает ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в ~/.claude/settings.json, причём токен — это ключ шлюза, а не ваш ключ провайдера; Codex: таблица [model_providers.magpie] и модель в ~/.codex/config.toml. ⑤ Самостоятельно экспортировать OPENAI_BASE_URL или ANTHROPIC_BASE_URL не нужно. ⑥ Ссылка импорта ничего не сохраняет, пока вы не нажмёте Add, а если такой id уже занят, кнопка называется Replace. ⑦ Модели magpie появляются и в списках /model самих Claude Code и Codex (в Claude Code — с пометкой via magpie), так что переключаться можно прямо в агенте.
Что в документации остаётся открытым
По состоянию на 2026-11-10: ① Официальная главная страница указывает минимальную версию macOS двумя способами (macOS 12+ и macOS 11 or later), поэтому ориентируйтесь на требование, показанное при загрузке. ② Список поддерживаемых агентов в README длиннее, чем в Get started, и продолжает расти; распознаётся ли ваш агент, покажет вывод magpie ls. ③ Официальная страница import сообщает, что без параметра models magpie показывает модели, которые возвращает /v1/models провайдера; в проверке QCode 2026-11-10 провайдер, добавленный без models=, открыл только первые 24 модели (вывод: 24 exposed of 28), поэтому после добавления выберите нужные модели командой magpie provider models.
Три способа добавить провайдера
Ссылка импорта или приложение
Ссылка импорта — это magpie://import? с параметрами; в браузере используйте https://usemagpie.ai/import# с теми же параметрами, каждое значение кодируется для URL. Параметры: name или preset, адреса chat, responses, anthropic и gemini, а также key и models. Если key в ссылке нет, вы вставляете ключ в диалоге. В приложении это Providers → Add provider.
Одна команда в терминале
Для пресета достаточно magpie provider add с id пресета и ключом (официальный пример — deepseek и sk-…); для своего адреса — url= (совместимый с OpenAI), anthropic= (совместимый с Anthropic), responses=, models= и key=. В терминале magpie import со ссылкой сначала показывает сводку и спрашивает подтверждение, -y пропускает вопрос; по проверке в документации QCode ссылка без ключа в терминале только показывается и не сохраняется, поэтому в терминале быстрее сразу выполнить magpie provider add.
Настройка magpie: установка, добавление провайдера, выбор модели для Claude Code и Codex
① Установка: в macOS и Linux выполните curl -fsSL https://usemagpie.ai/install.sh | sh, в Windows скачайте magpie-windows-amd64.exe; затем запустите magpie, чтобы заработал шлюз. ② Провайдер: на вкладке Providers нажмите ＋ Add provider и для пресета просто вставьте ключ, а для любого другого адреса выберите Custom · any compatible URL; как сделать это в терминале, показано в карточке выше, а полная команда для QCode — ниже. ③ Модель: на вкладке Agents нажмите на модель агента или выполните magpie claude deepseek/deepseek-v4-pro либо magpie codex deepseek/deepseek-v4-pro; модели через magpie называются в формате провайдер/модель. ④ Начните новую сессию, чтобы агент прочитал новую конфигурацию; Codex нужно ещё и перезапустить. ⑤ Проверка: magpie ls выводит текущие настройки каждого агента, а magpie provider test с id провайдера отправляет по одному крошечному запросу на каждый API и показывает задержку. ⑥ Вернуть агенту его собственную настройку: magpie claude default или magpie codex default.
Добавление QCode в magpie
По состоянию на 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 адрес responses оканчивается на /v1; на странице эндпоинтов QCode указано, что /openai/responses и /openai/v1/responses эквивалентны). Claude идёт через адрес anthropic, GPT — через chat и responses, китайские модели — через anthropic или chat; для точек доступа в Азии и Северной Америке замените домен на asia.qcode.cc или us.qcode.cc, пути не меняются. Проще всего кнопка в консоли «Импорт в CC Switch / magpie»: нажмите в ней «Импорт в magpie», и Claude с GPT настроятся за один раз; затем выберите модели командой magpie claude qcode/claude-sonnet-5-5 или magpie codex qcode/gpt-6.1-sol. Если задать только основную модель, слот opus в Claude Code получит ту же модель; чтобы там был Opus, выполните ещё magpie claude opus qcode/claude-opus-5-5. Ключ QCode не зависит от протокола: один ключ работает и с Anthropic-, и с OpenAI-совместимым интерфейсом в Claude Code, Codex и других инструментах; оплата по токенам, цены по моделям — на /models. Не хотите месячный тариф? «Разовые пакеты» начинаются с $4: разовый объём, который нужно израсходовать за 7 дней. Если у вас уже есть личный тариф и квоты не хватает, докупите бустер-пакет.
Частые вопросы
Почему после переключения в magpie ничего не меняется?
Скорее всего, сессия не перезапущена: запущенная сессия остаётся на модели, с которой стартовала, новая модель применяется со следующей сессии, а Codex нужно ещё и перезапустить. Затем убедитесь, что шлюз запущен: при работе через magpie шлюз работает вместе с приложением, и magpie healthcheck завершается с кодом 0, пока шлюз отвечает. magpie ls показывает текущие настройки каждого агента, а magpie provider test проверяет, отвечает ли провайдер; другие ошибки разобраны на /magpie-errors-and-fixes.
Нужно ли держать magpie постоянно открытым?
Если модель работает через magpie, то да: шлюз запущен вместе с приложением. После закрытия окна он продолжает работать в строке меню или в трее; magpie tray запускает только значок, magpie serve — только шлюз, а magpie daemon install оставляет его работать как сервис (systemd в Linux, launchd на Mac). Агент на собственной модели работает без magpie.
Где magpie хранит мой ключ и безопасно ли это?
Ключи хранятся в ~/.config/magpie/providers.json и доступны для чтения только вам, а из переменных окружения оболочки magpie ключи не читает. По документации агенты ваших ключей не видят: ANTHROPIC_AUTH_TOKEN в конфигурации Claude Code — это ключ шлюза. Веб-ссылка импорта держит параметры после #, а эту часть браузеры на сервер не отправляют. Есть и маскировка приватности: если её включить, ключи, пароли и адреса электронной почты в промпте заменяются плейсхолдерами на вашем компьютере ещё до отправки запроса и возвращаются в ответе; по умолчанию она выключена и включается в Settings → Privacy.
Как удалить magpie или восстановить исходную конфигурацию?
Чтобы восстановить: выполните magpie claude default или magpie codex default; magpie удаляет записанное им и восстанавливает заменённые значения, например прежний ANTHROPIC_BASE_URL. Чтобы удалить установку через скрипт, выполните curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall; ваши настройки и провайдеры остаются в ~/.config/magpie, а --purge удаляет и их.
Можно ли использовать magpie и CC Switch вместе?
Да, их можно установить одновременно: автор magpie yetone 2026-11-09 ответил в X, что пользоваться обоими вместе можно, а в README сказано, что Import в magpie переносит провайдеров из CC Switch. Оба инструмента изменяют конфигурационные файлы Claude Code и Codex; как они делят работу и на какие настройки смотреть при совместном использовании — на странице сравнения /magpie-vs-cc-switch.
Как добавить QCode в magpie?
Подойдёт любой из трёх способов. Быстрее всего кнопка в консоли «Импорт в magpie»; в терминале выполните magpie provider add QCode anthropic=https://api.qcode.cc/api url=https://api.qcode.cc/openai/v1 responses=https://api.qcode.cc/openai key=cr_xxx — в проверке QCode 2026-11-10 эта команда добавила провайдера с первого раза; в приложении выберите Custom в Providers → Add provider и укажите OpenAI-совместимый адрес (chat), Anthropic-совместимый адрес (anthropic) и свой ключ с префиксом cr_. Без models= magpie открывает только первые 24 модели, поэтому выберите нужные командой magpie provider models qcode gpt-6.1-sol claude-sonnet-5-5 claude-opus-5-5 claude-haiku-5-5 (без + список заменяется целиком); magpie provider test показывает ✓ во всех трёх строках (chat, responses и anthropic), если первой в списке стоит модель GPT. Чтобы заменить ключ сохранённого провайдера QCode, выполните magpie provider key с qcode и новым ключом.
Источники
README, LICENSE и справочник репозитория yetone/magpie на GitHub, GitHub API, сведения о релизах magpie-releases, главная страница usemagpie.ai, разделы официальной документации Get started и Add to magpie, страница Docker и страницы моделей Claude Code и Codex — всё прочитано 2026-11-10; ответ автора magpie yetone в X от 2026-11-09. QCode: статья о magpie и страница точек доступа на docs.qcode.cc, qcode.cc/models и qcode.cc/pay-as-you-go (получено 2026-11-10), а также проверка QCode на терминальной сборке magpie 2026-11-10; надписи кнопки импорта в консоли взяты из текстов сайта QCode.
Claude и GPT в magpie с одним ключом
Один API-ключ QCode для Claude Code, Codex и других инструментов, оплата по токенам; цены по моделям — на /models.
Похожие материалы
Разовые пакеты
Разовый объём на 7 дней без подписки; цены по моделям — на /models.
magpie или CC Switch: что выбрать
Чем два инструмента отличаются по работе, клиентам, преобразованию протоколов, переключению при сбое, маскировке приватности и лицензии, и как каждый подключается к QCode.
magpie не работает: ошибки 401 и 405 и их решение (2026-11)
Официальная причина и решение частых ошибок magpie: переключение не применяется, 401 в Docker, 405 от ZCode, 400 в provider test и пропавшие модели.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Утверждения на этой странице сверены 2026-11-10 с репозиторием, сайтом и документацией magpie; приоритет у официальных страниц. Проверенная версия: проверка QCode 2026-11-10 проводилась на magpie 0.1.3533; magpie выходит несколько раз в день, поэтому названия меню и команды зависят от установленной версии. Актуальный список моделей QCode — на /models.