Режим согласования

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

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

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

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

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

Tip

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

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

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

Когда использовать Plan Mode

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

Как использовать Plan Mode

Включение Plan Mode во время сессии

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

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

Использование команды /plan

Команда /plan предоставляет быстрый способ входа и выхода из Plan Mode:


/plan                          # Enter plan mode
/plan refactor the auth module # Enter plan mode and start planning
/plan exit                     # Exit plan mode, restore previous mode

При выходе из Plan Mode с помощью /plan exit ваш предыдущий режим согласования автоматически восстанавливается (например, если до входа в Plan Mode вы использовали Auto-Edit, вы вернетесь в Auto-Edit).

Запуск новой сессии в Plan Mode

Чтобы запустить новую сессию в Plan Mode, используйте /approval-mode, а затем выберите plan


/approval-mode

Выполнение «headless»-запросов в Plan Mode

Вы также можете выполнить запрос в Plan Mode напрямую с помощью флага -p или prompt:


qwen --prompt "What is machine learning?"

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


/plan I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.

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


What about backward compatibility?
How should we handle database migration?

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


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

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

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

Когда использовать Default Mode

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

Как использовать Default Mode

Включение Default Mode во время сессии

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

Запуск новой сессии в Default Mode

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


/approval-mode default

Выполнение «headless»-запросов в Default Mode

При выполнении headless-команд Default Mode используется по умолчанию. Вы можете явно указать его с помощью:


qwen --prompt "Analyze this code for potential bugs"

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


/approval-mode default


I need to add user profile pictures to our application. The pictures should be stored in an S3 bucket and the URLs saved in the database.

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

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

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

Настройка Default Mode по умолчанию


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

3. Режим Auto-Edit

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

Когда использовать режим Auto-Accept Edits

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

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


# Switch via command
/approval-mode auto-edit

# Or use keyboard shortcut
Shift+Tab (or Tab on Windows) # Switch from other modes

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

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

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

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

Когда использовать YOLO Mode

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

Warning

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

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

Как включить YOLO Mode


# Temporarily enable (current session only)
/approval-mode yolo

# Set as project default
/approval-mode yolo --project

# Set as user global default
/approval-mode yolo --user

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


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

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


# Fully automated refactoring task
qwen --prompt "Run the test suite, fix all failing tests, then commit changes"
 
# Without human intervention, AI will:
# 1. Run test commands (auto-approved)
# 2. Fix failed test cases (auto-edit files)
# 3. Execute git commit (auto-approved)

Переключение режимов и конфигурация

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

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


Default Mode → Auto-Edit Mode → YOLO Mode → Plan Mode → Default Mode

Постоянная конфигурация


// Project-level: ./.qwen/settings.json
// User-level: ~/.qwen/settings.json
{
  "permissions": {
"defaultMode": "auto-edit",  // or "plan" or "yolo"
"confirmShellCommands": true,
"confirmFileEdits": true
  }
}