Команды

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

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

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

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

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

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

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

Команда	Описание	Примеры использования
`/init`	Анализирует текущую директорию и создает начальный файл контекста	`/init`
`/summary`	Генерирует сводку проекта на основе истории диалога	`/summary`
`/compress`	Заменяет историю чата сводкой для экономии токенов	`/compress`
`/resume`	Возобновляет предыдущую сессию диалога	`/resume`
`/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 add Important Info`

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 Информация, настройки и справка

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

Команда	Описание	Примеры использования
`/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.8 Общие горячие клавиши

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

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

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

Команда	Описание
`qwen auth`	Интерактивная настройка аутентификации
`qwen auth qwen-oauth`	Аутентификация через Qwen OAuth
`qwen auth coding-plan`	Аутентификация через Alibaba Cloud Coding Plan
`qwen auth coding-plan --region china --key sk-sp-…`	Неинтерактивная настройка Coding Plan (для скриптов)
`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


---
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	Предотвращает инъекцию команд	Автоматическая обработка
Подтверждение выполнения	Избегает случайного выполнения	Подтверждение в диалоге
Отчет об ошибках	Помогает диагностировать проблемы	Просмотр информации об ошибке