Debug com Claude
Quando algo quebra, o Claude é o seu parceiro de debug
⏱ Estim. ~7 min
01 · Ler
Coisas quebram. Isso não é fracasso — é parte normal de construir software. A diferença entre um iniciante e um engenheiro experiente não é que os experientes nunca cometem erros. É que eles sabem como descrever o problema com clareza e achar correções de forma efetiva.
Claude Code é um ótimo parceiro de debug. Mas ele só pode te ajudar se você disser o que está errado. Descrições vagas como "não funciona" dão ao Claude pouquíssimas pistas. Descrições específicas como "o formulário envia, mas a mensagem de sucesso nunca aparece" apontam direto para o problema.
O padrão chave para reportar bugs: esperava X, recebi Y, tentei isso.
02 · Modelo de prompt
Quando ver um erro no terminal, copie e cole a mensagem exata para o Claude. Não parafraseie — o texto exato tem pistas importantes, tipo nomes de arquivos, números de linha e códigos de erro.
Ao rodar o servidor apareceu este erro: {{error_message}}03 · Modelo de prompt
Nem todo bug tem mensagem de erro. Às vezes é só algo com cara estranha no navegador. Para bugs visuais, descreva o que você vê versus o que esperava.
{{element}} está {{problem}} agora, mas deveria estar {{expected}}04 · Quiz
Ao reportar um bug para o Claude, o que você sempre deve incluir?
- O seu sistema operacional
- O nome do seu editor
- A mensagem de erro exata
- O horário atual
05 · Preencher
Ao descrever um bug, use o padrão: "esperava _____, mas recebi Y".
06 · Ler
Descrever problemas com clareza é a verdadeira habilidade — e te faz melhor colaborando tanto com IA quanto com colegas humanos.
Pontos-chave
- Descrever o problema com clareza é a habilidade de debug mais importante
- Padrão mágico: "esperava X, recebi Y, tentei isso"
- Copie a mensagem de erro exata — não parafraseie
- Para bugs visuais, descreva o que você vê versus o que esperava
- Inclua contexto: o que você estava fazendo quando quebrou?
07 · Quiz
Na sua página web tem um botão que, ao clicar, deveria mostrar uma mensagem de sucesso, mas nada acontece. Qual reporte de bug ajuda o Claude a corrigir mais rápido?
- O botão não funciona
- Tem um problema na minha página, você pode corrigir?
- Por favor, corrija o JavaScript
- O botão de enviar em index.html não responde ao clique — eu esperava que uma mensagem de sucesso aparecesse abaixo do formulário, mas nada aparece. O console não mostra erros.
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.