Claude Code: режимы разрешений, переключение и контроль команд

Claude Code: режимы разрешений, переключение и контроль команд

В Claude Code разрешения определяют, какие операции агент выполняет самостоятельно, а перед какими останавливается и запрашивает подтверждение. От выбранного режима зависит работа с файлами, терминалом, сетью и внешними инструментами.

Всего доступно шесть режимов: default, acceptEdits, plan, auto, dontAsk и bypassPermissions. У каждого собственные ограничения. Даже режим с отключёнными проверками сохраняет отдельные механизмы защиты.

Claude Code показывает активный режим в строке состояния

В терминале текущий режим отображается рядом с полем ввода. Например, manual mode on, accept edits on, plan mode on или auto mode on.

Для переключения используется Shift+Tab.

Строка состояния Claude Code в режимах auto, manual, accept edits и plan. Кадры из документации Claude Code
Строка состояния Claude Code в режимах auto, manual, accept edits и plan. Кадры из документации Claude Code
Выбор режима в приложении Claude на компьютере: Авто, Вручную, Принимать правки, План и Обход запросов разрешений
Выбор режима в приложении Claude на компьютере: Авто, Вручную, Принимать правки, План и Обход запросов разрешений

Основная последовательность:

auto → default → acceptEdits → plan → auto

Из auto mode первое нажатие переключает сессию в Manual. Далее идут acceptEdits и plan. Дополнительные режимы появляются после plan, если они доступны в текущей сессии.

Начиная с Claude Code 2.1.283, auto mode используется по умолчанию в новых интерактивных сессиях терминала и VS Code.

Выбрать режим непосредственно при запуске позволяет параметр --permission-mode.

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

Manual требует подтверждения большинства изменений и команд

Manual соответствует значению default в конфигурации. В интерфейсе используется название Manual, а при запуске допускаются оба значения: default и manual.

claude --permission-mode default

В этом режиме Claude может читать файлы и выполнять встроенные команды, не изменяющие состояние проекта. Большинство остальных действий требуют разрешения.

Например, при попытке изменить файл или выполнить команду, которая выходит за пределы разрешённых операций чтения, Claude Code показывает запрос. Пользователь принимает решение до выполнения.

Manual подходит для незнакомого репозитория и ситуаций, когда требуется лично контролировать изменения.

Количество запросов можно уменьшить без использования классификатора безопасности. Для этого документация предлагает включить встроенную Bash-песочницу.

Сначала запустите ручной режим:

claude --permission-mode default

Затем в сессии выполните:

/sandbox

Выберите auto-allow. Команды, выполняемые в пределах песочницы и соответствующие её условиям, смогут запускаться без постоянного подтверждения.

Песочница ограничивает доступ команд к файловой системе и другим ресурсам. Правила deny продолжают блокировать запрещённые действия, а явно заданные ask могут сохранять запросы.

acceptEdits автоматически принимает изменения файлов

Режим acceptEdits разрешает Claude Code создавать и изменять файлы без отдельного согласования каждой операции.

claude --permission-mode acceptEdits

Дополнительно автоматическое подтверждение получают распространённые команды файловой системы:

mkdir

touch

rm

rmdir

mv

cp

sed

Разрешение распространяется на рабочую директорию и каталоги, добавленные через additionalDirectories.

Возможность запуска команды не означает, что её можно применять к любому пути. Для защищённых директорий, критических операций удаления и путей за пределами допустимой области продолжают действовать ограничения.

Для touch есть отдельное условие: автоматическое разрешение предусмотрено для обычных путей к файлам. Дополнительные опции, шаблоны и префиксы вызывают запрос.

Остальные Bash-команды, за исключением встроенного набора операций чтения, также могут требовать подтверждения.

Практический сценарий: Claude исправляет код, а разработчик после выполнения смотрит изменения через редактор или команду git diff.

Перейти из Manual в acceptEdits можно одним нажатием Shift+Tab.

Plan готовит изменения и предлагает способ их выполнения

В plan Claude Code изучает структуру проекта и составляет план без непосредственного редактирования исходных файлов.

claude --permission-mode plan

Для отдельного запроса планирование можно включить командой /plan.

Работа терминальных команд во время анализа зависит от доступности auto mode.

Когда классификатор доступен и включена настройка useAutoModeDuringPlan, он проверяет исследовательские команды. По умолчанию настройка активна.

Если классификатор недоступен, Claude Code запрашивает разрешение на команды за пределами встроенного набора операций чтения.

После подготовки плана пользователь выбирает продолжение:

• Yes, and use auto mode разрешает приступить к работе в автоматическом режиме.

• Yes, manually approve edits оставляет подтверждение каждого изменения за пользователем.

• No, keep planning возвращает к уточнению плана.

Если auto mode недоступен, первый пункт предлагает автоматическое принятие правок. При включённом bypassPermissions возможен соответствующий вариант перехода в режим обхода.

Комбинация Ctrl+G открывает план во внешнем текстовом редакторе, где его можно поправить до утверждения.

Есть особенность: в интерактивном терминале, запущенном с доступным bypassPermissions, блокировки редактирования во время планирования могут не применяться. Claude по-прежнему получает инструкцию планировать без изменений, однако техническая защита редактирования в таком случае отсутствует.

Auto mode проверяет операции отдельной моделью

В auto стандартные запросы разрешений заменяются автоматической проверкой. Перед действием Claude Code обращается к классификатору, который решает, допустима ли операция.

claude --permission-mode auto

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

По умолчанию блокируются, например:

• загрузка и немедленное выполнение стороннего кода через curl | bash;

• передача конфиденциальных данных внешним адресатам;

• публикация изменений в production и миграции;

• принудительный git push;

• команды git reset --hard, git clean -fd, git restore . и другие операции, способные уничтожить локальные изменения;

• удаление облачных ресурсов и уничтожение инфраструктуры;

• изменение прав IAM, разрешений репозитория и общей инфраструктуры;

• операции с секретами, включая вывод действующих токенов.

Классификатор рассматривает исходную рабочую директорию и удалённые Git-репозитории, настроенные на момент запуска сессии, как доверенные. Новый адрес, добавленный через git remote add или изменённый через git remote set-url, автоматически доверенным не становится.

Разрешение конкретной заблокированной операции можно сформулировать в диалоге. Для этого необходимо указать само действие и его опасные особенности. Общего разрешения вроде «можно делать force push» недостаточно.

Некоторые блокировки таким способом снять нельзя. Тогда потребуется другой режим и ручное подтверждение.

Пользовательские запреты также учитываются. Например, фраза «не отправляй изменения до моей проверки» становится ограничением для классификатора. Для гарантированного запрета следует использовать permissions.deny, поскольку сообщения могут исчезать из рабочего контекста при его сокращении.

После повторных блокировок auto mode возвращает подтверждения

Если классификатор отклоняет действие, Claude Code показывает уведомление. Операция появляется в разделе Recently denied команды /permissions.

Там можно нажать r и повторить действие с ручным согласованием.

После трёх блокировок подряд или двадцати блокировок за сессию auto mode приостанавливает автоматическое подтверждение и возвращается к запросам пользователя.

После одобрения действия режим возобновляется.

Если классификатор не смог сформировать корректный вердикт, операция отклоняется. Для неинтерактивных запусков с -p, где нет механизма запроса разрешений, предусмотрено другое поведение: при достижении порога блокировок действие не запускается, а агент продолжает работу.

Auto mode требует поддерживаемой модели. Администратор Team или Enterprise также может отключить его организационной настройкой permissions.disableAutoMode.

dontAsk отклоняет команды, которые требуют участия пользователя

dontAsk рассчитан на скрипты и автоматические процессы.

claude --permission-mode dontAsk

В этом режиме Claude Code выполняет доступные операции чтения, заранее разрешённые инструменты и действия, одобренные соответствующими правилами или хуками.

Хук PreToolUse представляет собой обработчик, который срабатывает перед вызовом инструмента и может участвовать в принятии решения о разрешении.

Любая операция, требующая интерактивного подтверждения, отклоняется автоматически. Явное правило ask здесь также приводит к отказу.

Пример для CI:

claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"

Параметр -p запускает неинтерактивное выполнение запроса. Через --allowedTools указан список разрешённых инструментов: чтение файлов и команда npm test.

Если агент попытается выполнить операцию, требующую дополнительного согласования, он не будет ожидать ответа.

Режим dontAsk отсутствует в цикле переключения Shift+Tab. Его нужно выбирать при запуске.

bypassPermissions отключает стандартные проверки разрешений

bypassPermissions даёт Claude Code возможность выполнять почти все операции без подтверждения.

Запуск:

claude --permission-mode bypassPermissions

Эквивалентный вариант:

claude --dangerously-skip-permissions

В режиме разрешена запись даже в защищённые пути. Однако сохраняются отдельные исключения, включая явные правила ask и deny, инструменты, требующие человеческого ответа, и проверки удаления критических каталогов.

Например, команда:

rm -rf ~

направлена на рекурсивное удаление домашней директории. Если Claude Code распознаёт её как критическую операцию, в терминале появляется запрос подтверждения даже при bypassPermissions.

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

export CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1

claude --permission-mode bypassPermissions

Пример относится к macOS, Linux и WSL. Переменная считывается только из окружения запуска.

Отключение этой проверки снимает один из последних защитных барьеров. Документация рекомендует использовать bypassPermissions исключительно в изолированных контейнерах или виртуальных машинах без доступа к интернету.

На Linux и macOS для такого запуска рекомендуется пользователь без прав root.

Критические и защищённые пути обрабатываются отдельно

Защищённые пути нельзя автоматически изменять в большинстве режимов. Исключения касаются bypassPermissions и специальных интерактивных сессий plan, в которых доступен обход проверок.

Критические пути относятся к другой проверке. Claude Code отдельно анализирует распознаваемые команды rm и rmdir, направленные на файловый корень, домашнюю директорию, рабочую папку и другие важные каталоги.

Результат зависит от режима:

• default и acceptEdits запрашивают подтверждение;

• plan сохраняет запрос либо использует правила auto mode;

• auto запрашивает подтверждение в терминале, в других интерфейсах отклоняет операцию;

• dontAsk отклоняет;

• bypassPermissions в терминале запрашивает подтверждение с ограничением по времени, если специальная проверка не отключена.

Проверка распознаёт не все возможные способы удаления. Изоляция на уровне ОС защищает от действий, которые не удалось выявить анализатору команд.

Режимы Claude Code под разные сценарии

• Незнакомый репозиторий: default, чтобы лично подтверждать изменения.

• Локальная разработка без классификатора: default плюс /sandbox с auto-allow.

• Исследование проекта: plan, затем утверждение плана.

• Продолжительная автономная работа: auto, если доступна поддерживаемая модель.

• CI с фиксированными командами: dontAsk вместе с --allowedTools.

• Изолированная среда для выполнения без присмотра: bypassPermissions или --dangerously-skip-permissions.

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