Cuidados e armadilhas

Claude Code é poderoso. Também é perigoso se usado sem cuidado. Essa página lista armadilhas que aparecem no time — e como evitar.

Armadilhas críticas

1. Revisar SEMPRE antes de aceitar mudança de código

❌ Não aceita cegamente o que Claude sugere. Ele pode estar errado — sugerir função que não existe, importar lib que não tá instalada, ou quebrar código adjacente.

✅ Sempre lê o diff. No VS Code, o painel mostra antes/depois. Aprova só se entendeu.

Regra: se você não entende 80%+ do que Claude propõe, PEDE pra explicar antes.

2. Nunca commite credencial

❌ Pedir: “Claude, adiciona a API key do Apollo no código pra eu testar”

Claude vai fazer se você pedir. Mas a key vai pro Git pra sempre no histórico.

✅ Use .env + .gitignore:

# .env (NUNCA vai pro Git)
APOLLO_API_KEY=sua_chave_aqui

No código:

apollo_key = os.getenv("APOLLO_API_KEY")

Se acidentalmente commitou credencial:

1. Roda a chave imediatamente (nova no serviço, invalida antiga)
2. Avisa Fred
3. Limpeza do histórico é trabalho separado (não urgente — chave já foi rodada)

3. Cuidado com rm -rf, git reset --hard, git push --force

Claude pergunta antes de executar essas, mas você ainda tem que dizer não se não tem certeza.

Casos frequentes:

• “Limpa essa pasta” — Claude pode interpretar como rm -rf pasta/. Certifica antes.
• “Volta minha branch pro começo” — git reset --hard apaga mudanças não commitadas
• “Sobe forçado” — git push --force sobrescreve histórico remoto (proibido em main, mas cuidado em branches também)

Regra: destrutivo = pausa, pergunta, confirma.

4. Cuidado com “arruma tudo que tá errado”

Pedidos muito abertos levam Claude a mexer em 20 arquivos. Difícil revisar, difícil reverter.

❌ “Organiza o projeto” ❌ “Arruma tudo que tá errado” ❌ “Modernize a stack”

✅ “Identifica os 3 problemas mais críticos. Me mostra. Eu escolho qual corrigir primeiro.”

Regra: uma coisa de cada vez.

Armadilhas médias

5. Claude inventa quando não sabe

Se Claude não achou a função que você mencionou, ele pode inventar o nome de uma que faria sentido. Isso se chama hallucination.

Como prevenir:

• Peça pra ele ler o arquivo antes de responder
• Se ele citou algo, pergunte “onde esse código está exatamente?”
• Checa no VS Code (Cmd+P pra abrir arquivo) antes de acreditar

6. Commits enormes

Claude pode commitar 500 linhas em um arquivo só se você deixar.

Como prevenir:

• Após cada mudança lógica: /commit (não acumula)
• Pedidos específicos geram commits específicos
• Se o diff ficou grande, pede pra quebrar em commits menores:

  Esse diff tá grande demais. Quebra em 3 commits:
  1. Só renomeação de variáveis
  2. Só nova função
  3. Só testes

7. Perder trabalho por esquecer de commitar

Claude pode sugerir rodar um script que limpa pasta. Se você não commitou, perde tudo.

Hábito: após cada passo importante, /commit (não precisa push ainda, commit local já protege).

8. Usar Claude Code quando Claude (app) seria melhor

Tarefas de puro brainstorm (ex: “me dá 10 ideias de nomes pro produto X”) funcionam melhor no Claude app do que no Code. Code é otimizado pra agir no teu sistema, não pra conversa criativa longa.

Regra rápida: se não tem arquivo pra editar, usa Claude app.

Armadilhas menores (mas chatas)

9. Claude pede permissão demais

Algumas configs deixam Claude perguntar antes de QUALQUER ação. Vira pop-up fatigue.

Fix: roda /fewer-permission-prompts — Claude configura permissões sensatas.

10. Sessões muito longas ficam lentas/caras

Conversa de 2h acumula contexto, consome tokens, Claude fica mais lento.

Fix: /compact a cada 30-45min. Ou /clear quando começa tarefa nova.

11. Ignorar que Claude Code tá rodando em background

Claude pode ter processo de build/teste rodando. Se você feche VS Code, mata o processo.

Fix: antes de fechar, veja se tem algo rodando. Use Ctrl+C pra parar ou deixe terminar.

12. Usar linguagem confusa

“Faz aquela coisa que a gente falou ontem” — Claude não tem memória de ontem (exceto se você salvou via memory).

Fix: seja explícito. Ou peça pra ele consultar memory: “Olha na memory do projeto, a gente salvou decisão sobre X?”.

Checklist pra primeira semana

Na tua primeira semana com Claude Code, evita:

• ❌ Deletar arquivos em massa
• ❌ git push --force
• ❌ Alterar .env, .gitignore, configs de CI
• ❌ Merges grandes (quebra em PRs pequenos)
• ❌ Tarefas que afetam outros devs sem avisar antes

Faz:

• ✅ Muito commit pequeno
• ✅ PRs pra sua própria branch
• ✅ Perguntar quando tiver dúvida
• ✅ Ler o diff inteiro antes de aceitar
• ✅ Quando em dúvida: chama Fred/Paulo no Gather

Regra de ouro

Claude Code é um dev júnior extremamente capaz trabalhando na sua máquina. Trata como tal: confia, mas verifica. Delega execução, não decisão.

Próximos

→ Gerando pesquisa via Knowledge Hub — o fluxo de research com IA