Gerenciamento de Contexto
- Distinguir /clear de /compact e escolher o certo instantaneamente
- Entender a compactação automática e por que limpar proativamente ainda é melhor do que ela
- Aplicar quatro técnicas para manter sessões longas afiadas
- Reconhecer os sintomas de uma janela de contexto cheia e corrigi-los rapidamente
A grande ideia
Toda sessão tem uma janela de contexto finita. Conforme ela enche, o conteúdo mais antigo é comprimido e o Claude pode começar a "desviar". Gerenciar o contexto de forma deliberada é o que mantém sessões longas afiadas.
Os dois comandos essenciais
Dois comandos cobrem quase toda situação. O truque é casar o comando com a sua intenção.
Decida com uma pergunta: esta é uma tarefa nova ou a mesma?
Compactação automática
Quando o contexto se aproxima do limite, o Claude Code pode fazer compactação automática para que o trabalho continue sem uma parada brusca. É uma rede de segurança — mas usar /clear proativamente entre as tarefas dá resultados melhores do que depender dela.
- Trate a compactação automática como um recurso de último caso, não como estratégia. Limpar entre tarefas não relacionadas mantém o contexto mais limpo do que deixar a janela encher até a compactação automática entrar em ação.
Técnicas para manter a eficácia
Além dos dois comandos, quatro hábitos mantêm seu contexto enxuto desde o início.
- Não deixe uma tarde de trabalhos não relacionados se acumular em um único contexto.
- Passe leituras grandes para subagentes — eles queimam o contexto DELES e retornam apenas a conclusão. Veja /docs/claude-code/subagents.
- Aponte o Claude para arquivos com @caminho em vez de colar grandes blocos, e mantenha o CLAUDE.md enxuto (veja /docs/claude-code/claude-md).
- Uma statusline mostrando o uso de contexto indica quando compactar. Veja /docs/claude-code/statusline.
Isso se mapeia para a documentação ao vivo: subagentes, CLAUDE.md e statusline.
:::tip Sintoma → solução
Se o Claude começar a esquecer uma instrução anterior ou a se repetir, a janela provavelmente está cheia. /compact (mesma tarefa) ou /clear (nova tarefa) costuma resolver na hora. Mais em Solução de Problemas.
:::
- /clear apaga a conversa para um recomeço — use para tarefas não relacionadas
- /compact resume a sessão para liberar espaço — use para continuar a mesma tarefa quando a janela enche
- A compactação automática é uma rede de segurança; usar /clear proativamente entre as tarefas dá resultados melhores
- Mantenha o contexto enxuto: uma tarefa por sessão, delegue leituras pesadas a subagentes, referencie arquivos em vez de colar e observe o orçamento via uma statusline
- Esquecimento ou repetição significa janela cheia — /compact (mesma tarefa) ou /clear (nova tarefa) resolve