Команды
В этом документе описаны все команды, поддерживаемые 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 |
Используйте /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.Настройте быструю модель через /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 auth status | Показывает текущий статус аутентификации |
Эти команды выполняются вне сессии 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. Пользовательские команды
Сохраняйте часто используемые промпты в виде команд-ярлыков для повышения эффективности работы и обеспечения согласованности.
Пользовательские команды теперь используют формат 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-файлов (Устаревший)
Устаревший: Формат 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 | Предотвращение инъекций команд | Автоматическая обработка |
| Подтверждение выполнения | Избежание случайного выполнения | Подтверждение в диалоге |
| Отчет об ошибках | Помогает диагностировать проблемы | Просмотр информации об ошибке |