Você abre a conversa de manhã e ela acerta de primeira. No fim da tarde, a mesma conversa erra o que já tinha acertado, volta a sugerir o que você recusou e esquece o que ficou combinado.
A conclusão natural é que o modelo piorou. Não piorou. O que mudou foi o que está guardado dentro da conversa.
O que enche a janela
Tudo que acontece numa sessão fica registrado nela: cada arquivo lido, cada busca, cada saída de comando — e, principalmente, cada tentativa que deu errado.
A documentação oficial não deixa isso subentendido. A frase está lá, na página de boas práticas:
During long sessions, Claude's context window can fill with irrelevant conversation, file contents, and commands. This can reduce performance and sometimes distract Claude.
Ou seja: o problema não é a idade da conversa. É o entulho dentro dela.
Os três erros, com o nome que a doc dá
A mesma página tem uma seção chamada Avoid common failure patterns. Três dos itens são exatamente sobre encher o contexto.
1. The kitchen sink session
Você começa uma tarefa, pergunta outra coisa sem relação no meio, e volta para a primeira. O contexto fica cheio de informação que não serve para nenhuma das duas.
Correção oficial: /clear entre tarefas sem relação.
O detalhe que a maioria não faz: /clear não é para o fim do dia. É para a troca de
assunto. Se você terminou de mexer no formulário de login e vai olhar o relatório de vendas,
o /clear vai ali no meio — não depois de mais três horas.
Antes de limpar, vale rodar /rename para batizar a sessão. Assim ela fica fácil de achar
com /resume se você precisar voltar.
2. Correcting over and over
Ela faz errado, você corrige, continua errado, você corrige de novo. Cada tentativa que falhou continua ocupando espaço — e pior, continua sendo lida como se fosse contexto útil.
Correção oficial: depois de duas correções que não pegaram, /clear e escreva um
pedido novo, já incluindo o que você aprendeu nas tentativas.
Este é o item mais contraintuitivo do guia inteiro, e a doc é direta sobre ele:
A clean session with a better prompt almost always outperforms a long session with accumulated corrections.
Insistir na mesma conversa parece economizar tempo, porque o trabalho já está ali. Na prática é o caminho mais lento.
3. The infinite exploration
Você pede para "investigar" alguma coisa sem limitar o escopo. Ela lê centenas de arquivos, e todos entram na sua janela.
Correção oficial: limitar o escopo da investigação, ou delegar a um subagente — que roda numa conversa separada e devolve só o resumo, sem despejar tudo que leu na sua.
Os comandos, na ordem de usar
| Comando | Para quê |
|---|---|
/clear | Zera a janela inteira. Entre tarefas sem relação. |
/compact <instrução> | Resume a conversa preservando o que você mandar. Ex.: /compact Foco nas mudanças de API |
/context | Mostra o que está ocupando espaço agora. Use antes de decidir o que fazer. |
/btw | Pergunta avulsa cuja resposta não entra no histórico. Para conferir um detalhe sem crescer o contexto. |
Esc + Esc ou /rewind | Volta a conversa e o código a um ponto anterior, ou resume só um trecho. |
O /btw é o menos conhecido dos cinco e resolve um caso muito comum: você precisa conferir
uma coisinha no meio de uma tarefa longa. Perguntar normalmente custa contexto para sempre;
com /btw, a resposta não fica.
O que sobrevive quando a conversa é resumida
Quando a sessão compacta — automaticamente ou pelo seu comando — nem tudo é tratado igual. A documentação tem a tabela completa; o resumo que importa:
- Reinjetado do disco (não se perde): o
CLAUDE.mdda raiz, as regras sem escopo, a memória automática, e o plano escrito no modo de planejamento. - Recarregado quando ela lê o arquivo de novo: regras com escopo de caminho e o
CLAUDE.mdde subpasta. - Vira resumo (aqui mora a perda): a conversa em si, e o conteúdo dos arquivos lidos.
Por isso instrução que precisa valer sempre pertence ao CLAUDE.md, não ao meio da
conversa: o arquivo volta sozinho depois do resumo, sua explicação digitada não.
Dá para dizer o que preservar. No CLAUDE.md:
# Compact instructions
Ao compactar, preserve a lista completa de arquivos modificados e os comandos de teste.
O checklist de uma sessão que não apodrece
- Trocou de assunto?
/clearagora, não depois. - Corrigiu a mesma coisa duas vezes? Pare.
/cleare reescreva o pedido com o que aprendeu. - Vai mandar investigar? Diga onde procurar, ou peça um subagente.
- Dúvida rápida no meio da tarefa?
/btw. - Sessão longa inevitável?
/compactcom instrução, não o resumo automático. - Instrução que vale sempre? Move para o
CLAUDE.md— é o que volta depois do resumo.
Nenhum dos seis exige plano pago, configuração ou instalação. Todos são o comportamento que a documentação oficial recomenda, e a maior parte do ganho está nos dois primeiros.