📋 Colando o Erro Diretamente
A forma mais direta de debugar com Claude e colar o erro diretamente na conversa. O Claude analisa o stack trace, identifica o arquivo e a linha do problema, e propoe uma solucao.
💡 Conceito Principal
O comando mais simples para debugar e iniciar o Claude com o erro:
- •
claude "Estou recebendo este erro: [cole o stack trace]. Me ajude a corrigir." - •Sempre inclua o stack trace COMPLETO, nao apenas a mensagem final
- •Descreva o que voce estava fazendo quando o erro apareceu
⚡ Dica Pratica
Quanto mais contexto voce der sobre quando e como o erro acontece, mais preciso sera o diagnostico do Claude.
🔄 Pipe de Logs para o Claude
Em vez de copiar e colar, voce pode enviar logs diretamente via pipe. Isso e especialmente util para arquivos de log grandes ou saidas de terminal extensas.
💡 Conceito Principal
Use o pipe com a flag -p para enviar conteudo direto:
- •
cat error.log | claude -p "O que esta causando esses erros e como corrijo?" - •
npm test 2>&1 | claude -p "Analise as falhas e sugira correcoes" - •
docker logs app 2>&1 | tail -100 | claude -p "Diagnostique esses logs"
⚡ Dica Pratica
Use tail -100 para limitar a quantidade de log enviada. Logs muito grandes consomem tokens desnecessarios.
🔍 Tracando a Causa Raiz
O Claude nao apenas le o erro — ele traca o fluxo de execucao nos seus arquivos para encontrar a causa raiz real, nao apenas o sintoma.
💡 Conceito Principal
Apos receber o erro, o Claude automaticamente:
- •Le os arquivos mencionados no stack trace
- •Identifica a cadeia de chamadas que levou ao erro
- •Distingue entre o sintoma (onde o erro aparece) e a causa (onde o problema comeca)
⚡ Dica Pratica
Peca para o Claude explicar a causa raiz antes de corrigir: "Explique o que esta causando isso antes de propor a correcao".
🔧 Aplicando a Correcao
Uma vez identificada a causa raiz, peca ao Claude para aplicar a correcao e verificar que o problema foi resolvido.
💡 Conceito Principal
O prompt ideal para aplicar a correcao:
- •
"Corrija o bug e rode os testes para garantir que nada mais quebrou." - •O Claude edita o arquivo, roda os testes e confirma que o erro sumiu
- •Se novos erros aparecerem, ele continua ate tudo estar verde
⚡ Dica Pratica
Sempre peca para rodar os testes apos a correcao. Nunca aceite uma correcao sem verificacao automatica.
✅ Verificando a Resolucao
Apos a correcao, e essencial verificar que o erro foi realmente resolvido e que nenhum efeito colateral foi introduzido.
💡 Conceito Principal
Checklist de verificacao pos-fix:
- •O erro original nao aparece mais
- •Todos os testes existentes continuam passando
- •O cenario que causava o erro agora funciona corretamente
⚡ Dica Pratica
Se o erro era intermitente, mencione isso ao Claude. Ele pode sugerir testes especificos para condicoes de corrida ou estados inesperados.
🎯 Pro Tips para Debugging
Dicas avancadas para maximizar a eficiencia do debugging com Claude Code.
💡 Conceito Principal
Regras de ouro do debugging eficiente:
- •Inclua o stack trace COMPLETO — nunca resuma
- •Descreva o que disparou o erro (acao do usuario, endpoint, etc.)
- •Mencione se o erro e intermitente ou consistente
- •Aponte para o arquivo suspeito se voce tiver uma intuicao
✓ O que FAZER
- ✓Cole o stack trace completo
- ✓Descreva o trigger do erro
- ✓Peca diagnostico antes do fix
✗ O que NAO fazer
- ✗Resumir o erro com suas palavras
- ✗Pedir fix sem contexto
- ✗Aceitar correcao sem rodar testes
📋 Resumo do Modulo
Proximo Modulo:
3.9 - Refatoracao Multi-arquivo