Permissões e modos do Claude Code
VPS Agêntica
O mesmo ambiente do SetupVibe, agora numa VPS
Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.
Link de parceiro da Promovaweb.
Black Friday até 30/11
30%off
nos 2 primeiros meses do plano mensal da VPS
- Backup diário grátis para sempre
- Servidores em São Paulo no datacenter da Ascenty
- Datacenter Tier III manutenção sem parada
- Acesso root com disco SSD NVMe
- Réplica do backup em Ashburn, nos EUA
As permissões do Claude Code são limites aplicados pelo próprio cliente a cada chamada de ferramenta, como uma edição, um comando de shell ou uma busca na web. O modo da sessão define o comportamento padrão, enquanto as entradas allow, ask e deny dos arquivos de settings abrem ou fecham ações específicas por cima dele.
Sumário da página
Cada ferramenta tem um nível de aprovação
Você manda o agente investigar por que uma rota da API devolve erro 500. Ele lê arquivos e faz buscas sem perguntar nada, porque leitura dentro da pasta de trabalho não exige aprovação. Quando decide rodar npm test, a tela mostra o comando e espera a sua resposta. Quando propõe editar o controller, espera outra vez. Esse comportamento é o modo Manual, que começa só com permissões de leitura e consulta você antes de editar ou executar.
A Anthropic divide as ferramentas em níveis. Leitura e busca rodam livres dentro do diretório de trabalho e dos diretórios adicionais. Comandos de shell exigem aprovação, exceto um conjunto embutido de comandos só de leitura, como ls, cat e git status. Edição de arquivo exige aprovação. Busca e leitura de páginas na web também exigem, exceto um grupo de domínios de documentação pré-aprovados.
A opção de aprovar sem perguntar de novo também muda de alcance conforme o nível. Para um comando de shell, a liberação fica gravada para aquele repositório e aquele comando. Para edições de arquivo, vale até o fim da sessão.
Chamada
O modelo solicita uma ferramenta, como Bash ou Edit.
Permissões
Deny vence ask, que vence allow. A primeira que casa decide.
Modo
Sem entrada aplicável, o modo da sessão define o padrão.
Resultado
A execução ou a recusa volta ao modelo como informação.
Os modos mudam o padrão da sessão
A tecla Shift+Tab alterna entre os modos durante a sessão. A chave defaultMode nos settings define o modo das sessões novas. O modo Manual, chamado de default nos arquivos, pergunta no primeiro uso de cada ferramenta. O Accept edits aceita sozinho as edições de arquivo e comandos de sistema de arquivos como mkdir, touch, mv e cp dentro da pasta de trabalho. O Plan lê arquivos e roda comandos só de leitura para explorar, mas não edita o código. Ele termina com um plano para você aprovar.
O modo Auto troca a sua aprovação rotineira por um classificador que revisa as ações em segundo plano e barra as que julga perigosas. A partir da versão 2.1.283, ele é o modo inicial das sessões interativas no terminal e no VS Code. O dontAsk nega tudo que exigiria aprovação e só roda o que já está liberado, o que serve para sessões automáticas, sem acompanhamento na tela. O bypassPermissions pula as solicitações de aprovação. A documentação recomenda esse modo só em ambientes isolados, como containers e máquinas virtuais, porque ele libera inclusive a escrita em caminhos protegidos como .git e .claude.
Permissões allow, ask e deny
Cada entrada segue o formato Ferramenta ou Ferramenta(especificador). A entrada Bash(npm run test *) casa com os comandos de teste do projeto. A entrada Read(./.env) casa com a leitura do arquivo de variáveis. O comando /permissions abre a lista de todas as entradas ativas com o arquivo de origem de cada uma.
A ordem de avaliação é fixa: deny primeiro, ask depois e allow por último. A primeira entrada que casa decide. A especificidade não muda essa ordem. Um deny amplo como Bash(aws *) barra também aws s3 ls, mesmo com um allow específico para esse comando. Um deny com o nome puro da ferramenta, como Bash, retira a ferramenta inteira da visão do modelo. Um deny com padrão, como Bash(rm *), deixa a ferramenta disponível e recusa só as chamadas que casam.
As permissões são aplicadas pelo Claude Code, fora do modelo. Uma frase no CLAUDE.md dizendo “não rode migrações” orienta o que o agente tenta fazer. A entrada deny no settings garante que a chamada não acontece. Para mudar o que o agente pode fazer, você usa /permissions, as entradas dos arquivos, o modo da sessão ou um hook PreToolUse.
Onde as permissões moram
O Claude Code lê settings em quatro lugares. O ~/.claude/settings.json vale para você em todos os projetos da máquina. O .claude/settings.json do projeto vai para o Git e chega a todos os colegas do repositório. O .claude/settings.local.json fica fora do Git e guarda os ajustes pessoais daquele projeto. Os managed settings chegam pela organização, por arquivo, política de MDM ou pelo console do claude.ai. Nada abaixo deles consegue sobrepor uma chave gerenciada.
Entre os arquivos, a precedência vai dos managed settings para a linha de comando, depois o arquivo local, o do projeto e o do usuário. As listas de permissões se somam entre os níveis. Um deny em qualquer nível vence um allow em outro, então o deny do seu arquivo pessoal barra o allow que os colegas colocaram no projeto.
As entradas allow e os diretórios adicionais do .claude/settings.json de um projeto só valem depois que você aceita o diálogo de confiança daquela pasta. Esse diálogo lista o que o repositório quer liberar, para você conferir antes. As entradas deny e ask valem desde o começo, porque só restringem.
Permissões e sandbox são camadas diferentes
As permissões decidem quais ferramentas o agente usa e quais arquivos ou domínios ele acessa. A sandbox é uma barreira do sistema operacional em volta dos comandos de shell, com limites de sistema de arquivos e de rede para o Bash, o PowerShell e os processos que eles abrem. Ela vem desligada e liga com /sandbox ou com a chave sandbox.enabled. Roda no macOS, no Linux e no WSL2. No Windows nativo, os comandos rodam sem sandbox.
A documentação recomenda as duas juntas. Se um texto malicioso num arquivo ou numa página conseguir desviar o raciocínio do modelo, a sandbox continua aplicando os limites ao processo. As ferramentas de arquivo, os servidores MCP e os hooks rodam fora dela e seguem só as permissões.
O limite da pasta de trabalho no modo Manual também é uma solicitação de aprovação, não uma barreira do sistema. Um comando de shell que você aprova consegue escrever em qualquer lugar que o seu usuário alcança. Por isso a revisão de cada comando antes de aprovar continua sendo sua, como a própria Anthropic registra na página de segurança.