magpie не работает? Ошибки 401 и 405: причины и решение (ноябрь 2026)
По состоянию на 2026-11-10 официальная документация magpie, заметки к релизам и issue в репозитории называют причину и решение для каждой из этих частых ошибок. Если после переключения агент по-прежнему использует старую модель, значит, запущенная сессия работает с моделью, с которой стартовала: откройте новую сессию (для Codex также перезапустите приложение Codex). Ошибка 401 в Docker или в локальной сети означает, что запрос пришёл без действующего ключа шлюза: создайте ключ командой magpie gateway-key add. По поводу 405 от ZCode автор ответил в issue #425, что magpie не переписывает ваши промпты и не выдаёт себя за официальный клиент. С QCode ошибка 400 в строках chat и responses в provider test — ожидаемое поведение, а если видны только первые 24 модели, выберите нужные командой magpie provider models.
Обновлено 2026-11-10
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре самые частые ошибки
После переключения откройте новую сессию
Ответ из официального FAQ: запущенная сессия продолжает работать с тем, с чем стартовала, поэтому откройте новую; для Codex также перезапустите приложение Codex.
Запросу нужен ключ шлюза
Документация magpie по Docker: на запрос с хоста или с другой машины шлюз отвечает только при действующем ключе шлюза, без ключа приходит 401. Ключ создаётся командой magpie gateway-key add с именем (если magpie работает в Docker, перед ней добавьте docker exec magpie).
ZCode: принцип автора
Issue #425 закрыт (not planned). Принцип автора: magpie не переписывает ваши промпты и не выдаёт себя за официальный клиент. Начиная с v0.1.590 это сообщение об ошибке поясняет, что ZCode принимает запросы только от собственного приложения, и предлагает добавить в группу другого провайдера.
400 в provider test — это нормально
Документация QCode: если первая модель в models — Claude, строки chat и responses показывают 400, потому что Claude обслуживается только на эндпоинте Anthropic Messages; галочка в строке anthropic означает, что Claude работает.
Откуда берутся ошибки magpie?
По состоянию на 2026-11-10 большинство ошибок magpie возникает в одном из трёх мест: в сессии агента, в локальном шлюзе или в модельном эндпоинте за ним. magpie запускает шлюз на вашем компьютере по адресу 127.0.0.1:3425 и для поддерживаемых агентов записывает адрес и токен шлюза в собственный конфигурационный файл агента. Агент читает конфигурацию при запуске, поэтому переключение действует только для сессий, начатых после него; если шлюз не запущен, агент не может подключиться; а когда шлюз работает в Docker или открыт для локальной сети, запросам извне контейнера и с других машин нужен действующий ключ шлюза. Ниже ошибки разобраны по тексту и симптому, с причиной и командой из официальной документации magpie, заметок к релизам и issue в репозитории. Диагностику начните с трёх команд: magpie healthcheck, затем magpie provider test с ID провайдера и magpie log. Настройка для WSL описана в /magpie-wsl-windows-setup.
2026-11-10: в v0.1.3518 исправлена отправка текста не в UTF-8
Согласно официальным заметкам к релизу, в v0.1.3518, вышедшей 2026-11-10, исправлена ошибка: текст не в кодировке UTF-8 в теле запроса уходил провайдеру как символ замены � (U+FFFD). Если модель получала отправленный вами текст не в UTF-8 как �, убедитесь, что magpie обновлён до этой версии или новее; установленный magpie обновляется сам.
Хронология
Issue #425 (ZCode возвращает 405) закрыт с ответом автора; в версии, вышедшей в тот же день, текст ошибки изменён.
Автор отвечает в X на жалобу о запутанном списке моделей: создайте группу маршрутизации и выбирайте в агенте только её.
Проверены официальные README, docs/start, docs/docker, reference и issue #425 и #4453; в тот же день вышла версия с исправлением для текста не в UTF-8.
Что официальные источники решают, а что пока оставляют открытым
Задокументировано в magpie
① Запущенная сессия работает с моделью, с которой стартовала; откройте новую, а для Codex также перезапустите приложение Codex. ② Когда модель используется через magpie, шлюз работает вместе с приложением; после закрытия окна он остаётся в строке меню или в трее, magpie serve запускает только шлюз, а magpie daemon install оставляет его работать как службу; magpie healthcheck завершается с кодом 0, пока шлюз отвечает. ③ На loopback подходит любой токен; когда шлюз открыт в сеть (0.0.0.0 в Docker, открытие для локальной сети), удалённым запросам нужен действующий ключ шлюза, иначе 401, причём дистрибутив WSL за NAT тоже считается удалённым. ④ Текст ошибки 401 в Docker приведён во втором вопросе FAQ ниже; решение — создать ключ шлюза и указать его в настройках агента. ⑤ Страница в браузере, открытая без ключа, отклоняется (401); открывайте ссылку из лога, а с переменной MAGPIE_WEB_KEY ключ сохраняется после перезапусков. ⑥ Если задана MAGPIE_ALLOW_IPS, запрос с любого другого адреса отклоняется с 403 ещё до проверки ключа. ⑦ magpie provider test с ID провайдера отправляет по одному крошечному запросу на каждый API и показывает задержку. ⑧ magpie log показывает, где лежат логи, а magpie log -f следит за ними в реальном времени.
Что официальные источники пока оставляют открытым
По состоянию на 2026-11-10: ① Issue #4453 всё ещё открыт: в SSH-сессии Claude Desktop отклоняет loopback-адрес шлюза 127.0.0.1:3425, который magpie для него записывает, и сообщает, что удалённые сессии с этим шлюзом недоступны. На момент проверки автор репозитория ещё не ответил, поэтому ориентируйтесь на будущий официальный ответ. ② Формулировки ошибок меняются от версии к версии — например, сообщение для ZCode уже переписывали, — поэтому ошибки здесь разобраны по смыслу, а точный текст в вашей версии может отличаться. ③ magpie выпускает несколько релизов в день; в какой версии исправлена ваша проблема, смотрите в GitHub Releases.
Один и тот же 401 в двух ситуациях
Локальный loopback
Официальный reference: для запросов через loopback проверка мягкая — подходит любой токен, даже устаревший или отключённый ключ шлюза; агенты по умолчанию подключаются к 127.0.0.1:3425.
Docker или локальная сеть
Когда шлюз открыт в сеть, удалённым запросам нужен действующий ключ шлюза, переданный как Bearer, x-api-key, x-goog-api-key или ?key=, иначе 401. Удалёнными считаются и запросы через проброс портов Docker (даже запросы самого хоста идут через мост), и дистрибутив WSL за NAT.
Проверяйте magpie в таком порядке
① Сначала проверьте версию: magpie выпускает несколько релизов в день, и проверка для этой страницы 2026-11-10 проводилась на 0.1.3533; установленный magpie обновляется сам, либо запустите заново официальный установщик curl -fsSL https://usemagpie.ai/install.sh | sh. ② Запустите magpie healthcheck: код выхода 0 означает, что шлюз отвечает. Если шлюз не запущен, команда выводит no gateway at http://127.0.0.1:3425 (проверено QCode 2026-11-10); тогда откройте приложение или запустите только шлюз командой magpie serve. ③ Запустите magpie provider test с ID провайдера (если вы добавили QCode по его документации, ID — qcode): команда отправляет по одному крошечному запросу на каждый API, и видно, какая строка падает. ④ Командой magpie log -n 200 выведите последние строки лога, а обращаясь за помощью, приложите путь, который показывает magpie log. ⑤ Если переключение не сработало, откройте новую сессию, а для Codex перезапустите приложение Codex. ⑥ При 401 в Docker или в локальной сети создайте ключ в Gateway → Gateway keys или командой magpie gateway-key add с именем (в Docker перед ней добавьте docker exec magpie). ⑦ Про WSL — в /magpie-wsl-windows-setup.
Два нормальных результата в QCode
По состоянию на 2026-11-10 документация QCode описывает два нормальных результата. ① Если первая модель в models — Claude, то при проверке qcode командой magpie provider test строки chat и responses показывают ✗ 400 с сообщением, что модель недоступна на этом эндпоинте: Claude обслуживается только на эндпоинте Anthropic Messages, так что галочка в строке anthropic означает, что Claude работает; чтобы проверить GPT, запустите magpie codex qcode/gpt-6.1-sol и отправьте реальный запрос. ② Если при добавлении провайдера не указан models=, magpie открывает только первые 24 модели списка; нужные выберите командой magpie provider models, указав ID провайдера qcode и ID моделей, а список моделей в продаже есть на https://qcode.cc/models. Один ключ QCode работает и с Anthropic-совместимым, и с OpenAI-совместимым интерфейсом: в поля anthropic, chat и responses в magpie впишите https://api.qcode.cc/api, https://api.qcode.cc/openai/v1 и https://api.qcode.cc/openai. Оплата — по токенам, цены по моделям — на /models. Три шага: зарегистрируйтесь, пополните баланс, скопируйте ключ (он начинается с cr_) и добавьте его по странице magpie на docs.qcode.cc. Хотите сначала попробовать несколько дней? «Разовые пакеты» начинаются с $4: разовый объём, который нужно израсходовать за 7 дней; подробнее — на /pay-as-you-go.
Частые вопросы
Я переключил модель, а агент всё ещё использует старую. Почему?
Как сказано в официальном FAQ, запущенная сессия продолжает работать с моделью, с которой стартовала. Откройте новую сессию, а для Codex также перезапустите приложение Codex. Агенты читают конфигурацию при запуске, поэтому изменение применяется к следующей сессии. Чтобы вернуть агента в исходное состояние, выберите в списке одну из его собственных моделей или выполните magpie с именем агента и default, например magpie claude default.
Ошибка 401: the API key sent is not an enabled magpie gateway key
Это текст ошибки 401 из документации magpie по Docker: ключ, который агент отправил извне контейнера, не является действующим ключом шлюза (когда шлюз открыт для локальной сети, запросам с других машин ключ шлюза тоже нужен). Документация называет типичный случай: после обновления со старого образа агент вне контейнера всё ещё отправляет magpie или другой ключ, который не является ключом шлюза. Решение: создайте ключ в Gateway → Gateway keys или командой magpie gateway-key add с именем (в Docker перед ней добавьте docker exec magpie) — она выведет новый sk-magpie-key-…, — и укажите его в агенте как API-ключ. На локальном loopback подходит любой токен.
ZCode: 405 Method Not Allowed — что делать?
Заголовок issue #425 начинается с ZCode provider returns 405 Method Not Allowed, а сам issue закрыт (not planned). В ответе от 2026-10-01 автор изложил принцип: magpie не переписывает ваши промпты и не выдаёт себя за официальный клиент. Начиная с v0.1.590 это сообщение об ошибке поясняет, что ZCode принимает запросы только от собственного приложения, и предлагает добавить в группу другого провайдера. Если вы последуете этому совету и добавите провайдера, который работает по API-ключу, у QCode есть модели GLM (например, glm-5.3) и через интерфейс Anthropic, и через OpenAI Chat; список моделей — на /models.
В provider test строки chat и responses показывают 400. Я ошибся в настройке?
Нет, если в строке anthropic стоит галочка. QCode обслуживает модели Claude только на эндпоинте Anthropic Messages; когда первая модель в models — Claude, тест отправляет её и в chat, и в responses и по задумке получает 400 с текстом Model 'claude-opus-5-5' is not available on this endpoint. Чтобы галочки стояли во всех трёх строках, при перечислении моделей командой magpie provider models поставьте первой модель GPT, например gpt-6.1-terra (так проверено QCode 2026-11-10); GPT можно проверить и иначе: запустите magpie codex qcode/gpt-6.1-sol и отправьте реальный запрос.
Почему в magpie видны только некоторые модели и что делать, если список моделей слишком запутанный?
По проверке QCode, если при добавлении провайдера не указан models=, magpie открывает только первые 24 модели. Если после magpie provider models указать ID провайдера и ID моделей, весь список заменяется вашим; чтобы открыть всего одну модель дополнительно, в reference используется запись +ID модели (а -ID модели убирает одну), остальные остаются как есть. Если список запутан, автор 2026-11-05 ответил в X: создайте группу маршрутизации и выбирайте в агенте только её; в reference также описан переключатель Only through routing groups у провайдера, который оставляет весь провайдер только для групп маршрутизации.
Агент получает 502 или не может подключиться, а во вкладке Routing в magpie пусто?
Причина по официальному FAQ: прокси-приложение (Surge, Clash, mihomo и подобные с включённым системным прокси, режимом TUN или расширенным режимом) перехватило запрос агента к http://127.0.0.1:3425 и отправило его в другое место, поэтому до magpie он вообще не доходит. Официальное решение: перед остальными правилами добавьте два правила, которые пускают локальные адреса напрямую, — IP-CIDR,127.0.0.0/8,DIRECT,no-resolve и IP-CIDR6,::1/128,DIRECT,no-resolve, — а затем пусть агент отправит новый запрос.
Источники
README magpie, docs/start и docs/docker на usemagpie.ai (включая китайские версии), docs/reference.md в репозитории, GitHub Releases для упомянутых версий, issue #425 и #4453 с комментариями и архив X-поста автора от 2026-11-05 — всё прочитано 2026-11-10. QCode: qcode.cc/models, qcode.cc/pay-as-you-go, страница magpie на docs.qcode.cc и записи собственной проверки QCode от 2026-11-10.
Подключите magpie с ключом QCode
Один ключ QCode для полей anthropic, chat и responses в magpie: интерфейсы, совместимые с Anthropic и OpenAI, оплата по токенам, цены по моделям — на /models.
Похожие материалы
Разовые пакеты
Разовый объём на 7 дней без подписки; цены по моделям — на /models.
Настройка magpie для Claude Code: локальный шлюз для Claude Code и Codex (2026-11)
Настройка magpie: команды установки и удаления, три способа добавить провайдера, выбор моделей для Claude Code и Codex и три адреса QCode.
Настройка magpie в WSL и magpie на Windows (2026-11)
Где установить magpie с WSL: приложение для Windows и magpie.exe, агенты в дистрибутивах WSL, статус issue по WSL и три адреса QCode.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Сведения на этой странице проверены 2026-11-10 по официальной документации, заметкам к релизам и issue в репозитории magpie; приоритет у официальных страниц. Тексты ошибок и названия меню меняются от версии к версии, поэтому ориентируйтесь на установленную у вас версию. Актуальный список моделей QCode — на /models.