Режим утверждения

Qwen Code предоставляет три различных режима разрешений, позволяющих гибко управлять взаимодействием ИИ с вашим кодом и системой в зависимости от сложности задачи и уровня риска.

Сравнение режимов разрешений

Режим	Редактирование файлов	Выполнение команд оболочки	Рекомендуется для	Уровень риска
Plan	❌ Только анализ в режиме «только чтение»	❌ Не выполняются	• Исследование кода • Планирование сложных изменений • Безопасный код-ревью	Наименьший
Default	✅ Требуется ручное подтверждение	✅ Требуется ручное подтверждение	• Новые или незнакомые кодовые базы • Критически важные системы • Совместная работа в команде • Обучение и преподавание	Низкий
Auto-Edit	✅ Подтверждение выполняется автоматически	❌ Требуется ручное подтверждение	• Ежедневные задачи разработки • Рефакторинг и улучшение кода • Безопасная автоматизация	Средний
YOLO	✅ Подтверждение выполняется автоматически	✅ Подтверждение выполняется автоматически	• Доверенные личные проекты • Автоматизированные скрипты/CI/CD • Пакетная обработка задач	Наибольший

Краткое руководство

Начните с режима Plan (Планирование): идеально подходит для понимания кода перед внесением изменений
Работайте в режиме Default (По умолчанию): сбалансированный выбор для большинства задач разработки
Переключитесь в режим Auto-Edit (Автоматическое редактирование): когда требуется внести множество безопасных изменений в код
Используйте режим YOLO умеренно: только для доверенной автоматизации в контролируемых средах

Tip

Во время сеанса вы можете быстро переключаться между режимами с помощью комбинации Shift+Tab (или просто Tab в Windows). Строка состояния терминала отображает текущий режим, поэтому вы всегда знаете, какие разрешения имеет Qwen Code.

1. Используйте режим Plan для безопасного анализа кода

Режим Plan указывает Qwen Code создать план, проанализировав кодовую базу с использованием только операций чтения. Этот режим идеально подходит для изучения кодовых баз, планирования сложных изменений или безопасного рецензирования кода.

Когда использовать режим планирования

Реализация в несколько этапов: когда для реализации функции требуется внести изменения в множество файлов
Исследование кода: когда вы хотите тщательно изучить кодовую базу перед внесением любых изменений
Интерактивная разработка: когда вы хотите итеративно уточнять направление работы с помощью Qwen Code

Как использовать режим планирования

Включение режима планирования во время сеанса

Вы можете переключиться в режим планирования во время сеанса, нажав Shift+Tab (или просто Tab в Windows), чтобы циклически переключаться между режимами разрешений.

Если вы находитесь в обычном режиме (Normal Mode), то первое нажатие Shift+Tab (или Tab в Windows) переводит вас в режим auto-edits, что отображается в нижней части терминала надписью ⏵⏵ accept edits on. Повторное нажатие Shift+Tab (или Tab в Windows) переводит вас в режим планирования, о чём свидетельствует надпись ⏸ plan mode.

Запуск нового сеанса в режиме планирования

Чтобы начать новый сеанс в режиме планирования, выполните команду /approval-mode, а затем выберите plan:


/approval-mode

Выполнение «безголовых» запросов в режиме планирования

Также вы можете напрямую выполнить запрос в режиме планирования, используя флаг -p или опцию prompt:


qwen --prompt "Что такое машинное обучение?"

Пример: Планирование сложной рефакторизации


/approval-mode plan


Мне нужно рефакторить нашу систему аутентификации для использования OAuth2. Создайте подробный план миграции.

Qwen Code анализирует текущую реализацию и создаёт исчерпывающий план. Уточните его с помощью последующих запросов:


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

Настройка режима Plan как режима по умолчанию


// .qwen/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

2. Использование режима по умолчанию для контролируемого взаимодействия

Режим по умолчанию — это стандартный способ работы с Qwen Code. В этом режиме вы сохраняете полный контроль над всеми потенциально опасными операциями: перед внесением любых изменений в файлы или выполнением команд оболочки Qwen Code запрашивает ваше подтверждение.

Когда использовать режим по умолчанию

Начинаете работу с новой кодовой базой: когда вы изучаете незнакомый проект и хотите проявить особую осторожность
Критически важные системы: при работе с продакшн-кодом, инфраструктурой или конфиденциальными данными
Обучение и преподавание: когда вы хотите понять каждый шаг, который выполняет Qwen Code
Совместная работа в команде: когда над одной и той же кодовой базой работают несколько человек
Сложные операции: когда изменения затрагивают несколько файлов или включают сложную логику

Как использовать режим по умолчанию

Включить режим по умолчанию во время сеанса

Вы можете переключиться в режим по умолчанию во время сеанса, нажав Shift+Tab (или Tab в Windows), чтобы циклически переключаться между режимами разрешений. Если вы находитесь в любом другом режиме, повторное нажатие Shift+Tab (или Tab в Windows) в конечном итоге вернёт вас в режим по умолчанию, который обозначается отсутствием индикатора режима в нижней части терминала.

Запустить новый сеанс в режиме по умолчанию

Режим по умолчанию — это начальный режим при запуске Qwen Code. Если вы изменили режим и хотите вернуться в режим по умолчанию, выполните:


/approval-mode default

Выполнить «безголовые» запросы в режиме по умолчанию

При выполнении безголовых команд поведение по умолчанию — это режим по умолчанию. Вы можете явно указать его следующим образом:


qwen --prompt "Проанализируй этот код на наличие потенциальных ошибок"

Пример: Безопасная реализация функции


/approval-mode default


Мне нужно добавить аватары пользователей в наше приложение. Аватары должны храниться в бакете S3, а их URL — сохраняться в базе данных.

Qwen Code проанализирует вашу кодовую базу и предложит план. Затем он запросит подтверждение перед выполнением следующих действий:

Созданием новых файлов (контроллеров, моделей, миграций);
Изменением существующих файлов (добавлением новых столбцов, обновлением API);
Выполнением команд оболочки (миграций базы данных, установки зависимостей).

Вы можете просмотреть каждое предложенное изменение и одобрить или отклонить его по отдельности.

Настройка режима по умолчанию как основного


// .qwen/settings.json
{
  "permissions": {
    "defaultMode": "default"
  }
}

3. Режим автоматических правок

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

Когда использовать режим автоматического принятия правок

Повседневная разработка: Идеально подходит для большинства задач программирования
Безопасная автоматизация: Позволяет ИИ изменять код, одновременно предотвращая случайное выполнение опасных команд
Совместная работа в команде: Используйте в общих проектах, чтобы избежать непреднамеренного влияния на других участников

Как переключиться в этот режим


# Переключение через команду
/approval-mode auto-edit

# Или используйте сочетание клавиш
Shift+Tab (или Tab в Windows) # Переключение из других режимов

Пример рабочего процесса

Вы просите Qwen Code рефакторить функцию
ИИ анализирует код и предлагает изменения
Все изменения в файлах применяются автоматически, без подтверждения
Если требуется запуск тестов, ИИ запросит подтверждение перед выполнением команды npm test

4. Режим YOLO — полная автоматизация

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

Когда использовать режим YOLO

Автоматизированные скрипты: выполнение заранее определённых автоматизированных задач
CI/CD-конвейеры: автоматическое выполнение в контролируемых средах
Личные проекты: быстрая итерация в полностью доверенных средах
Пакетная обработка: задачи, требующие цепочек многошаговых команд

Warning

Используйте режим YOLO с осторожностью: ИИ может выполнять любую команду с теми же правами, что и ваш терминал. Убедитесь, что:

Вы доверяете текущей кодовой базе
Вам понятны все действия, которые ИИ собирается выполнить
Важные файлы сохранены резервной копией или зафиксированы в системе контроля версий

Как включить режим YOLO


# Временно включить (только для текущей сессии)  
/approval-mode yolo  

# Установить как значение по умолчанию для проекта  
/approval-mode yolo --project  

# Установить как глобальное значение по умолчанию для пользователя  
/approval-mode yolo --user

Пример конфигурации


// .qwen/settings.json  
{  
  "permissions": {  
    "defaultMode": "yolo",  
    "confirmShellCommands": false,  
    "confirmFileEdits": false  
  }  
}

Пример автоматизированного рабочего процесса



# Полностью автоматизированная задача рефакторинга
qwen --prompt "Запустить набор тестов, исправить все упавшие тесты, затем зафиксировать изменения"

# Без вмешательства человека ИИ выполнит следующие действия:

# 1. Запустит команды тестирования (автоматически подтверждено)

# 2. Исправит упавшие тестовые случаи (автоматическое редактирование файлов)

# 3. Выполнит фиксацию изменений в Git (автоматически подтверждено)

Переключение режимов и настройка

Переключение с помощью сочетания клавиш

Во время сеанса Qwen Code используйте Shift+Tab (или Tab в Windows), чтобы быстро переключаться между тремя режимами:


Режим по умолчанию → Режим автоматического редактирования → Режим YOLO → Режим планирования → Режим по умолчанию

Постоянные настройки


// На уровне проекта: ./.qwen/settings.json
// На уровне пользователя: ~/.qwen/settings.json
{
  "permissions": {
    "defaultMode": "auto-edit",  // или "plan", или "yolo"
    "confirmShellCommands": true,
    "confirmFileEdits": true
  }
}