Qual modo devo usar como iniciante?

Comece no modo manual, o padrão, que pede aprovação para tudo que muda algo. Assim você aprende o comportamento do agente revisando cada ação. O modo plano também é ótimo no início, porque o agente só explora e propoe sem mexer. Afrouxe só quando ganhar confiança naquela tarefa.

Qual a diferença entre aceitar edições e automático?

No aceitar edições, o agente edita arquivos sem perguntar, mas outras ações ainda passam por você, e a ideia e revisar pelo resultado. No automático, ele age em quase tudo sem interromper, com uma checagem de segurança em segundo plano. O automático da mais autonomia e pede mais confiança da sua parte.

O modo automático e seguro para tudo?

Ele reduz as interrupcoes com uma checagem de segurança, mas não é garantia. Use-o para tarefas em que você confia na direção, nunca como substituto da revisão em operações sensíveis. O modo controla as interrupcoes, não a sua responsabilidade pelo resultado, que continua sendo sua.

Preciso decorar todos os modos?

Não. Para o dia a dia, dominar o manual, o plano e o aceitar edições já resolve a maioria dos casos. O automático, o so-pre-aprovados e o sem freios atendem a cenários específicos, como tarefas longas, automação e ambientes isolados. Você aprende quando cada um faz sentido com a prática.

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

Os modos de permissão

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

O que você vai aprender

Nomear os principais modos de permissão.
Entender o que cada modo libera sem perguntar.
Alternar de modo conforme a confiança na tarefa.
Escolher mais cautela para trabalho sensível.

Um controle entre cautela e autonomia

Você já sabe que o Claude Code pede aprovação antes de agir. O modo de permissão e o botao que regula o quanto ele pede. Pense num controle deslizante entre dois extremos. De um lado, a cautela máxima: ele pergunta antes de cada ação que muda algo, e você revisa tudo. Do outro, a autonomia: ele trabalha em trechos longos sem interromper e só volta para relatar no fim. Nenhum extremo e certo ou errado por si; o acerto e casar o modo com a tarefa. Trabalho delicado pede cautela; tarefa repetitiva em que você confia no rumo pede menos interrupcao.

Diagrama de um controle deslizante horizontal de cautela a autonomia, com os modos posicionados: plano e manual no lado da cautela (só leitura ou pergunta tudo), aceitar edições no meio (edita sem perguntar), automático mais a frente (age com checagem de segurança) e sem freios no extremo da autonomia (sem checagem, só em ambiente isolado). — Do mais cauteloso ao mais automático: cada modo troca controle por menos interrupcoes.

O ponto de partida e sempre o modo manual, o padrão. Nele, o agente faz livremente as leituras, que não mudam nada, e pede a sua aprovação para qualquer edição, criação ou comando que altere algo. E o modo mais seguro e o certo para quem esta começando e para qualquer trabalho sensível, porque nada acontece sem o seu aval. A partir dele, você pode afrouxar quando fizer sentido. Começar cauteloso e aprender o comportamento do agente antes de dar mais autonomia e o caminho recomendado, e não o contrario.

Conhecendo os modos, um a um

Além do manual, vale conhecer os principais. O modo plano faz o agente só explorar e propor um plano, sem editar nada, ótimo para entender um projeto ou desenhar uma abordagem antes de mexer. O modo aceitar edições libera as edições de arquivo e alguns comandos comuns de sistema sem perguntar, mantendo você revisando depois, pelo resultado, em vez de a cada passo, bom para iterar rápido num código que você vai conferir. O modo automático deixa o agente agir sem as interrupcoes de rotina, com uma checagem de segurança em segundo plano, útil em tarefas longas para reduzir a fadiga de tanto aprovar.

Modo	O que roda sem perguntar	Bom para
Manual (padrão)	Só leituras	Começar e trabalho sensível
Plano	Só leituras (explora e propoe)	Entender antes de mudar
Aceitar edições	Leituras e edições de arquivo	Iterar num código que você revisa
Automatico	Quase tudo, com checagem de segurança	Tarefas longas, menos interrupcao
Sem freios	Tudo, sem checagem	Só em ambiente isolado (container)

Do mais cauteloso ao mais solto. Ha ainda um modo so-pre-aprovados, para automação (CI).

🎮 Jogo da aula

Qual modo para cada situação?

Classifique cada situação conforme ela pede mais cautela ou mais autonomia no modo de permissão.

Ha dois modos extremos que merecem cuidado especial e que a terceira aula deste módulo detalha. O modo so-pre-aprovados serve para automação sem ninguém por perto, como em servidores de integração, liberando apenas o que você autorizou de antemao. E o modo sem freios pula todas as checagens, executando qualquer coisa na hora, o que só e aceitavel em ambientes isolados, como um container descartavel. Por ora, guarde que eles existem e que não são para o uso comum do dia a dia na sua máquina de trabalho.

Alternar de modo na hora certa

A boa noticia e que você não fica preso a um modo. Dentro da sessão, um atalho de teclado circula pelos modos principais, deixando você apertar o freio ou soltar a autonomia conforme a tarefa muda. Da também para iniciar a ferramenta já num modo específico e para definir um modo padrão para um projeto, nas configurações. Na prática, muita gente começa no plano para o agente entender e propor, aprova o plano, passa a revisar as edições uma a uma e, quando ganha confiança naquela tarefa, afrouxa um pouco. Trocar de modo no meio do caminho e normal e faz parte de dirigir bem.

O erro mais comum de iniciante e o oposto do que a intuicao sugere: não é afrouxar cedo demais por preguica de aprovar, e sim confiar no modo automático como se fosse um piloto infalivel. Ele tem uma checagem de segurança, mas não é garantia, e a revisão continua sendo sua. A regra de ouro atravessa todo este módulo: o modo controla as interrupcoes, não a sua responsabilidade. Mesmo no modo mais solto, o que vai para produção passa pelo seu julgamento. As próximas aulas mostram como refinar esse controle com regras e como se proteger de verdade.

Teste rápido

No modo manual (padrão), o que o Claude Code faz sem pedir a sua aprovação?

Perguntas frequentes

Qual modo devo usar como iniciante?: Comece no modo manual, o padrão, que pede aprovação para tudo que muda algo. Assim você aprende o comportamento do agente revisando cada ação. O modo plano também é ótimo no início, porque o agente só explora e propoe sem mexer. Afrouxe só quando ganhar confiança naquela tarefa.
Qual a diferença entre aceitar edições e automático?: No aceitar edições, o agente edita arquivos sem perguntar, mas outras ações ainda passam por você, e a ideia e revisar pelo resultado. No automático, ele age em quase tudo sem interromper, com uma checagem de segurança em segundo plano. O automático da mais autonomia e pede mais confiança da sua parte.
Como troco de modo no meio de uma sessão?: Um atalho de teclado circula pelos modos principais dentro da sessão, então você ajusta na hora conforme a tarefa muda. Da também para iniciar a ferramenta já num modo e definir um padrão por projeto nas configurações. Trocar de modo durante o trabalho e comum e recomendado.
O modo automático e seguro para tudo?: Ele reduz as interrupcoes com uma checagem de segurança, mas não é garantia. Use-o para tarefas em que você confia na direção, nunca como substituto da revisão em operações sensíveis. O modo controla as interrupcoes, não a sua responsabilidade pelo resultado, que continua sendo sua.
Preciso decorar todos os modos?: Não. Para o dia a dia, dominar o manual, o plano e o aceitar edições já resolve a maioria dos casos. O automático, o so-pre-aprovados e o sem freios atendem a cenários específicos, como tarefas longas, automação e ambientes isolados. Você aprende quando cada um faz sentido com a prática.

Fontes

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

← A memória que o Claude Code escreve sozinho Concluir e avançar →