SpyBara
Go Premium

permission-modes.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 160 additions and 160 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 23:58 Mon 5 23:58 Tue 6 23:59 Wed 7 23:59 Sat 10 23:01 Sun 11 23:57 Wed 14 22:58 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sun 25 23:58 Mon 26 22:57 Tue 27 22:59 Wed 28 23:57 Fri 30 23:01

Escolha um modo de permissão

Controle se Claude pede permissão antes de agir. Alterne modos de permissão com Shift+Tab na CLI, o indicador de modo no VS Code ou o seletor de modo no Desktop.

Um modo de permissão define quais ações Claude pode executar em uma sessão sem pedir sua permissão primeiro. No modo Manual, Claude Code para e pede sua permissão antes da maioria das ações que editam arquivos, executam comandos shell ou acessam a rede. No modo automático, um segundo modelo, o classificador, revisa as ações em vez de você; como o classificador avalia ações lista quais ações ele revisa e quais o ignora.

Com Claude Code v2.1.283 ou posterior, o modo automático é o modo de permissão inicial integrado para sessões de terminal interativo e VS Code. Em versões anteriores, é o modo de permissão inicial integrado apenas nos planos Pro, Max e Team. Qual modo uma sessão inicia cobre as superfícies e configurações que alteram o modo de permissão inicial. Você também pode alterar o modo de permissão de uma sessão em execução a qualquer momento.

Modos disponíveis

Cada modo faz uma compensação diferente entre conveniência e supervisão. A tabela abaixo mostra o que Claude pode fazer sem um prompt de permissão em cada modo. O modo Manual aparece sob seu valor de configuração, default.

Modo O que é executado sem perguntar Melhor para
default Apenas leituras Revisar cada ação você mesmo, trabalho sensível
acceptEdits Leituras, edições de arquivo e comandos comuns do sistema de arquivos (mkdir, touch, mv, cp, etc.) Iterando sobre código que você está revisando
plan Leituras, mais comandos aprovados pelo classificador quando modo automático está disponível Explorando uma base de código antes de alterá-la
auto Tudo, com verificações de segurança em segundo plano Tarefas longas, reduzindo fadiga de prompts
dontAsk Leituras de arquivos dentro dos seus diretórios de trabalho e ferramentas pré-aprovadas; qualquer coisa que geraria um prompt é negada, embora um mod que você instalou ainda possa aprovar algumas dessas chamadas CI bloqueado e scripts
bypassPermissions Tudo Apenas contêineres isolados e VMs

O modo que revisa cada ação é nomeado Manual na CLI, em claude --help, nas extensões VS Code e JetBrains, e no aplicativo de desktop. Seu valor de configuração é default, que é o que hooks e integrações SDK usam. A CLI aceita manual como um alias em qualquer lugar onde você digita o valor, por exemplo claude --permission-mode manual ou "defaultMode": "manual".

As gravações em caminhos protegidos nunca são auto-aprovadas, exceto no modo bypassPermissions e em sessões de modo plan onde permissões de bypass estão disponíveis, significando sessões iniciadas de uma forma que coloca bypassPermissions no ciclo de modo.

Os modos definem a linha de base. Sobreponha regras de permissão no topo para pré-aprovar ou bloquear ferramentas específicas. Regras de negação bloqueiam em todos os modos, incluindo bypassPermissions. Regras de negação e solicitação não se aplicam a EndConversation enquanto Claude ainda tiver pelo menos uma outra ferramenta que possa chamar. Regras de permissão não têm efeito em bypassPermissions.

Ações que nenhum modo auto-aprova

Claude Code não auto-aprova o seguinte em nenhum modo, incluindo bypassPermissions. Cada item vincula à seção que diz o que acontece em vez disso em cada modo:

  • Ferramentas correspondidas por uma regra de solicitação explícita

  • Ferramentas de conector que sua organização definiu como ask, em sessões onde essa configuração chega a Claude Code

  • Ferramentas que requerem interação do usuário: a ferramenta integrada AskUserQuestion e ferramentas MCP marcadas requiresUserInteraction

  • Remoções reconhecidas de rm e rmdir em caminhos críticos, que nenhuma regra allow ou "allow" de hook PreToolUse aprova

  • As salvaguardas de mensagens entre sessões

  • Leituras fora dos diretórios de trabalho enquanto permissions.blockReadsOutsideWorkingDirectories está ativado: comandos Bash reconhecidos de leitura de arquivo e qualquer retry não-sandboxizado que precisa de aprovação para executar fora do sandbox, mesmo em modo automático e modo bypassPermissions. Requer Claude Code v2.1.257 ou posterior.

    Um comando que o analisador de shell não consegue rastrear, como um que muda de diretório mais de uma vez ou executa um subshell, solicita da mesma forma mesmo quando não nomeia nenhum caminho externo. Este prompt não se aplica quando o comando é executado no sandbox e o sandbox impõe o bloqueio.

Configurações comuns

Os modos de permissão decidem se Claude pede antes de uma ação, e o sandbox Bash e os limites de isolamento externos decidem o que uma ação pode alcançar uma vez que é executada. Cada linha abaixo emparelha um objetivo com as flags ou configurações que o levam lá e o isolamento que precisa, como ponto de partida. Modos disponíveis lista o que é executado sem um prompt em cada modo.

Você quer Comece com Isolamento necessário Notas
Revisar cada ação você mesmo Modo Manual: claude --permission-mode default Nenhum Trabalho sensível, código desconhecido
Iterar localmente com menos prompts, sem um classificador Modo Manual mais o sandbox Bash em modo auto-allow: claude --permission-mode default, depois execute /sandbox e selecione auto-allow O sandbox Bash integrado, em macOS, Linux e WSL2 Regras de negação ainda se aplicam, e regras de solicitação que nomeiam um comando, como Bash(git push *), ainda solicitam. O modo auto-allow abrange outros comandos que podem solicitar confirmação. Para ativar o sandbox a partir de um arquivo de configurações em vez disso, defina sandbox.enabled como true
Explorar antes de alterar qualquer coisa claude --permission-mode plan Nenhum Claude Code bloqueia edições até que você aprove um plano
Trabalhar sem supervisão em modo automático claude --permission-mode auto, o modo de permissão inicial integrado com v2.1.283 ou posterior Nenhum; um sandbox ou contêiner adiciona defesa em profundidade Requer um modelo suportado, e sua organização pode desativar o modo automático
Executar em CI com uma lista de permissões exata claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read" Nenhum além do que seu executor de CI fornece Cloud sessions ignora dontAsk de arquivos de configurações
Executar totalmente sem supervisão dentro de um contêiner claude -p "<prompt>" --dangerously-skip-permissions Obrigatório: um contêiner, VM ou o runtime do sandbox; em Linux e macOS, execute como um usuário não-root Cloud sessions ignora este modo de arquivos de configurações. Nesta execução -p, as poucas chamadas que ainda solicitariam são negadas em vez disso

O sandbox Bash e o modo automático funcionam independentemente e se combinam, com as exceções listadas em Sandbox modes. Para a interação completa, veja Como sandboxing se relaciona com permissões e modos de permissão e Como isolamento se relaciona com modos de permissão.

Qual modo uma sessão inicia

Quando você inicia uma nova sessão em um terminal, Claude Code pega o modo de permissão do primeiro destes que se aplica:

  1. A flag --permission-mode ou --dangerously-skip-permissions

  2. permissions.defaultMode em um arquivo de configurações

    Se você definir "auto" em .claude/settings.json ou .claude/settings.local.json, o valor não entra em vigor, e Claude Code então usa o padrão integrado em vez de um defaultMode de ~/.claude/settings.json. Se você definir "bypassPermissions" nesses dois arquivos, também não entra em vigor, e a sessão inicia no modo Manual. Os outros valores se aplicam de qualquer arquivo de configurações.

  3. O padrão integrado

Conversas que a extensão VS Code inicia seguem a lista própria da extensão em Alternar modos de permissão. Para o modo de permissão que Claude Code inicia uma sessão retomada, veja modo de permissão ao retomar.

O padrão integrado auto requer Claude Code v2.1.228 ou posterior em macOS, Linux e WSL, e v2.1.233 ou posterior no Windows nativo. Em versões anteriores, o padrão integrado é Manual.

O padrão integrado depende de como você executa Claude Code. A primeira linha que corresponde à sua sessão se aplica. A tabela cobre sessões que você inicia em um terminal ou através da extensão VS Code; para o aplicativo de desktop e claude.ai, veja as abas Desktop e Web em Alternar modos de permissão.

Como você executa Claude Code Modo de permissão inicial integrado
Qualquer arquivo de configurações define disableAutoMode como "disable" default
claude -p ou o Agent SDK default
Sua organização tem a configuração HIPAA aplicada e a sessão é elegível para ela default com Claude Code v2.1.285 ou posterior; o modo auto continua disponível para alternar
Em um terminal ou através da extensão VS Code auto com Claude Code v2.1.283 ou posterior; em versões anteriores, auto em planos Pro, Max ou Team em sessões que buscam sinalizadores de recurso, e default caso contrário

Quando a flag, um arquivo de configurações ou o padrão integrado seleciona auto mas o modo auto não está disponível para a sessão, Claude Code inicia a sessão no modo Manual em vez disso. O modo auto não está disponível quando a sessão não atende aos requisitos de disponibilidade, como um arquivo de configurações desativando-o ou um modelo que não o suporta, ou quando Anthropic o desativou temporariamente no lado do servidor.

A primeira vez que o padrão integrado inicia uma de suas sessões em modo auto, Claude Code mostra um aviso que vincula a esta página:

  • Em um terminal, uma vez, no topo da sessão
  • Na extensão VS Code, como um cartão na tela de nova conversa que permanece até você descartá-lo

Se seu ~/.claude/settings.json define um defaultMode diferente de auto e nenhum outro arquivo de configurações define um, suas sessões continuam iniciando nesse modo. Nos planos Pro, Max e Team, e em sessões que não buscam sinalizadores de recurso, Claude Code pergunta uma vez, no terminal ou na extensão VS Code, se você quer alterar a configuração para modo auto. Se você recusar, sua configuração permanece como está.

Chamadas de ferramenta negadas em execuções de claude -p e do Agent SDK

No Claude Code v2.1.302 ou posterior, execuções de claude -p e do Agent SDK sem modo de permissão definido iniciam no modo Manual. Esse modo aparece como default nas opções do SDK e nas configurações. Chamadas que precisam de aprovação são negadas, a menos que você as aprove com uma regra de permissão, hook, callback canUseTool ou --permission-prompt-tool.

Para que essas chamadas sejam aprovadas, adicione regras de permissão ou inicie no modo auto:

Estes exemplos mostram a forma do modo auto para a CLI e cada SDK:

CLI

claude -p "Run the test suite and fix any failures" --permission-mode auto

TypeScript

const options = {
  permissionMode: "auto"
};

Python

from claude_agent_sdk import ClaudeAgentOptions

options = ClaudeAgentOptions(permission_mode="auto")

Antes da v2.1.302, essas execuções podiam iniciar no modo auto se não buscassem sinalizadores de recurso, por exemplo em um provedor de terceiros ou com DISABLE_TELEMETRY.

Inicie em um modo de permissão diferente

Você pode definir o modo de permissão inicial para uma sessão, ou como padrão para cada sessão em uma máquina, projeto ou organização. Quando mais de um arquivo de configurações define permissions.defaultMode, precedência de configurações decide, então um valor de projeto ou gerenciado supera ~/.claude/settings.json. Para alterar o modo de permissão de uma sessão já em execução, veja Alternar modos de permissão.

Para definir o modo de permissão inicial para Faça isto
Uma sessão que você está prestes a iniciar Passe o modo de permissão como uma flag, por exemplo claude --permission-mode default
Cada sessão de terminal que você inicia nesta máquina Defina permissions.defaultMode em ~/.claude/settings.json. Para o que a extensão VS Code lê, veja Alternar modos de permissão
Cada sessão de terminal que você inicia em um projeto Defina permissions.defaultMode em .claude/settings.json do projeto. Sessões que você inicia em um terminal honram todos os valores exceto auto e bypassPermissions; sessões que a extensão VS Code inicia não leem configurações de projeto para o modo de permissão inicial
Cada sessão de terminal em sua organização Defina permissions.defaultMode em configurações gerenciadas. Sessões de terminal iniciam nesse modo e as pessoas ainda podem alternar para modo auto; para o que a extensão VS Code lê, veja Alternar modos de permissão. Para remover o modo auto para que ninguém possa selecioná-lo, defina permissions.disableAutoMode como "disable" em vez disso

Este exemplo faz cada sessão de terminal em sua máquina iniciar no modo Manual, cujo valor de configuração é default. Salve em ~/.claude/settings.json:

{
  "permissions": {
    "defaultMode": "default"
  }
}

A próxima sessão que você inicia mostra ⏸ manual mode on na barra de status.

Modos de permissão com a configuração HIPAA

Em uma organização com a configuração HIPAA aplicada, o padrão integrado auto não se aplica. Uma sessão de terminal ou do VS Code inicia no modo Manual quando nada mais escolhe seu modo de permissão inicial. Uma sessão de terminal também mostra Auto mode isn't the default for your organization · Shift+Tab to switch, e a extensão VS Code não mostra nenhum aviso. Verifique como os desenvolvedores fazem login e se conectam lista as sessões às quais isso se aplica.

O modo auto e bypassPermissions continuam disponíveis:

Requer Claude Code v2.1.285 ou posterior, a versão mínima para a configuração HIPAA.

Alternar modos de permissão

Cada interface tem seu próprio controle para alternar modos de permissão durante uma sessão e sua própria forma de escolher o modo de permissão que novas sessões iniciam. Selecione sua interface para ver seus controles.

CLI

Durante uma sessão: pressione Shift+Tab para alternar modos de permissão. De auto, o primeiro pressionamento alterna para default, e o ciclo então executa default → acceptEdits → plan. Modos opcionais se encaixam após plan. A barra de status mostra o modo ativo como um ⏸ manual mode on cinza para default, ou como ⏵⏵ accept edits on, ⏸ plan mode on, ⏵⏵ auto mode on, ⏵⏵ don't ask on ou ⏵⏵ bypass permissions on.

Observe a barra de status neste clipe de uma sessão que começou no modo auto. Cada vez que você pressiona Shift+Tab, ela muda de auto mode on para manual mode on, accept edits on, plan mode on e de volta para auto mode on.