Qwen Code CLI: установка, модели и первый рабочий запрос
Qwen Code CLI запускает coding-агента в терминале. Он может читать файлы проекта, искать связи, предлагать план, менять код и выполнять команды. В отличие от отдельного чата, агент работает с реальной папкой. Это полезно, но ошибка в выборе директории или разрешений сразу затрагивает файлы на компьютере.
Для первого запуска не нужна большая задача. Установите CLI официальным способом, выберите поставщика модели, откройте маленький Git-проект и начните с запроса без изменений. Только после проверки плана разрешите одну ограниченную правку.
Выберите способ установки
Официальный репозиторий Qwen Code предлагает standalone installer как основной путь. На Linux и macOS команда выглядит так:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
На Windows PowerShell:
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex
Команды загружают скрипт и сразу выполняют его. Перед использованием в рабочей среде откройте адрес скрипта, проверьте официальный домен и текущую инструкцию в репозитории. В организации установка может быть разрешена только через централизованный менеджер.
Есть вариант через npm:
Команда для этого шага: npm install -g @qwen-code/qwen-code@latest.
Для него официальная документация требует Node.js 22 или новее. На macOS и Linux доступен Homebrew:
Команда для этого шага: brew install qwen-code.
Не смешивайте способы без причины. Если одновременно остались standalone и npm-версии, оболочка может запускать не тот бинарник, который вы обновили.
Проверьте установку и PATH
После standalone-установки перезапустите терминал, чтобы обновились переменные окружения. Затем выполните:
Команда для этого шага: qwen --version.
Если команда не найдена, не переустанавливайте ее пять раз. Сначала проверьте путь:
Команда для этого шага: command -v qwen.
В PowerShell используйте:
Команда для этого шага: Get-Command qwen.
На Windows standalone installer обычно добавляет бинарник в пользовательский путь, связанный с %LOCALAPPDATA%\qwen-code\bin. Точное расположение и опции восстановления PATH смотрите в текущем Installation Guide.
Если qwen --version показывает старую версию, сравните путь бинарника со способом установки. Обновляйте тем же каналом, которым устанавливали CLI.
Разберитесь с моделью и авторизацией
Qwen Code не равен одной фиксированной модели. CLI поддерживает разные model providers и способы авторизации. В интерактивной сессии команда /auth открывает настройку поставщика, а /model переключает доступную модель.
На дату проверки официальный репозиторий описывает Qwen OAuth, OpenAI-compatible providers и другие варианты. Конкретная доступность зависит от региона, учетной записи, ключа и версии. Не копируйте API-ключ в запрос агенту и не записывайте его открытым текстом в репозиторий.
Для кастомного поставщика используется раздел modelProviders в настройках. Ключ рекомендуется передавать через переменную окружения, на которую ссылается envKey. Старые поля с ключом непосредственно в settings.json помечены как deprecated.
У настроек есть уровни. Пользовательский файл действует для всех проектов, а .qwen/settings.json в корне репозитория может задавать проектные параметры. Флаги командной строки, например --model, могут переопределить модель для конкретной сессии.
Это удобно для эксперимента, но усложняет диагностику. Если агент использует не ту модель, проверьте:
1. выбор в /auth;
2. текущую модель в /model;
3. аргументы запуска;
4. переменные окружения;
5. проектный и пользовательский settings.json.
Не называйте модель только по красивому отображаемому имени. Для воспроизводимости зафиксируйте provider, точный model ID, версию CLI и дату теста.
Подготовьте безопасный проект
Не запускайте Qwen Code из домашней директории. Агент будет видеть слишком широкую область файлов. Для первого теста создайте отдельную папку с минимальным сайтом или возьмите копию учебного репозитория без секретов.
Проверьте Git:
Команды по порядку: git status, git branch --show-current и git log -1 --oneline.
Если репозиторий новый, сначала создайте .gitignore, посмотрите список файлов и добавьте только нужные пути. Команда git add . может случайно включить .env, логи и результаты сборки.
Для маленького теста достаточно index.html и отдельного файла стилей. Откройте страницу вручную, затем создайте baseline commit. После этого любое изменение агента будет видно в diff.
Первый запрос должен быть read-only
Запустите qwen из корня проекта. После авторизации не просите сразу «улучшить сайт». Первый запрос должен проверить ориентацию агента:
Изучи этот проект без изменения файлов и без команд с записью. Назови точку входа, опиши структуру страницы и перечисли файлы, которые пришлось бы изменить, чтобы добавить блок с тремя преимуществами. Предложи план и критерии проверки. Остановись до любых изменений.
Хороший ответ ссылается на существующие файлы, не придумывает framework и отделяет план от реализации. Если агент назвал несуществующий путь, попросите показать, на чем основан вывод.
Не подтверждайте план автоматически. Проверьте:
• затрагиваются ли только нужные файлы;
• сохраняется ли текущий стиль;
• не предлагается ли новая зависимость без необходимости;
• есть ли мобильная проверка;
• понятен ли результат для пользователя.
Выберите режим подтверждений
Qwen Code поддерживает approval modes. Названия и поведение нужно смотреть в текущей документации и интерфейсе /approval-mode. Для первой задачи используйте режим, в котором редактирование и команды не проходят бесконтрольно.
Режим plan подходит для исследования без изменений. auto оценивает действия и может давать больше автономности. yolo автоматически одобряет инструменты и подходит только для доверенной изолированной среды. Название не является шутливым предупреждением, а обозначает реальное снятие барьера.
Даже безопасная команда может иметь неожиданный эффект в неверной папке. Перед подтверждением смотрите:
• точную команду;
• текущую рабочую директорию;
• список изменяемых файлов;
• сетевой доступ;
• возможность отмены.
Разрешите одну ограниченную правку
После принятия плана дайте точное разрешение:
Реализуй только блок с тремя преимуществами в index.html и существующем файле стилей. Не добавляй зависимости и новые файлы. После изменения покажи diff и назови ручные проверки. Не выполняй commit.
Если агент просит изменить дополнительный файл, остановитесь и выясните причину. Расширение scope должно быть отдельным решением.
После завершения выйдите из интерфейса или откройте второй терминал и проверьте результат независимо:
Команды по порядку: git status и git diff.
Обычный git diff не показывает содержимое новых untracked-файлов. Сверьте их со статусом и прочитайте отдельно. Затем откройте страницу в браузере, измените ширину окна и проверьте ссылки и клавиатурную навигацию.
Добавляйте в staging только проверенные пути:
Команды по порядку: git add index.html styles.css и git diff --cached.
Коммит создавайте после чтения staged diff.
Как оценить выбранную модель
Не сравнивайте модели просьбой написать случайную функцию. Дайте одинаковую задачу из вашего проекта и сбросьте ветку к одному baseline. Для каждой модели запишите:
• правильно найденные файлы;
• число лишних изменений;
• результат тестов;
• количество уточнений;
• время до принятого diff;
• фактический расход по данным поставщика.
Более дорогая или крупная модель не всегда выгоднее на простой правке. Быстрая модель может хорошо искать и исправлять локальную ошибку, а сложный архитектурный план потребует более сильной. Переключайте модель по задаче, а не по статусу «лучшая».
Не смешивайте модель и CLI. Неудача может быть вызвана недостаточным контекстом, неправильным provider, устаревшей версией, широким запросом или разрешениями.
Устойчивые правила храните после успешного цикла
Qwen Code может использовать QWEN.md и совместимые инструкции проекта. Не создавайте большой файл до первой задачи. Сначала выясните реальные команды и ограничения.
Полезные правила:
• команда сборки;
• команда тестов;
• каталог, который нельзя менять;
• формат environment variables;
• требование остановиться перед миграцией или деплоем;
• ручная проверка для конкретного интерфейса.
Не записывайте ключи и временные детали. Каждое правило должно быть проверяемым. Если команда переехала, обновите инструкцию в том же pull request.
Типичные ошибки
Если авторизация не работает, сначала откройте /auth и проверьте выбранного provider. Если модель недоступна, сверьте model ID с каталогом поставщика и правами ключа. Ошибка лимита не исправляется переустановкой CLI.
Если агент не видит файлы, проверьте pwd или текущую директорию PowerShell. Если изменения слишком широкие, вернитесь к baseline и разбейте задачу. Если команда тестов падает, запустите ее самостоятельно и отделите ошибку окружения от ошибки кода.
При попадании секрета в файл или историю отзовите ключ. Удаление строки не устраняет уже раскрытый credential.
Проверьте границу между CLI и поставщиком модели
Открытый исходный код Qwen Code не означает, что содержимое запросов остается на компьютере. CLI передает контекст выбранному model provider. Если настроен OpenAI-compatible endpoint, данные уходят именно туда. При смене provider меняются условия обработки, цены, доступные модели и ограничения.
До работы с закрытым репозиторием выясните:
• какой endpoint фактически используется;
• какие файлы агент может прочитать;
• сохраняет ли поставщик запросы;
• разрешена ли обработка персональных данных;
• кто владеет API-ключом;
• как удалить или отозвать доступ.
Проверьте настройки на тестовом запросе без секретов. Не полагайтесь на отображаемое имя модели: посмотрите effective configuration и логи, если они доступны без раскрытия ключа.
Для командной работы не храните общий ключ в пользовательском settings.json каждого сотрудника. Используйте одобренный способ выдачи и ротации credentials. Ограничьте бюджет и права ключа на стороне provider. Если сотрудник покидает проект, его доступ должен отключаться отдельно от удаления Qwen Code.
Установленные extensions и MCP-серверы расширяют область данных и действий. Перед подключением прочитайте их код или документацию, зафиксируйте источник и версию и проверьте, какие инструменты они добавляют. Удобная интеграция не должна незаметно получить доступ к production.
Для первого сравнения отключите дополнительные extensions и MCP. Сначала получите понятный baseline на встроенных возможностях. Затем подключайте по одному компоненту и повторяйте тот же тест. Так можно отделить качество модели от ошибок интеграции.
Проверьте также бюджет у model provider. Ограничение расходов должно находиться на стороне учетной записи, а не только в обещании агенту «не тратить много». Для автоматических запросов назначьте отдельный ключ с минимальными правами и собственным лимитом.
На курсе «Вайбкодинг на максималках» терминальные агенты разбираются через один воспроизводимый маршрут: безопасная папка, read-only исследование, план, ограниченный diff, тест и Git-чекпойнт. Это позволяет менять модель, не теряя контроль над проектом.
Qwen Code CLI имеет смысл оценивать как оболочку для управляемой работы, а не как кнопку генерации. Установите один официальный вариант, явно выберите provider и модель, начните в маленьком репозитории и проверяйте каждое изменение независимо. После такого теста станет понятно, подходит ли инструмент вашему процессу.