Skip to Content
Руководство для пользователейВозможностиКоманды

Команды

В этом документе описаны все команды, поддерживаемые Qwen Code. Они помогут эффективно управлять сессиями, настраивать интерфейс и контролировать поведение инструмента.

Команды Qwen Code вызываются с помощью специальных префиксов и делятся на три категории:

Тип префиксаОписание функцииТипичный сценарий использования
Слэш-команды (/)Управление самим Qwen Code на мета-уровнеУправление сессиями, изменение настроек, получение справки
Команды с @Быстрая вставка содержимого локальных файлов в диалогПозволяет ИИ анализировать указанные файлы или код в директориях
Команды с !Прямое взаимодействие с системным ShellВыполнение системных команд, таких как git status, ls и т.д.

1. Слэш-команды (/)

Слэш-команды используются для управления сессиями Qwen Code, интерфейсом и базовым поведением.

1.1 Управление сессиями и проектами

Эти команды помогают сохранять, восстанавливать и обобщать прогресс работы.

КомандаОписаниеПримеры использования
/initАнализирует текущую директорию и создает файл начального контекста/init
/summaryГенерирует краткое описание проекта на основе истории диалога/summary
/compressЗаменяет историю чата кратким содержанием для экономии токенов/compress
/resumeВозобновляет предыдущую сессию диалога/resume
/recapГенерирует однострочную сводку текущей сессии/recap
/restoreВосстанавливает файлы до состояния до выполнения инструментов/restore (список) или /restore <ID>

1.2 Управление интерфейсом и рабочим пространством

Команды для настройки внешнего вида интерфейса и рабочей среды.

КомандаОписаниеПримеры использования
/clearОчищает содержимое терминала/clear (горячая клавиша: Ctrl+L)
/contextПоказывает разбивку использования окна контекста/context
detailПоказывает разбивку использования контекста по элементам/context detail
/themeИзменяет визуальную тему Qwen Code/theme
/vimВключает/выключает режим редактирования Vim в поле ввода/vim
/directoryУправляет рабочим пространством с поддержкой нескольких директорий/dir add ./src,./tests
/editorОткрывает диалог выбора поддерживаемого редактора/editor

1.3 Настройки языка

Команды для управления языком интерфейса и вывода.

КомандаОписаниеПримеры использования
/languageПросмотр или изменение настроек языка/language
ui [language]Установка языка интерфейса/language ui zh-CN
output [language]Установка языка вывода LLM/language output Chinese
  • Доступные встроенные языки интерфейса: zh-CN (упрощенный китайский), en-US (английский), ru-RU (русский), de-DE (немецкий)
  • Примеры языков вывода: Chinese, English, Japanese и т.д.

1.4 Управление инструментами и моделями

Команды для управления ИИ-инструментами и моделями.

КомандаОписаниеПримеры использования
/mcpСписок настроенных MCP-серверов и инструментов/mcp, /mcp desc
/toolsОтображает список доступных в данный момент инструментов/tools, /tools desc
/skillsСписок и запуск доступных навыков (skills)/skills, /skills <name>
/planПереключение в режим планирования или выход из него/plan, /plan <task>, /plan exit
/approval-modeИзменение режима подтверждения для использования инструментов/approval-mode <mode (auto-edit)> --project
planТолько анализ, без выполненияБезопасный просмотр
defaultТребует подтверждения для измененийЕжедневное использование
auto-editАвтоматическое подтверждение измененийДоверенное окружение
yoloАвтоматическое подтверждение всегоБыстрое прототипирование
/modelПереключение модели, используемой в текущей сессии/model
/model --fastУстановка облегченной модели для подсказок/model --fast qwen3-coder-flash
/extensionsСписок всех активных расширений в текущей сессии/extensions
/memoryОткрывает диалог управления памятью (Memory Manager)/memory
/rememberСохраняет долговременную запись в памяти/remember Prefer terse responses
/forgetУдаляет совпадающие записи из автоматической памяти/forget <query>
/dreamРучной запуск консолидации автоматической памяти/dream

1.5 Встроенные навыки (Skills)

Эти команды вызывают встроенные навыки, предоставляющие специализированные рабочие процессы.

КомандаОписаниеПримеры использования
/reviewПроверка изменений кода с помощью 5 параллельных агентов + детерминированный анализ/review, /review 123, /review 123 --comment
/loopЗапуск промпта по расписанию/loop 5m check the build
/qc-helperОтветы на вопросы по использованию и настройке Qwen Code/qc-helper how do I configure MCP?

Полную документацию по /review см. в разделе Code Review.

1.6 Побочный вопрос (/btw)

Команда /btw позволяет задавать быстрые побочные вопросы, не прерывая и не влияя на основной поток диалога.

КомандаОписание
/btw <your question>Задать быстрый побочный вопрос
?btw <your question>Альтернативный синтаксис

Как это работает:

  • Побочный вопрос отправляется отдельным API-запросом с учетом недавнего контекста диалога (до последних 20 сообщений)
  • Ответ отображается над Composer — вы можете продолжать печатать в ожидании
  • Основной диалог не блокируется — он продолжается независимо
  • Ответ на побочный вопрос не попадает в историю основного диалога
  • Ответы отображаются с полной поддержкой Markdown (блоки кода, списки, таблицы и т.д.)

Горячие клавиши (интерактивный режим):

Горячая клавишаДействие
EscapeОтмена (во время загрузки) или закрытие (после)
Space или EnterЗакрыть ответ (когда поле ввода пустое)
Ctrl+C или Ctrl+DОтменить выполняющийся побочный вопрос

Пример:

(While the main conversation is about refactoring code) > /btw What's the difference between let and var in JavaScript? ╭──────────────────────────────────────────╮ │ /btw What's the difference between let │ │ and var in JavaScript? │ │ │ │ + Answering... │ │ Press Escape, Ctrl+C, or Ctrl+D to cancel│ ╰──────────────────────────────────────────╯ > (Composer remains active — keep typing) (After the answer arrives) ╭──────────────────────────────────────────╮ │ /btw What's the difference between let │ │ and var in JavaScript? │ │ │ │ `let` is block-scoped, while `var` is │ │ function-scoped. `let` was introduced │ │ in ES6 and doesn't hoist the same way. │ │ │ │ Press Space, Enter, or Escape to dismiss │ ╰──────────────────────────────────────────╯ > (Composer still active)

Поддерживаемые режимы выполнения:

РежимПоведение
InteractiveОтображается над Composer с рендерингом Markdown
Non-interactiveВозвращает текстовый результат: btw> question\nanswer
ACP (Agent Protocol)Возвращает асинхронный генератор stream_messages
Tip

Используйте /btw, когда вам нужен быстрый ответ без отвлечения от основной задачи. Это особенно полезно для уточнения концепций, проверки фактов или получения быстрых пояснений, не прерывая основной рабочий процесс.

1.7 Сводка сессии (/recap)

Команда /recap генерирует краткую сводку «на чем вы остановились» для текущей сессии, чтобы вы могли возобновить старый диалог без прокрутки страниц истории.

КомандаОписание
/recapГенерация и показ однострочной сводки сессии

Как это работает:

  • Использует настроенную быструю модель (настройка fastModel), если доступна, с откатом к основной модели сессии. Для сводки достаточно небольшой и дешевой модели.
  • Недавний диалог (до 30 сообщений, только текст — вызовы инструментов и ответы фильтруются) отправляется модели с жестким системным промптом.
  • Сводка отображается приглушенным цветом с префиксом , чтобы отличаться от реальных ответов ассистента.
  • Возвращает встроенную ошибку, если выполняется ход модели или обрабатывается другая команда. Если нет usable диалога или генерация падает, /recap показывает короткое информационное сообщение вместо сводки — ручная команда всегда что-то отвечает.

Автоматический запуск при возвращении:

Если терминал теряет фокус на 5+ минут и снова получает его, сводка генерируется и показывается автоматически (только если ответ модели не в процессе; иначе ждет завершения текущего хода). В отличие от ручной команды, авто-запуск полностью молчит при ошибке: если генерация падает или нечего суммировать, в историю ничего не добавляется. Управляется настройкой general.showSessionRecap (по умолчанию: true); ручная команда /recap работает независимо от этой настройки.

Пример:

> /recap ❯ Refactoring loopDetectionService.ts to address long-session OOM caused by unbounded streamContentHistory and contentStats. The next step is to implement option B (LRU sliding window with FNV-1a) pending confirmation.
Tip

Настройте быструю модель через /model --fast <model> (например, qwen3-coder-flash), чтобы /recap работала быстро и дешево. Установите general.showSessionRecap в false, чтобы отключить авто-запуск, сохранив доступность ручной команды.

1.8 Информация, настройки и справка

Команды для получения информации и выполнения системных настроек.

КомандаОписаниеПримеры использования
/helpОтображает справку по доступным командам/help или /?
/aboutОтображает информацию о версии/about
/statsОтображает подробную статистику текущей сессии/stats
/settingsОткрывает редактор настроек/settings
/authИзменяет метод аутентификации/auth
/bugОтправить отчет об ошибке в Qwen Code/bug Button click unresponsive
/copyКопирует содержимое последнего вывода в буфер обмена/copy
/quitНемедленный выход из Qwen Code/quit или /exit

1.9 Основные горячие клавиши

Горячая клавишаФункцияПримечание
Ctrl/cmd+LОчистка экранаЭквивалентно /clear
Ctrl/cmd+TПереключение описания инструментовУправление MCP-инструментами
Ctrl/cmd+C×2Подтверждение выходаМеханизм безопасного выхода
Ctrl/cmd+ZОтмена вводаРедактирование текста
Ctrl/cmd+Shift+ZПовтор вводаРедактирование текста

1.10 Подкоманды аутентификации CLI

Помимо слэш-команды /auth внутри сессии, Qwen Code предоставляет отдельные подкоманды CLI для управления аутентификацией прямо из терминала:

КомандаОписание
qwen authИнтерактивная настройка аутентификации
qwen auth coding-planАутентификация через Alibaba Cloud Coding Plan
qwen auth coding-plan --region china --key sk-sp-…Неинтерактивная настройка Coding Plan (для скриптов)
qwen auth api-keyАутентификация с помощью API-ключа
qwen auth qwen-oauthАутентификация через Qwen OAuth (прекращено 15.04.2026)
qwen auth statusПоказывает текущий статус аутентификации
Tip

Эти команды выполняются вне сессии Qwen Code. Используйте их для настройки аутентификации перед запуском сессии, а также в скриптах и CI-окружениях. Полные сведения см. на странице Authentication.

2. Команды с @ (Вставка файлов)

Команды с @ используются для быстрой вставки содержимого локальных файлов или директорий в диалог.

Формат командыОписаниеПримеры
@<file path>Вставляет содержимое указанного файла@src/main.py Please explain this code
@<directory path>Рекурсивно читает все текстовые файлы в директории@docs/ Summarize content of this document
Отдельный @Используется при обсуждении самого символа @@ What is this symbol used for in programming?

Примечание: пробелы в путях необходимо экранировать обратной косой чертой (например, @My\ Documents/file.txt)

3. Команды с ! — Выполнение Shell-команд

Команды с восклицательным знаком позволяют выполнять системные команды прямо внутри Qwen Code.

Формат командыОписаниеПримеры
!<shell command>Выполняет команду в суб-Shell!ls -la, !git status
Отдельный !Переключает режим Shell: любой ввод выполняется напрямую как Shell-команда!(ввод) → Ввод команды → !(выход)

Переменные окружения: Команды, выполняемые через !, устанавливают переменную окружения QWEN_CODE=1.

4. Пользовательские команды

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

Note

Пользовательские команды теперь используют формат Markdown с опциональным YAML-фронтматтером. Формат TOML объявлен устаревшим, но по-прежнему поддерживается для обратной совместимости. При обнаружении TOML-файлов будет отображаться предложение об автоматической миграции.

Краткий обзор

ФункцияОписаниеПреимуществаПриоритетСценарии использования
Пространство именПоддиректория создает команды с двоеточиемЛучшая организация команд
Глобальные команды~/.qwen/commands/Доступны во всех проектахНизкийЛичные часто используемые команды, кросс-проектное использование
Проектные команды<project root directory>/.qwen/commands/Специфичны для проекта, поддерживают контроль версийВысокийКомандное использование, команды для конкретного проекта

Правила приоритета: Проектные команды > Пользовательские команды (при совпадении имен используется проектная команда)

Правила именования команд

Таблица сопоставления пути к файлу и имени команды

Расположение файлаСгенерированная командаПример вызова
~/.qwen/commands/test.md/test/test Parameter
<project>/.qwen/commands/git/commit.md/git:commit/git:commit Message

Правила именования: Разделитель пути (/ или \) преобразуется в двоеточие (:)

Спецификация формата Markdown-файлов (Рекомендуется)

Пользовательские команды используют Markdown-файлы с опциональным YAML-фронтматтером:

--- description: Optional description (displayed in /help) --- Your prompt content here. Use {{args}} for parameter injection.
ПолеОбязательноОписаниеПример
descriptionОпциональноОписание команды (отображается в /help)description: Code analysis tool
Тело промптаОбязательноСодержимое промпта, отправляемое моделиЛюбой Markdown-контент после фронтматтера

Формат TOML-файлов (Устаревший)

Warning

Устаревший: Формат TOML по-прежнему поддерживается, но будет удален в будущих версиях. Пожалуйста, перейдите на формат Markdown.

ПолеОбязательноОписаниеПример
promptОбязательноСодержимое промпта, отправляемое моделиprompt = "Please analyze code: {{args}}"
descriptionОпциональноОписание команды (отображается в /help)description = "Code analysis tool"

Механизм обработки параметров

Метод обработкиСинтаксисСценарии использованияФункции безопасности
Контекстно-зависимая вставка{{args}}Требуется точный контроль параметровАвтоматическое экранирование Shell
Обработка параметров по умолчаниюБез специальных метокПростые команды, добавление параметровДобавляется как есть
Вставка Shell-команд!{command}Требуется динамический контентТребуется подтверждение перед выполнением

1. Контекстно-зависимая вставка ({{args}})

СценарийКонфигурация TOMLСпособ вызоваФактический эффект
Прямая вставкаprompt = "Fix: {{args}}"/fix "Button issue"Fix: "Button issue"
В Shell-командеprompt = "Search: !{grep {{args}} .}"/search "hello"Выполнение grep "hello" .

2. Обработка параметров по умолчанию

Ситуация вводаМетод обработкиПример
Есть параметрыДобавляются в конец промпта (разделены двумя переносами строк)/cmd parameter → Исходный промпт + параметр
Нет параметровПромпт отправляется как есть/cmd → Исходный промпт

🚀 Вставка динамического контента

Тип вставкиСинтаксисПорядок обработкиНазначение
Содержимое файла@{file path}Обрабатывается первымВставка статических файлов-ссылок
Shell-команды!{command}Обрабатывается в серединеВставка результатов динамического выполнения
Замена параметров{{args}}Обрабатывается последнимВставка пользовательских параметров

3. Выполнение Shell-команд (!{...})

ОперацияВзаимодействие с пользователем
1. Разбор команды и параметров-
2. Автоматическое экранирование Shell-
3. Показ диалога подтверждения✅ Подтверждение пользователя
4. Выполнение команды-
5. Вставка вывода в промпт-

Пример: Генерация сообщения Git Commit

--- description: Generate Commit message based on staged changes --- Please generate a Commit message based on the following diff: ```diff !{git diff --staged} ```

4. Вставка содержимого файлов (@{...})

Тип файлаСтатус поддержкиМетод обработки
Текстовые файлы✅ Полная поддержкаПрямая вставка содержимого
Изображения/PDF✅ Поддержка мультимодальностиКодирование и вставка
Бинарные файлы⚠️ Ограниченная поддержкаМожет быть пропущено или обрезано
Директория✅ Рекурсивная вставкаСледует правилам .gitignore

Пример: Команда проверки кода

--- description: Code review based on best practices --- Review {{args}}, reference standards: @{docs/code-standards.md}

Практический пример создания

Таблица шагов создания команды «Рефакторинг в чистую функцию»

ОперацияКоманда/Код
1. Создание структуры директорийmkdir -p ~/.qwen/commands/refactor
2. Создание файла командыtouch ~/.qwen/commands/refactor/pure.md
3. Редактирование содержимого командыСм. полный код ниже.
4. Тестирование команды@file.js/refactor:pure
--- description: Refactor code to pure function --- Please analyze code in current context, refactor to pure function. Requirements: 1. Provide refactored code 2. Explain key changes and pure function characteristic implementation 3. Maintain function unchanged

Сводка лучших практик для пользовательских команд

Таблица рекомендаций по проектированию команд

Пункт практикиРекомендуемый подходИзбегать
Именование командИспользуйте пространства имен для организацииИзбегайте слишком общих имен
Обработка параметровЯвно используйте {{args}}Полагаться на добавление по умолчанию (легко запутаться)
Обработка ошибокИспользуйте вывод ошибок ShellИгнорировать ошибки выполнения
Организация файловОрганизуйте по функциям в директорияхВсе команды в корневой директории
Поле описанияВсегда указывайте четкое описаниеПолагаться на автогенерируемое описание

Таблица напоминаний о функциях безопасности

Механизм безопасностиЭффект защитыДействие пользователя
Экранирование ShellПредотвращение инъекций командАвтоматическая обработка
Подтверждение выполненияИзбежание случайного выполненияПодтверждение в диалоге
Отчет об ошибкахПомогает диагностировать проблемыПросмотр информации об ошибке
Last updated on