Módulo 6 - Permissões e segurança

Caminhos protegidos e o modo sem freios

8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

  • Saber o que são os caminhos protegidos e por que existem.
  • Entender o que o modo sem freios pula.
  • Reconhecer quando esse modo e aceitavel e quando não é.
  • Adotar o ambiente isolado como condição para a autonomia total.

As defesas que já vem de fabrica

Nem toda proteção depende de você configurar. O Claude Code já traz uma defesa de fabrica: um conjunto de caminhos protegidos, arquivos e pastas tao sensíveis que ele nunca os altera sem a sua aprovação explicita, aconteça o que acontecer no modo escolhido. A ideia e evitar que um deslize corrompa coisas difíceis de recuperar. Entre esses caminhos estão a pasta do controle de versão, que guarda todo o histórico do projeto, a própria pasta de configuração do Claude Code e vários arquivos de ambiente do sistema. Mesmo num modo mais solto, tocar nesses lugares faz a ferramenta parar e pedir permissão.

Diagrama de um escudo em volta de um grupo de pastas e arquivos sensíveis rotulados: pasta de controle de versão, configuração do Claude Code e arquivos de ambiente do sistema. Uma etiqueta indica que a proteção vale em todos os modos exceto no sem freios, onde o escudo aparece rachado.
Caminhos protegidos: uma defesa de fabrica que só cai no modo sem freios.

Por que justamente esses caminhos? Porque um erro neles seria caro. Corromper a pasta de controle de versão poderia bagunçar o histórico inteiro do projeto. Alterar a configuração da própria ferramenta poderia mudar o comportamento dela de formas inesperadas, até afrouxar proteções. Mexer em arquivos de ambiente do sistema poderia afetar coisas fora do projeto. Ao trancar esses lugares por padrão, o Claude Code garante que as ações automáticas fiquem restritas ao trabalho normal, e que qualquer toque no que é estrutural passe obrigatoriamente pelo seu aval, uma camada de segurança que você nem precisa lembrar de ligar.

O modo sem freios: poder com responsabilidade

Existe um modo que derruba todas essas proteções de uma vez: o modo sem freios. Nele, o Claude Code executa qualquer ação na hora, sem checagem e sem pedir nada, inclusive nos caminhos protegidos. O nome da opção que o ativa e deliberadamente assustador, um aviso embutido de que você esta abrindo mão das redes de segurança. Isso não é um defeito nem uma armadilha; e uma ferramenta legitima para um cenário específico: rodar o agente de forma totalmente autonoma dentro de um ambiente isolado e descartavel, como um container ou uma máquina virtual que não tem acesso aos seus dados importantes e que você pode jogar fora depois.

A pergunta certa não é esse modo e perigoso, e sim onde ele está rodando. Num container descartavel, sem segredos e sem acesso ao mundo, o pior que pode acontecer e você jogar o container fora e começar de novo, então a autonomia total compensa. Na sua máquina de trabalho, com os seus projetos, as suas credenciais e o seu sistema, o mesmo modo e imprudente, porque um único comando ruim poderia causar um estrago real e difícil de desfazer. A própria ferramenta reforca esse cuidado: em sistemas comuns, ela se recusa a iniciar nesse modo com privilegios de administrador, justamente para dificultar o pé na jaca.

🎮 Jogo da aula

Modo sem freios: pode ou não?

Avalie a situação e escolha a decisão mais sensata sobre usar o modo sem freios.

Situação: quero rodar o agente de forma totalmente autonoma, sem aprovar nada.

Para quem quer menos interrupcoes sem correr esse risco, a alternativa certa quase nunca e o sem freios: e o modo automático, que reduz muito as aprovações mas mantem uma checagem de segurança em segundo plano. Ou seja, se o seu incomodo e aprovar demais, suba um degrau na autonomia, não pule direto para o abismo. Reserve o modo sem freios para o seu lugar próprio, os ambientes isolados, e trate o nome assustador da opção como o que ele é: um lembrete de que ali não ha mais nenhuma rede embaixo de você.

Autonomia total pede isolamento

A lição que amarra esta aula e simples e vale como principio: autonomia total só combina com isolamento. Quanto mais você tira as redes de segurança do agente, mais o ambiente ao redor precisa ser inofensivo. Um container sem segredos e descartavel e o lugar onde faz sentido dar liberdade máxima, porque o custo de um erro e baixo. A sua máquina principal, com projetos reais e credenciais, e o lugar onde as proteções devem ficar de pe. Casar o nível de autonomia com o nível de isolamento e o que separa um uso ousado e seguro de uma aposta arriscada.

Com isso, você já entende as camadas de defesa do Claude Code: os modos que regulam as interrupcoes, as regras que refinam o controle, os caminhos protegidos que a ferramenta já tranca e o modo sem freios que só cabe no isolamento. Falta uma camada que não está na configuração, mas na sua cabeça: os cuidados de segurança que nenhuma ferramenta automatiza por você, como desconfiar de conteúdo externo e proteger segredos. E o tema da próxima aula, e talvez o mais importante do módulo, porque trata do que só o julgamento humano resolve.

Teste rápido

Em qual situação o modo sem freios (que pula todas as checagens) e aceitavel?

Perguntas frequentes

O que são os caminhos protegidos?
São arquivos e pastas sensíveis que o Claude Code nunca altera sem a sua aprovação, em todos os modos exceto o sem freios. Incluem a pasta de controle de versão, a configuração da própria ferramenta e arquivos de ambiente do sistema. Existem para evitar que um deslize corrompa coisas difíceis de recuperar.
Preciso configurar os caminhos protegidos?
Não. Eles já vem ativos de fabrica, sem você fazer nada. São uma camada de segurança automática: mesmo num modo mais solto, o agente para e pede permissão antes de tocar nesses lugares. Você pode adicionar as suas próprias travas com regras de bloquear, mas a proteção base já está la.
Por que a opção do modo sem freios tem um nome assustador?
Porque e um aviso embutido. O nome deliberadamente alarmante lembra que você esta abrindo mão de todas as redes de segurança. Não é para o uso comum: serve para rodar o agente de forma totalmente autonoma dentro de um ambiente isolado e descartavel, onde um erro não causa estrago real.
Quero menos interrupcoes. Uso o modo sem freios?
Na máquina de trabalho, não. Para reduzir aprovações com segurança, o certo e o modo automático, que mantem uma checagem em segundo plano. Reserve o sem freios para ambientes isolados. Se o incomodo e aprovar demais, suba um degrau na autonomia, sem pular para um modo que remove todas as proteções.
Por que a ferramenta recusa rodar sem freios como administrador?
Porque combinar o modo sem checagens com privilegios de administrador multiplicaria o estrago possível de um erro, atingindo o sistema inteiro. A recusa e uma trava de segurança para dificultar esse cenário arriscado. Autonomia total foi pensada para ambientes isolados e sem privilegios elevados, não para a sua conta principal.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.