7 октября 2026 г.

Qwen Code CLI: как установить агента для программирования и подключить инструменты

Андрей Присекин
Автор

Андрей Присекин

Создаю AI-агентов, автоматизирую бизнес-процессы

Qwen Code CLI - агент для программирования в терминале: он читает проект, предлагает изменения и может вызывать инструменты. Чтобы начать, установи CLI, открой каталог репозитория, выполни qwen, выбери провайдера модели и дай небольшую задачу. MCP подключай потом, по одному серверу; перед доступом к чужим сервисам проверь разрешения и результат первой команды.

Название обманывает: чат Qwen и Qwen Code - разные сценарии. Чат помогает ответить на вопрос, а CLI действует в каталоге с кодом. Если нужен обзор самой нейросети, у меня есть материал про Qwen от Alibaba. Здесь разберём установку агента, его рабочий цикл и внешний инструмент, который он сможет вызвать.

Что именно устанавливается и какой доступ нужен

По официальному описанию Qwen Code, это программа для терминала. Запускаешь её из папки проекта, пишешь задачу обычным языком, агент читает нужные файлы и предлагает правку. Он может обратиться к модели через Alibaba ModelStudio, другого встроенного провайдера или совместимый сервер. Без настроенного провайдера установка CLI сама по себе код не исправит.

Мне нравится начинать с вопроса «где здесь точка входа и какой тест проверяет вход пользователя?». На это не требуется запись в файлы. Так сразу видно, видит ли агент правильный репозиторий, и насколько осмысленно он выбирает контекст. Если начинает уверенно описывать несуществующие модули, не давай ему более широких прав.

Для первой пробы хватит тестового проекта с Git и нескольких минут на проверку diff. Для npm-установки нужен Node.js версии 22 или новее; у официального автономного установщика свой комплект и свой способ обновления. Ставить CLI поверх работающего проекта не обязательно - устанавливается программа, а запускать её можно уже в нужном каталоге.

Как установить Qwen Code CLI на Windows, macOS и Linux

В актуальном quickstart есть автономный установщик и ручной путь через npm. Я покажу npm: команда одинаковая для трёх систем, а исход установки легко проверить. Автономный установщик тоже существует, но запускать скачанный скрипт через конвейер без просмотра я бы не стал.

  1. Установи Node.js 22+ с официального сайта Node.js. Открой новый терминал и выполни node --version и npm --version. Первая команда должна показать версию не ниже 22, вторая - версию npm.
  2. На Windows открой PowerShell; на macOS/Linux - обычный терминал. Выполни npm install -g @qwen-code/qwen-code@latest. Не запускай команду из-под администратора только ради обхода ошибок доступа: лучше поправить каталог глобальных пакетов в своей учётной записи.
  3. Проверь qwen --version. Если терминал отвечает «command not found», закрой и открой его снова. Потом сверь, попала ли папка глобальных бинарников npm в PATH; официальная инструкция по установке отдельно разбирает этот случай.
  4. Перейди в тестовый репозиторий: cd /path/to/your/project (замени путь своим). Выполни git status --short, чтобы заранее увидеть чужие незавершённые правки. Затем введи qwen.
  5. На первом запуске выбери способ авторизации. Внутри сессии команда /auth снова откроет выбор провайдера, /doctor поможет проверить конфигурацию, а /help покажет команды. Не вставляй API-ключ в текст задачи или файл проекта.

Путь первого запуска Qwen Code: Node.js, CLI, провайдер и проверка репозитория

Как выбрать модель и не спутать CLI с бесплатным API

На экране авторизации документация Qwen Code предлагает Alibaba ModelStudio (план или API-ключ), сторонних провайдеров с ключом и собственный совместимый сервер. Доступные модели, цены и география зависят от выбранного поставщика. Не буду обещать, что запросы бесплатны, если сам исполняемый файл открыт для установки.

Особенно важная поправка к старым гайдам: бесплатный вход через Qwen OAuth прекращён 15 апреля 2026 года. Если инструкция советует просто войти через этот OAuth и работать без счёта, она устарела. Перед подключением загляни в условия своего провайдера: подписка на чат, план для кодинга и оплата API-запросов могут быть разными продуктами.

Я бы для знакомства выбрал провайдера, у которого можно увидеть расход и ограничить бюджет, а затем проверил одну маленькую задачу. Локальный или совместимый сервер тоже возможен, но его адрес и способность выбранной модели работать с инструментами придётся настроить самому. Не стоит приписывать Qwen Code конкретную модель по умолчанию: она зависит от текущей настройки.

Первая задача: что попросить и что проверить

Дай агенту задачу с наблюдаемым результатом: «Найди функцию, которая парсит CSV. Объясни, как обрабатывается пустая строка; ничего не меняй». Если путь к проекту верный и ответ ссылается на реальные файлы, можно перейти к правке: «Добавь тест для пустой строки, исправь только обработку этого случая и запусти тест модуля». Так ты увидишь и поведение агента, и точный объём изменений.

Перед подтверждением каждой команды посмотри, что она затронет. npm install, миграция базы и скрипт из незнакомого репозитория требуют другого уровня доверия, чем чтение файла. Режимы разрешений Qwen Code позволяют начать с plan (анализ без записи) или default (подтверждение правок и команд). yolo подтверждает действия автоматически, для первого знакомства он мне не нужен.

После ответа снова запусти git status --short, посмотри git diff и выполни проверочный тест сам. Если теста нет, хотя бы открой изменённую функцию и проверь крайние случаи. Обещание агента «исправлено» - текст; результат в репозитории - факт. На похожем разрыве между зелёной галочкой и реальным исправлением уже попались агенты в тестовом эксперименте.

Как подключить инструменты Qwen Code через MCP

MCP даёт агенту доступ к внешним инструментам: например, к локальному сервису документации или вашему внутреннему API. Это отдельное соединение, а не магическое свойство модели. Официальный справочник MCP описывает три варианта транспорта: stdio для локального процесса, http для удалённого сервера и устаревающий sse для совместимости.

Для тестового локального HTTP-сервера, который ты контролируешь и уже запустил по адресу http://localhost:3000/mcp, шаги такие:

  1. В терминале выполни qwen mcp add --scope project --transport http docs-local http://localhost:3000/mcp. Адрес здесь пример, не публичный готовый сервер: подставь URL своего реального MCP. --scope project записывает настройку в .qwen/settings.json текущего репозитория. Не коммить туда секреты.
  2. Перезапусти Qwen Code в этом же проекте. В сессии открой /mcp и проверь, появился ли docs-local и какие инструменты он показывает.
  3. Попроси агента вызвать один безвредный инструмент чтения и посмотри результат. Если он предлагает запись в базу или сеть вместо чтения документации, остановись и проверь конфигурацию сервера и подтверждения вызовов.

Схема MCP для Qwen Code: агент, подключённый сервер и доступные действия

В документации есть и qwen mcp add для локального процесса, и прямое редактирование mcpServers в settings.json. Не копируй чужой конфиг с ключами в общий репозиторий. Если сервер не появился после добавления, сначала проверь область настройки (проектная или пользовательская), затем перезапусти сессию. Подробно о том, что такое MCP как протокол, у меня есть отдельный материал; здесь важен рабочий и безопасный первый вызов.

Где Qwen Code полезен и когда взять другой инструмент

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

Если хочется оставаться внутри VS Code с панелью действий, посмотри гайд по Cline. Если нужен именно Qwen Code, не путай его с чат-приложением Qwen, моделью Qwen Coder или другими агентами: интерфейсы и доступ к инструментам у них различаются. CLI не исправит неверное ТЗ и не решит за тебя, какие файлы безопасно отправлять выбранному провайдеру.

Мой порядок на рабочем репозитории такой: сначала вопрос только на чтение, потом одна правка с тестом, потом один MCP-сервер с минимальными правами. Если на любом шаге не можешь объяснить, что агент прочитал и что запустил, вернись на шаг назад. Время, сэкономленное на коде, не стоит потерянного контроля над проектом.

Источники

← Все статьи