Qwen Code на Windows ставится двумя путями: через npm при установленном Node.js версии 22 или новее либо готовым скриптом PowerShell из инструкции проекта. После установки в папке репозитория запускают команду qwen и входят командой /auth. Для рабочего компьютера важнее установки то, куда уйдут данные после входа и кто подтверждает действия агента.

Что поставить

TL;DR

Для Windows у Qwen Code два штатных пути: npm install -g @qwen-code/qwen-code@latest при наличии Node.js 22+ и скрипт установки PowerShell из инструкции проекта QwenLM.

Qwen Code — агент для работы с кодом в терминале, о возможностях которого рассказывает материал про Qwen Code в разработке компании. Сотруднику, который открывает его на Windows впервые, нужна конкретная последовательность действий. Она отличается от запуска Claude Code, разобранного в статье про Claude Code на Windows: здесь свои требования к версии Node.js, своя команда запуска и своя схема входа.

ПутьЧто нужноКогда выбирать
npmNode.js 22 или новее, право ставить глобальные пакетыСреда разработчика уже есть, версии пакетов контролирует команда
Скрипт PowerShellРазрешение запускать скрипты и доступ к адресу загрузкиНужна быстрая установка на чистой машине, скрипт прочитан заранее
Приложение для рабочего столаЗагрузка из релизов проекта на GitHubСотруднику удобнее окно, чем терминал

Все сведения по установке взяты из репозитория Qwen Code. Версии и адреса там меняются, поэтому перед установкой на рабочие машины сверьте страницу и закрепите выбранный путь во внутренней памятке.

Установка по шагам

На корпоративном компьютере установка упирается в права и политики. Глобальный пакет npm требует прав на запись в каталог Node.js либо настроенного пользовательского каталога. Скрипт PowerShell может блокироваться политикой выполнения или антивирусом. Выясните это у администратора заранее, чтобы решение приняли до установки, а защита осталась на месте.

  1. Проверьте версию Node.js командой node --version в PowerShell. Если версия ниже 22, обновите её через утверждённый в компании способ.
  2. Выполните npm install -g @qwen-code/qwen-code@latest. Если используете скрипт, сначала откройте его текст в браузере и прочитайте, и лишь потом запускайте.
  3. Закройте терминал и откройте новый: по сведениям из репозитория, после установки перезапуск нужен, чтобы подхватились переменные окружения.
  4. Перейдите в папку тестового репозитория командой cd и введите qwen. Должен открыться интерактивный интерфейс агента.

Отдельная проблема Windows — пути и оболочка. Агент выполняет команды в оболочке, и сценарии, написанные под Linux, на PowerShell запускаются по-другому: другие разделители путей, другие переменные, другие команды. Если проект собирается скриптами для Bash, заранее решите, чем пользуется команда: установленным Git for Windows с оболочкой Bash или подсистемой Linux. Иначе первая же задача на сборку упрётся в ошибки, причём модель тут ни при чём.

Запускать скрипт, скачанный из сети, на рабочем компьютере вслепую нельзя. Прочитайте его, убедитесь, что адреса загрузки ведут на ожидаемые ресурсы проекта, и согласуйте запуск с администратором. Путь через npm прозрачнее: пакет ставится известной командой, а версию можно зафиксировать вместо суффикса latest.

Вход и модель

Внутри сессии команда /auth открывает настройку провайдера и учётных данных. По описанию проекта, поддерживаются интерфейсы OpenAI, Anthropic, Gemini и Qwen, а также сторонние провайдеры и локальные модели. Выбор провайдера определяет всё остальное: куда уходит код, как оплачивается расход и какие условия обработки данных действуют.

Для рабочего компьютера возможны два осмысленных варианта. Первый: облачный интерфейс выбранного разработчика, когда компания допустила отправку фрагментов кода наружу. Второй: локальная модель на своём сервере, и тогда в качестве провайдера указывают её адрес. Как устроена локальная схема, описано в статье про Qwen Code с локальной моделью. Условия облачного провайдера читайте на его странице: в пересказах они устаревают.

● Discovery · 1 час · бесплатно

Какой провайдер модели допустим в вашей компании для кода?

Прийти на Discovery →

Ключи доступа хранят в переменных окружения пользователя или в менеджере секретов, а файлы репозитория остаются свободными от них. Файл настроек поддерживает подстановку переменных окружения, что позволяет держать в нём ссылку вместо значения. Выдайте каждому сотруднику собственный ключ, чтобы расход и отзыв ключа оставались управляемыми.

Режимы и права

Настройки Qwen Code живут в файлах settings.json трёх уровней. Пользовательский лежит в папке .qwen профиля, проектный — в папке .qwen корня репозитория, а системный на Windows расположен в C:\ProgramData\qwen-code\settings.json. Системный файл удобен администратору: он задаёт правила для всех машин и по приоритету выше пользовательского и проектного, поэтому сотруднику труднее молча ослабить обязательные ограничения.

  • Режим подтверждения задаёт параметр tools.approvalMode. Среди значений в документации есть plan, default, auto-edit, auto и yolo; новичкам оставляйте осторожные варианты и держите yolo выключенным.
  • Правила разрешений позволяют запретить отдельные команды: внесите туда те, что затрагивают системные каталоги и сеть.
  • Файл .qwenignore вместе с .gitignore задаёт файлы, которые агент пропускает при чтении. Внесите туда каталоги с выгрузками и файлы окружения.
  • Песочница включается параметром tools.sandbox; проверьте на тестовой машине, как она работает в вашей версии Windows, и только потом закладывайте в регламент.

Права проверяет система вокруг агента, а модель их лишь соблюдает по инструкции. Поэтому защита строится на настройках режима, списках запретов и правах учётной записи Windows, под которой запущен терминал. Рабочему разработчику запускать агента из-под администратора нельзя.

Первая задача

Для проверки возьмите тестовый репозиторий без секретов и сформулируйте задачу с готовым критерием, например: «объясни структуру проекта и найди функции без тестов», а затем «допиши тест для одной из них». Сначала попросите агента только читать и объяснять. Если ответ совпадает с реальными файлами, переходите к правке небольшого участка.

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

Принимает результат человек. Прочитайте diff целиком, запустите тесты и линтер отдельной командой в обычном окне терминала, посмотрите, появились ли вызовы несуществующих функций. Журнал разговора и ключи остаются на этом компьютере, поэтому хранение этих данных включают в правила компании так же, как другие рабочие материалы.

Среди первых проблем чаще всего встречаются три. Терминал открыли ещё до установки, и команда qwen в нём пока отсутствует: помогает новое окно. Корпоративная сеть блокирует адрес провайдера, и вход завершается ошибкой соединения. Агент запущен в каталоге, который шире нужного, и читает лишние файлы. Каждый пункт легко проверить, поэтому их вносят в памятку заранее.

Через неделю соберите впечатления: какие задачи агент закрыл без ручных исправлений, где пришлось переписывать, что мешало на уровне Windows. Из этих заметок получается памятка для следующих сотрудников: версия Node.js, выбранный путь установки, режим по умолчанию и список запрещённых действий.

// с чего начать

Возьмите одного разработчика и один тестовый репозиторий. Поставьте Qwen Code через npm с зафиксированной версией, оставьте режим подтверждения каждого действия и поручите единственную задачу с тестом. По итогам решите, расширять ли пилот. Для команд, где с агентом начнут работать десятки сотрудников, есть обучение сотрудников работе с ИИ.

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

Как установить Qwen Code на Windows?
Проверьте Node.js 22 или новее и выполните npm install -g @qwen-code/qwen-code@latest в PowerShell. Есть и скрипт установки PowerShell из инструкции проекта, но перед запуском его текст нужно прочитать. После установки откройте новый терминал.
Как запустить Qwen Code после установки?
Перейдите в папку проекта и введите команду qwen. Внутри сессии выполните /auth, чтобы выбрать провайдера и ввести учётные данные. Начните с вопроса о структуре проекта и сверьте ответ с файлами.
Где лежит файл настроек Qwen Code?
Пользовательский settings.json находится в папке .qwen профиля, проектный — в .qwen корня репозитория. Системный на Windows расположен в каталоге ProgramData\qwen-code. Значения более высокого уровня переопределяют низкие, а аргументы командной строки приоритетнее файлов.
Какой режим подтверждения выбрать новичку?
Выбирайте осторожные режимы, где агент спрашивает разрешение на изменения, и держите отключённым yolo. Список режимов в документации: plan, default, auto-edit, auto, yolo. Расширяйте самостоятельность после проверки на тестовом репозитории.
Можно ли использовать Qwen Code с локальной моделью на Windows?
Да, в качестве провайдера можно указать адрес локальной модели, о чём сказано в описании проекта. Тогда код остаётся в вашем контуре, но качество зависит от модели и памяти машины. Результат всё равно проверяет человек.