Guia de campo para depuração de código Claude, catálogo de erros, modelo de relatório de erros e exercícios práticos.

Pare de colar erros no Claude Code e torcer para que funcione. Este guia prático ensina um ciclo de depuração de seis etapas, mostra como escrever relatórios de erros que um assistente de codificação com IA pode usar e explica mensagens de erro, registros e recuperações reais, para que você resolva problemas com base em evidências, em vez de palpites.

■ DOWNLOAD DIGITAL INSTANTÂNEO
Este é um produto para download digital. Nenhum item físico será enviado.

■ O QUE VOCÊ APRENDERÁ
• Aplique um ciclo de seis etapas: observar, reproduzir, isolar, formular hipóteses, corrigir e verificar.
• Redija relatórios de erros com erros exatos, etapas, comparação entre o esperado e o real e o ambiente.
• Leia erros e rastreamentos de pilha do Node.js, Python, navegador e TypeScript
• Utilize o console do navegador, a aba Rede, os logs do servidor e os logs de compilação para encontrar as causas.
• Crie reproduções mínimas e use o git bisect para descobrir quando um bug começou.
• Identifique e corrija 26 erros comuns, com mais 9 no catálogo complementar.
• Escreva primeiro um teste de regressão que falhe e mantenha-o para que os bugs permaneçam corrigidos.
• Recupere com segurança usando git e pontos de verificação do Claude Code e saiba quando parar.

■ O QUE ESTÁ INCLUÍDO
• O guia ilustrado (69 páginas) (ClaudeEverything-06-Debugging-Field-Guide.pdf)
• Texto completo do guia em Markdown editável (.md) e texto simples (.txt) (editable-text/)
• Arquivo Markdown editável (bug-report-template.md)
• Arquivo de texto simples (bug-report-template.txt)
• Arquivo Markdown editável (debugging-checklist.md)
• Arquivo Markdown editável (error-catalog.md)
• Pasta com 8 arquivos (practice-bugs/)
• Instruções para começar (README.md)
• Termos da licença em linguagem simples (LICENSE.txt)
Tamanho do download: PDF 689 KB, ZIP 578 KB. O guia tem 69 páginas.

■ PARA QUEM É INDICADO
• Iniciantes que estão criando aplicativos ou sites com o Claude Code e encontram dificuldades devido a erros
• Construtores de nível intermediário que desejam um processo de depuração repetível
• Desenvolvedores autodidatas que trabalham com JavaScript, Node.js ou Python
• Freelancers e empreendedores individuais que gerenciam seus próprios projetos
Nível de habilidade: Iniciante a Intermediário

■ PARA QUEM NÃO É INDICADO
• Engenheiros experientes que buscam ferramentas avançadas de criação de perfis ou de análise de incidentes em produção
• Pessoas que desejam instruções de instalação do Claude Code ou de configuração de conta

■ DO QUE VOCÊ PRECISA
• Acesso ao Claude Code, que requer um plano Anthropic elegível ou uma conta API (verifique os preços atuais da Anthropic)
• Um computador com terminal (macOS, Linux ou Windows)
• É necessário o Node.js versão 20 ou superior para executar os arquivos de exercícios incluídos.
• Familiaridade básica com a execução de comandos em um terminal; recomenda-se o uso do Git.

■ COMO OBTER SEUS ARQUIVOS
1. Após a compra, acesse Etsy > Você > Compras (em um navegador da web; os downloads não funcionam no aplicativo Etsy).
2. Localize este pedido e selecione "Baixar arquivos".
3. Abra o guia em PDF ou descompacte o arquivo ZIP e leia o arquivo README.md primeiro.

■ COMBINA BEM COM (também disponível na loja ClaudeEverything)
• É novo no Claude Code? O guia Claude 101 para iniciantes aborda a instalação, boas práticas e como desfazer alterações com o Git.
• Quer mais receitas? O livro "50 Claude Code Workflows" inclui uma categoria completa de depuração, além de testes e verificações de implantação.

■ LICENÇA E USO
Uso pessoal e para pequenas empresas. Você pode usar as técnicas, modelos e código em seus próprios projetos e nos projetos de seus clientes. É proibida a revenda, o compartilhamento ou a republicação do guia ou dos modelos. A licença está incluída no download (LICENSE.txt).

■ SUPORTE
Se um arquivo não abrir ou se encontrar algum erro, entre em contato com a loja pelo Etsy. Por favor, não envie senhas ou chaves de API.
• Os arquivos de exercícios exigem o Node.js versão 20 ou superior; execute `node --version` para verificar e, em seguida, execute cada arquivo com `node <nome do arquivo>`.
• A redação das mensagens de erro pode variar ligeiramente entre as versões do Node.js, Python e do navegador; verifique o código de erro (como ENOENT ou TS2339) quando a frase for diferente.
• Os comandos e menus do Claude Code descritos neste guia foram verificados em outubro de 2026; caso encontre alguma diferença, consulte a documentação oficial do Claude Code.
• Cada arquivo de solução imprime "Autoverificação aprovada." quando é executado corretamente; se você adaptar um e uma asserção falhar, o Node imprime os valores esperados e reais para comparação.

■ BOM SABER
• O software, os preços e os nomes dos planos podem sofrer alterações. As páginas marcadas como "Nota de versão" indicam o que você deve verificar novamente na documentação oficial.
• Não há promessa ou implicação de renda, classificação ou resultado comercial.
• Feito com auxílio de IA: o conteúdo foi redigido com Claude, e o produto foi projetado e montado pela ClaudeEverything.
• ClaudeEverything é uma editora independente e não possui qualquer vínculo, endosso ou patrocínio da Anthropic. Claude e Claude Code são produtos e marcas registradas da Anthropic, pertencentes ao seu proprietário.
• Devido à natureza dos downloads digitais, não oferecemos devoluções nem trocas. Se houver algum problema com o seu arquivo, envie-nos uma mensagem e nós o ajudaremos.