Qwen Code — терминальный агент, который работает с проектом целиком: читает файлы, вносит правки, запускает команды. Разбираем установку, настройку ключа для доступа из России и приёмы, которые экономят баланс.
Запросы «qwen cli», «qwen code cli», «qwen агент» показывают, что интерес сместился от чата к агентам. Причина понятна: агент не подсказывает строку, а выполняет задачу.
Что такое Qwen Code CLI
Это агент командной строки на моделях Qwen Coder. Ему дают доступ к каталогу проекта и формулируют задачу словами — дальше он сам решает, какие файлы открыть, что изменить и как проверить результат.
Отличие от плагина в редакторе принципиальное: плагин видит открытый файл, агент — весь репозиторий. Поэтому задачи вида «вынеси работу с БД в отдельный слой» для него нормальны.
Установка
Агент ставится через npm или установочный скрипт и работает на Windows, macOS и Linux. Node.js должен быть установлен заранее. После установки команда доступна в любой консоли — в том числе во встроенном терминале вашей IDE.
Если установочный скрипт не скачивается, дело обычно в домене, а не в вашей системе: часть зарубежных адресов не отвечает на российские запросы. Помогает установка через пакетный менеджер.
Ключ и доступ из России
Сам агент работает локально, упирается только модель. Прямая регистрация в зарубежном сервисе с российскими данными обычно не проходит, а карта РФ не принимается.
Решение — ключ от сервиса доступа, работающего по официальному API. Формат запросов совместимый, поэтому агент не отличает такой ключ от оригинального:
- Зарегистрируйтесь в LeanTech AI по email.
- Создайте ключ в личном кабинете.
- Пропишите адрес совместимого API и ключ в конфигурации агента или в переменной окружения.
- Запустите агента и дайте небольшую задачу для проверки.
Как ставить задачи
- Ограничивайте область. «Почини падающий тест в tests/api, схему БД не трогай» — предсказуемо. «Улучши код» — нет.
- Начинайте с модуля, а не с корня репозитория. Так резко падает количество сюрпризов в дифе.
- Смотрите диф всегда. Особенно в файлах, которых задача не касалась.
- Правьте точечно. Уточнение дешевле полного перезапуска: агент не перечитывает весь контекст заново.
Запуск в CI
Агент вызывается из пайплайна как обычная утилита: задача передаётся параметром, ключ — переменной окружения. Типичные сценарии — автоматическое исправление упавших тестов, генерация changelog, проверка стиля кода.
Осторожность та же, что и локально: в автоматическом режиме диф никто не смотрит, поэтому давайте агенту узкие задачи и обязательно прогоняйте тесты после.
Какую модель выбрать под агента — разбираем в отдельной статье.
Частые вопросы
Нужен ли Node.js?
Да, для установки через npm. На ваше виртуальное окружение Python или другой стек это не влияет — агент живёт отдельно.
Можно ли запускать агента внутри IDE?
Да, во встроенном терминале — он стартует в корне проекта и видит нужную структуру файлов.
Сколько стоит работа агента?
Дороже чата: агент читает файлы и перечитывает результат. Зато доводит задачу до конца, а не выдаёт черновик.