Qwen Code: как установить coding agent и запустить первый проект

Qwen Code можно скачать и установить бесплатно. Но это ещё не означает бесплатную работу с моделью. Сам CLI открыт под лицензией Apache-2.0, а запросы обрабатывает выбранный модельный провайдер. У него могут быть собственные тарифы, квоты и ограничения.

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

Не начинайте с единственной копии рабочего сайта. Создайте новую пустую папку qwen-first-task, а в ней файл index.html. Добавьте обычную HTML-разметку с заголовком «Каталог» и тремя элементами: «Чайник», «Кофемолка» и «Термос». К каждому элементу добавьте класс card. Не подключайте библиотеки, сервер и внешние данные. Откройте файл в браузере и убедитесь, что заголовок и все три названия видны. Это исходное поведение, которое нужно сохранить.

Создайте точку возврата в Git. Сначала проверьте, что Git установлен:

Команды по порядку: git --version, cd /путь/к/qwen-first-task, git init, git status, git add index.html, git status, git commit -m "Исходная версия до Qwen Code" и git status.

До git add первый git status должен показывать только созданный index.html. Если там есть .env, ключи, папки зависимостей или сборочные файлы, не добавляйте их: вы находитесь не в пустой учебной папке. После git add index.html второй статус должен показывать этот единственный подготовленный файл.

Если первая команда не находится, установите Git по официальной инструкции, перезапустите терминал и повторите проверку. Если первый коммит просит имя и почту, выполните предложенные Git команды git config, повторите git commit, а затем git status. Продолжайте, только когда статус сообщает, что рабочее дерево чистое.

В официальном репозитории есть три основных маршрута. Standalone-вариант не требует отдельной установки Node.js:

На macOS также доступен Homebrew:

Команда для этого шага: brew install qwen-code.

Если Node.js уже используется в вашей работе, можно установить npm-пакет. Текущая документация требует Node.js 22 или новее:

После установки перезапустите терминал и выполните:

Команда для этого шага: qwen --version.

В ответе должна появиться версия, а не ошибка command not found. Теперь CLI установлен. Авторизация и доступ к модели настраиваются отдельно, и именно на этом шаге определяется реальная стоимость работы.

Перейдите в учебную папку и запустите Qwen Code:

Команды по порядку: cd /путь/к/qwen-first-task и qwen.

Введите /auth. В актуальной документации по авторизации перечислены три направления: Alibaba ModelStudio, сторонние провайдеры и собственный провайдер с совместимым API. Выберите тот, где у вас уже есть аккаунт, понятный тариф и доступная модель. Не ориентируйтесь только на название модели: перед началом проверьте цену, лимиты и региональные условия на стороне самого провайдера.

Старые инструкции могут предлагать Qwen OAuth и тысячу бесплатных запросов в день. Этот free tier прекращён 15 апреля 2026 года, а пункт удалён из /auth. Если его нет в меню, установка не сломана. Просто материал, по которому вы идёте, устарел.

API-ключ вводите только тем способом, который показывает выбранный маршрут авторизации. Не вставляйте реальный ключ в промпт, index.html, Git-коммит или будущий QWEN.md. После настройки выполните:

В интерфейсе используется команда /doctor.

Команда помогает проверить конфигурацию. Если диагностика прошла, не поручайте агенту сразу менять проект. Сначала включите режим анализа:

В интерфейсе используется команда /plan.

Обычная просьба «сначала составь план» сама по себе не запрещает инструменту менять файлы. Команда /plan включает read-only режим: Qwen Code может исследовать проект и составлять план, но не должен редактировать файлы или выполнять команды.

Дайте первый запрос:

Сверьте ответ с папкой. Если в ней только index.html, агент не должен придумывать React, сервер, базу данных или сборку. Команда запуска тоже должна соответствовать реальности: простой HTML-файл можно открыть в браузере без npm install.

Такой сеанс проверяет не качество будущего кода, а понимание исходной точки. Если Qwen Code неверно описал файлы или предлагает лишнюю инфраструктуру, исправьте контекст до первой правки. Чем раньше обнаружена ошибка в понимании проекта, тем меньше ненужного diff придётся разбирать.

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

1. Над карточками появилось поле поиска с понятной подписью.

2. При вводе части названия остаются только совпадающие карточки.

3. Регистр букв не влияет на поиск.

4. Пустая строка снова показывает все три карточки.

5. Решение не добавляет сервер, фреймворк и внешние зависимости.

Оставаясь в Plan Mode, отправьте:

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

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

В интерфейсе используется команда /approval-mode default.

default здесь является техническим значением настройки; видимое название режима: Ask Permissions. В нём каждое изменение файла и каждая shell-команда требуют ручного подтверждения. Посмотрите на строку состояния, затем разрешите выполнить согласованный план.

Не включайте yolo: этот режим автоматически одобряет все вызовы инструментов. Sandbox тоже не является заменой разрешениям. Его можно отдельно включить запуском qwen -s, но доступность и реализация изоляции зависят от операционной системы. Для первого локального задания достаточно отдельной папки, Git и Ask Permissions; sandbox добавляют, когда понимают его границы.

Читайте каждый запрос на действие. Разрешение должно соответствовать плану: изменение index.html ожидаемо, а установка пакета или обращение к постороннему сайту не относятся к плану. После завершения не принимайте текстовый отчёт агента за доказательство. В отдельном терминале выполните:

Команды по порядку: git status и git diff.

Сначала сверьте полный список изменённых и новых файлов из git status с одобренным планом. Обычный git diff не показывает содержимое untracked-файлов, поэтому каждый новый файл нужно отдельно открыть и прочитать. Неожиданному файлу нужен ответ агента и ваше отдельное решение; не добавляйте его в коммит автоматически.

В просмотренных изменениях должна быть только функция фильтра. Затем откройте страницу в браузере и вручную проверьте: полное название, часть названия, другой регистр, запрос без совпадений и очистку поля. Отдельно убедитесь, что исходный заголовок и все три карточки сохранились. Эти действия являются инструкцией читателю; автор не заявляет, что провёл этот тест за вас.

Если один случай не работает, сообщите один наблюдаемый симптом: например, «по запросу чай карточка Чайник исчезает; исправь сравнение регистра, не меняй разметку карточек». После исправления снова просмотрите git diff и повторите все проверки, а не только упавший случай.

Когда результат соответствует критериям, сохраните его:

Команды по порядку: git add index.html, git diff --cached, git commit -m "Добавлен фильтр карточек" и git status.

Коммит создавайте только после проверки полного staged diff через git diff --cached. Если в git status остался новый или изменённый файл, разберитесь с ним до коммита: широкая команда git add . здесь намеренно не используется.

Так у вас появляется не просто ответ модели, а проверенная функция и отдельная точка возврата. Если хочется системно пройти путь от постановки задачи и Git до отладки, базы данных, деплоя и защиты, этот цикл разбирается в курсе «Вайбкодинг на максималках». Курс построен вокруг Codex и VS Code, а не Qwen Code, поэтому ссылка здесь про общий процесс разработки, а не про обучение конкретному CLI.

Симптом «qwen не найден» относится к установке, а не к модели. Перезапустите терминал, снова выполните qwen --version и сверьте выбранный способ установки с Quickstart. При npm-маршруте отдельно проверьте node --version: нужна версия 22 или новее.

Если CLI запускается, но модель не отвечает, откройте /auth, проверьте выбранного провайдера и выполните /doctor. Ошибка авторизации, исчерпанная квота и недоступная в регионе модель решаются на стороне провайдера. Переустановка CLI не создаст тариф или API-доступ.

Если инструкция требует Qwen OAuth, не пытайтесь вернуть исчезнувший пункт. Бесплатный OAuth прекращён 15 апреля 2026 года. Выберите один из текущих маршрутов /auth и заранее узнайте его условия.

Если агент предлагает слишком много файлов, вернитесь в /plan и сузьте задачу до одного наблюдаемого поведения. Если в diff попал секрет, не коммитьте его: удалите значение из файлов и истории незакоммиченных изменений, затем перевыпустите ключ у провайдера.

Qwen Code умеет читать постоянный контекст из QWEN.md, а также совместим с AGENTS.md. Команда /init может создать стартовый файл по содержимому проекта. Не принимайте сгенерированный текст вслепую: оставьте только устойчивые инструкции, которые пригодятся в следующем сеансе.

Для учебной страницы достаточно записать:

Не храните в QWEN.md ключи, пароли и временные детали одной задачи. Это briefing для агента, а не хранилище секретов и не журнал переписки.

Следующим заданием можно добавить кнопку «Сбросить поиск». Сначала опишите её поведение в /plan: кнопка очищает поле, возвращает все карточки и получает фокус после нажатия. Затем вернитесь в Ask Permissions, согласуйте ограниченный diff, проверьте три случая в браузере и создайте новый коммит. После двух таких циклов у проекта будут две отдельные функции, две проверенные разницы и две понятные точки возврата, независимо от того, какой провайдер модели вы выбрали.