As configurações que mudam tudo

Permissões: para de aprovar sem parar

Por defeito, o Claude pede permissão antes de cada comando shell e de cada modificação de ficheiro. É a configuração certa para começar: enquanto não souberes o que a ferramenta faz, cada ação merece um olhar. Mas ao fim de uma hora, terás aprovado trinta vezes ls, cat e git status — comandos de leitura que não podem estragar nada. Esta fricção tem um custo real: interrompe a tua concentração e, pior, treina-te a clicar «sim» mecanicamente, o que arruína o próprio interesse do controlo.

A solução: autorizar de uma vez por todas os comandos não destrutivos, e manter a validação manual para aqueles que modificam o estado do teu sistema ou tocam na rede de forma sensível. O sistema de permissões do Claude Code assenta em listas de autorização por ferramenta e por padrão de comando, guardadas em ficheiros de configuração. Podes consultá-las e modificá-las a qualquer momento com o comando /permissions.

O mais simples para começar: cola este prompt no Claude Code — ele atualizará o teu ficheiro .claude/settings.local.json, onde vivem as tuas permissões locais:

adiciona permissões a este projeto claude code para autorizar os comandos bash não destrutivos: WebSearch, WebFetch, source, export, curl, jq, cat, ls, grep, echo, which, wc, file, pwd, mkdir, touch, head, tail, find, sort, tree, diff, node, npm, npx, git status, git diff, git log

Anatomia dos ficheiros de configuração

O Claude Code lê as suas configurações a três níveis, do mais geral ao mais específico: ~/.claude/settings.json (as tuas configurações pessoais, válidas em todo o lado), .claude/settings.json (as configurações do projeto, a versionar no Git para partilhar com uma equipa), e .claude/settings.local.json (as tuas configurações locais para este projeto, ignoradas pelo Git). As permissões concedidas «para este projeto» aterram neste último.

{
  "permissions": {
    "allow": [
      "Bash(ls:*)",
      "Bash(cat:*)",
      "Bash(git status)",
      "Bash(git diff:*)",
      "WebSearch",
      "WebFetch(domain:docs.anthropic.com)"
    ],
    "deny": [
      "Bash(rm -rf:*)"
    ]
  }
}

Lê este ficheiro uma vez para compreenderes a lógica: cada entrada combina uma ferramenta (Bash, WebFetch…) e um padrão. Bash(git diff:*) autoriza git diff com quaisquer argumentos, mas não git push. A lista deny prevalece sempre sobre allow: é o teu cinto de segurança, mesmo que uma regra de autorização seja demasiado ampla.

Modos: Plan vs Auto-Edit

Para além das permissões comando a comando, o Claude Code tem modos de permissão que controlam o seu grau de autonomia global. No terminal, passas de um para o outro com Shift+Tab; na extensão, um seletor faz a mesma coisa. A prática dos utilizadores experientes: passar a maior parte do tempo em Plan Mode ou Ask Before Edits durante a fase de reflexão.

Em Plan Mode, o Claude não toca em nada: lê, analisa e apresenta-te um plano de ação detalhado. É aí que tudo se joga. Lês o que ele propõe, debates, pedes revisões: «porquê esta abordagem em vez daquela?», «adiciona uma etapa de verificação aqui». Enquanto o plano não estiver validado, ficas em modo restritivo. Uma vez o plano fechado, passas para Auto-Edit (aceitação automática das modificações) e deixa-lo executar depressa, sem te interromper a cada ficheiro.

• Plan Mode → fase de conceção: o Claude lê e planeia, não modifica nada. Ideal para as tarefas complexas ou novas.
• Ask Before Edits (por defeito) → o Claude propõe cada modificação e espera pelo teu acordo. Bom compromisso no dia a dia.
• Auto-Edit → fase de execução: o plano está validado, o Claude avança sem te interromper nas edições de ficheiros.

flowchart LR
  A["Plan Mode: o Claude propõe"] --> B{"Plano validado?"}
  B -->|"Não: debate-se, revê-se"| A
  B -->|"Sim"| C["Auto-Edit: execução rápida"]
  C --> D["Releitura do resultado"]
  D --> E["/clear e depois tarefa seguinte"]

O modo YOLO: a manusear com precaução

Existe um nível acima: lançar o Claude Code com claude --dangerously-skip-permissions, que desativa todos os pedidos de permissão. O nome é explícito — é voluntariamente intimidante. Este modo tem usos legítimos: tarefas longas e bem delimitadas (corrigir erros de lint em 50 ficheiros, gerar boilerplate) em que cada interrupção arruína o interesse da automatização.

Mas compreende o que estás a assinar: o Claude pode então executar qualquer comando sem te consultar. A recomendação da Anthropic é reservar este modo a ambientes isolados — um contentor Docker, uma máquina virtual, uma pasta sem dados sensíveis. No teu posto de trabalho principal, com os teus verdadeiros ficheiros de clientes, fica pelas listas de autorização: obténs 95% da fluidez com 5% do risco.

Contexto: recomeçar limpo com /clear e /compact

Cada conversa com o Claude vive numa janela de contexto: a memória de trabalho do modelo. Tudo entra nela — as tuas mensagens, as respostas dele, o conteúdo dos ficheiros lidos, as saídas dos comandos. Esta janela é grande mas finita, e sobretudo: quanto mais se enche de coisas sem relação com a tua tarefa atual, mais as respostas se degradam. O modelo começa a misturar os assuntos, a repescar decisões de uma tarefa anterior, a perder o fio.

Quando começas uma nova tarefa (nova funcionalidade, correção, assunto diferente), limpa a conversa para recomeçares com um contexto limpo. Existem dois comandos, e não fazem a mesma coisa:

O bom reflexo: /clear por defeito entre as tarefas, /compact apenas quando estás a meio de algo longo e o Claude te avisa que o contexto se está a encher. Nota que o Claude Code também dispara uma compactação automática quando a janela se aproxima da saturação — mas uma compactação escolhida no momento certo (depois de uma etapa terminada, não a meio de um raciocínio) preserva melhor a qualidade.

O atalho que recarrega o teu contexto

«Mas se fizer /clear, o Claude esquece todo o meu projeto!» Exato — e é por isso que o capítulo 8 existe. O ficheiro CLAUDE.md, lido automaticamente no arranque de cada sessão, contém o contexto permanente do teu projeto. /clear apaga o ruído conversacional; CLAUDE.md garante que o essencial volta sempre.

Dica de especialista entretanto: cria um atalho (por exemplo um pequeno comando qnew) que pede ao Claude para reler o teu CLAUDE.md e resumir o ponto de situação do projeto. Assim cada sessão recomeça com todo o contexto do projeto, sem o ruído das conversas passadas. Verás no capítulo 8 como construir este ficheiro como deve ser.