Configurar permissões

​

Como as permissões são avaliadas

• permissionMode: 'bypassPermissions', que aprova automaticamente cada chamada que chega à etapa do modo de permissão, exceto pelas ações que nenhum modo aprova automaticamente
• Cada entrada allowedTools simples como "Read", que aprova automaticamente essa ferramenta inteira antes do callback ser consultado, exceto pelas ações que nenhum modo aprova automaticamente e pelas leituras de caminhos de rede

• Hooks: execute código personalizado para permitir, negar ou modificar solicitações de ferramenta. Veja Controlar execução com hooks.
• Callback canUseTool: solicite aprovação dos usuários em tempo de execução, quando nenhuma etapa anterior resolver a chamada. Veja Lidar com aprovações e entrada do usuário.

​

Regras de permissão e negação

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

​

Modos de permissão

• Um permissions.defaultMode dos arquivos de configuração da sessão quando um se aplica
• Caso contrário, o padrão integrado, que pode ser modo auto

​

Modos disponíveis

​

Definir modo de permissão

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();

​

Detalhes do modo

​

Modo aceitar edições (acceptEdits)

• Edições de arquivo (ferramentas Edit, Write)
• Comandos do sistema de arquivos: mkdir, touch, rm, rmdir, mv, cp, sed

• Trabalha em um caminho fora desse escopo
• Escreve em um caminho protegido
• Remove um caminho crítico com rm ou rmdir

​

Modo não perguntar (dontAsk)

​

Modo contornar permissões (bypassPermissions)

​

Modo plano (plan)

​

Modo auto (auto)

• O que você vê: uma mensagem system com subtipo status e permissionMode definido como "default", que o TypeScript SDK tipa como SDKStatusMessage. A partir daí, chamadas que precisam de aprovação e não correspondem a nenhuma regra de permissão chegam ao seu callback canUseTool.
• Para retornar ao modo auto: alterne para um modelo suportado e, em seguida, chame set_permission_mode("auto") ou setPermissionMode("auto"). Se você alternar o modelo de volta sem fazer essa chamada, a sessão permanece no modo default. Enquanto o modelo não suportado estiver ativo, a chamada falha com Cannot set permission mode to auto: auto mode unavailable for this model.

​

Recursos relacionados

• Lidar com aprovações e entrada do usuário: prompts de aprovação interativa e perguntas de esclarecimento
• Guia de hooks: executar código personalizado em pontos-chave do ciclo de vida do agente
• Regras de permissão: regras declarativas de permissão/negação em settings.json