Игорь Градов
Игорь Градов
5 мин
ai

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

Qwen Code после установки каждый раз заново изучает репозиторий и тратит оплачиваемые запросы на одно и то же, поэтому разбираем настройку под проект по документации версии 0.28.0 из ноября 2026 года.

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

Результат такой: агент меньше спрашивает, расходует меньше токенов (кусочков текста, за которые провайдер берёт плату) и не может случайно навредить проекту. Подключение к своему ключу и OpenAI-совместимому провайдеру мы разбирали в прошлом материале, здесь следующий шаг.

Почему это важно

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

Документация Qwen Code перечисляет шесть зон настройки: файл QWEN.md, правила, режимы подтверждений и разрешения, MCP-серверы (подключаемые внешние инструменты), субагенты (узкие помощники со своими инструкциями и урезанными правами) и песочница, которая не выпускает команды агента за пределы проекта. Ниже разобраны первые три зоны, они дают главную экономию.

Проект обновляется быстро. Если у вас не версия 0.28.0, сверяйтесь с командой qwen --help и документацией в репозитории.

Что понадобится?

  • Установленный Qwen Code, подключённый к провайдеру.
  • Ключ API (личный пароль доступа к модели). Храните его в переменных окружения или пользовательских настройках, а не в настройках проекта.
  • Ваш проект в Git.
  • Около получаса на первый проход.

Настройки проекта можно коммитить, тогда их получит вся команда. Поэтому ключи туда класть нельзя.

Как настроить Qwen Code под проект за пять шагов?

  1. Создайте черновик QWEN.md. Это обычный Markdown-файл, его Qwen Code читает в начале каждой сессии. Команда /init изучит код и соберёт черновик с командами сборки и найденными соглашениями. Если файл уже есть, она предложит дополнения, а не перезапишет его.

  2. Сократите QWEN.md до конкретики. Документация прямо предупреждает: чем длиннее файл, тем хуже модель ему следует. Фраза «Используй отступ в 2 пробела в TypeScript» работает, «пиши код аккуратно» нет. Другие файлы подключайте через @путь/к/файлу, пути считаются от самого QWEN.md. Если в репозитории уже лежит AGENTS.md для других ИИ-инструментов, Qwen Code прочитает и его, дублировать не нужно.

  3. Вынесите частные инструкции в правила. Правило это Markdown-файл в папке .qwen/rules/ с полем paths:. Оно попадает в контекст, только когда агент открывает подходящий файл. Пока агент правит Makefile, инструкции про React место не занимают, а при открытии .tsx правило подгружается до конца сессии. Личные правила из ~/.qwen/rules/ грузятся всегда, проектные только если вы доверяете папке (trusted folder).

  4. Выберите режим подтверждений. Режимов пять, переключаются клавишами Shift+Tab (в Windows клавишей Tab) или командой /approval-mode. Закрепить режим можно так:

/approval-mode plan --project
/plan
/plan exit

Если работаете в Auto, задайте дешёвую быструю модель командой /model --fast или параметром fastModel в настройках. Нужна предсказуемость? Режим Auto-Edit правит файлы без вопросов, а команды выполняет только после вашего «да».

  1. Добавьте точечные разрешения. В файле settings.json или интерактивно командой /permissions задаются три списка: allow выполняется без вопросов, ask спрашивает всегда, даже в разрешительных режимах, deny запрещён полностью. Пример из документации: разрешить Bash(git status) и Bash(pnpm test ), спрашивать на Bash(git push ), запретить Bash(rm -rf *) и чтение .env.
Как это применить

Пример QWEN.md из документации для проекта «API заказов»:

# Проект: API заказов
Обзор проекта: @README.md
## Команды
- Установка зависимостей: pnpm install (не npm)
- Тесты: pnpm test
- Линтер перед коммитом: pnpm lint --fix
## Нельзя
- Трогать src/legacy/ без явной просьбы
- Коммитить и пушить без моего подтверждения

Итог: агент не путает менеджер пакетов, не лезет в старый код и не отправляет изменения без спроса. Для разовых предпочтений есть автопамять: команда /remember всегда использовать snake_case в Python записывает правило сразу, /forget удаляет, /memory показывает загруженные файлы.

Частые ошибки
  • Раздутый QWEN.md. Файл уходит в каждый запрос каждой сессии, так что каждую лишнюю строку вы оплачиваете много раз.
  • Ставка на автопамять. Она работает «по возможности», всё обязательное пишите в QWEN.md.
  • Забытый .gitignore. Локальный файл инструкций загружается после общего и может его переопределять, но в .gitignore его придётся добавить вручную.
  • Auto без быстрой модели. Без неё каждая проверка классификатора стоит как полноценный запрос к основной модели.
  • Ключ API в настройках проекта, которые уходят в общий репозиторий.

Что делать с этим прямо сейчас, по ролям

Автору Дзена, который ведёт сайт или телеграм-бота с помощью ИИ-агента: заведите короткий QWEN.md с запретами вроде «не пушить без подтверждения». Это страховка от случайной поломки.

Маркетологу, который считает бюджет на нейросети: проверьте режим. Auto без быстрой модели незаметно удваивает число запросов, а значит и счёт.

Предпринимателю из РФ и СНГ: о доступности сервисов в России источник не сообщает. Qwen Code работает с OpenAI-совместимым провайдером по вашему ключу, так что выбирайте провайдера, которым можете стабильно платить.

Совет редакции dzen.guru

Я бы начал с одного дня в режиме Plan: смотрите, что агент собирается делать, и по ходу дописывайте запреты в QWEN.md. Через неделю файл сам сложится из реальных ошибок, а не из фантазий. Честная оговорка: настройки снижают риск, но не отменяют его. Команду deny для удаления файлов я поставил бы в первый же день, даже если вы доверяете модели.

Хотите, чтобы ИИ работал на ваш канал?

В dzen.guru разбираем инструменты, которые экономят авторам часы и деньги. Начните с подборки практических гайдов.

Смотреть гайды

Пять минут на QWEN.md сегодня избавят от сотни одинаковых вопросов агента и лишних строк в счёте завтра.

Поделиться:TelegramVK
Игорь Градов
Игорь Градов

Основатель dzen.guru. Эксперт по монетизации и продвижению на Дзен. Автор курса «Старт на Дзен 2026».

Комментарии

Читайте также

Рекомендательные системы не измеряют вкусы, а назначают ценности: три метрики, три ленты
ai

Рекомендательные системы не измеряют вкусы, а назначают ценности: три метрики, три ленты

Автор цикла «Человек в мире современных технологий» в новой статье утверждает, что метрика рекомендательной ленты не измеряет вкусы читателей, а назначает им…

5 мин
Тест вместо промпта: разработчик МТС показал, что такое ИИ-агент с автопроверкой кода
ai

Тест вместо промпта: разработчик МТС показал, что такое ИИ-агент с автопроверкой кода

Go-разработчик МТС Web Services Егор Гурин предложил писать тесты до кода и отдавать их ИИ-агенту вместо словесного промпта, пока часть пользователей…

5 мин
Языки программирования дошли до вайбкодинга: ИИ пишет код, но не гарантирует надёжность
ai

Языки программирования дошли до вайбкодинга: ИИ пишет код, но не гарантирует надёжность

Генеративный ИИ способен писать почти весь код, но к осени 2026 года регулярные находки ошибок показали, что написать программу и убедиться в её правильности…

5 мин