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

​

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

• permissionMode: 'bypassPermissions', который автоматически одобряет каждый вызов, достигающий шага режима разрешений, кроме действий, которые ни один режим не одобряет автоматически
• Каждая запись allowedTools без спецификатора, такая как "Read", которая автоматически одобряет весь этот инструмент перед консультацией callback, кроме действий, которые ни один режим не одобряет автоматически и чтения из сетевых путей

• Hooks: запустите пользовательский код для разрешения, отклонения или изменения запросов инструментов. См. Control execution with hooks.
• canUseTool callback: запросите у пользователей одобрение во время выполнения, когда ни один более ранний шаг не разрешит вызов. См. Handle approvals and user input.

​

Правила разрешения и запрета

const options = {
  allowedTools: ["Read", "Glob", "Grep"],
  permissionMode: "dontAsk"
};

​

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

• permissions.defaultMode из файлов параметров сеанса, когда он применяется
• В противном случае встроенное значение по умолчанию, которое может быть режимом auto

​

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

​

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

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions


async def main():
    async for message in query(
        prompt="Help me refactor this code",
        options=ClaudeAgentOptions(
            permission_mode="default",  # Set the mode here
        ),
    ):
        if hasattr(message, "result"):
            print(message.result)


asyncio.run(main())

import { query } from "@anthropic-ai/claude-agent-sdk";

async function main() {
  for await (const message of query({
    prompt: "Help me refactor this code",
    options: {
      permissionMode: "default" // Set the mode here
    }
  })) {
    if ("result" in message) {
      console.log(message.result);
    }
  }
}

main();

import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions


async def main():
    async with ClaudeSDKClient(
        options=ClaudeAgentOptions(
            permission_mode="default",  # Start in default mode
        )
    ) as client:
        await client.query("Help me refactor this code")

        # Change mode dynamically mid-session
        await client.set_permission_mode("acceptEdits")

        # Process messages with the new permission mode
        async for message in client.receive_response():
            if hasattr(message, "result"):
                print(message.result)


asyncio.run(main())

import { query } from "@anthropic-ai/claude-agent-sdk";

async function main() {
  const q = query({
    prompt: "Help me refactor this code",
    options: {
      permissionMode: "default" // Start in default mode
    }
  });

  // Change mode dynamically mid-session
  await q.setPermissionMode("acceptEdits");

  // Process messages with the new permission mode
  for await (const message of q) {
    if ("result" in message) {
      console.log(message.result);
    }
  }
}

main();

​

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

​

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

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

• Работает с путем вне этой области
• Записывает в защищенный путь
• Удаляет критический путь с помощью rm или rmdir

​

Режим не спрашивать (dontAsk)

​

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

​

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

​

Авторежим (auto)

• Что вы увидите: сообщение system с подтипом status и permissionMode, установленным в "default", которое TypeScript SDK типизирует как SDKStatusMessage. С этого момента вызовы, требующие подтверждения и не соответствующие никакому правилу разрешения, достигают вашего обратного вызова canUseTool.
• Чтобы вернуться в авторежим: переключитесь на поддерживаемую модель, затем вызовите set_permission_mode("auto") или setPermissionMode("auto"). Если вы переключите модель обратно без этого вызова, сессия останется в режиме default. Пока активна неподдерживаемая модель, вызов завершается ошибкой Cannot set permission mode to auto: auto mode unavailable for this model.

​

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

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