Como dominar a Engenharia de Contexto no Claude Code: 5 Padrões e 13 Passos usados pelos engenheiros da Anthropic

Toda sessão longa do Claude Code termina do mesmo jeito: você perde horas de progresso e começa do zero.

A solução não é um modelo mais inteligente, é um sistema que a equipe do Claude Code usa internamente e nunca escreveu um guia sobre isso.

A maioria dos devs não tem isso e nem sabe que existe.

Aqui está o sistema completo 👇

🧠Antes de mergulharmos, compartilho notas diárias sobre IA e vibe coding no meu canal do Telegram:https://t.me/zodchixquant

O que engenharia de contexto realmente significa

Claude lê milhares de linhas a cada sessão. A maior parte é ruído, e os 5% que importam ficam enterrados na segunda hora.

É aí que Claude começa a inventar funções e corrigir bugs que você nunca escreveu. A solução não é um modelo maior, é controlar o que entra na sessão.

Estes são os 6 padrões que a equipe do Claude Code usa no próprio monorepo.

Padrão 1: CLAUDE.md em camadas (Etapas 1-3)

Um único CLAUDE.md não é suficiente. A equipe do Claude Code usa três camadas, cada uma com um escopo diferente.

Etapa 1: CLAUDE.md raiz com regras do projeto inteiro

Coloque um CLAUDE.md na raiz do seu repositório. Mantenha abaixo de 100 linhas. Ele deve responder a quatro perguntas que Claude tem a cada prompt:

1# Projeto: [nome]
2
3## Stack
4- Runtime: Node 22, TypeScript 5.5
5- Framework: Next.js 15, React 19
6- Database: Postgres 16, Drizzle ORM
7- Testing: Vitest, Playwright
8
9## Convenções
10- Imports: apenas caminhos absolutos de `@/`
11- Componentes: arquivos em kebab-case, exports em PascalCase
12- Testes: colocados como `[arquivo].test.ts`
13- Commits: conventional commits, sem rodapé de co-autor
14
15## Não mexa
16- `infra/terraform/` (gerenciado pela operação)
17- `migrations/` (gerado, nunca editado manualmente)
18- `vendor/` (dependências commitadas)
19
20## Padrões
21- Execute `npm test` antes de declarar uma tarefa concluída
22- Verifique tipos com `tsc --noEmit` a cada edição
23- Formate com Prettier ao salvar

Etapa 2: CLAUDE.md em subdiretório para contexto específico do módulo

Adicione CLAUDE.md em qualquer pasta onde as regras mudem. Claude lê o mais próximo quando trabalha naquela pasta, além do arquivo raiz.

Exemplo, src/auth/CLAUDE.md:

1# Módulo Auth
2
3Este módulo gerencia sessão e fluxos OAuth.
4
5## Regras
6- Nunca registre tokens, mesmo que truncados
7- Todas as leituras de sessão passam por `getSession()`, nunca cookies brutos
8- Novos provedores exigem revisão de segurança antes do merge
9
10## Arquivos para ler primeiro
11- `session.ts` para o contrato
12- `providers/index.ts` para o padrão de registro

Etapa 3: CLAUDE.md pessoal em ~/.claude/CLAUDE.md

Esta é sua camada de preferências global. Fica fora de qualquer repositório, aplica-se em todos os lugares.

1## Minhas preferências
2- Explique o que você vai fazer antes de fazer em edições de múltiplos arquivos
3- Alerte se meu pedido parecer que vai quebrar algo
4- Prefira composição em vez de herança
5- Trabalho em zsh no macOS

As três camadas se empilham: preferências globais + regras do projeto + regras do módulo. Claude lê todas as três a cada prompt sem precisar reenviá-las pelo seu contexto.

Padrão 2: Referências cirúrgicas a arquivos (Etapas 4-5)

O padrão "deixar Claude descobrir quais arquivos importam" é a maneira mais lenta e burra de usar contexto.

Etapa 4:@arquivo com autocomplete

Quando você digita @ em um prompt, Claude abre um seletor fuzzy de arquivos. Use isso em vez de descrever arquivos em texto.

Ruim: "olhe o código de autenticação de usuário e o helper de sessão"

Bom: "olhe

@src/auth /session.ts e

@src/auth /providers/google.ts, corrija a renovação do token"

Referências cirúrgicas carregam exatamente aqueles arquivos. Descrições em texto forçam Claude a pesquisar, ler 4-5 arquivos candidatos e escolher o errado metade das vezes.

Etapa 5: /focus para escopo de um fluxo de trabalho inteiro

Para tarefas mais longas, defina o escopo de toda a sessão do Claude para pastas específicas:

1/focus src/auth src/api/auth-routes

Agora toda pesquisa, grep e leitura opera apenas dentro dessas duas pastas.

Reduz o uso de contexto em 60-80% em tarefas focadas, e Claude para de "ajudar" lendo arquivos não relacionados para contexto que não precisa.

Execute /focus clear para redefinir.

Padrão 3: Compactar-e-continuar (Etapas 6-8)

Sessões longas atingem o limite de contexto e travam. O truque não é evitar sessões longas, é executá-las através de compactação controlada.

Etapa 6: Monitore o uso de contexto com /stats

Execute /stats periodicamente.

Quando você ultrapassar 70% de uso de contexto, está na zona de perigo. Acima de 85%, Claude começa a descartar mensagens antigas sem avisar.

Etapa 7: /compact com instruções de preservação

/compact sozinho resume a conversa. Com instruções, você diz a Claude o que preservar literalmente:

1/compact preserve: plano da tarefa atual, todas as decisões sobre o refactor de auth, a saída do teste com falha da etapa 3

Etapa 8: /resume para sessões que duram dias

Se uma tarefa durar vários dias, termine cada sessão com /compact preserve: ... e comece a próxima com:

1claude --resume [id-da-sessão]

Ou apenas claude --continue para a sessão mais recente. Continua exatamente de onde parou com o estado compactado intacto.

Padrão 4: Leitura primeiro, plano depois (Etapas 9-10)

O maior vazamento de contexto é Claude editar arquivos antes de entendê-los. O modo plano força a ler primeiro, escrever depois.

Etapa 9: Ative o modo plano em toda tarefa arriscada

Pressione Shift+Tab para entrar no modo plano antes de qualquer tarefa que toque mais de um arquivo.

No modo plano, Claude só pode ler. Ele explica o que faria, lista cada arquivo que planeja tocar e mostra as alterações propostas. Nada é executado até você aprovar.

A economia é real: uma leitura, uma edição, em vez de ler 8, editar 3 errado, reverter, reler, editar de novo.

Etapa 10: Bloqueie o modo plano para caminhos sensíveis via hooks

Torne o modo plano obrigatório para áreas arriscadas. Em .claude/settings.json:

1{
2  "hooks": {
3    "PreToolUse": [
4      {
5        "matcher": "Edit(src/auth/**)|Edit(migrations/**)",
6        "hooks": [
7          {
8            "type": "command",
9            "command": "claude-require-plan-mode"
10          }
11        ]
12      }
13    ]
14  }
15}

Qualquer tentativa de edição em src/auth/*\ ou migrations/\\ *aciona um requisito de modo plano. Claude não pode ignorar isso.

Padrão 5: Isolamento de contexto de subagentes (Etapas 11-13)

Subagentes são a maneira mais limpa de manter seu contexto principal pequeno. Cada subagente é executado em sua própria janela, então a sessão pai nunca vê o ruído.

Etapa 11: Projete subagentes com superfície mínima de ferramentas

Restrinja as ferramentas ao que a tarefa precisa.

Um revisor-de-código não precisa de Write ou Edit.

Um atualizador-de-docs não precisa de Bash. Menos superfície, menos contexto queimado em documentação e descrições de ferramentas irrelevantes.

1---
2name: revisor-de-código
3description: Revisar alterações de código em busca de bugs e problemas de segurança
4tools: Read, Grep, Glob
5model: sonnet
6---

Etapa 12: Passe apenas as referências de arquivo que o agente precisa

Não diga "revise as alterações recentes." Diga "revise @src/auth/session.ts e @src/auth/providers/google.ts."

O subagente lê apenas aquelas, não seu melhor palpite do que "recente" significa.

Etapa 13: Use modelos mais baratos para subagentes

Defina o modelo por agente com base na tarefa.

Sonnet para tarefas de revisão e teste, Haiku para atualizações de docs e lints, Opus apenas para auditorias de arquitetura ou segurança onde raciocínio profundo importa.

Defina globalmente se necessário:

1export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"

Subagentes mais baratos = mais chamadas de subagentes por dólar = mais isolamento = contexto principal menor.

O iniciador de engenharia de contexto de 30 minutos

10 minutos: escreva um CLAUDE.md raiz enxuto com stack, convenções, lista de não mexer e padrões.

5 minutos: adicione CLAUDE.md em subdiretório nos seus 2-3 módulos mais editados.

5 minutos: crie um CLAUDE.md pessoal em ~/.claude/CLAUDE.md com suas preferências.

5 minutos: construa uma skill em .claude/skills/ para o fluxo de trabalho que você mais faz.

5 minutos: grave o atalho Shift+Tab na memória muscular e comece toda tarefa de múltiplos arquivos no modo plano.

Pronto!

Sua próxima sessão usará 50-70% menos contexto para a mesma quantidade de trabalho. Na sessão 5, os padrões se tornam reflexo, e você para de atingir o limite completamente.

Contexto não é algo que Claude gerencia para você. É algo que você projeta.

Agora você tem o sistema.

Obrigado por ler!

Compartilho notas diárias sobre IA, finanças e vibe coding no meu canal do Telegram: https://t.me/zodchixquant