Noções Básicas de Gerenciamento de Contexto

10 exemplos para você começar com o gerenciamento de contexto do Claude Code - 7 básicos e 3 intermediários.

Pré-requisitos

• Claude Code CLI instalado e em execução dentro de um diretório de projeto (um repositório git não é necessário, mas recomendado).
• Nenhum pacote extra para instalar - CLAUDE.md é apenas um arquivo markdown, e /init, @mentions, /compact e /clear são todos integrados ao próprio Claude Code.

Exemplos Básicos

1. Gere um CLAUDE.md inicial com /init

Execute /init dentro de um projeto novo ou existente para que o Claude Code crie um CLAUDE.md inicial para você.

cd my-project
claude
# inside the Claude Code session:
/init

• O Claude Code escaneia o projeto (arquivos de pacote, layout de pastas, documentação existente) e escreve uma primeira versão do CLAUDE.md.
• O arquivo gerado é um ponto de partida, não um documento finalizado - sempre leia-o e corrija qualquer coisa errada ou faltando.
• Executar /init novamente em um projeto que já possui um CLAUDE.md o atualizará em vez de duplicar o trabalho do zero.

Relacionado: Inicializando um Novo Projeto com /init - um guia completo deste comando.

2. Escreva um CLAUDE.md mínimo manualmente

Um arquivo CLAUDE.md não precisa de sintaxe especial - é markdown que o Claude Code lê automaticamente no início de cada sessão.

# Project: Order Service
 
- Language: TypeScript, strict mode.
- Tests live in `__tests__/`, mirroring the source structure.
- Never edit files under `generated/` - they are rebuilt by `npm run codegen`.

• Coloque este arquivo na raiz do seu projeto como CLAUDE.md.
• Cada item de lista deve ser uma regra concreta e verificável, não uma preferência vaga.
• Faça o commit dele no controle de versão para que toda a equipe compartilhe a mesma memória do projeto.

Relacionado: O que CLAUDE.md Realmente Faz - por que este arquivo é importante.

3. Aponte o Claude Code para um arquivo com @mentions

Use @ seguido por um caminho para referenciar um arquivo exato em vez de descrevê-lo em prosa.

# in a Claude Code prompt:
Fix the bug in @src/utils/formatDate.ts where timezones aren't applied.

• @mentions evitam o trabalho de adivinhação do Claude Code ao procurar o arquivo certo - você o nomeia diretamente.
• Eles funcionam para qualquer arquivo no projeto, não apenas código-fonte - arquivos de configuração e documentação também.
• O uso excessivo de @mentions para arquivos grandes pode inflar rapidamente a janela de contexto, já que o conteúdo completo do arquivo é carregado.

Relacionado: Referenciando Arquivos Específicos com @mentions - padrões mais aprofundados para isso.

4. Libere espaço no meio da sessão com /compact

Quando uma conversa longa começa a ficar lenta ou a janela de contexto está enchendo, condense-a em vez de perder tudo.

# inside a Claude Code session:
/compact

• /compact resume a conversa até o momento, mantendo as partes relevantes e descartando o resto.
• Use-o quando quiser continuar trabalhando na mesma tarefa, mas a sessão acumulou muita troca exploratória.
• Não é sem perdas - detalhes muito específicos anteriores podem ser suavizados no resumo.

Relacionado: Por que /compact e /clear Existem - quando usar cada um.

5. Comece de novo de forma limpa com /clear

Quando uma conversa se desviou ou o contexto ficou obsoleto, limpe-a e comece de novo.

# inside a Claude Code session:
/clear

• /clear descarta todo o histórico da conversa - CLAUDE.md ainda é recarregado no início da nova sessão.
• Use-o ao mudar para uma tarefa não relacionada, em vez de arrastar histórico irrelevante.
• Ao contrário de /compact, nada da conversa antiga é mantido.

Relacionado: Por que /compact e /clear Existem - a comparação completa.

6. Adicione uma regra global do projeto que o Claude Code nunca deve quebrar

Regras concretas e inegociáveis pertencem ao CLAUDE.md como declarações explícitas, não como convenções implícitas.

## Hard Rules
 
- Never commit directly to `main` - always open a pull request.
- Never modify `.env.production` - ask the user first.
- Always run `npm test` before declaring a task finished.

• Uma seção dedicada "Regras Rígidas" torna as regras inegociáveis fáceis de verificar em comparação com preferências gerais de estilo.
• Emparelhe regras críticas com uma verificação real aplicada (CI, um hook de pré-commit) - CLAUDE.md é uma orientação que o agente lê, não uma barreira técnica rígida.
• Mantenha a lista curta - um punhado de regras verdadeiramente rígidas tem mais probabilidade de ser seguido do que cinquenta delas.

Relacionado: Escrevendo um Arquivo CLAUDE.md que Realmente é Seguido - o padrão completo.

7. Referencie vários arquivos relacionados ao mesmo tempo

@mentions podem ser encadeados quando uma tarefa abrange genuinamente vários arquivos.

# in a Claude Code prompt:
Compare @src/api/userController.ts with @src/api/orderController.ts
and make the error handling consistent between them.

• Encadear alguns @mentions direcionados consome menos contexto do que pedir ao Claude Code para pesquisar todo o código-fonte.
• Mantenha a lista para os arquivos que realmente importam para a tarefa - cada menção adiciona seu conteúdo completo ao contexto.
• Para um diretório inteiro de arquivos relacionados, descrever o padrão em prosa geralmente consome menos recursos do que mencionar cada arquivo individualmente.

Relacionado: Referenciando Arquivos Específicos com @mentions - mais sobre o escopo das menções.

Exemplos Intermediários

8. Camada de um CLAUDE.md aninhado para uma subpasta

Uma subpasta pode ter seu próprio CLAUDE.md que adiciona regras sobre o arquivo raiz, com escopo apenas para essa parte do código-fonte.

<!-- backend/CLAUDE.md -->
# Backend-specific rules
 
- All database queries go through the `repositories/` layer - never query directly from a route handler.
- Use `zod` schemas to validate every external input before it reaches business logic.

• O CLAUDE.md raiz ainda se aplica em todos os lugares - este arquivo apenas adiciona detalhes relevantes para backend/.
• Arquivos aninhados são úteis quando um projeto tem áreas genuinamente distintas (frontend vs backend, pacotes em um monorepo).
• Mantenha as regras aninhadas não contraditórias com o arquivo raiz - orientações conflitantes forçam o agente a adivinhar qual delas prevalece.

Relacionado: Arquivos CLAUDE.md Aninhados e Como Funciona a Herança de Escopo - a mecânica completa.

9. Diagnostique uma sessão que ficou lenta

Antes de usar /compact ou /clear, descubra o que está realmente consumindo contexto.

# a few questions to answer before deciding what to do:
# - Have I @mentioned any very large files repeatedly?
# - Has the conversation run many exploratory searches with verbose output?
# - Is CLAUDE.md itself unusually long?

• Arquivos grandes lidos na íntegra, @mentions excessivos e saída verbosa de ferramentas são os culpados usuais pelo inchaço do contexto.
• /compact é a medida correta quando a tarefa ainda está em andamento e você quer continuar.
• /clear é a medida correta quando você está mudando de tarefa completamente e o histórico antigo não é mais relevante.

Relacionado: Auditoria do que Está Consumindo Sua Janela de Contexto do Claude Code - um fluxo de trabalho de auditoria completo.

10. Combine CLAUDE.md, @mentions e /clear em uma tarefa

Um fluxo de trabalho realista encadeia todas as três ferramentas em vez de depender de apenas uma.

# CLAUDE.md already documents the project's conventions, so:
Refactor @src/services/payment.ts to use the retry pattern
described in CLAUDE.md under "Error Handling".
 
# ...later, once that task is done and merged:
/clear
# start the next, unrelated task with a clean session

• CLAUDE.md fornece as convenções permanentes, @mentions restringem a solicitação ao arquivo exato e /clear redefine após a conclusão da tarefa.
• Essa combinação mantém cada sessão focada: memória ampla do projeto mais um escopo de tarefa apertado e atual.
• Evite que uma única sessão longa acumule várias tarefas não relacionadas - é isso que torna o inchaço do contexto e as respostas confusas mais prováveis.

Relacionado: Melhores Práticas de Gerenciamento de Contexto - padrões que unem tudo isso.

Versões da Stack: Escrito contra a linha de modelos Claude atual em aproximadamente junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos do produto mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.