O que é o desenvolvimento guiado por testes?

É um método em que você escreve primeiro o teste que define o comportamento certo, e só depois o código que faz esse teste passar. No início o teste falha, porque o código não existe; fazê-lo passar vira o objetivo. Com o Claude Code, você define o teste e deixa o agente escrever o código.

Por que escrever o teste antes do código?

Porque o teste é a definição mais exata possível do que o código deve fazer, sem ambiguidade, e dá ao agente um alvo cristalino, melhor que uma descrição em palavras. E, como é automático, o agente sabe na hora se acertou. É o pedido claro com critério de sucesso levado ao extremo.

Como o teste vira uma prova de que funciona?

Quando o teste que você definiu passa, você tem evidência concreta de que o código faz o que deveria, não só a impressão de que ficou bom. E, como o teste fica no projeto, protege o comportamento no futuro: se alguém o quebrar depois, o teste falha e avisa. Ele vira uma sentinela permanente.

Quando esse método não se aplica?

Quando a tarefa não tem um certo verificável num teste, como ajustes visuais ou explorações abertas. Nesses casos, não há um teste óbvio, e o método não se encaixa bem. Mas, sempre que o comportamento certo é bem definido, começar pelo teste dá ao agente o melhor alvo e a você a melhor prova.

Módulo 17 - Fluxos de trabalho profissionais

Desenvolvimento guiado por testes

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 desenvolvimento guiado por testes.
Ver por que o teste primeiro dá um alvo ao agente.
Aplicar o método com o Claude Code.
Reconhecer o teste como prova de que funciona.

Começar pelo teste, não pelo código

Existe uma forma de trabalhar que combina especialmente bem com o Claude Code: o desenvolvimento guiado por testes. A ideia inverte a ordem intuitiva. Em vez de escrever o código primeiro e testar depois, você escreve primeiro o teste, aquele que define o que o código deve fazer, e só então escreve o código que faz o teste passar. No início, o teste falha, naturalmente, porque o código ainda não existe. Fazê-lo passar vira o objetivo. Com o agente, isso fica poderoso: você escreve ou pede o teste que define o certo, e deixa o Claude Code escrever o código para passar nele. Você define o destino; ele traça o caminho.

Por que isso rende tanto com o agente? Porque resolve o maior problema de conversar com uma IA: dar um objetivo preciso. Um teste é a definição mais exata possível de o que o código deve fazer, sem ambiguidade. Quando você dá ao Claude Code um teste que precisa passar, ele tem um alvo cristalino, muito melhor que uma descrição em palavras, que pode ser interpretada de vários jeitos. E, como o teste é automático, o agente sabe na hora se acertou: o teste passou ou não. É o pedido claro com critério de sucesso, do módulo da conversa, levado ao extremo: o critério não é uma frase, é um teste que ou passa ou não passa.

Diagrama do desenvolvimento guiado por testes em ciclo: primeiro escrever o teste que define o certo (o teste falha, marcado em vermelho), depois o agente escreve o código para passar (o teste passa, marcado em verde), e o ciclo repete para o próximo comportamento, com o teste como alvo claro. — Escreva o teste que define o certo (falha); o agente faz o código passar (verde). O teste é o alvo.

O teste como prova de que funciona

Além de dar um alvo ao agente, o teste primeiro dá a você uma prova. Lembre da lição do curso: o agente às vezes erra, e a verificação é sua. O desenvolvimento guiado por testes embute a verificação no método. Quando o teste que você definiu passa, você tem uma evidência concreta de que o código faz o que deveria, não apenas a impressão de que ficou bom. Isso é muito mais forte do que ler o código e achar que está certo. E, como o teste fica no projeto, ele protege o comportamento no futuro: se alguém, ou o próprio agente, quebrar aquele comportamento depois, o teste falha e avisa. O teste que você escreveu vira uma sentinela permanente.

🎮 Jogo da aula

Desenvolvimento por testes: verdade ou mito?

Para cada afirmação sobre desenvolvimento guiado por testes com o Claude Code, diga se é verdadeira ou falsa.

Um cuidado importante liga com o módulo da conversa: ao usar esse método, deixe claro ao agente que ele deve fazer o código passar no teste, sem alterar o teste. Sem esse cuidado, um agente com pressa poderia mudar o teste para ele passar, em vez de escrever o código certo, e o teste passaria pelo motivo errado. Dizer conserte o código para passar no teste, sem mexer no teste fecha essa porta. É o mesmo princípio de dizer o que não fazer, e aqui ele é essencial, porque o teste é a sua âncora de verdade. Com essa fronteira clara, o desenvolvimento guiado por testes é um dos métodos mais seguros e produtivos de trabalhar com o Claude Code.

Quando começar pelos testes

O desenvolvimento guiado por testes brilha quando o comportamento certo é bem definido e você consegue expressá-lo num teste. Uma função que calcula algo, uma regra de negócio clara, uma correção com um caso específico que precisa funcionar: são casos ideais, porque o teste captura exatamente o que deve acontecer. Nem tudo se encaixa: algumas tarefas, como ajustes visuais ou explorações abertas, não têm um teste óbvio, e aí o método não se aplica bem. Mas, sempre que a tarefa tem um certo verificável, começar pelo teste dá ao agente o melhor alvo possível e a você a melhor prova. Vale ter esse método na manga para os muitos casos em que ele se encaixa.

Com o desenvolvimento guiado por testes, você tem uma técnica poderosa para tarefas com um certo verificável. A próxima aula cobre a situação oposta, quando algo já está errado e você precisa descobrir por quê: a depuração sistemática. É o método de caçar bugs com rigor, em vez de chutar mudanças na esperança de que uma funcione. Assim como o desenvolvimento por testes traz método para construir, a depuração sistemática traz método para consertar, e as duas juntas cobrem os dois lados do trabalho de quem programa: fazer o novo funcionar e fazer o quebrado voltar a funcionar, sempre com o Claude Code como parceiro.

Teste rápido

Por que o desenvolvimento guiado por testes combina tão bem com o Claude Code?

Perguntas frequentes

O que é o desenvolvimento guiado por testes?: É um método em que você escreve primeiro o teste que define o comportamento certo, e só depois o código que faz esse teste passar. No início o teste falha, porque o código não existe; fazê-lo passar vira o objetivo. Com o Claude Code, você define o teste e deixa o agente escrever o código.
Por que escrever o teste antes do código?: Porque o teste é a definição mais exata possível do que o código deve fazer, sem ambiguidade, e dá ao agente um alvo cristalino, melhor que uma descrição em palavras. E, como é automático, o agente sabe na hora se acertou. É o pedido claro com critério de sucesso levado ao extremo.
Como o teste vira uma prova de que funciona?: Quando o teste que você definiu passa, você tem evidência concreta de que o código faz o que deveria, não só a impressão de que ficou bom. E, como o teste fica no projeto, protege o comportamento no futuro: se alguém o quebrar depois, o teste falha e avisa. Ele vira uma sentinela permanente.
Qual cuidado ter ao usar esse método?: Deixe claro que o agente deve fazer o código passar no teste, sem alterar o teste. Sem isso, um agente com pressa poderia mudar o teste para ele passar, em vez de escrever o código certo. Dizer conserte o código, sem mexer no teste fecha essa porta e mantém o teste como sua âncora de verdade.
Quando esse método não se aplica?: Quando a tarefa não tem um certo verificável num teste, como ajustes visuais ou explorações abertas. Nesses casos, não há um teste óbvio, e o método não se encaixa bem. Mas, sempre que o comportamento certo é bem definido, começar pelo teste dá ao agente o melhor alvo e a você a melhor prova.

Fontes

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

← O ritmo profissional Concluir e avançar →