🔍 Dar Contexto ao Claude
O primeiro passo para corrigir um bug e dar contexto suficiente para o Claude entender o problema. Quanto mais informacao voce fornecer, mais rapido ele encontra a solucao.
💡 Conceito Principal
Descreva o bug com clareza, incluindo o comportamento esperado vs. o comportamento atual. Use comandos como:
- •
claude "O botao de login retorna erro 403 ao clicar. Deveria redirecionar para /dashboard" - •Inclua mensagens de erro exatas, stack traces e logs relevantes
- •Mencione quando o bug comecou (ex: "depois do ultimo deploy") para ajudar a isolar a causa
⚡ Dica Pratica
Cole o erro diretamente no prompt: claude "Este erro aparece no console: TypeError: Cannot read property 'map' of undefined em UserList.jsx:42"
🕵️ Investigacao
Deixe o Claude investigar o codebase para entender o contexto completo do bug. Ele vai ler arquivos, seguir imports e rastrear o fluxo de dados.
💡 Conceito Principal
O Claude vai automaticamente explorar arquivos relacionados. Voce pode guiar a investigacao:
- •
"Investigue o fluxo de autenticacao em src/auth/ para encontrar onde o 403 e gerado" - •
"Verifique os middlewares que interceptam requests para /api/login" - •O Claude usa grep, leitura de arquivos e analise de dependencias para mapear o problema
⚡ Dica Pratica
Se o Claude pedir permissao para ler muitos arquivos, aceite. Uma investigacao ampla no inicio economiza tempo depois. Use Shift+Tab para aceitar todas as permissoes de uma vez.
🩺 Diagnostico
Apos a investigacao, o Claude vai apresentar seu diagnostico com a causa raiz. E importante validar esse diagnostico antes de partir para a correcao.
💡 Conceito Principal
Valide o diagnostico fazendo perguntas de follow-up:
- •
"Tem certeza que o problema e no middleware e nao no controller?" - •
"Existem outros lugares onde esse mesmo padrao pode causar bugs?" - •Peca para o Claude explicar a cadeia de eventos que leva ao bug
⚡ Dica Pratica
Peca ao Claude: "Antes de corrigir, me explique passo a passo como o bug acontece". Isso garante que voce entende o problema e pode validar a solucao.
🔧 Aplicar a Correcao
Com o diagnostico confirmado, peca ao Claude para implementar a correcao. Ele vai editar os arquivos necessarios e voce pode revisar cada mudanca.
💡 Conceito Principal
Guie a correcao com instrucoes claras:
- •
"Corrija o bug. Adicione validacao de null antes do .map() e um fallback para array vazio" - •Revise o diff que o Claude mostra antes de aceitar - pressione
ypara aceitar ounpara rejeitar - •Peca para rodar os testes:
"Rode npm test para garantir que nada quebrou"
⚡ Dica Pratica
Sempre peca para rodar testes apos a correcao: "Rode os testes relacionados e me mostre se passam". Isso evita que a correcao quebre outra coisa.
📝 Commit da Correcao
Com o bug corrigido e testes passando, use o comando /commit para criar um commit limpo e descritivo automaticamente.
💡 Conceito Principal
O Claude gera commits seguindo convencoes do projeto:
- •Digite
/commit- o Claude analisa as mudancas e cria uma mensagem de commit - •Ele segue o padrao Conventional Commits:
fix: resolve null pointer in UserList component - •Voce pode pedir ajustes na mensagem antes de confirmar
⚡ Dica Pratica
Se preferir mais controle, use: "Faca commit com a mensagem: fix: add null check before mapping users array". O Claude executa o git add e git commit para voce.
🚀 Pro Tips
Dicas avancadas para acelerar o debugging e resolver bugs mais complexos com eficiencia.
💡 Conceito Principal
Tecnicas avancadas para debugging eficiente:
- •Pipe de logs direto:
cat error.log | claude -p "Analise esses logs e encontre a causa do crash" - •Bug em producao:
"O Sentry mostra este erro em producao: [stack trace]. Encontre e corrija" - •Use
/compactse a conversa ficar longa durante o debugging para manter o contexto limpo
⚡ Dica Pratica
Para bugs intermitentes, peca: "Adicione logs temporarios nos pontos criticos para capturar o estado quando o bug ocorre". Depois de reproduzir, envie os logs ao Claude.
📋 Resumo do Modulo
Proximo Modulo:
3.2 - Construir Feature Nova