Настройка Qwen Code: QWEN.md, субагенты и песочница избавляют от лишних трат токенов
Qwen Code после установки каждый раз заново изучает репозиторий и переспрашивает то, что можно сказать один раз, а вы платите за это токенами. Например, он не знает, что в проекте пакеты ставят через pnpm, а не npm, и каждый раз уточняет. Такие команды и запреты записывают в файл QWEN.md, который агент читает в начале сессии. Разбор для версии 0.28.0 показывает шесть настроек, после которых вопросов и расходов становится меньше.
AI-обработка оригинала Habr AI; редакция Hamidun News
Qwen Code после установки работает «как есть»: каждый раз заново изучает репозиторий, переспрашивает одно и то же и тратит токены на то, что можно было сказать один раз. Представьте, что в вашем проекте пакеты ставятся через pnpm, а не npm, а тесты запускаются особой командой. Агент этого не знает и каждую сессию либо спрашивает, либо угадывает.
Эти сведения записывают один раз в файл QWEN.md, то есть в постоянную памятку для проекта, которую агент читает в начале каждой сессии. Разбор проверен по документации Qwen Code версии 0.
28.0 (ноябрь 2026) и описывает шесть настроек: QWEN.md, правила, режимы подтверждений, MCP-серверы (внешние инструменты), субагенты (узкие помощники с урезанными правами) и песочницу (изоляцию команд агента).
Цель простая: чтобы агент меньше спрашивал, меньше тратил и не мог случайно навредить. Проект быстро меняется, поэтому при другой версии сверяйтесь с qwen --help.
Память и правила: сказать один раз
Настройки лежат в двух местах: ~/.qwen/settings.json действует для вас во всех проектах, а .qwen/settings.json в корне репозитория — только в этом проекте, и его можно коммитить, чтобы он был у всей команды. Ключи API туда класть не нужно: для них есть переменные окружения или пользовательские настройки.
QWEN.md — обычный Markdown-файл. Их может быть три, и загружаются все сразу: ~/.qwen/QWEN.md для вас во всех проектах, QWEN.md в корне для всей команды и .qwen/QWEN.local.md только для вас в этом проекте. Локальный файл грузится после общего, поэтому им можно дополнять или переопределять командные инструкции. В .gitignore его придётся добавить вручную. Если в репозитории уже есть AGENTS.md для других ИИ-инструментов, Qwen Code прочитает и его.
Быстрее всего начать с команды /init: она изучит код и создаст черновик с командами сборки и найденными соглашениями. Главное правило — коротко и конкретно. Документация предупреждает: чем длиннее файл, тем хуже модель ему следует. Фраза «используй отступ в 2 пробела в TypeScript» работает, «пиши код аккуратно» — нет. К тому же QWEN.md уходит в каждый запрос каждой сессии, так что каждая лишняя строка — это токены, за которые вы платите много раз.
Помимо файла есть автопамять: Qwen Code сам сохраняет заметки в ~/.qwen/projects/<проект>/memory/. Команда /remember запоминает сразу, /forget удаляет, /memory показывает загруженные файлы. Но автопамять работает «по возможности», поэтому обязательное пишите в QWEN.md.
Если файл разрастается, часть инструкций выносят в правила — Markdown-файлы в .qwen/rules/. У правила есть поле paths: например, 'src/*/.tsx'. Тогда инструкции про React попадут в контекст, только когда агент откроет подходящий файл. Пока он правит Makefile, они места не занимают. Правило без paths работает как QWEN.md. Проектные правила грузятся, только если вы доверяете папке (trusted folder).
Подтверждения, MCP и субагенты
Режимов подтверждений пять: Plan (только чтение), Ask Permissions (спрашивает и про правки, и про команды), Auto-Edit (файлы правит сам, команды с вашего согласия), Auto (решает классификатор) и YOLO (всё сам, только в изолированном окружении). Переключение — Shift+Tab (в Windows Tab) или /approval-mode. В свежих версиях по умолчанию стоит Auto: каждую команду, обращение к сети или вызов MCP-инструмента оценивает отдельная модель-классификатор. Это дополнительные запросы к API. Если быстрая модель не задана, используется основная, и каждая проверка стоит как полноценный запрос. Поэтому задайте дешёвую командой /model --fast или через "fastModel" в настройках либо переключитесь в Auto-Edit.
Точечные разрешения задаются в блоке permissions: allow выполняется без вопросов (например, git status и pnpm test), ask всегда спрашивает (git push), deny запрещает полностью (rm -rf и чтение .env). Файл .qwenignore, как и .agentignore или .aiignore, работает как .gitignore и экономит контекст, но секреты не защищает: учитывают его не все инструменты.
MCP (Model Context Protocol) — открытый стандарт для подключения баз данных, трекеров и документации. Сервер добавляется командой qwen mcp add; флаг --scope project сохранит его в настройках проекта. Для удалённых сервисов рекомендован транспорт http, для локальных программ и Docker — stdio, sse устарел. Описания инструментов тоже занимают контекст, поэтому подключайте только нужное и ограничивайте набор через includeTools или excludeTools.
Субагент — отдельный помощник со своими инструкциями, инструментами и контекстом. Он может прочитать сто файлов, а основной агент получит только итог. Файлы лежат в .qwen/agents/ (у проектных приоритет) или ~/.qwen/agents/. Ревьюер с model: fast и инструментами read_file, grep_search, glob и run_shell_command не может править код, потому что у него нет write_file и edit. Надёжное ограничение — список tools, а не approvalMode: при основной сессии в YOLO субагент с plan всё равно окажется в YOLO.
Песочница: что агент сможет, даже не спросив
Режимы решают, спросит ли агент, а песочница — что он сможет сделать, даже если не спросил. Если вы хоть иногда работаете в Auto или YOLO, она нужна. В последних версиях для Linux появился режим, где сам Qwen Code работает как обычно, а команды и файловые операции агента выполняются в изоляции через bwrap (Bubblewrap).
Начните с /init, сократите QWEN.md, вынесите частные инструкции в правила, задайте /model --fast, разнесите команды по allow и deny, создайте ревьюера только для чтения и включите песочницу.
- 18 нояб. 2026 г.AWS выпустила SMART: WhatsApp-агента на AgentCore поднимают одной командой
- 18 нояб. 2026 г.ИИ ищет неизвестные уязвимости в V8 за $4,24 и 13 минут, а в феврале не нашёл за $350
- 18 нояб. 2026 г.Поиск «Мира Квестов» разбирает живой текст: 37% поисков доходят до карточки квеста
- 18 нояб. 2026 г.12 сервисов с готовым дизайном избавят ИИ-сайты от слопа: бесплатно или от $6 в месяц
Вопросы и ответы по материалу
Что известно по теме: память и правила: сказать один раз?
Настройки лежат в двух местах: ~/.qwen/settings.json действует для вас во всех проектах, а .qwen/settings.json в корне репозитория — только в этом проекте, и его можно коммитить, чтобы он был у всей команды. Ключи API туда класть не нужно: для них есть переменные окружения или пользовательские настройки. QWEN.md — обычный Markdown-файл. Их может быть три, и загружаются все сразу: ~/.qwen/QWEN.md для вас во всех проектах, QWEN.md в корне для всей команды и .qwen/QWEN.local.md только для вас в этом проекте.
Что известно по теме: подтверждения, MCP и субагенты?
Режимов подтверждений пять: Plan (только чтение), Ask Permissions (спрашивает и про правки, и про команды), Auto-Edit (файлы правит сам, команды с вашего согласия), Auto (решает классификатор) и YOLO (всё сам, только в изолированном окружении). Переключение — Shift+Tab (в Windows Tab) или /approval-mode. В свежих версиях по умолчанию стоит Auto: каждую команду, обращение к сети или вызов MCP-инструмента оценивает отдельная модель-классификатор. Это дополнительные запросы к API.
Что известно по теме: песочница: что агент сможет, даже не спросив?
Режимы решают, спросит ли агент, а песочница — что он сможет сделать, даже если не спросил. Если вы хоть иногда работаете в Auto или YOLO, она нужна. В последних версиях для Linux появился режим, где сам Qwen Code работает как обычно, а команды и файловые операции агента выполняются в изоляции через bwrap (Bubblewrap). Начните с /init, сократите QWEN.md, вынесите частные инструкции в правила, задайте /model --fast, разнесите команды по allow и deny, создайте ревьюера только для чтения и включите песочницу.
Соберите рабочего ИИ-агента или сервис своими руками без ручного кода
В Академии Жемала Хамидуна (academy.hamidun.com) открыт бесплатный 72-часовой тест-драйв: интерактивные скетч-уроки по Claude Code и Cursor, живой Tech Radar и готовые шаблоны агентов.
Главное из мира ИИ — раз в неделю
7 ключевых событий недели, отобранных вручную. Без шума, репостов и пресс-релизов.
Готово! Проверьте почту — мы отправили подтверждение.