Руководства

Настройка разрешений

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

Claude Agent SDK предоставляет элементы управления разрешениями для управления использованием инструментов Claude. Используйте режимы разрешений и правила для определения того, что разрешено автоматически, и обратный вызов canUseTool для обработки всего остального во время выполнения.

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

Как оцениваются разрешения

Когда Claude запрашивает инструмент, SDK проверяет разрешения в следующем порядке:

Хуки
Запустите хуки в первую очередь, которые могут разрешить, запретить или перейти к следующему шагу
Правила разрешений
Проверьте правила, определённые в settings.json в этом порядке: сначала правила deny (блокируют независимо от других правил), затем правила allow (разрешают при совпадении), затем правила ask (запрашивают утверждение). Эти декларативные правила позволяют вам предварительно одобрить, заблокировать или потребовать утверждение для конкретных инструментов без написания кода.
Режим разрешений
Применить активный режим разрешений (bypassPermissions, acceptEdits, dontAsk и т. д.)
Обратный вызов canUseTool
Если не разрешено правилами или режимами, вызовите ваш обратный вызов canUseTool для принятия решения

На этой странице основное внимание уделяется режимам разрешений (шаг 3), статической конфигурации, которая контролирует поведение по умолчанию. Для других шагов:

Хуки: запустите пользовательский код для разрешения, запрета или изменения запросов инструментов. См. Управление выполнением с помощью хуков.
Правила разрешений: настройте декларативные правила разрешения/запрета в settings.json. См. Параметры разрешений.
Обратный вызов canUseTool: запросите утверждение пользователя во время выполнения. См. Обработка утверждений и ввода пользователя.

Режимы разрешений

Режимы разрешений обеспечивают глобальный контроль над использованием инструментов Claude. Вы можете установить режим разрешений при вызове query() или изменить его динамически во время сеансов потоковой передачи.

Доступные режимы

SDK поддерживает эти режимы разрешений:

Режим	Описание	Поведение инструмента
`default`	Стандартное поведение разрешений	Без автоматических одобрений; несовпадающие инструменты запускают ваш обратный вызов `canUseTool`
`acceptEdits`	Автоматически принимать редактирование файлов	Редактирование файлов и операции с файловой системой (`mkdir`, `rm`, `mv` и т. д.) автоматически одобряются
`bypassPermissions`	Обойти все проверки разрешений	Все инструменты работают без запросов разрешений (используйте с осторожностью)
`plan`	Режим планирования	Нет выполнения инструментов; Claude планирует без внесения изменений

Наследование подагентом: при использовании bypassPermissions все подагенты наследуют этот режим, и его нельзя переопределить. Подагенты могут иметь различные системные подсказки и менее ограниченное поведение, чем ваш основной агент. Включение bypassPermissions предоставляет им полный автономный доступ к системе без каких-либо запросов утверждения.

Установка режима разрешений

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

Детали режимов

Режим принятия редактирования (`acceptEdits`)

Автоматически одобряет операции с файлами, чтобы Claude мог редактировать код без запросов. Другие инструменты (такие как команды Bash, которые не являются операциями с файловой системой) по-прежнему требуют обычных разрешений.

Автоматически одобренные операции:

Редактирование файлов (инструменты Edit, Write)
Команды файловой системы: mkdir, touch, rm, mv, cp

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

Режим обхода разрешений (`bypassPermissions`)

Автоматически одобряет все использования инструментов без запросов. Хуки по-прежнему выполняются и могут блокировать операции при необходимости.

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

Режим планирования (`plan`)

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

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

Связанные ресурсы

Для других шагов в потоке оценки разрешений:

Обработка утверждений и ввода пользователя: интерактивные запросы утверждения и уточняющие вопросы
Руководство по хукам: запуск пользовательского кода в ключевых точках жизненного цикла агента
Правила разрешений: декларативные правила разрешения/запрета в settings.json

Was this page helpful?

Руководства

Настройка разрешений

Как оцениваются разрешения

Когда Claude запрашивает инструмент, SDK проверяет разрешения в следующем порядке:

Хуки
Запустите хуки в первую очередь, которые могут разрешить, запретить или перейти к следующему шагу
Правила разрешений
Проверьте правила, определённые в settings.json в этом порядке: сначала правила deny (блокируют независимо от других правил), затем правила allow (разрешают при совпадении), затем правила ask (запрашивают утверждение). Эти декларативные правила позволяют вам предварительно одобрить, заблокировать или потребовать утверждение для конкретных инструментов без написания кода.
Режим разрешений
Применить активный режим разрешений (bypassPermissions, acceptEdits, dontAsk и т. д.)
Обратный вызов canUseTool
Если не разрешено правилами или режимами, вызовите ваш обратный вызов canUseTool для принятия решения

Хуки: запустите пользовательский код для разрешения, запрета или изменения запросов инструментов. См. Управление выполнением с помощью хуков.
Правила разрешений: настройте декларативные правила разрешения/запрета в settings.json. См. Параметры разрешений.
Обратный вызов canUseTool: запросите утверждение пользователя во время выполнения. См. Обработка утверждений и ввода пользователя.

Режимы разрешений

Доступные режимы

SDK поддерживает эти режимы разрешений:

Режим	Описание	Поведение инструмента
`default`	Стандартное поведение разрешений	Без автоматических одобрений; несовпадающие инструменты запускают ваш обратный вызов `canUseTool`
`acceptEdits`	Автоматически принимать редактирование файлов	Редактирование файлов и операции с файловой системой (`mkdir`, `rm`, `mv` и т. д.) автоматически одобряются
`bypassPermissions`	Обойти все проверки разрешений	Все инструменты работают без запросов разрешений (используйте с осторожностью)
`plan`	Режим планирования	Нет выполнения инструментов; Claude планирует без внесения изменений

Установка режима разрешений

Детали режимов

Режим принятия редактирования (`acceptEdits`)

Автоматически одобренные операции:

Редактирование файлов (инструменты Edit, Write)
Команды файловой системы: mkdir, touch, rm, mv, cp

Режим обхода разрешений (`bypassPermissions`)

Режим планирования (`plan`)

Связанные ресурсы

Для других шагов в потоке оценки разрешений:

Обработка утверждений и ввода пользователя: интерактивные запросы утверждения и уточняющие вопросы
Руководство по хукам: запуск пользовательского кода в ключевых точках жизненного цикла агента
Правила разрешений: декларативные правила разрешения/запрета в settings.json

Was this page helpful?

Как оцениваются разрешения

Режимы разрешений

Доступные режимы

Установка режима разрешений

Детали режимов

Режим принятия редактирования (acceptEdits)

Режим обхода разрешений (bypassPermissions)

Режим планирования (plan)

Связанные ресурсы

Как оцениваются разрешения

Режимы разрешений

Доступные режимы

Установка режима разрешений

Детали режимов

Режим принятия редактирования (acceptEdits)

Режим обхода разрешений (bypassPermissions)

Режим планирования (plan)

Связанные ресурсы

Режим принятия редактирования (`acceptEdits`)

Режим обхода разрешений (`bypassPermissions`)

Режим планирования (`plan`)

Режим принятия редактирования (`acceptEdits`)

Режим обхода разрешений (`bypassPermissions`)

Режим планирования (`plan`)