Команды

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

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

1. Slash-команды (/)

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

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

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

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

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

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

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

• Доступные встроенные языки интерфейса: zh-CN (упрощенный китайский), en-US (английский), ru-RU (русский), de-DE (немецкий), ja-JP (японский), pt-BR (португальский - Бразилия), fr-FR (французский), ca-ES (каталанский)
• Примеры языков вывода: Chinese, English, Japanese и т.д.

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

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

1.5 Встроенные skills

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

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

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

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

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

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

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

Пример:

(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)

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

1.7 Второе мнение (/advisor)

Команда /advisor выполняет независимое ревью текущего диалога только для чтения и возвращает структурированное второе мнение — не выполняя задачу и не прерывая основной диалог.

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

• Ревью отправляется как отдельный одноходовый API-запрос с контекстом недавнего диалога (до последних 40 сообщений)
• Модель-ревьюер не может выполнять инструменты — инструменты удаляются на уровне запроса (тот же механизм, что и для /btw), поэтому ревью никогда не пишет код и не выполняет команды; каждое утверждение должно основываться на видимом транскрипте
• Основной диалог не прерывается; ревью показывается только вам
• Ревью отображается как обрамлённый markdown-блок с четырьмя фиксированными разделами — Verdict, Risks, Missing evidence и Recommendation — под заголовком /advisor · <model>, указывающим используемую модель-ревьюера
• В отличие от /btw, который выполняется fire-and-forget и не блокирует сессию, /advisor блокирует ввод до возврата ревью; при полном окне контекста с мощной моделью-ревьюером это может занять десятки секунд
• По умолчанию используется основная модель; установите advisorModel, чтобы направить ревью на другую (обычно более мощную) модель — недавний транскрипт отправляется этой модели, даже если она использует другого провайдера

Пример:

> /advisor is my fix for the null check actually correct?

  Consulting advisor...

  ╭──────────────────────────────────────────────────────╮
  │ /advisor · qwen3-max                                 │
  │                                                      │
  │ Verdict                                              │
  │ The approach is sound, but the edge case at line 42  │
  │ is unverified.                                       │
  │                                                      │
  │ Risks                                                │
  │  - The fix assumes the config is always loaded; a    │
  │    startup race could leave it null.                 │
  │                                                      │
  │ Missing evidence                                     │
  │  - No test exercises the null-config path in the     │
  │    visible transcript.                               │
  │                                                      │
  │ Recommendation                                       │
  │ Add a focused unit test for the null-config branch   │
  │ before merging.                                      │
  ╰──────────────────────────────────────────────────────╯

Ревью отображается в обрамлённом блоке, заголовок которого указывает используемую модель-ревьюера. Неизвестная advisorModel не проверяется заранее — если провайдер отклоняет её, /advisor сообщает о сбое, поэтому проверяйте имя модели; только неразрешимые селекторы алиасов (например, fast без настроенной быстрой модели) откатываются на основную модель. Запросы advisor не используют настроенные фолбэки моделей.

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

1.8 Краткое содержание сессии (/recap)

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

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

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

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

Если терминал находится не в фокусе более 5 минут, а затем снова получает фокус, резюме генерируется и отображается автоматически (только если ответ модели не находится в процессе выполнения; иначе команда ждет завершения текущего хода). В отличие от ручной команды, автозапуск полностью молчит при сбое: если генерация завершается ошибкой или нечего резюмировать, сообщение в историю не добавляется. Управляется настройкой general.showSessionRecap (по умолчанию: false); ручная команда /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.

1.9 Просмотр diff (/diff)

Команда /diff открывает интерактивный просмотрщик diff, показывающий незакоммиченные изменения и diff для каждого хода. Используйте ←/→ для переключения между текущим git diff и отдельными ходами диалога, ↑/↓ для навигации по файлам и Enter для просмотра inline-diff.

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

В интерактивном режиме /diff открывает диалоговое окно с выбором источника в верхней части:

• Current — рабочее дерево против HEAD (git diff HEAD). Показывает все незакоммиченные изменения, включая проиндексированные, непроиндексированные и неотслеживаемые файлы.
• T1, T2, T3, … — diff для каждого хода, по одной вкладке на каждый ход модели, изменивший файлы. Самые последние ходы отображаются первыми. Каждая вкладка показывает превью исходного промпта для контекста.

Список файлов отображает статистику по каждому файлу (добавленные/удаленные строки) с тегами для специальных состояний (new, deleted, untracked, binary, truncated, oversized). Нажмите Enter на файле, чтобы просмотреть его inline-diff с подсветкой синтаксиса для блоков изменений.

Diff для каждого хода требует включения контрольных точек файлов (по умолчанию включено в интерактивном режиме). Когда контрольные точки файлов отключены, доступен только источник “Current”.

Горячие клавиши:

Пример:

┌ /diff · Turn 3 "refactor the auth middleware" ──── 3 files +45 -12 ┐
│                                                                     │
│ ◀ Current · T3 · T2 · T1 ▶                                         │
│                                                                     │
│ › src/utils/parser.ts                              +30 -8           │
│   src/utils/parser.test.ts                         +12 -2           │
│   README.md                                        +3 -2            │
│                                                                     │
│ ←/→ source · ↑/↓ file · Enter view · Esc close                     │
└─────────────────────────────────────────────────────────────────────┘

Неинтерактивный режим:

В headless-режиме (--prompt) или неинтерактивном контексте /diff выводит текстовое резюме рабочего дерева против HEAD. Навигация по ходам недоступна.

3 files changed, +45 / -12
  +30  -8  src/utils/parser.ts
  +12  -2  src/utils/parser.test.ts
   +3  -2  README.md

Web Shell: В Web Shell UI (qwen serve), /diff открывает графический диалог diff. Панель вкладок в верхней части позволяет переключаться между представлением Changes и представлением History (/log).

Просмотр истории (/log) — только Web Shell

Команда /log открывает браузер истории коммитов для текущего рабочего пространства. Она доступна только в Web Shell UI; CLI/TUI не имеет этой команды.

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

/log открывает диалоговое окно со списком коммитов в обратном хронологическом порядке (новые первые). Каждая строка показывает:

• Короткий SHA (моноширинный, с кнопкой копирования полного SHA)
• Тему коммита (одна строка)
• Имя автора и относительное время (например, “2h ago”)
• Метки ссылок веток/тегов, если есть
• Иконку слияния (⎇) для merge-коммитов

Нажмите на строку коммита, чтобы развернуть его детали по запросу:

• Полное тело сообщения коммита
• Статистику изменений файлов (изменённые файлы, добавленные/удалённые строки, разбивка по файлам)

Используйте Load more внизу, чтобы загрузить следующую страницу коммитов (50 на страницу).

Пример:

┌─ History ──────────────────────────── 50 commits ─ ✕ ┐
│                                                       │
│  a1b2c3d  feat(cli): add --json flag        2h ago   │
│           wenshao                                    │
│                                                       │
│  e4f5g6h  fix(core): handle null config     5h ago   │
│           dev · main  v1.2.0                         │
│                                                       │
│ ▼ 789abcd  refactor: simplify parser        1d ago   │
│   ┌─────────────────────────────────────────────┐    │
│   │  Broke the monolithic parse() into smaller  │    │
│   │  functions for readability.                 │    │
│   │                                             │    │
│   │  3 files · +45 −12                          │    │
│   │   +30 −8   src/parser.ts                    │    │
│   │   +10 −2   src/utils.ts                     │    │
│   │   +5  −2   test/parser.test.ts              │    │
│   └─────────────────────────────────────────────┘    │
│                                                       │
│              [ Load more ]                            │
└───────────────────────────────────────────────────────┘

1.10 Информация, настройки и помощь

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

1.11 Часто используемые сочетания клавиш

1.12 Команды аутентификации

Используйте /auth внутри сессии Qwen Code для настройки аутентификации. Используйте /doctor для проверки текущего статуса аутентификации и состояния окружения.

2. Команды @ (Подключение файлов)

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

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

3. Команды с восклицательным знаком (!) — Выполнение Shell-команд

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

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

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

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

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

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

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

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

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

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

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

---
description: Опциональное описание (отображается в /help)
---
 
Здесь ваш текст промпта.
Используйте {{args}} для внедрения параметров.

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

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

1. Контекстное внедрение ({{args}})

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

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

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

Пример: Генерация сообщения для Git-коммита

---
description: Генерация сообщения коммита на основе проиндексированных изменений
---
 
Пожалуйста, сгенерируй сообщение коммита на основе следующего diff:
 
```diff
!{git diff --staged}
```

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

Пример: Команда для Code Review

---
description: Code review на основе лучших практик
---
 
Проведи ревью {{args}}, эталонные стандарты:
 
@{docs/code-standards.md}

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

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

---
description: Рефакторинг кода в чистую функцию
---
 
Пожалуйста, проанализируй код в текущем контексте и выполни рефакторинг в чистую функцию.
Требования:
 
1. Предоставь рефакторенный код
2. Объясни ключевые изменения и реализацию характеристик чистой функции
3. Сохрани функциональность без изменений

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

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

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

5. Подкоманды CLI

Эти команды выполняются из shell как qwen <subcommand> перед началом интерактивной сессии.

Управление сессиями

qwen sessions list

Выводит список ваших недавних сессий Qwen Code с метаданными.

Флаги:

Человекочитаемый вывод (по умолчанию):

Таблица со столбцами: SESSION ID, STARTED (UTC-время), TITLE, BRANCH, PROMPT.

JSON-вывод (--json):

Выводит JSON Lines в stdout. Каждая строка представляет собой JSON-объект с полями:

sessionId, startTime, mtime, prompt, gitBranch, customTitle, titleSource, filePath, cwd

Подсказка о наличии дополнительных сессий выводится в stderr, чтобы конвейеризация в jq оставалась безопасной.

Примеры:

# Показать последние 20 сессий (по умолчанию)
qwen sessions list
 
# Показать последние 50 сессий
qwen sessions list --limit 50
 
# Вывести в формате JSON для скриптов
qwen sessions list --json | jq .

qwen sessions ps

Выводит список интерактивных сессий Qwen Code, запущенных на этой машине в данный момент. sessions list обходит сохранённые транскрипты («над чем я работал»); эта команда обходит реестр живых процессов («что запущено в данный момент»). Записи, оставшиеся от завершённой сессии, удаляются по мере обнаружения. Headless-сессии (qwen -p) не регистрируются в реестре живых процессов, поэтому не отображаются.

Флаги:

Человекочитаемый вывод (по умолчанию):

Таблица со столбцами: NAME, PID, AGE, DIRECTORY.

JSON-вывод (--json):

Выводит JSON Lines в stdout, самые новые сессии первыми. Каждая строка представляет собой JSON-объект с полями:

schemaVersion, pid, procStart, pidNs, sessionId, cwd, name, startedAt,
qwenVersion

Ничего другого не записывается в stdout — пустой список не выводит ничего — поэтому qwen sessions ps --json | jq . безопасен для использования в скриптах.

JSON-вывод — это сырые данные: значения полей выводятся точно так, как были записаны, без санитизации для терминала. Обрабатывайте их как данные и санитизируйте перед отображением в терминале.

Примеры:

# Показать другие живые сессии
qwen sessions ps
 
# Какие директории сейчас заняты?
# Примечание: `jq -r` отображает сырое записанное значение в терминале
# (см. примечание о сырых данных выше); пропускайте через санитайзер,
# если путь не является доверенным.
qwen sessions ps --json | jq -r .cwd