- Для установки через npm нужен подходящий Node.js и терминал с правами пользователя.
- node --version npm install -g @qwen-code/qwen-code@latest qwen --version cd my-project qwen После запуска Qwen Code запросит способ авторизации.
- Откройте небольшой проект и попросите: «Изучи структуру папок и объясни, где реализована обработка формы обратной связи.
- Пример: «После отправки формы возникает ошибка 500.
- Создайте отдельный учебный проект с функцией подсчёта цены после скидки.
Qwen Code — инструмент разработки, который работает с проектом через терминал и другие поддерживаемые интерфейсы. Он помогает читать структуру репозитория, объяснять функции, писать изменения и запускать тесты. Это удобно для повторяемых задач, но опасно воспринимать его правки как гарантированно верные. Надёжный процесс начинается с контроля версий, ограниченного задания и проверки изменений до применения.
Что подготовить к установке
Для установки через npm нужен подходящий Node.js и терминал с правами пользователя. В актуальных инструкциях Qwen Code для ручной установки указывается Node.js версии 22 и выше. Подготовьте отдельный тестовый проект, проверьте его сборку без агента и сохраните изменения в Git. Начинать на единственной копии рабочего сайта рискованно.
Как установить и запустить CLI
node --version
npm install -g @qwen-code/qwen-code@latest
qwen --version
cd my-project
qwen
После запуска Qwen Code запросит способ авторизации. В зависимости от действующего плана доступны аккаунт Qwen с соответствующей подпиской, QwenCloud, Alibaba ModelStudio или другие поддерживаемые провайдеры. Для некоторых методов нужен API-ключ, для других — вход через браузер. Используйте только способ, доступный вашему аккаунту, и не копируйте секреты в README или исходники проекта.
Внутри CLI команда /auth предназначена для настройки авторизации, а /doctor помогает проверить конфигурацию. Имена некоторых пунктов меню могут меняться между версиями, поэтому не привязывайте рабочий регламент к конкретному расположению кнопки.
Первая безопасная задача
Откройте небольшой проект и попросите: «Изучи структуру папок и объясни, где реализована обработка формы обратной связи. Пока ничего не меняй. Назови файлы и функции, от которых зависит поведение». После анализа задайте одну локальную правку: добавить проверку обязательного поля или исправить сообщение об ошибке. Не разрешайте без просмотра менять конфигурацию, удалять файлы и обращаться к внешним системам.
- Создайте новую Git-ветку для эксперимента.
- Сохраните состояние проекта и действующие тесты.
- Попросите показать предполагаемый план изменения.
- Примените минимальную правку.
- Проверьте diff и запустите тесты.
- Примите или откатите изменения по результату проверки.
Как составить запрос для отладки
Пример: «После отправки формы возникает ошибка 500. Вот текст ошибки и способ воспроизведения. Найди вероятную причину, перечисли затронутые файлы, предложи минимальную правку. Не меняй зависимости и не затрагивай базу данных. Добавь тест, подтверждающий исправление». Чем точнее воспроизведение, тем меньше вероятность, что агент начнёт переписывать несвязанные части кода.
Критерии приёмки изменений
| Проверка | Что считать успехом |
|---|---|
| Статические проверки | Линтер и проверка типов без новых ошибок |
| Тесты | Проходят старые и добавленные проверки |
| Diff | Нет необоснованных массовых переписываний |
| Зависимости | Нет случайных новых пакетов |
| Безопасность | Секреты и доступы не попали в репозиторий |
Небольшая задача для Qwen Code с проверяемым исправлением
Создайте отдельный учебный проект с функцией подсчёта цены после скидки. Пусть файл price.js содержит ошибку: return price - discount, хотя скидка задаётся в процентах. Попросите Qwen Code: «Найди функцию расчёта скидки, объясни ошибку и исправь её минимальным изменением. Не меняй другие файлы, сначала покажи diff. Добавь тест: цена 1000, скидка 15% — результат 850».
function finalPrice(price, discountPercent) {
return price * (1 - discountPercent / 100);
}
console.assert(finalPrice(1000, 15) === 850);
Это ожидаемый исправленный вариант, а не результат исполнения команды агентом. Сначала проверьте, что тест падает на старой реализации, затем — что проходит после правки. Отдельно решите, нужно ли отклонять отрицательную цену и скидку больше 100%, вместо того чтобы автоматически менять бизнес-правила. Ссылку на исходную задачу и результат тестов полезно сохранить в Git-ревизии.
Типичные ошибки и их причины
Команда qwen не найдена — проверьте корректность установки и системную переменную PATH. Ошибка авторизации — уточните провайдера, подписку, регион и действительность ключа. Агент видит не тот проект — проверьте текущую директорию. Тесты падают после исправления — откатите последний diff и попросите диагностировать именно упавшую проверку. Не выдавайте агенту административные права только ради устранения ошибки доступа.
Как работать с приватным репозиторием
До подключения модели проверьте правила компании на передачу кода и логов. Конфигурационные файлы могут содержать секреты, а логи — персональные данные. Для крупных проектов ограничьте область чтения и редактирования, используйте отдельный токен с минимальными правами и сохраняйте журнал изменений. Избегайте автоматического выполнения потенциально разрушительных команд без подтверждения.
Если нужно создать интерфейс с нуля, сначала прочитайте Qwen Web Dev; если приложение уже существует и требует подключения модели, полезнее интеграция API. Эти задачи отделены от использования CLI.
Когда Qwen Code действительно экономит время
Хорошие задачи — объяснение незнакомого модуля, написание тестов, небольшая рефакторизация, устранение воспроизводимой ошибки и документация. Масштабные изменения архитектуры требуют плана, code review и контрольных тестов. Считайте пользу по времени до проверенного результата, а не по количеству сгенерированных строк.