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

Обычно вопрос «как заставить Qwen работать прямо в консоли и писать код самостоятельно?» возникает после неудачного первого опыта: пользователь установил Qwen Code, задал вопрос, получил текст с фрагментом кода и вынужден переносить его в проект вручную. Ожидался агент, который сам работает с файлами, а получился обычный чат.

На деле Qwen Code — полноценный агент: он открывает и изменяет файлы, а также запускает команды. Поведение зависит от режима: Ask Permissions требует подтверждений, Auto-Edit и Auto допускают больше самостоятельности. Проверяйте строку статуса: название Default не доказывает выбор новой установки. Ниже описаны установка, запуск из каталога проекта, настройка модели после изменений в апреле 2026 года и переход к самостоятельному редактированию. Информация проверена 30 августа 2026 года по официальной документации Qwen.

Материалы о моделях и агентах: документация Ailoot.

Что означает «Qwen Code сам пишет код»?#

Отличие легко заметить. Браузерный чат отвечает текстом. Пользователь читает ответ, копирует код, вставляет его в файл, запускает программу, находит ошибку и передаёт её обратно в чат. Все действия между диалогом и проектом выполняет сам человек.

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

Поэтому фраза «Qwen не пишет код сам» обычно указывает на одну из двух причин: открыт браузерный чат вместо терминального агента либо агент запущен в режиме, где он запрашивает разрешение перед каждой правкой. Установка Qwen Code решает первую проблему, а выбор другого режима — вторую. Оба случая рассмотрены ниже.

Как установить Qwen Code в терминал?#

Быстрее всего воспользоваться официальным установщиком: он сам выбирает подходящий вариант для системы.

В macOS и Linux откройте терминал и выполните команду:

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, если он уже установлен. Понадобится Node.js версии 22 или новее:

npm install -g @qwen-code/qwen-code@latest

После установки перезапустите терминал. Установщик добавляет команду qwen в системные пути, но открытая до этого перезапуска консоль может её не обнаружить. Это частая причина сообщения о том, что команда не найдена. Убедиться, что установка прошла успешно, можно так:

qwen --version

Если команда вывела номер версии, агент установлен и готов к запуску в проекте.

Как запустить Qwen Code в своём проекте?#

Сначала перейдите в каталог с кодом. Это важно: агент работает с тем каталогом, из которого запущен, и получает доступ к его содержимому.

cd путь-к-твоему-проекту
qwen

Интерфейс агента появится прямо в терминале. При первом запуске потребуется подключить модель — этот шаг описан в следующем разделе. После этого можно проверить, что агент видит проект, например, такой просьбой:

что делает этот проект?

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

Есть и запуск без интерактивного интерфейса — одной командой. Такой вариант подходит для скриптов и автоматизированных задач:

qwen -p "перечитай README и обнови список команд"

Команда выполняет задачу и завершает работу, не открывая диалог. Для первого знакомства этот способ не нужен, но он пригодится позднее.

Почему агент запущен, но ничего не делает сам?#

Первое возможное препятствие — доступ к модели. Раньше Qwen Code позволял войти через аккаунт qwen.ai и пользоваться агентом без привязки карты. Этот способ авторизации назывался Qwen OAuth, но его закрыли. В документации по авторизации указано, что бесплатный тариф Qwen OAuth отменили 15 апреля 2026 года. Сохранённые ранее данные входа ещё могли некоторое время действовать, однако новые запросы сервер отклоняет. Возможность войти через qwen.ai убрали и из меню.

Чтобы агент мог обрабатывать задачи, необходимо настроить доступ к модели. Доступные варианты — платные и локальный бесплатный — описаны в следующем разделе.

Если модель подключена, агент показывает правки и ждёт, проверьте режим. Это ожидаемо для Ask Permissions с подтверждением изменений и команд, а не признак универсального режима новой установки. Для самостоятельной работы выберите режим явно.

Как подключить модель после отключения бесплатного входа?#

В интерфейсе агента введите:

/auth

Появится меню с тремя основными вариантами. Рассмотрим каждый.

Alibaba ModelStudio — официальный способ подключения от разработчиков Qwen. Он включает Coding Plan с фиксированной оплатой и недельной квотой для индивидуального разработчика, Token Plan с оплатой по использованию для команд, а также подключение уже созданного ключа ModelStudio. Это платный доступ к моделям Qwen.

Сторонние провайдеры — это встроенный выбор поставщика с подключением по ключу. В официальном перечне указаны DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope и другие. Получите ключ у выбранного провайдера и укажите его, чтобы агент мог обращаться к его модели.

Custom Provider предназначен для собственного сервера, прокси или локальной модели. Например, через этот вариант подключается модель, запущенная на компьютере с помощью Ollama. Поддерживаются форматы OpenAI, Anthropic и Gemini, поэтому такой способ совместим со многими вариантами доступа.

Ключ и параметры можно задать вручную в файле ~/.qwen/settings.json. Поле modelProviders описывает доступные модели, env содержит ключи, security.auth.selectedType задаёт протокол для запуска, а model.name — модель по умолчанию. Тогда при запуске qwen настройки будут прочитаны из файла и вводить их заново не понадобится. Для первого раза удобнее меню /auth; к файлу можно вернуться, когда потребуется сохранить параметры.

О том, какие бесплатные возможности остались после апреля, читайте в материале о бесплатном Qwen Code.

Какой режим выбрать, чтобы агент самостоятельно редактировал код?#

Самостоятельность агента определяется режимом доступа. Всего предусмотрено пять вариантов — от наиболее осторожного до наиболее свободного.

Если агент только описывает предполагаемые правки и ждёт, вероятно, выбран режим Ask Permissions. В старых версиях он назывался Default. В этом режиме нужно вручную подтверждать каждое изменение и выполнение команды, поэтому может казаться, что агент бездействует.

Чтобы разрешить самостоятельное редактирование файлов, переключитесь в Auto-Edit. Правки будут применяться без запроса, но перед запуском команд агент продолжит просить подтверждение. Это помогает избежать случайного выполнения, например, rm не в том каталоге.

Auto использует внутреннюю оценку действий. Выбирайте его явно после проверки версии и статуса. Сохранённое имя default для Ask Permissions нужно для совместимости и не доказывает стартовый режим.

YOLO — наиболее свободный режим. Агент без запросов редактирует файлы и выполняет команды. Согласно документации, он предназначен для доверенных личных проектов и автоматизированных сценариев. При работе над проектом можно получить нежелательный результат, поэтому включайте его осознанно и по возможности используйте копию.

Как переключать режим во время работы?#

Режим меняется прямо во время работы. Нажмите Shift+Tab, чтобы перейти к следующему варианту. В Windows ту же функцию выполняет обычная клавиша Tab. Переключение идёт по кругу: Plan, подтверждения, автоматическое редактирование, Auto, YOLO и снова Plan.

Текущий режим отображается в строке состояния в нижней части интерфейса. Проверяйте его перед тем, как поручать агенту большую задачу: так вы не запустите YOLO, когда хотели только посмотреть план.

Новичку удобно придерживаться такой последовательности:

1. Запустите агента в режиме Plan и попросите изучить задачу и предложить план. В этом режиме он только читает код и описывает предполагаемые действия.
2. Ознакомьтесь с планом. Если он вас устраивает, нажмите Shift+Tab, чтобы выбрать Auto-Edit или Auto.
3. Поручите агенту выполнить задачу. Теперь он сможет сам редактировать файлы, а вы — наблюдать за результатом.

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

Локальная модель без банковской карты#

Установите открытую модель на компьютер через Ollama или vLLM, затем в меню /auth добавьте её как Custom Provider. После этого агент будет обращаться к модели на вашем устройстве, а не к облаку Alibaba. Банковская карта и ключи не нужны, ограничений по количеству запросов нет. Открытые модели, подходящие для программирования, рассматриваются в обзоре бесплатных моделей для кода.

Для локальной работы нужно подходящее оборудование. Модель, способная уверенно писать код, требует большого объёма видеопамяти. На игровом компьютере с мощной видеокартой такой запуск может быть практичным. На обычном ноутбуке модель может не поместиться в память или будет слишком медленно отвечать.

Ещё одно преимущество локального запуска — конфиденциальность: код остаётся на компьютере и не передаётся на внешний сервер. Для проекта с чувствительными данными это может быть важнее экономии на подписке.

Как защитить проект от неудачных изменений агента?#

Самостоятельность агента полезна, когда результат соответствует задаче. Несколько простых привычек помогут ограничить последствия ошибки.

Первая — git. Если проект находится под контролем версий, можно просмотреть каждое изменение и отменить его. Без git исправить последствия неудачной правки сложнее; с системой контроля версий возврат к предыдущему состоянию выполняется короткой командой.

Вторая — начинать с режима Plan. Перед большой задачей попросите агента составить план в режиме, который не позволяет ему менять файлы. Ознакомьтесь с его предложениями и лишь затем разрешите редактирование.

Третья — аккуратно пользоваться YOLO. В этом режиме агент самостоятельно запускает команды, в том числе команды удаления файлов. Не применяйте его в основном рабочем проекте. Используйте YOLO для копий и небольших задач, где возможную ошибку можно легко исправить.

Эти меры помогают справиться с опасением, что самостоятельные изменения повредят проект. В отдельном разборе отмены правок при вайб-кодинге рассматривается Claude Code, но принцип работы с git применим и здесь.

С чего начать?#

Порядок действий такой:

1. Установите Qwen Code одной командой и перезапустите терминал.
2. Перейдите в каталог проекта через cd и запустите qwen.
3. Настройте модель через /auth: выберите платный вариант или локальную модель через Ollama, если платный доступ недоступен.
4. Опишите задачу в режиме Plan и ознакомьтесь с планом агента.
5. Нажмите Shift+Tab, выберите Auto-Edit или Auto и поручите агенту работу.
6. Используйте git, чтобы при необходимости отменить изменения.

Если агент не пишет код самостоятельно, обычно нужно проверить подключение модели и режим работы. Настройте модель через /auth, а для автоматического редактирования нажмите Shift+Tab и выберите Auto-Edit. После этого агент сможет работать непосредственно в терминале.

Чтобы сравнить Qwen с другими агентами для разных задач, ознакомьтесь с обзором аналогов Claude Code: в нём сопоставлены разные инструменты и области их применения.

Больше материалов и инструментов: Ailoot.