Как установить и настроить Qwen Code

Главное: Qwen Code — официальный open-source агент для программирования, отдельный от обычного Qwen Studio. Он работает в терминале, может анализировать файлы проекта и выполнять агентные задачи. Установка доступна для Windows, macOS и Linux; официальный проект также описывает Desktop и интеграции с редакторами.

Что нужно до установки

Откройте официальный проект Qwen Code: https://github.com/QwenLM/qwen-code Если используете рекомендуемый standalone-установщик, он старается поставить подходящую сборку автоматически. Для ручной установки через npm официальный quickstart требует Node.js 22 или новее.

Если нужен официальный мобильный Qwen Studio, также скачать Qwen через vSofte можно на странице приложения. vSofte — независимый навигационный каталог: он не хранит установочные файлы Qwen, не размещает APK или другие установщики у себя и не запрашивает пароли, коды подтверждения или платёжные данные.

Qwen Code и Qwen Studio — разница

Qwen Studio — универсальный ассистент в браузере и приложении. Qwen Code запускается в контексте проекта и рассчитан на разработку. Если вам нужен только чат, установка Qwen Code не нужна. Сравнение сценариев есть в статье про Qwen на компьютере.

Установка на Windows

Официальный quickstart предоставляет PowerShell-команду для standalone-установки и альтернативу через npm. Саму актуальную команду лучше копировать из документации, чтобы не зависеть от старой версии инструкции: https://github.com/QwenLM/qwen-code/blob/main/docs/users/quickstart.md После установки перезапустите терминал, если команда qwen не находится сразу.

Установка через npm

При ручной установке сначала установите Node.js 22+, затем используйте официальный пакет @qwen-code/qwen-code. После установки проверьте, что команда доступна в новом терминале. Если оболочка не видит её, проблема обычно связана с PATH или версией Node/npm.

Установка на macOS и Linux

Для macOS/Linux официальный проект предлагает shell-установщик, а также Homebrew и npm. Выберите один способ и придерживайтесь его для обновлений. Смешивание нескольких глобальных установок может привести к тому, что терминал запускает не ту версию.

Как проверить, какая версия запускается

Используйте стандартные команды оболочки для просмотра пути к исполняемому файлу и версию Qwen Code. Если после обновления поведение не изменилось, возможно, в PATH осталась более старая копия.

Первый запуск и авторизация

Перейдите в папку проекта и запустите qwen. При первом запуске инструмент предложит настроить провайдера модели. Официальная документация также позволяет вызвать команду /auth внутри сессии. Не помещайте API-ключи в публичные файлы проекта.

Как проверить конфигурацию

В документации Qwen Code предусмотрена диагностическая команда /doctor. Она полезна, если агент запускается, но возникают проблемы с настройкой провайдера, окружением или соединением.

Qwen Code Desktop и редакторы

Официальный README перечисляет Desktop для macOS, Windows и Linux, а также варианты работы с редакторами. Это тот же класс инструмента Qwen Code, а не мобильный Qwen Studio. Выбирайте Desktop, если удобнее графический интерфейс, и терминал — если важна работа непосредственно в shell.

VS Code и другие IDE

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

Можно ли подключить локальную модель

Qwen Code поддерживает разные способы подключения моделей. Локальный вариант требует отдельного сервера или совместимого провайдера. Сначала добейтесь стабильного запуска модели, затем подключайте агент. Инструкция по весам — в статье про локальный Qwen3.8.

Почему локальная модель может работать хуже облачной

Причина может быть не в Qwen Code, а в размере модели, квантовании, контексте, шаблоне инструментов или настройке локального API. Для агентной работы особенно важна корректная поддержка tool calling выбранным бэкендом.

Типичные ошибки установки

Команда qwen не найдена

Перезапустите терминал, проверьте PATH и способ установки. При npm убедитесь, что глобальный каталог npm доступен оболочке.

Слишком старая версия Node.js

Если выбрана npm-установка, обновите Node.js до версии, указанной в текущем quickstart, затем переустановите пакет.

Авторизация не проходит

Проверьте выбранного провайдера и ключ. Не путайте авторизацию Qwen Studio с API-настройкой Qwen Code — это разные сценарии.

Обновление и удаление

Обновляйте тем же способом, которым устанавливали инструмент. Для standalone следуйте официальной документации, для npm обновляйте глобальный пакет, для Homebrew — формулу. После обновления проверьте фактическую версию команды.

Как безопасно работать с проектом

Перед крупными автоматическими правками используйте систему контроля версий и проверьте чистое состояние рабочей ветки. Агенту проще давать ограниченную, проверяемую задачу, чем сразу разрешать изменение всего проекта без точки возврата.

Секреты и API-ключи

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

Контрольный список перед завершением

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

Если результат отличается от ожидаемого

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

Контрольный список перед завершением

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

Если результат отличается от ожидаемого

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

Контрольный список перед завершением

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

Если результат отличается от ожидаемого

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

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

Нужен ли Qwen Code обычному пользователю Qwen?

Нет. Для обычного диалога проще использовать Qwen Studio.

Работает ли Qwen Code на Windows?

Да. Официальный quickstart содержит отдельный способ установки для Windows.

Можно ли использовать Qwen Code без Node.js?

Standalone-установщик может не требовать ручной npm-установки. Node.js нужен для варианта через npm и некоторых сценариев разработки.

Где смотреть актуальную команду установки?

В официальном quickstart: https://github.com/QwenLM/qwen-code/blob/main/docs/users/quickstart.md