Gerenciamento de Contexto no Claude Code: /clear vs /compact e o Resto

Dois comandos fazem o trabalho de verdade. /clear inicia uma conversa do zero com uma janela vazia. /compact comprime a conversa atual em um resumo e continua de onde parou. Todo o resto dos comandos de contexto no Claude Code serve para ver o que está preenchendo a janela ou para se recuperar quando algo dá errado.

Esse é o mapa completo. A habilidade está em saber qual dos dois você precisa antes de o indicador virar vermelho.

Se quiser entender os fundamentos primeiro, veja o que é uma janela de contexto de verdade. Este artigo é a versão do operador: qual comando, quando, e o que você perde.

O que realmente preenche sua janela de contexto

Não é só o chat. O Claude Code enche a janela com leituras de arquivos, o CLAUDE.md do projeto, entradas de memória, corpos de skills invocadas, definições de ferramentas MCP, saída de hooks e a própria conversa.

Execute /context (ou /context all) para ver tudo isso. Ele exibe uma grade colorida de uso de tokens por categoria, além de dicas de otimização e avisos de capacidade.

É por isso que isso importa. Se seus servidores MCP e definições de skills estão consumindo metade da janela antes de você digitar uma palavra, compactar a conversa vai adiantar muito pouco. Você precisa saber o que está pesando antes de decidir como cortar.

/clear vs /compact, a única bifurcação que importa

/clear esquece. /compact lembra um resumo.

/clear inicia uma conversa totalmente nova com uma janela de contexto vazia. Seu chat anterior não é destruído. Ele permanece acessível via /resume.

Passe um nome com /clear <nome> para rotular a nova sessão. O CLAUDE.md do projeto e a memória são recarregados do disco para a nova sessão.

/compact mantém você na mesma sessão. Ele resume tudo até o momento em uma linha de base condensada e continua a partir daí. Segundo a documentação oficial do Claude Code, essa é a divisão: clear para uma nova tarefa, compact para liberar tokens dentro da tarefa atual.

O padrão deve ser /clear. É mais rápido e mais limpo do que arrastar o ruído acumulado de uma tarefa para a próxima. O time do Claude Code concorda sem rodeios. "PAREM DE USAR COMPACT, usem /clear," escreveu @trq212 do time do Claude Code, que enquadrou a diferença entre como o time trabalha e como a comunidade trabalha como uma questão de com que frequência cada um limpa o contexto.

O autor do Medium Mubashar chega à mesma regra: "use clear por padrão, recorra ao compact quando a continuidade importa."

Clear esquece. Compact lembra um resumo. Saber qual você precisa é toda a habilidade.

Colocando IA para trabalhar em uma prática de design? O Brainy ajuda designers a fazer isso sem perder o artesanato. Veja o que estamos construindo para criadores.

Como guiar um compact

/compact aceita instruções em texto livre. Use-as.

Um /compact simples deixa o Claude decidir o que importa. /compact foque no bug de autenticação ou /compact mantenha o schema do banco de dados diz o que proteger. Um resumo guiado é muito mais confiável do que um genérico.

Isso importa porque a compactação é com perdas por design. Um compact às cegas pode descartar detalhes que você precisava, e é por isso que uma transferência geralmente supera uma limpeza: despeje o que você precisa em um arquivo markdown, execute /clear e aponte a nova sessão para esse arquivo.

Para a maioria dos trabalhos na mesma tarefa, um /compact focado é suficiente. Para uma transferência crítica onde você não pode perder detalhes, escreva primeiro.

O que sobrevive a um compact, e o que desaparece silenciosamente

Algumas coisas são reinjetadas após o resumo. Outras somem até você as acionar novamente.

As linhas perigosas são as silenciosas. Regras com escopo de caminho e arquivos CLAUDE.md aninhados saem da janela após um compact e só retornam quando você lê um arquivo correspondente novamente. Se seu projeto depende de regras com escopo, um compact pode mudar o comportamento do Claude sem avisar.

Compactação automática, a rede de segurança que você não pode desligar

Quando a conversa se aproxima do limite de contexto, o Claude Code compacta por conta própria. Mesmo comportamento de um /compact manual.

Você não pode desativar isso. Não existe configuração. Planeje ao redor disso, não contra isso.

Tudo bem, porque o melhor instinto é compactar cedo, não na beira do limite. O cookbook de uso de ferramentas da Anthropic mostra a compactação automática cortando tokens de entrada em cerca de 58% em uma execução de agente com múltiplos tickets, de aproximadamente 204k para 82k. Uma análise em hyperdev.matsuoka.com relata que compactar proativamente por volta de 60% da capacidade, em vez de esperar até 95%, aliada a uma melhor edição de contexto, entregou até 39% de melhora de desempenho em relação à linha de base.

A lição é simples. Não espere a janela chegar no limite. Um /clear limpo ou um /compact antecipado supera um auto-compact em pânico no meio de um raciocínio.

Ver e salvar: /context, /cost e /export

Três comandos para inspecionar e preservar antes de cortar.

/context mostra a grade de tokens por categoria. Execute sempre que o Claude parecer lento. Lentidão geralmente é janela cheia, não modelo burro.

/cost (alias /usage) mostra o custo da sessão e estatísticas de uso do plano. Nos planos Pro, Max, Team e Enterprise, detalha o uso por skill, subagente, plugin e servidor MCP. Para assinantes Max e Pro, aquela cifra em dólares é uso do plano, não uma conta avulsa.

/export [nome_do_arquivo] escreve a transcrição em texto simples, para um arquivo nomeado ou via diálogo de salvar. Execute antes de um /clear quando quiser um registro.

/rewind e /resume, recupere-se sem começar do zero

Quando você tomou um caminho errado, não precisa começar do zero.

/rewind (aliases /checkpoint, /undo) volta a um checkpoint anterior. Pode restaurar o estado da conversa, o estado do código, ou ambos, ou resumir a partir de uma mensagem que você escolher. Existe um atalho de teclado para isso. Execute /keybindings para ver a vinculação atual em vez de adivinhar.

/resume (alias /continue) traz uma conversa passada de volta, por seletor, ID de sessão ou nome. Essa é a rede de segurança sob o /clear. Limpar nunca deleta, então um clear errado está a um /resume de distância.

Arquivos de memória sobrevivem ao clear e ao compact

O CLAUDE.md é a camada durável. Sobrevive a tudo.

O CLAUDE.md do projeto e os arquivos de memória recarregam após um /clear e são reinjetados após um /compact. Qualquer coisa que você re-explica a cada sessão pertence a eles, não ao chat. /memory abre esses arquivos para edição e permite habilitar, desabilitar ou visualizar entradas de auto-memória.

Segundo a documentação do Claude Code, é por isso que o CLAUDE.md é o lugar certo para invariantes. Regras como "sempre execute os testes" ou "nunca toque no schema" persistem entre resets e moldam futuros resumos. Empurre fatos para dentro dele e você para de pagar o imposto de re-explicação a cada sessão.

Quando a janela ainda está muito apertada

Cortar a conversa não é a única alavanca. Três movimentos cobrem o restante.

Subagentes são o principal. Passe um trabalho independente para um subagente que roda em seu próprio contexto limpo e retorna apenas o resultado. O thread principal permanece enxuto enquanto o trabalho pesado acontece em outro lugar. Para uma tarefa grande, nada mais libera tanto espaço.

CLAUDE.md com escopo de caminho e memória aninhada mantêm as regras próximas dos arquivos que elas governam, então elas carregam apenas quando relevante em vez de ficar na janela a sessão toda.

Uma janela maior ajuda mas não desculpa desleixo. Os modelos mais recentes do Claude, a família Opus 4.x e Sonnet 4.x e o Fable 5, suportam até 1M de tokens de contexto. Uma janela cheia ainda é mais lenta e mais cara de ler, então o gerenciamento ainda importa. É o mesmo motivo pelo qual vale a pena usar uma janela de contexto com eficiência não importa o quão grande ela fique.

A regra de decisão, em uma tabela

Uma tabela. Copie.

Use /clear por padrão. Recorra ao /compact apenas quando a continuidade dentro de uma tarefa é o ponto. Execute /context quando as coisas ficarem lentas, porque se servidores MCP e skills forem o problema, nenhuma quantidade de compactação do chat vai resolver.

FAQ

Devo usar /clear ou /compact com mais frequência?

/clear, de longe. O hábito declarado do time do Claude Code, ecoado por r/ClaudeCode e uma nota do LinkedIn de jdfiscus, é limpar ao concluir uma tarefa e manter o /compact para permanecer dentro de uma tarefa longa. Conversas longas que dependem de compactações repetidas perdem detalhes a cada passagem.

O /clear deleta minha conversa?

Não. /clear inicia uma janela limpa mas deixa a conversa anterior intacta e acessível via /resume. Nada é destruído.

Posso desligar a compactação automática?

Não. A compactação automática roda quando a conversa se aproxima do limite, e não existe configuração para desativá-la. A solução é limpar ou compactar deliberadamente antes de chegar lá.

O que o /compact realmente perde?

Detalhe literal. Saídas exatas de ferramentas, dumps longos de arquivos e texto preciso de mensagens anteriores são comprimidos em um resumo. Um compact às cegas pode perder detalhes que você precisava, e é por isso que um /compact <instruções> guiado ou uma transferência via markdown supera o padrão.

Como vejo o que está preenchendo meu contexto?

Execute /context (ou /context all). Ele mostra uma grade colorida de uso de tokens por categoria: leituras de arquivos, CLAUDE.md, memória, skills, definições MCP, saída de hooks e a conversa, com dicas de otimização.

Onde devo colocar regras para que sobrevivam a resets?

No CLAUDE.md, editado via /memory. O CLAUDE.md do projeto e a memória recarregam após /clear e são reinjetados após /compact, então são o único contexto garantido para persistir.

Pare de deixar seu contexto apodrecer

A janela enche quer você gerencie ou não. A única questão é se você corta de propósito ou deixa um auto-compact fazer isso no meio de um raciocínio.

Use /clear por padrão entre tarefas. Use /compact com instruções dentro de uma. Execute /context quando travar, empurre fatos duráveis para o CLAUDE.md, e conte com subagentes para os trabalhos pesados. Essa é a disciplina inteira.

Se você está integrando IA em uma prática de design, o mesmo instinto se aplica em todo lugar: mantenha a máquina focada e mantenha o artesanato seu. Essa é a aposta por trás do Claude Code para designers, e há mais sobre IA para designers se quiser o resto.

O Brainy ajuda designers a colocar a IA para trabalhar sem perder o artesanato. Veja o que estamos construindo para criadores.