Гайды

Qwen Code не работает: причины и решения

9 октября 2026 · 12 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 9 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.

Qwen Code не работает чаще всего по одной из четырёх причин: отменён бесплатный вход через Qwen OAuth, сбились настройки аутентификации, сеть блокирует SSL/TLS или команда qwen не находится в PATH. Ниже — документированный порядок диагностики по слоям, настройка доступа и учебный пример. Собственный прогон по запросу «qwen code не работает» показал: скачали подборку результатов веб-поиска по запросу «qwen code не работает»: текст отдали 10 из 10. Медиана объёма читаемого текста топа — 2642 слова. Метку 2026 года несут 9 из 10 прочитанных страниц.

Прямой ответ и границы продукта

Qwen Code — это агентный инструмент для написания кода от Qwen, который живёт в вашем терминале и помогает воплощать идеи в код быстрее, чем когда-либо, — так его описывает официальная документация проекта. Инструмент работает в командной строке: он редактирует файлы, запускает команды и создаёт коммиты. Документация проекта перечисляет и другие его возможности: создание функций из описаний, отладку и исправление ошибок, навигацию по кодовой базе, автоматизацию рутинных задач и подсказки продолжения.

Границы продукта важны для диагностики. Qwen Code — это клиент, который подключается к провайдеру модели. Сам по себе он не содержит модель: без настроенного доступа к провайдеру сессия не начнётся. Документация проекта прямо указывает, что при первом запуске вам будет предложено подключить провайдера модели. Если этот шаг не пройден, интерфейс не покажет рабочий чат — и пользователь видит «не работает».

Второй слой границ — окружение. Документация проекта требует Node.js 22 или новее для ручной установки через npm. Если версия ниже, установка или запуск завершатся ошибкой. Рекомендуемый установщик использует отдельный архив, если он доступен для вашей платформы; если не удаётся, он использует npm — тогда Node.js 22 или новее с npm должны быть доступны в PATH.

Третий слой — способ входа. Документация проекта сообщает, что Qwen OAuth больше не доступен для выбора в диалоговом окне — его бесплатный тариф был отменён 15 апреля 2026 года. Это документированная причина отказа у пользователя, ранее работавшего через Qwen OAuth: старый способ входа отклоняет новые запросы.

Границы доступа из России источники не описывают как отдельный сценарий. В обзоре на GEN202 разбирается доступ из России для Qwen в целом, но применительно к Qwen Code конкретных указаний на этот счёт там нет. Для читателя из РФ это означает: ориентируйтесь на требования провайдера и региона аккаунта, которые называет документация проекта.

Что делать в первую очередь: проверить версию Node.js, затем способ аутентификации, затем сеть. Этот порядок соответствует структуре официального руководства по устранению неполадок, где первым разделом идут ошибки аутентификации или входа в систему.

Условия доступа и источник актуальных требований

Актуальные требования публикует документация проекта на qwenlm.github.io и её зеркало в репозитории на GitHub. Именно эти страницы стоит открывать при сомнениях: они обновляются вместе с релизами.

Главное изменение доступа: бесплатный тариф Qwen OAuth был отменён 15 апреля 2026 года. Документация проекта поясняет, что существующие кэшированные токены могут продолжать работать некоторое время, но новые запросы будут отклоняться. Рекомендация источника — перейти на Alibaba Cloud Coding Plan, OpenRouter, Fireworks AI или другого провайдера, запустить qwen и использовать /auth для настройки.

Документация проекта описывает три верхнеуровневых варианта в меню /auth при первом запуске. Первый — Alibaba ModelStudio, официальный рекомендуемый вариант: он открывает подменю с Coding Plan для индивидуальных разработчиков с недельной квотой, Token Plan для команд и компаний с оплатой по мере использования и выделенным эндпоинтом, либо Standard API Key для подключения с существующим ключом ModelStudio. Token Plan и Standard API Key также дают доступ к встроенному инструменту web_search без дополнительной настройки.

Второй вариант — сторонние провайдеры: документация проекта перечисляет встроенные подключения по API-ключу для DeepSeek, Grok, MiniMax, Z.AI, Kimi, Idealab, ModelScope, OpenRouter и Requesty. Третий — пользовательский провайдер: ручное подключение локального сервера, прокси или неподдерживаемого провайдера, с поддержкой OpenAI, Anthropic, Gemini и других совместимых эндпоинтов.

Регион аккаунта определяет площадку. Документация проекта называет два региона для Coding Plan: Aliyun ModelStudio (Beijing) на bailian.console.aliyun.com и Alibaba Cloud (intl) на bailian.console.alibabacloud.com. Выбирайте по региону вашего аккаунта.

Отдельный случай — неинтерактивные окружения. Документация проекта указывает, что в headless-средах (CI, SSH, контейнеры) обычно невозможно пройти процесс входа через браузер OAuth, и в таких случаях следует использовать Alibaba Cloud Coding Plan или метод аутентификации по API-ключу. Если вы запускаете Qwen Code в CI и видите зависание на входе — это ожидаемое поведение для браузерного потока.

Для читателей, сравнивающих инструменты, полезна статья про Cline в России: там разобраны доступ и оплата для похожего класса ассистентов.

Документированный порядок действий

Порядок восстановления работоспособности состоит из четырёх шагов, каждый из которых проверяет свой слой.

Шаг первый — установка. Документация проекта предлагает быструю установку через скрипт для Unix-систем и PowerShell для Windows, а также ручную установку через npm install -g @qwen-code/qwen-code@latest и Homebrew командой brew install qwen-code. После установки рекомендуется перезапустить терминал, чтобы переменные окружения вступили в силу. Если qwen сразу не стал доступен в PATH, документация рекомендует перезапустить терминал и проверить установку, если команда по-прежнему не найдена.

Шаг второй — аутентификация. Запустите qwen в терминале: при первом запуске откроется меню подключения провайдера модели. Выберите Alibaba ModelStudio для официального варианта, стороннего провайдера при наличии его API-ключа или пользовательский провайдер для локального сервера. Документация проекта напоминает: Qwen OAuth был отключён 15 апреля 2026 года, и при прежнем использовании этого способа нужно переключиться на один из текущих вариантов.

Шаг третий — проверка конфигурации. Откройте ~/.qwen/settings.json для глобальных настроек или ./.qwen/settings.json для настроек конкретного проекта. Документация проекта описывает настройку моделей и провайдеров именно в этом файле, а переключение моделей — командой /model. Для headless-сценариев доступна настройка через переменные окружения.

Шаг четвёртый — проверка сессии. Запустите интерактивную сессию и выполните команду /about: она показывает сведения о текущей сборке. Документация проекта приводит эту команду как способ сообщить версию при обращении за помощью.

Если после всех шагов сессия не стартует, документация проекта советует искать похожие Issues на GitHub или создавать новые. Перед этим стоит собрать сведения о версии и окружении.

Учебный пример и критерии проверки

Разберём типовой сценарий восстановления на учебном примере. Ситуация: разработчик работал с Qwen Code через Qwen OAuth, обновил инструмент и получил отказ. Это учебный пример редакции.

Первый шаг диагностики — определить слой отказа. Запустите qwen и посмотрите, на каком этапе процесс останавливается. Если команда не найдена — проблема в установке. Если открывается меню, но вход отклоняется — проблема в аутентификации. Если появляется ошибка сети — проблема в сертификатах или прокси.

Второй шаг — устранить причину. При отказе OAuth запустите /auth и выберите текущий вариант: Coding Plan, стороннего провайдера или API-ключ. Документация проекта прямо предписывает переключиться на API Key или Coding Plan через /auth, если вы всё ещё используете Qwen OAuth.

Третий шаг — проверить результат. Выполните /about и убедитесь, что сессия активна. Затем задайте простой вопрос о проекте, например what does this project do? — эту команду документация проекта приводит как пример первого знакомства с кодовой базой.

Критерии самостоятельной проверки, которые предлагает редакция:

• Команда qwen запускается из любого каталога после перезапуска терминала.
• Меню /auth показывает текущие варианты входа и не предлагает Qwen OAuth как выбираемый пункт.
• Файл ~/.qwen/settings.json содержит корректный провайдер и не содержит зависшего security.auth.selectedType.
• Сессия отвечает на вопрос о проекте без ошибок сети.
• Команда /about выводит сведения о сборке.

Для сравнения поведения с другим ассистентом пригодится материал про Cursor AI не работает: там разобраны похожие по природе сбои входа и сети.

Смежные варианты и выбор по задаче

Qwen Code — один из нескольких инструментов в этом классе. Выбор зависит от того, где вы работаете и какой доступ у вас есть.

Если нужен графический интерфейс, документация проекта упоминает новое расширение для VS Code в бета-версии: оно даёт нативный опыт работы в IDE и не требует знакомства с терминалом. Расширение устанавливается из маркетплейса, работа идёт в боковой панели. В репозитории проекта на GitHub есть Issue, где пользователь сообщает, что расширение Qwen Code Companion для VS Code перестало работать после обновления версии. Это отдельный канал распространения, и его сбои диагностируются иначе, чем сбои CLI.

Если нужен headless-режим, документация проекта описывает философию Unix: Qwen Code компонуем и скриптуем, его можно встраивать в конвейеры и CI. Для таких сценариев подходит аутентификация по API-ключу, поскольку браузерный вход в headless-средах недоступен.

Если вы сравниваете лимиты разных инструментов, посмотрите разбор opencode лимиты: там описано, как устроены квоты и что делать при исчерпании. Для читателей из России полезен материал Cursor AI в России: он про доступ и оплату зарубежных ассистентов.

Типичные проблемы и способы диагностики

Официальное руководство по устранению неполадок перечисляет конкретные ошибки и их причины. Разберём их по группам.

Ошибки аутентификации. Документация проекта приводит сообщение «Qwen OAuth free tier was discontinued on 2026-04-15» с пояснением, что Qwen OAuth больше не доступен с 15 апреля 2026 года. Решение — перейти на API Key или Coding Plan через /auth.

Отдельная проблема — невозможность отобразить интерфейс после сбоя аутентификации. Документация проекта объясняет причину: если аутентификация не удалась после выбора типа, настройка security.auth.selectedType может сохраниться в settings.json, и при перезапуске CLI зависает, пытаясь аутентифицироваться неудачным типом. Порядок исправления: откройте ~/.qwen/settings.json или ./.qwen/settings.json, удалите поле security.auth.selectedType, перезапустите CLI, чтобы он снова запросил аутентификацию.

Ошибки сертификатов. Документация проекта описывает ошибки UNABLE_TO_GET_ISSUER_CERT_LOCALLY, UNABLE_TO_VERIFY_LEAF_SIGNATURE и unable to get local issuer certificate. Причина — корпоративная сеть с файрволом, который перехватывает и проверяет SSL/TLS-трафик; это часто требует добавления пользовательского корневого CA-сертификата в доверенные для Node.js. Решение — переменная окружения NODE_EXTRA_CA_CERTS с путём к корпоративному сертификату.

Для самоподписанных эндпоинтов документация проекта приводит ошибку «Connection error. (cause: fetch failed)». Причина — Qwen Code направлен на самостоятельно размещённый сервер, TLS-сертификат которого самоподписан, и Node.js его отклоняет. Документация проекта показывает запуск с флагом --insecure и предупреждает: отключение проверки снимает защиту от атак типа «человек посередине», поэтому применять это стоит только для эндпоинтов, которым вы полностью доверяете.

Проблемы с прокси. Документация проекта указывает, что при работе за прокси его настраивают через qwen --proxy <url> или параметр proxy в settings.json. Ошибка «Device authorization flow failed: fetch failed» возникает, когда Node.js не смог достичь конечных точек Qwen OAuth; источник называет это проблемой прокси или доверия к SSL/TLS.

Проблемы установки и обновления. Обзор на try-qwen-ai.com описывает отдельный класс сбоев: команда qwen не найдена, конфликты установок, ошибки Node.js и MODULE_NOT_FOUND, а также поломки после обновления. Этот обзор приводит собственные диагностические версии, включая v0.25.0 как текущую стабильную на момент публикации. Источник советует сохранить работу перед диагностикой и определить отказавший слой.

При ручной установке отдельно стоит проверить окружение: документация проекта требует Node.js 22 или новее для этого способа установки.

Частые вопросы

Почему Qwen Code перестал работать после обновления?

Одна из документированных причин — отмена бесплатного тарифа Qwen OAuth 15 апреля 2026 года. Документация проекта сообщает, что новые запросы через этот способ входа отклоняются, а кэшированные токены работают лишь некоторое время. Решение — запустить /auth и выбрать текущий вариант: Coding Plan, стороннего провайдера или API-ключ. Если проблема появилась именно после обновления версии, проверьте также настройки в settings.json.

Как исправить зависание Qwen Code при запуске?

Документация проекта описывает причину: после неудачной аутентификации в settings.json может сохраниться поле security.auth.selectedType, и CLI зависает, пытаясь войти неудачным способом. Откройте ~/.qwen/settings.json или ./.qwen/settings.json, удалите это поле и перезапустите CLI. После перезапуска инструмент снова запросит аутентификацию, и вы сможете выбрать рабочий вариант входа.

Что делать при ошибке сертификата в Qwen Code?

Ошибки вида UNABLE_TO_VERIFY_LEAF_SIGNATURE возникают в корпоративных сетях, где файрвол проверяет SSL/TLS-трафик. Документация проекта советует установить переменную NODE_EXTRA_CA_CERTS с путём к корпоративному корневому сертификату. Для самоподписанных эндпоинтов документация проекта приводит запуск с флагом --insecure, но предупреждает, что это снимает защиту от атак типа «человек посередине».

Как настроить Qwen Code в CI или контейнере?

В headless-окружениях браузерный вход через OAuth обычно недоступен. Документация проекта предписывает использовать Alibaba Cloud Coding Plan или аутентификацию по API-ключу. Настройку можно выполнить через переменные окружения или через файл settings.json. Такой подход подходит для CI, SSH-сессий и контейнеров, где нет интерактивного браузера.

Какие способы входа доступны сейчас?

Документация проекта называет три верхнеуровневых варианта в меню /auth: Alibaba ModelStudio с подменю Coding Plan, Token Plan и Standard API Key; сторонние провайдеры с подключением по API-ключу; пользовательский провайдер для локального сервера или прокси. Qwen OAuth в этом меню больше не предлагается. Регион аккаунта определяет площадку: Beijing или intl.