🎯 Hack 4 — Contexto Pequeno
O erro mais comum ao usar o Claude Code é despejar toda a base de código no contexto. Mais arquivos não significa mais inteligência — significa mais ruído. O princípio do contexto pequeno é simples: dê ao Claude apenas o que ele precisa para a tarefa atual, nada além disso.
💡 A lógica do contexto cirúrgico
O Claude Code tem um limite de contexto. Quando está cheio com informação desnecessária, o modelo perde capacidade de raciocínio sobre o que importa. A estratégia certa:
- •Divida tarefas grandes em etapas focadas. Cada etapa tem seu próprio contexto mínimo.
- •Carregue apenas arquivos relevantes para a tarefa atual — não o diretório inteiro.
- •Cole trechos, não arquivos completos quando apenas uma função ou bloco importa.
- •Use o CLAUDE.md como contexto base — ele já contém a visão geral do projeto.
📊 Impacto do contexto excessivo
- •Com contexto enxuto: o Claude foca nos detalhes relevantes e produz soluções precisas
- •Com contexto cheio: o modelo começa a "perder o fio", mistura padrões de arquivos diferentes e sugere soluções genéricas
- •Contexto irrelevante é tão prejudicial quanto falta de contexto — cria interferência no raciocínio
💻 Antes e Depois
✗ Abordagem ruim
"Aqui está todo o meu projeto
[cola 15 arquivos inteiros]
Adicione autenticação."
✓ Abordagem correta
"Veja o arquivo routes.ts
e middleware.ts. Adicione
JWT auth nas rotas /api."
⚡ Dica Prática
Antes de começar qualquer tarefa, pergunte: "Quais são os 2-3 arquivos que o Claude realmente precisa para resolver isso?" Se você não consegue responder, provavelmente precisa decompor a tarefa em etapas menores primeiro.
✓ O que FAZER
- ✓Selecione apenas os arquivos diretamente relacionados à tarefa
- ✓Divida funcionalidades grandes em microtarefas sequenciais
- ✓Referencie arquivos pelo nome em vez de colar o conteúdo
- ✓Aproveite o CLAUDE.md para contexto permanente do projeto
✗ O que NÃO fazer
- ✗Despejar o projeto inteiro esperando que o Claude "entenda tudo"
- ✗Incluir arquivos de configuração que não afetam a tarefa atual
- ✗Colar histórico de outras sessões para "dar contexto adicional"
- ✗Misturar múltiplos problemas não relacionados em uma só mensagem
🔍 Hack 5 — /context
Quando uma sessão parece mais lenta ou o Claude começa a dar respostas imprecisas, o instinto é reiniciar tudo. Mas com o /context, você primeiro diagnostica: veja exatamente o que está consumindo seus tokens, identifique o culpado e tome ação cirúrgica — sem perder o trabalho feito.
💡 O relatório do /context
O comando /context gera um relatório detalhado mostrando:
- •Prompt de sistema: quantos tokens o sistema reserva para instruções base
- •Arquivos carregados: lista com tamanho em tokens de cada arquivo no contexto
- •Servidores MCP: quanto cada servidor MCP ativo está consumindo
- •Histórico da conversa: porcentagem ocupada pelas mensagens anteriores
- •Total e disponível: visão consolidada do contexto usado vs disponível
💻 Saída típica do /context
$ /context
─── Distribuição do Contexto ───────────
Prompt de sistema 12% (24.5k tokens)
Arquivos carregados 38% (77.8k tokens)
├ database/schema.prisma 18%
├ app/api/routes.ts 12%
└ lib/auth.ts 8%
Servidores MCP 8% (16.4k tokens)
Histórico 15% (30.7k tokens)
─── Total: 73% utilizado ───────────────
⚠ Contexto acima de 70% — considere /compact
⚡ Dica Prática
Execute /context antes de compactar para saber o que realmente está pesando. Se um arquivo específico está consumindo 20%+ do contexto e não é mais necessário para a tarefa atual, remova-o da sessão antes de compactar — isso pode economizar mais contexto do que a compactação em si.
✓ O que FAZER
- ✓Execute /context quando a sessão parecer mais lenta ou imprecisa
- ✓Use o relatório para identificar arquivos que podem ser removidos
- ✓Verifique quais servidores MCP estão ativos e se todos são necessários
✗ O que NÃO fazer
- ✗Reiniciar tudo sem primeiro diagnosticar onde está o problema
- ✗Ignorar o relatório e compactar sem entender o que está pesando
- ✗Deixar servidores MCP ativos que não são usados na tarefa atual
🗜️ Hack 6 — /compact e /clear
Dois comandos para situações diferentes: /compact quando você quer continuar na mesma tarefa mas recuperar performance, e /clear quando a tarefa encerrou e uma nova começa. Saber quando usar cada um evita perda de decisões importantes e garante sessões sempre eficientes.
💡 Diferença entre /compact e /clear
/compact
- • Comprime o histórico da conversa
- • Mantém decisões e resultados importantes
- • Libera contexto sem perder continuidade
- • Aceita instruções sobre o que preservar
- Quando usar: contexto em ~60%+, mesma tarefa
/clear
- • Reinicia completamente o contexto da conversa
- • CLAUDE.md e arquivos do projeto permanecem
- • Contexto do zero — ideal para nova tarefa
- • Mais rápido e eficiente que compact
- Quando usar: tarefa encerrada, nova tarefa começa
💻 Usando o /compact com instrução
# Contexto chegou a 62% — hora de compactar
$ /compact but keep all API integration decisions and the authentication flow we decided on
Compactando histórico...
Preservando: decisões de API, fluxo de auth...
✓ Contexto reduzido de 62% para 18%
# Decisões importantes preservadas
# Pronto para continuar com performance máxima
Protocolo de gerenciamento de contexto
Execute /compact
Comprima o histórico com instrução específica. Continue a tarefa com contexto recuperado e performance restaurada.
Execute /clear
Ao terminar uma tarefa e começar outra. O CLAUDE.md garante que o Claude ainda conhece o projeto — contexto limpo para máximo desempenho na nova tarefa.
Zona crítica — não chegue aqui
Acima de 85%, a qualidade degrada severamente. Se acontecer: use /clear e recomece a tarefa com contexto limpo. Melhor perder o histórico do que continuar com desempenho ruim.
⚡ Dica Prática
Use o /compact com instruções específicas sobre o que preservar: decisões de arquitetura, escolhas de API, regras de negócio definidas na sessão. Exemplos: /compact but keep database schema decisions ou /compact focus on authentication changes.
✓ O que FAZER
- ✓Execute /compact em ~60% do contexto — não espere chegar a 80%+
- ✓Passe instruções claras sobre o que preservar no /compact
- ✓Use /clear ao mudar de tarefa — CLAUDE.md sempre persiste
✗ O que NÃO fazer
- ✗Esperar o contexto estourar para agir — a degradação começa antes
- ✗Usar /compact sem instruções — pode perder detalhes importantes
- ✗Usar /clear no meio de uma tarefa complexa sem salvar as decisões em algum lugar
🎯 Resumo do Módulo 1.2
Próximo Módulo:
1.3 — Fluxo de Trabalho Inteligente: plan mode, interação colaborativa e autoverificação para eliminar retrabalho e garantir qualidade em cada etapa.