Режимы разрешений Claude Code: шесть способов управлять действиями агента
Claude Code может самостоятельно читать файлы, менять код, выполнять команды в терминале и обращаться к внешним сервисам. Однако в одних случаях Claude Code запрашивает подтверждение перед действием, а в других продолжает работу самостоятельно. Поведение зависит от выбранного режима разрешений.
В Claude Code предусмотрено шесть таких режимов. Они определяют, какие действия агент может выполнять без согласования с пользователем. Различия особенно заметны при работе над большими проектами, когда постоянные запросы разрешений мешают выполнению задачи.
В новых версиях Claude Code по умолчанию работает auto mode
Начиная с версии 2.1.283, auto mode стал встроенным начальным режимом для интерактивных сессий в терминале и VS Code. Ранее такой режим по умолчанию использовался только на тарифах Pro, Max и Team.
В auto mode отдельная проверяющая модель анализирует действия Claude перед выполнением. Пользователю больше не приходится самостоятельно подтверждать каждое изменение файла или запуск команды. При обнаружении потенциально опасного действия проверяющая модель может его заблокировать.
Текущий режим отображается в строке состояния Claude Code. Переключаться между режимами в терминале можно сочетанием Shift+Tab.
Разбираю Claude Code и ИИ-агентов на практике: как применять их в реальных рабочих задачах, автоматизировать рутину, собирать собственных ИИ-ассистентов и зарабатывать с помощью новых технологий. Практические разборы, инструменты, кейсы и эксперименты: от первого ИИ-агента до полноценных рабочих систем. Подписывайтесь.
Manual оставляет пользователю контроль над выполнением команд
Ручной режим называется Manual, хотя в настройках ему соответствует значение default. При его использовании Claude Code свободно читает файлы и выполняет разрешённые операции чтения, но запрашивает подтверждение перед большинством изменений, запуском команд и обращениями к сети.
Запустить агент сразу в ручном режиме можно командой:
claude --permission-mode default
Manual подходит для работы с незнакомым проектом, чувствительными данными или кодом, изменения которого требуют внимательной проверки.
Пользователь самостоятельно решает, разрешать ли очередную операцию. Такой подход увеличивает число остановок во время работы, зато позволяет проверять действия до выполнения.
Если требуется меньше запросов без подключения проверяющей модели, документация предлагает сочетать Manual со встроенной песочницей Bash. Для этого после запуска нужно выполнить /sandbox и выбрать auto-allow.
Песочница ограничивает доступ команд к системе, а разрешённые внутри неё операции могут выполняться без постоянных подтверждений. Явные правила запрета продолжают действовать. Команды, для которых установлено обязательное подтверждение, также могут вызывать запрос.
acceptEdits позволяет менять файлы без каждого подтверждения
Режим acceptEdits предназначен для ситуаций, когда пользователь готов проверять изменения после их внесения.
Claude Code автоматически получает разрешение создавать и редактировать файлы в рабочем каталоге. Дополнительно разрешаются распространённые файловые команды, включая mkdir, touch, mv, cp, sed, rm и rmdir.
Для включения достаточно выполнить:
claude --permission-mode acceptEdits
Автоматическое разрешение распространяется на рабочую директорию и дополнительные разрешённые каталоги. Запись за их пределами требует отдельного подтверждения.
Сохраняются и другие ограничения. Например, Claude Code не сможет автоматически удалить критический системный каталог или записать данные в защищённый путь. Большинство остальных команд оболочки по-прежнему требуют разрешения, если они не входят во встроенный набор операций только для чтения.
Режим удобен при последовательной доработке кода. Агент вносит изменения, после чего пользователь просматривает результат в редакторе или через git diff.
Plan помогает согласовать изменения до начала работы
Режим plan позволяет сначала исследовать проект и подготовить план действий.
Claude Code изучает файлы, выполняет допустимые команды для анализа и формирует последовательность предлагаемых изменений. В обычной сессии редактирование исходного кода остаётся заблокированным до утверждения плана.
Запуск:
claude --permission-mode plan
Во время работы можно перейти в планирование через Shift+Tab или использовать команду /plan для отдельного запроса.
Когда план готов, Claude Code предлагает несколько вариантов продолжения:
• Yes, and use auto mode. Утвердить план и перейти к выполнению с автоматической проверкой действий.
• Yes, manually approve edits. Утвердить план, сохранив ручное подтверждение изменений.
• No, keep planning. Продолжить планирование и попросить Claude скорректировать предложенные действия.
Если auto mode недоступен, первый вариант заменяется автоматическим принятием правок. При запуске с доступным обходом разрешений соответствующий вариант может переключать сессию в bypassPermissions.
Предложенный план можно открыть в текстовом редакторе через Ctrl+G и исправить самостоятельно.
Для планирования действует отдельная особенность: когда auto mode доступен, проверяющая модель может разрешать исследовательские команды без участия пользователя. Если такой возможности нет, команды за пределами разрешённого набора операций чтения запрашивают подтверждение.
Auto выполняет задачи самостоятельно, но блокирует рискованные действия
В auto Claude Code работает без большинства стандартных запросов разрешений. Перед выполнением операций их анализирует отдельная модель-классификатор, которая оценивает соответствие действия запросу пользователя и возможные последствия.
По умолчанию проверка блокирует, среди прочего:
• скачивание и непосредственный запуск внешнего кода, например через curl | bash;
• передачу конфиденциальной информации на внешние адреса;
• развёртывание изменений в production и миграции;
• массовое удаление данных в облачном хранилище;
• принудительную отправку изменений через git push --force;
• команды Git, способные уничтожить несохранённые изменения, включая git reset --hard;
• изменение прав доступа к инфраструктуре и репозиториям;
• уничтожение инфраструктурных ресурсов через terraform destroy и аналогичные команды.
Такие ограничения действуют по умолчанию. Документация допускает согласование конкретных операций, если пользователь явно укажет действие и связанные с ним риски. Однако некоторые блокировки требуют выхода из auto mode и ручного подтверждения.
Отдельно можно обозначить границы непосредственно в диалоге. Например, попросить Claude не отправлять изменения в репозиторий до проверки. Классификатор учитывает подобные указания при анализе действий.
Для постоянной защиты надёжнее использовать правила deny, поскольку ограничения из переписки могут потеряться при сокращении контекста сессии.
При трёх последовательных блокировках или двадцати блокировках за сессию auto mode временно возвращает запросы подтверждений. После разрешения соответствующего действия автоматический режим возобновляется.
Auto mode подходит для продолжительных задач, когда пользователь доверяет общей последовательности работы, но хочет сохранить дополнительную проверку потенциально опасных операций.
Проверка классификатором снижает количество запросов и рисков, однако не гарантирует безопасность каждого действия.
dontAsk запускает только заранее разрешённые операции
Режим dontAsk предназначен прежде всего для автоматизированных сценариев, в которых некому отвечать на запросы разрешений.
Claude Code выполняет операции чтения в рабочей директории и инструменты, разрешённые заранее. Любое действие, которому понадобилось бы подтверждение, автоматически отклоняется.
Запуск:
claude --permission-mode dontAsk
Для CI, системы непрерывной интеграции, в которой автоматически запускаются проверки проекта, можно заранее определить список допустимых команд:
claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"
В примере агент получает возможность читать файлы и запускать npm test. Другие операции, требующие подтверждения, будут отклоняться, если они не разрешены отдельными правилами.
Важное отличие от auto mode заключается в отсутствии попытки самостоятельно согласовать действие через модель-классификатор. Если операции нет среди разрешённых, агент её не выполняет.
bypassPermissions снимает почти все проверки
bypassPermissions отключает стандартные запросы разрешений и проверки безопасности. Claude Code получает возможность немедленно выполнять команды и изменять даже защищённые пути.
Режим можно включить при запуске:
claude --dangerously-skip-permissions
Однако название режима не означает, что абсолютно любое действие будет выполнено без ограничений.
Продолжают действовать явные правила deny и ask, отдельные требования интерактивного подтверждения, а также проверки некоторых опасных операций удаления.
Например, команда rm -rf ~, направленная на рекурсивное удаление домашней директории, распознаётся как попытка удаления критического пути. Даже в bypassPermissions Claude Code обычно требует дополнительного разрешения в терминале.
Начиная с версии 2.1.311, документация предусматривает возможность отключить и этот запрос переменной окружения CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS=1. Переменная должна присутствовать в окружении при запуске Claude Code. Указание её в блоке env файла настроек не сработает.
Такой уровень доступа требует особенно строгой изоляции.
Anthropic рекомендует использовать bypassPermissions только в контейнерах, виртуальных машинах или изолированных средах разработки без доступа к интернету. Агент не должен иметь возможности повредить основную систему пользователя.
Защищённые пути остаются под контролем системы разрешений
В Claude Code существуют защищённые пути, запись в которые не получает обычного автоматического одобрения.
Ограничение распространяется на режимы Manual, acceptEdits, plan и auto. Исключение предусмотрено для bypassPermissions, а также для особых интерактивных сессий планирования, запущенных с доступным обходом разрешений.
Отдельная категория защиты относится к критическим путям файловой системы. Claude Code проверяет распознаваемые операции удаления системного корня, домашней папки, рабочего каталога и других критических директорий через rm и rmdir.
Такая проверка может пропустить отдельные способы удаления. Поэтому ограничения на уровне операционной системы и изолированного окружения остаются необходимыми даже при использовании встроенных механизмов безопасности.
Шесть практических сценариев выбора режима
Для повседневной работы можно ориентироваться на следующие сочетания:
• Проверять каждое изменение самостоятельно: Manual.
• Работать локально с меньшим числом запросов и без классификатора: Manual вместе с /sandbox в режиме auto-allow.
• Сначала исследовать незнакомый проект: plan с утверждением предложенных изменений.
• Поручить продолжительную задачу с автоматической проверкой: auto.
• Запустить скрипт в CI с фиксированным набором команд: dontAsk и --allowedTools.
• Выполнить задачу полностью без присмотра: bypassPermissions исключительно внутри изолированного контейнера или виртуальной машины.
Переключение режимов доступно во время сессии через Shift+Tab. Из auto mode первое нажатие переводит в Manual, затем последовательно доступны acceptEdits и plan. Дополнительные режимы появляются в цикле в зависимости от настроек и способа запуска.
dontAsk в этот цикл не входит, его задают через параметр запуска. Для доступа к bypassPermissions необходимо разрешить его ещё при создании сессии.
Источник: документация Claude Code.