Quando algo quebra: lendo um erro sem entrar em pânico
Vai acontecer. Uma hora você atualiza o navegador e, no lugar do seu site, aparece uma tela branca, um texto vermelho ou uma frase em inglês cheia de palavras estranhas. Seu coração acelera. Você pensa: "quebrei tudo".
Respira. Você não quebrou nada de grave. E esse momento é mais normal do que você imagina.
A ideia: erro não é bronca, é um recado
Quando o computador não consegue fazer algo, ele não fica em silêncio. Ele te avisa. Esse aviso é a mensagem de erro.
Pense num GPS. Quando você erra a rua, ele não desliga nem te xinga. Ele fala "recalculando rota" e te mostra onde você está. A mensagem de erro é exatamente isso: o computador dizendo "não entendi essa parte aqui, ó". É informação, não julgamento.
E aqui está o segredo que muda tudo: o erro é seu amigo. Ele aponta o dedo para o lugar do problema. Sem ele, você ficaria perdido sem saber onde olhar. Com ele, você (ou o Claude) sabe por onde começar.
Onde os erros aparecem
Existem dois lugares principais onde um erro pode surgir. Saber qual é já ajuda muito.
1. No terminal
O terminal é aquela janela de texto onde o Claude Code roda e onde você ligou o servidor do site. Se algo der errado nos bastidores, o texto do erro aparece ali, geralmente em vermelho ou com a palavra Error.
2. Na tela do navegador
Às vezes o site abre, mas mostra uma mensagem de erro no lugar do conteúdo, ou uma tela esquisita. Esse erro veio do próprio site tentando se montar.
Não precisa decorar a diferença agora. Só saiba que, quando algo quebrar, o recado está em um desses dois lugares.
O que fazer no susto: a regra das 3 respirações
Antes de qualquer coisa, não apague nada. O maior erro do iniciante é, no susto, sair deletando arquivos ou desfazendo tudo. Isso costuma piorar.
Faça assim:
- Respire. De verdade. Três respirações fundas. O problema não vai a lugar nenhum.
- Encontre a mensagem. Olhe o terminal e o navegador. Ache o texto em vermelho ou a palavra
Error. - Leia a última linha primeiro. Mensagens de erro costumam ser longas, com várias linhas. A parte mais útil quase sempre está nas últimas linhas — é o resumo do que deu errado. O resto é detalhe técnico.
Você não precisa entender tudo que está escrito. Está em inglês, cheio de termos? Tudo bem. Seu trabalho agora é só localizar o erro e copiar o texto. Entender e consertar é tarefa do Claude — e a gente faz isso no próximo post.
Um exemplo do que você pode ver
Não se assuste com algo assim no terminal:
Error: Cannot find module './foto.jpg'
Parece grego, mas olhe a última parte: ele está dizendo que procurou um arquivo chamado foto.jpg e não achou. Viu? O erro literalmente te conta o que faltou. Esse é o ponto: por baixo do susto, quase sempre tem um recado simples.
Se algo der errado (ao lidar com o erro)
- Não acho a mensagem em lugar nenhum. Role o terminal para cima — às vezes o erro apareceu antes e ficou para trás. No navegador, tente atualizar a página uma vez para ver se o erro reaparece.
- O texto some rápido demais. Tire um print da tela. No Mac: Cmd + Shift + 4. No Windows: tecla Print Screen ou a ferramenta de captura. Assim você guarda o erro para mostrar depois.
- Vontade de apagar tudo e recomeçar. Segura essa vontade. Apagar é quase sempre desnecessário e te faz perder progresso. Um erro se conserta; um projeto apagado, não.
Trocar o pânico por curiosidade é uma das maiores viradas de chave de quem aprende a construir coisas. O erro deixou de ser um monstro e virou uma pista.
No próximo post, a gente faz o que realmente importa: pegar essa mensagem de erro e pedir para o Claude consertar — do jeito certo, para ele acertar de primeira.