Официальные формулировки · по состоянию на 2026-11-10

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 и китайских моделей.

#magpie не работает#magpie 401#ZCode 405#provider test 400

Четыре самые частые ошибки

Новая сессия

После переключения откройте новую сессию

Ответ из официального FAQ: запущенная сессия продолжает работать с тем, с чем стартовала, поэтому откройте новую; для Codex также перезапустите приложение Codex.

401

Запросу нужен ключ шлюза

Документация magpie по Docker: на запрос с хоста или с другой машины шлюз отвечает только при действующем ключе шлюза, без ключа приходит 401. Ключ создаётся командой magpie gateway-key add с именем (если magpie работает в Docker, перед ней добавьте docker exec magpie).

405

ZCode: принцип автора

Issue #425 закрыт (not planned). Принцип автора: magpie не переписывает ваши промпты и не выдаёт себя за официальный клиент. Начиная с v0.1.590 это сообщение об ошибке поясняет, что ZCode принимает запросы только от собственного приложения, и предлагает добавить в группу другого провайдера.

400

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 обновляется сам.

Хронология

2026-10-01

Issue #425 (ZCode возвращает 405) закрыт с ответом автора; в версии, вышедшей в тот же день, текст ошибки изменён.

2026-11-05

Автор отвечает в X на жалобу о запутанном списке моделей: создайте группу маршрутизации и выбирайте в агенте только её.

2026-11-10

Проверены официальные 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.

Похожие материалы

Оплата криптовалютой

Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.

Сведения на этой странице проверены 2026-11-10 по официальной документации, заметкам к релизам и issue в репозитории magpie; приоритет у официальных страниц. Тексты ошибок и названия меню меняются от версии к версии, поэтому ориентируйтесь на установленную у вас версию. Актуальный список моделей QCode — на /models.

Не знаете, с чего начать?

Попробовать неделю

Пакет «Малый» — $4: квота $30 на 7 дней

Работаете каждый день

«Стартовый» — $9.00 в месяц и $5 квоты каждый день: всего $0.060 за $1 квоты, у пакета «Средний» — около $0.113