Setup Completo: do zero ao Claude Code · Capítulo 7 de 18 · 10 min
Defina o que o Claude faz sem pedir licença
Um modo de trabalho e três regras por ferramenta funcionam como a alçada de aprovação da sua empresa.
Este capítulo faz parte do curso gratuito Setup Completo: do zero ao Claude Code.
A leitura executiva antes do passo a passo: permissões são a sua política de governança para um agente (IA que age sozinha, como funcionário com a chave da loja) que executa ações reais no computador. Você define, por escrito, o que a IA pode fazer sem pedir licença e o que exige aprovação humana. É a mesma lógica de uma alçada de aprovação financeira, só que aplicada a arquivos e comandos. Acertar isso é o que separa uso responsável de risco operacional.
Duas camadas fazem esse controle. A primeira é o modo de permissão, o jeito geral de trabalhar da sessão. Desde 14 de agosto de 2026, os planos Pro, Max e Team começam no modo Auto: um porteiro automático libera o que é rotina e barra o que parece perigoso antes de executar. São seis modos no total:
| Modo | Como se comporta | Quando usar |
|---|---|---|
| Manual | Pergunta antes de cada ação | Primeira semana, para ver tudo o que ele faz |
| Accept edits | Edita arquivos livre, pergunta antes de comandos | Redação e ajustes de página |
| Plan | Só lê e propõe um plano, não altera nada | Antes de mudança grande |
| Auto (padrão) | Libera a rotina e barra o arriscado | O dia a dia |
| dontAsk (só no terminal) | Não pergunta; recusa o que as regras não liberam | Automação com lista fechada |
| Bypass permissions | Não verifica nada | Só em máquina isolada de teste |
Para abrir uma sessão já num modo, use a opção --permission-mode, por exemplo claude --permission-mode plan. A segunda camada são as regras por ferramenta: dizer ao Claude "pode fazer X, Y e Z sozinho, mas avise antes de fazer W". Elas valem por cima de qualquer modo, e uma regra de bloqueio continua bloqueando até no Bypass. É como entregar a cópia da chave da casa para o faxineiro semanal: ele limpa e organiza livremente, mas, se precisar mexer no cofre, liga primeiro. Suponha uma imobiliária de duas pessoas que usa o Claude para atualizar a página de imóveis: criar e editar arquivos fica livre, e qualquer comando que apague algo continua esperando o seu sim.
VOCÊ CLAUDE ARQUIVO │ │ │ │ "crie index.html" │ │ ├─────────────────────▶│ │ │ │ Read = Allow ✓ │ │ │ Write = Allow ✓ │ │ ├─────────────────────▶│ │ │ │ index.html criado │ │ │ │ "rode Remove-Item" │ │ ├─────────────────────▶│ │ │ │ Bash = Ask (!) │ │ ◀───── "posso?" ────┤ │ │ "sim, vai" │ │ ├─────────────────────▶├─────────────────────▶│ │ │ │ comando executado
┌─────────────────────────────────────────────────────────────────┐ │ Claude Code — Permissions /exit │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Ferramenta Status atual Alterar │ │ ────────────────── ────────────────── ────────────────────── │ │ Read ✓ Allow [Allow] [Ask] [Deny] │ │ Write ✓ Allow [Allow] [Ask] [Deny] │ │ Edit ✓ Allow [Allow] [Ask] [Deny] │ │ Glob ✓ Allow [Allow] [Ask] [Deny] │ │ Grep ✓ Allow [Allow] [Ask] [Deny] │ │ WebFetch ✓ Allow [Allow] [Ask] [Deny] │ │ WebSearch ✓ Allow [Allow] [Ask] [Deny] │ │ Bash ! Ask [Allow] [Ask] [Deny] │ │ PowerShell ! Ask [Allow] [Ask] [Deny] │ │ │ │ Modo da sessão: Auto (padrão) │ │ ← Terminal em "Ask" = Claude pergunta antes de rodar comandos. │ │ Ideal para iniciantes. Troque para Allow após ~1 mês de uso. │ └─────────────────────────────────────────────────────────────────┘
Maneira mais simples, pelo menu visual dentro do Claude Code
- 01Abra o PowerShell (Windows + digitar "powershell" + Enter).
- 02Digite claude e Enter.
- 03Já dentro do Claude Code, digite /permissions (com a barra) e aperte Enter.
- 04Aparece um menu com as ferramentas que o Claude pode usar: Read (ler arquivos), Write (criar arquivos), Edit (editar), Bash (rodar comandos), entre outras.
- 05Para cada uma, você escolhe Allow (permitir), Ask (perguntar a cada vez) ou Deny (bloquear).
Configuração recomendada para iniciantes
| Ferramenta | O que faz | Sugestão |
|---|---|---|
| Read | Lê arquivos do seu computador | Allow (permitir sempre) |
| Write | Cria novos arquivos | Allow |
| Edit | Edita arquivos existentes | Allow |
| Grep / Glob | Procura por texto em arquivos | Allow |
| WebFetch / WebSearch | Pesquisa coisas na internet | Allow |
| Bash / PowerShell | Rodam comandos no terminal | Ask (deixe perguntando, é o mais perigoso) |
Bash é a ferramenta que mais merece cuidado. Comandos de terminal podem deletar arquivos, mexer no Git e até apagar pastas inteiras. Deixe em Ask até ganhar confiança, mesmo com o modo Auto ligado: a regra escrita vale por cima do porteiro automático. Com um mês de uso, libere o Bash só para comandos específicos, como os do git.
Atalho turbo: peça em português que o Claude configure tudo sozinho.
Em vez de clicar em menu por menu, abra o Claude Code no terminal embutido do VS Code (no passo em que rodamos o Claude Code dentro do VS Code: Terminal → Novo Terminal → digite claude) e cole o prompt abaixo (o pedido escrito, como um bilhete de instruções ao funcionário). Ele lê o arquivo %USERPROFILE%\.claude\settings.json, aplica a configuração recomendada e mostra o resultado antes de salvar.
Maneira avançada: editar direto o arquivo de configuração.
O arquivo fica numa pasta chamada .claude dentro da sua pasta de usuário. Para chegar lá
- 01Aperte Windows + R ao mesmo tempo.
- 02Digite %USERPROFILE%\.claude e aperte Enter.
- 03Abre o Explorador de Arquivos na pasta certa.
- 04Procure (ou crie) um arquivo chamado settings.json.
- 05Clique nele com o botão direito → Abrir com → Visual Studio Code.
- 06Cole o conteúdo abaixo e salve com Ctrl+S.
{
"permissions": {
"allow": [
"Read",
"Write",
"Edit",
"Glob",
"Grep",
"WebFetch",
"WebSearch"
],
"ask": [
"Bash",
"PowerShell"
]
}
}Esse trecho entre chaves {...} é só um arquivo de configuração. Você não precisa entender JSON: copie, cole, salve. O Claude Code lê esse arquivo automaticamente toda vez que você abrir.
Para a configuração entrar em vigor, saia do Claude Code (digite /exit) e abra de novo.
BASH = Ask (recomendado para iniciantes): ───────────────────────────────────────────────────────── Você: "apague os arquivos temporários" Claude: (detecta que vai usar Remove-Item) Claude: "Posso rodar 'Remove-Item *.tmp'? [Aprovar / Negar]" Você: [Aprovar] Claude: executa ✓ BASH = Allow (para usuários experientes): ───────────────────────────────────────────────────────── Você: "apague os arquivos temporários" Claude: (detecta que vai usar Remove-Item) Claude: Remove-Item *.tmp ← executa direto, sem perguntar Claude: "Feito." ✓ Regra: comece em Ask. Quando conhecer bem o que o Claude faz no seu PC (cerca de 1 mês de uso), passe para Allow.
Com as permissões definidas, você controlou o que o Claude faz. Falta controlar o que ele envia. Esse é o assunto do próximo passo, sobre segurança e privacidade: o que sai da sua máquina para a nuvem e o que você nunca deve colar num prompt.
Abra o Claude Code, digite /permissions e confira a lista. O acerto é ver Read, Write e Edit em Allow e Bash e PowerShell em Ask. Depois peça "crie um arquivo teste.txt" e depois "apague o teste.txt": o primeiro pedido roda direto e o segundo para e pede o seu sim. Aconteceu assim? A alçada está no lugar.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
Depois, siga para
- CursoClaude Code CLI: Programação com IA
- CursoAgentes de código para executivossugerido pelo grafoO Setup ensina permissões, contexto do projeto e escolha de modelo por custo. Essa preparação sustenta os exercícios de comparação de assistentes, criação do gerador de UTM e regras de projeto no curso de aprendizado por reforço e vibecoding.
- CursoSetup de Vibecoding no Macsugerido pelo grafo11 capítulos de “Setup de Vibecoding no Mac” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
- CursoVídeo com IA: Claude Code, Codex e ElevenLabssugerido pelo grafo7 capítulos de “Vídeo com IA: Claude Code, Codex e ElevenLabs” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup de Vibecoding no MacConfigurar permissões (parar de aprovar tudo o tempo todo)Examinar conexões de Configurar permissões (parar de aprovar tudo o tempo todo)
- Claude Code CLI: Programação com IAFazer a primeira delegação ao Claude e ver o arquivo nascerExaminar conexões de Fazer a primeira delegação ao Claude e ver o arquivo nascer
- VS Code: Do Zero ao Editor ProfissionalClaude Code: o que um líder faz sem programarExaminar conexões de Claude Code: o que um líder faz sem programar
- Skills de IA com Vibecoding e TerminalModos de Permissão: Equilibrando Velocidade e Controle HumanoExaminar conexões de Modos de Permissão: Equilibrando Velocidade e Controle Humano
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.