Como o agente sabe se corrigir depois de um erro?

Ele le a mensagem de erro, que costuma dizer o tipo do problema e onde ele apareceu, e usa essa informação para ajustar a próxima tentativa, em vez de chutar. E o mesmo raciocínio de um programador experiente: partir da pista concreta do erro. Por isso rodar as verificacoes ajuda tanto.

O que faco quando ele fica tentando a mesma coisa sem sucesso?

Interrompa com a tecla ESC e reformule. O loop costuma indicar um problema mal definido ou um contexto que falta, e não um limite do agente. Dar a informação que faltava, mudar a abordagem ou deixar o pedido mais claro geralmente destrava na hora. Insistir na mesma tentativa raramente ajuda.

Errar muito e sinal de que a ferramenta e ruim?

Erros fazem parte do método, tanto para humanos quanto para o agente. O que importa e a correção: um bom agente le o erro e ajusta. Muitos erros seguidos no mesmo ponto costumam apontar para um pedido ou contexto que precisam melhorar, mais do que para uma falha da ferramenta.

Se ele se corrige sozinho, ainda preciso revisar?

Sim, sempre. A autocorrecao resolve a parte técnica, como fazer um teste passar, mas não garante que aquilo era o que você queria. A sua revisão julga o sentido: se a mudança resolve o problema certo. Ela é a rede de segurança final e a sua responsabilidade, mesmo com testes verdes.

Como percebo cedo que virou um loop?

Pelo sinal de repetição sem progresso: as tentativas se parecem e o erro não muda. Quando notar isso, pare e pergunte o que você não contou que o agente precisaria saber. Quase sempre a peca que falta está na entrada, no pedido ou no contexto, e da para destravar redirecionando.

Módulo 4 - O fluxo agêntico por dentro

Quando ele erra e se corrige

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

O que você vai aprender

Entender o ciclo de erro e correção do agente.
Ver como ele usa a mensagem de erro para se ajustar.
Saber quando um erro vira loop e como destravar.
Reforcar a revisão humana como rede final.

O erro como pista, não como fracasso

Depois de tanto cuidado, ainda assim o agente erra, e isso é esperado. A diferença de um bom agente está no que ele faz com o erro. Quando um comando falha, ele produz uma mensagem de erro que costuma dizer o tipo do problema e onde ele apareceu. O Claude Code le essa mensagem e a usa como pista para se ajustar, exatamente como faria um programador experiente. Em vez de chutar mudanças aleatorias, ele parte da informação concreta do erro. Por isso rodar os testes e tao valioso: o erro que aparece e o mapa que guia a próxima tentativa.

Diagrama circular do ciclo de correção com quatro etapas: agir (uma edição), observar o erro (uma mensagem destacada), ler a mensagem e ajustar, e tentar de novo, com uma seta de saída para o sucesso quando o teste passa e uma seta para pedir ajuda quando o ciclo emperra. — O ciclo de correção: agir, ler o erro, ajustar e tentar de novo, até passar ou pedir ajuda.

Esse ciclo de correção e o mesmo que você viu no módulo de boas-vindas, agora com nome e detalhe. O agente age, observa o resultado, e se o resultado for um erro, ele não desiste nem finge que passou: ele le, entende e tenta outra abordagem. Muitas vezes você vê ele corrigir sozinho, em segundos, um erro que apareceu na primeira tentativa. E um dos comportamentos mais úteis da ferramenta, e ele fica melhor quanto mais você deixa o agente rodar as verificacoes, porque cada erro visivel vira combustivel para o acerto seguinte.

Quando o erro vira loop

As vezes o ciclo emperra. O agente tenta uma coisa, falha, tenta algo parecido, falha de novo, e você percebe que ele está rodando em círculos sem se aproximar da solução. Isso costuma acontecer quando o problema esta mal definido, quando falta um contexto que só você tem, ou quando a abordagem inteira precisa mudar. A saída não é assistir a mesma tentativa se repetir: e interromper com a tecla ESC, como você aprendeu, e reformular. Um pedido mais claro, um contexto novo ou uma sugestão de outro caminho costumam destravar na hora.

Deixar o loop rolar (frustrante)

Assistir a mesma tentativa falhar de novo.
Esperar o agente se acertar sozinho.
Acumular frustracao sem sair do lugar.

Interromper e redirecionar (eficaz)

Interromper com ESC ao notar o círculo.
Dar um contexto que faltava ou mudar a abordagem.
Reformular o pedido com mais clareza.

🎮 Jogo da aula

O agente travou. E agora?

O Claude Code tentou a mesma correção três vezes e continua falhando no mesmo erro. Escolha a melhor atitude.

Erro: o mesmo teste falha a cada tentativa, sem progresso.

Perceber cedo que virou loop e uma habilidade que se ganha com prática. O sinal e a repetição sem progresso: as tentativas se parecem e o erro não muda. Nesses momentos, quase sempre o problema está na entrada, no pedido ou no contexto, e não na capacidade do agente. Dar um passo atrás e perguntar o que eu não contei que ele precisaria saber costuma revelar a peca que faltava. Redirecionar bem vale mais que insistir muito, e essa e uma das diferenças entre quem se frustra e quem flui com a ferramenta.

A sua revisão e a rede de segurança final

Por mais que o agente explore, pense, confira e se corrija, existe uma verdade que atravessa o curso inteiro: a rede de segurança final e você. O agente pode se convencer de que resolveu, com os testes passando, e ainda assim ter feito algo que não era o que você queria, ou que resolve o sintoma e esconde outro problema. Só a sua revisão, entendendo o que mudou e por que, fecha essa última brecha. Isso não é desconfianca exagerada; e o mesmo cuidado que se tem ao revisar o trabalho de qualquer colega, por mais competente que seja.

Com esta aula, você fecha o módulo mais conceitual do curso e sai enxergando o Claude Code por dentro: uma caixa de ferramentas dividida entre explorar e agir, um agente que pensa e planeja conforme a dificuldade, que confere o próprio trabalho e que aprende com os erros num ciclo de correção, tudo sob a sua revisão final. A partir do próximo módulo, o curso deixa a teoria e começa a te dar poder de configuração, começando pela memória de projeto, o CLAUDE.md, que ensina o agente a trabalhar do SEU jeito.

Teste rápido

O Claude Code rodou os testes, todos passaram, e ele disse que terminou. O que ainda cabe a você?

Perguntas frequentes

Como o agente sabe se corrigir depois de um erro?: Ele le a mensagem de erro, que costuma dizer o tipo do problema e onde ele apareceu, e usa essa informação para ajustar a próxima tentativa, em vez de chutar. E o mesmo raciocínio de um programador experiente: partir da pista concreta do erro. Por isso rodar as verificacoes ajuda tanto.
O que faco quando ele fica tentando a mesma coisa sem sucesso?: Interrompa com a tecla ESC e reformule. O loop costuma indicar um problema mal definido ou um contexto que falta, e não um limite do agente. Dar a informação que faltava, mudar a abordagem ou deixar o pedido mais claro geralmente destrava na hora. Insistir na mesma tentativa raramente ajuda.
Errar muito e sinal de que a ferramenta e ruim?: Erros fazem parte do método, tanto para humanos quanto para o agente. O que importa e a correção: um bom agente le o erro e ajusta. Muitos erros seguidos no mesmo ponto costumam apontar para um pedido ou contexto que precisam melhorar, mais do que para uma falha da ferramenta.
Se ele se corrige sozinho, ainda preciso revisar?: Sim, sempre. A autocorrecao resolve a parte técnica, como fazer um teste passar, mas não garante que aquilo era o que você queria. A sua revisão julga o sentido: se a mudança resolve o problema certo. Ela é a rede de segurança final e a sua responsabilidade, mesmo com testes verdes.
Como percebo cedo que virou um loop?: Pelo sinal de repetição sem progresso: as tentativas se parecem e o erro não muda. Quando notar isso, pare e pergunte o que você não contou que o agente precisaria saber. Quase sempre a peca que falta está na entrada, no pedido ou no contexto, e da para destravar redirecionando.

Fontes

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

← Pensar e planejar antes de agir Concluir e avançar →