Настройка magpie в WSL и установка в Windows: где запускать (ноябрь 2026)
По состоянию на 2026-11-10 в README magpie сказано, что в Windows подключаются и агенты внутри дистрибутивов WSL. Поэтому magpie можно запустить в Windows, а Claude Code и Codex оставить в WSL: каждый из них появится на странице Agents отдельной записью. Файл для Windows — magpie-windows-amd64.exe (для ARM: magpie-windows-arm64.exe), а magpie.exe принимает те же команды, что и на других системах; в официальном справочнике добавлено, что magpie daemon работает внутри WSL так же, как в Linux. Три адреса провайдера QCode одинаковы, где бы ни работал magpie.
Обновлено 2026-11-10
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре факта из официальных источников
Windows: файл приложения и magpie.exe
В релизе на GitHub для Windows опубликованы magpie-windows-amd64.exe (для ARM: magpie-windows-arm64.exe) и терминальная сборка magpie-cli-windows-amd64.exe; на сайте указана Windows 10 или новее. magpie.exe принимает те же команды, что и на других системах.
Агентов в WSL подключает magpie в Windows
В README сказано: в Windows агенты внутри дистрибутивов WSL тоже подключаются, а их сеансы учитываются. Официальная документация по подключению агентов добавляет: каждый найденный агент становится отдельной записью, а его файлы конфигурации редактируются через общий ресурс дистрибутива \\wsl.localhost.
Внутри WSL: daemon и web
В справочнике сказано, что magpie daemon работает внутри WSL так же, как в Linux, если включён systemd ([boot] systemd=true в /etc/wsl.conf), а magpie web — окно приложения в браузере — указан для WSL и серверов, к которым подключаются по SSH.
Адреса QCode не меняются
В руководстве QCode по magpie указаны anthropic https://api.qcode.cc/api, chat https://api.qcode.cc/openai/v1 и responses https://api.qcode.cc/openai. Эти три адреса вводятся одинаково, работает ли magpie в Windows или в WSL.
Что такое magpie и при чём здесь WSL?
По состоянию на 2026-11-10 magpie (репозиторий yetone/magpie на GitHub, лицензия MIT) запускает на вашем компьютере шлюз и позволяет выбирать модель для каждого агента в одном месте; описание репозитория — «Every agent's model. One place.». Согласно README, шлюз работает на 127.0.0.1:3425 с OpenAI Chat, OpenAI Responses, Anthropic Messages и Gemini, а в Windows подключаются и агенты внутри дистрибутивов WSL. Официальная документация по подключению агентов объясняет, как это устроено: magpie один раз просматривает каждый запущенный дистрибутив и не запускает остановленные, находит агента по папке в домашнем каталоге дистрибутива или по его команде там и редактирует его файлы через \\wsl.localhost; адрес и ключ шлюза зависят от сетевого режима дистрибутива — mirrored или NAT. Пока шлюз слушает только loopback, при NAT он также доступен по адресу Windows в сети WSL.
2026-10-27: сопровождающий влил исправление 404 у Codex в WSL
2026-10-27 сопровождающий yetone написал в issue #2198, что исправление влито и выходит в v0.1.1763. Теперь, если в config.toml Codex на стороне Windows не задана резервная модель, magpie ищет в запущенных дистрибутивах, где найден Codex, первый config.toml с model_provider = "magpie" и берёт из него model; остановленные дистрибутивы не открываются. Он также написал, что настоящий Codex в настоящем дистрибутиве не проверялся, и оставил issue открытым, пока кто-нибудь с реальной WSL не подтвердит исправление.
Хронология
Открыт issue #2198: Codex в WSL получает 404 на имя модели, которую magpie не отдаёт.
yetone вливает исправление #2198; issue остаётся открытым до проверки в реальной WSL.
Повторная проверка по GitHub и официальной документации 2026-11-10: #2198, #3333, #3689 и #4453 открыты, #3175 закрыт автором.
Что magpie документирует и что пока не сказано
Что сказано в документации magpie и сопровождающим
① Файлы для Windows: magpie-windows-amd64.exe, magpie-windows-arm64.exe и терминальная сборка magpie-cli-windows-amd64.exe; нужна Windows 10 или новее. ② README: в Windows агенты внутри дистрибутивов WSL тоже подключаются, а их сеансы учитываются. ③ Документация по подключению: каждый агент WSL — отдельная запись, которую редактируют через \\wsl.localhost; при выводе списка остановленный дистрибутив не запускается, но изменение одного из полей записи пишет файлы и тем самым запускает его; если в настройках выключить «Detect agents in WSL», magpie вообще не запускает wsl.exe. ④ Адрес и ключ шлюза зависят от сетевого режима дистрибутива — mirrored или NAT; при NAT шлюз также доступен по адресу Windows в сети WSL, пропустит ли он WSL, решает брандмауэр Windows, а дистрибутиву, который не может подключиться, показывается правило брандмауэра, открывающее доступ. ⑤ Руководство start: собственные настройки, провайдеры и статистику использования magpie хранит в Windows в папке .config\magpie внутри папки пользователя. ⑥ Сопровождающий yetone в #2198 (Codex в WSL, 404): исправление влито; issue остаётся открытым до подтверждения в реальной WSL.
Что официально пока не сказано
По состоянию на 2026-11-10: ① Где устанавливать: пошагового руководства по установке в WSL нет, и не сказано, где лучше запускать magpie — в Windows или в WSL; в install.sh есть ветки для macOS и Linux, а справочник описывает magpie daemon и magpie web внутри WSL. ② WSL1 (#3333, открыт). Наблюдение участника issue: WSL 1 использует сетевой стек Windows, поэтому для Claude Code нужно прописывать 127.0.0.1; он опубликовал патч и отмечает, что не проверял его на реальном дистрибутиве WSL1. Сопровождающий пока не ответил. ③ VS Code, открытый в WSL при NAT (#3689, открыт). Наблюдение участника issue: автор пишет, что в сетевом режиме Mirrored всё работает, а при NAT — нет. Сопровождающий пока не ответил. ④ #3175 рядом с документацией: в #3175 сообщалось, что после wsl --shutdown magpie.exe вызывает wsl.exe примерно каждые 60 секунд; 2026-10-22 автор закрыл его как completed без комментария. В актуальной документации по подключению сказано, что просматриваются только запущенные дистрибутивы, а остановленные не запускаются. Как связаны эти сведения, официально не сказано. ⑤ Claude Desktop по SSH (#4453, открыт): участник пишет, что выбор адреса — продуктовое решение, и оставляет его сопровождающему.
Два места для запуска magpie
magpie в Windows, агенты в WSL
Установите приложение для Windows или терминальную сборку magpie-cli-windows-amd64.exe. Согласно README, агенты внутри запущенных дистрибутивов WSL тоже подключаются и появляются на странице Agents отдельными записями. В Windows magpie не работает как служба; справочник предлагает magpie autostart on — тогда magpie, а вместе с ним и шлюз, открывается при входе в систему.
magpie внутри WSL
Запустите в дистрибутиве официальный установщик: curl -fsSL https://usemagpie.ai/install.sh | sh. В скрипте есть ветка для Linux, а на Linux без рабочего стола он ставит терминальную сборку. После включения systemd команда magpie daemon install держит шлюз постоянно запущенным, а magpie web открывает окно приложения в браузере; справочник описывает оба варианта внутри WSL.
Как настроить magpie с WSL и QCode
① В Windows скачайте magpie-windows-amd64.exe (для ARM: magpie-windows-arm64.exe) с usemagpie.ai или из GitHub Releases; в справочнике отмечено, что перед первым запуском SmartScreen может запросить подтверждение. ② Добавьте QCode в Providers → Add provider или в терминале: 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 (по состоянию на 2026-11-10 проверено на терминальной сборке magpie 0.1.3533 для Linux: команда добавляет провайдера). Для anthropic указывается корень без /v1; url — это адрес chat, он заканчивается на /v1. ③ Запустите дистрибутив WSL и откройте страницу Agents: magpie показывает Claude Code, Codex и другие агенты из запущенных дистрибутивов, каждый отдельной записью. Выберите qcode/claude-sonnet-5-5 для Claude Code и qcode/gpt-6.1-sol для Codex. ④ Если какого-то агента нет, проверьте, что в настройках включён «Detect agents in WSL»; в документации по подключению сказано, что поиск идёт через sh -l (читается ~/.profile, но не ~/.bashrc), а команды ищутся и там, где их держат nvm, fnm и volta, а также pnpm, bun и ~/.local/bin. ⑤ Если при NAT дистрибутив не достаёт до шлюза, разрешите доступ правилом брандмауэра, которое показывает magpie. ⑥ Чтобы запустить magpie внутри WSL, выполните в дистрибутиве curl -fsSL https://usemagpie.ai/install.sh | sh, включите systemd ([boot] systemd=true в /etc/wsl.conf), затем выполните magpie daemon install. ⑦ Без magpie задайте в оболочке WSL ANTHROPIC_BASE_URL=https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN=cr_xxx, как на странице переменных окружения QCode.
QCode с magpie в Windows или WSL
По состоянию на 2026-11-10 один API-ключ QCode обслуживает интерфейсы, совместимые и с Anthropic, и с OpenAI, а в руководстве QCode по magpie указаны три адреса: anthropic https://api.qcode.cc/api (корень, без /v1), chat https://api.qcode.cc/openai/v1 и responses https://api.qcode.cc/openai. Они одинаковы, работает ли magpie в Windows или внутри WSL. Claude идёт только через /api, GPT — через два адреса OpenAI, а китайские модели работают и через chat, и через anthropic. Оплата по токенам, цены по моделям — на /models. Три шага: ① зарегистрируйтесь и пополните баланс (Alipay и другие популярные способы оплаты); ② купите личный тариф или «Разовые пакеты» и скопируйте API-ключ с префиксом cr_; ③ добавьте QCode в magpie по инструкции https://docs.qcode.cc/ru/docs/ide/magpie. Не хотите месячный тариф? «Разовые пакеты» начинаются с $4: разовый объём, который нужно израсходовать за 7 дней. Если у вас уже есть личный тариф и квоты не хватает, докупите бустер-пакет.
Частые вопросы
Работает ли magpie с WSL?
Да. По состоянию на 2026-11-10 в README сказано, что в Windows агенты внутри дистрибутивов WSL тоже подключаются, а их сеансы учитываются. magpie просматривает только запущенные дистрибутивы и при выводе списка никогда не запускает остановленные; если в настройках выключить «Detect agents in WSL», magpie вообще не запускает wsl.exe. В справочнике также описано, как использовать magpie daemon и magpie web внутри WSL.
Codex в WSL выдаёт 404 на имя модели — что делать?
Сопровождающий yetone написал в issue #2198, что исправление влито и выходит в v0.1.1763, поэтому сначала убедитесь, что magpie в Windows этой версии или новее. В #2198 описан случай, когда Codex, подключённый внутри дистрибутива WSL, запрашивает модель, которую magpie не отдаёт, и получает 404. После исправления, если Codex на стороне Windows не задаёт резервную модель, magpie читает первый запущенный дистрибутив, в config.toml которого есть model_provider = "magpie", и берёт его model. Issue по-прежнему открыт (переоткрыт): yetone написал, что настоящий Codex в настоящем дистрибутиве не проверялся, и issue ждёт подтверждения от кого-нибудь с реальной WSL.
Почему дистрибутив WSL снова запускается после wsl --shutdown?
Чтобы magpie вообще не запускал wsl.exe, в официальной документации есть переключатель «Detect agents in WSL» в настройках: если его выключить, magpie перестаёт и искать агентов в WSL. Само поведение описано в issue #3175: 2026-10-21 автор написал, что после wsl --shutdown magpie.exe вызывал wsl.exe примерно каждые 60 секунд и дистрибутив возвращался в состояние Running, и попросил добавить переключатель или снизить частоту; 2026-10-22 он сам закрыл issue как completed без комментария. В актуальной документации по подключению сказано, что каждый запущенный дистрибутив просматривается один раз, а остановленный не запускается. Как связаны эти сведения, официально не сказано.
VS Code, открытый в WSL, не работает с magpie (ECONNREFUSED 127.0.0.1:3425)?
Это issue #3689: по состоянию на 2026-11-10 он открыт, ответа сопровождающего и официальной инструкции пока нет. Наблюдения участника issue: у автора в VS Code адрес модели Copilot был 127.0.0.1:3425, и сервер VS Code внутри WSL выдавал connect ECONNREFUSED 127.0.0.1:3425; позже он написал, что в сетевом режиме Mirrored всё работает, а при NAT — нет, и что с включённым общим доступом magpie в локальной сети, IP-адресом хоста Windows и ключом шлюза, вручную указанными в VS Code, всё работало, но кнопка переподключения в панели Agents возвращала прежние настройки VS Code. Про NAT в официальной документации сказано, что подключённые magpie агенты WSL используют адрес Windows в сети WSL, а пропускать ли их, решает брандмауэр Windows.
Какой адрес использует Claude Code в WSL1?
По состоянию на 2026-11-10 официальная документация описывает адреса для сетевых режимов mirrored, NAT и bridged, а WSL1 обсуждается в issue #3333 (открыт); сопровождающий пока не ответил. У автора в WSL1 curl http://127.0.0.1:3425/v1/models проходит, но magpie записал в ANTHROPIC_BASE_URL для Claude Code адрес, не относящийся к loopback. Наблюдение участника issue: WSL 1 использует сетевой стек Windows, поэтому адрес должен быть 127.0.0.1; он опубликовал патч и отмечает, что не проверял его на реальном дистрибутиве WSL1.
Можно ли подключить QCode к magpie, установленному в WSL?
Да. Добавьте QCode как провайдера с тремя адресами из руководства QCode по magpie: anthropic https://api.qcode.cc/api, chat https://api.qcode.cc/openai/v1 и responses https://api.qcode.cc/openai; Claude идёт только через /api. Адреса одинаковы, работает ли magpie в Windows или внутри WSL. Без magpie: на странице переменных окружения QCode https://docs.qcode.cc/ru/docs/getting-started/environment описаны ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN для Claude Code.
Источники
README magpie, справочник, install.sh, документация о подключении агентов и маршрутизации шлюза, страницы usemagpie.ai (главная, docs/start, docs/remote, docs/docker), GitHub Releases API и issue #2198, #3175, #3333, #3689 и #4453 с комментариями в репозитории yetone/magpie (ветка main) — всё прочитано 2026-11-10. QCode: страницы magpie и переменных окружения на docs.qcode.cc, qcode.cc/models, /pay-as-you-go и /pricing, получены 2026-11-10.
Подключите QCode к magpie в Windows или WSL
Один API-ключ QCode для Claude Code, Codex и других инструментов, оплата по токенам; цены по моделям — на /models.
Похожие материалы
Разовые пакеты
Разовый объём на 7 дней без подписки; цены по моделям — на /models.
Настройка magpie для Claude Code: локальный шлюз для Claude Code и Codex (2026-11)
Настройка magpie: команды установки и удаления, три способа добавить провайдера, выбор моделей для Claude Code и Codex и три адреса QCode.
magpie не работает: ошибки 401 и 405 и их решение (2026-11)
Официальная причина и решение частых ошибок magpie: переключение не применяется, 401 в Docker, 405 от ZCode, 400 в provider test и пропавшие модели.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Сведения на этой странице проверены 2026-11-10 по репозиторию и сайту magpie; приоритет у официальных страниц. magpie выпускает несколько сборок в день, поэтому названия меню и поведение соответствуют установленной версии, а открытые issue могут измениться. Актуальный список моделей QCode — на /models.