Você tem esses problemas ao usar o Claude Code?
・Quando a sessão do Claude Code fica longa, a qualidade das respostas cai por algum motivo.
・Quais são os comandos? Eu não entendo muito bem as diferenças.
・Não consigo decidir quando usar subagentes.
・O contexto está uma bagunça total.
Agora mesmo, um post de Thariq (@trq212), um funcionário da Anthropic, sobre "gerenciamento de sessão do Claude Code e o contexto de 1 milhão de tokens" está viralizando com 540.000 visualizações 😳
Então, para todos que estão tendo esses problemas, vou detalhar e explicar o conteúdo de uma forma fácil de entender 👇
Post original aqui: https://x.com/trq212/status/2044548257058328723?s=20
■ Fundamentos da 𝗷𝗮𝗻𝗲𝗹𝗮 𝗱𝗲 𝗰𝗼𝗻𝘁𝗲𝘅𝘁𝗼
Primeiro, como pré-requisito, a janela de contexto do Claude Code é de 1 milhão de tokens.
O contexto inclui tudo o seguinte:
・Prompt do sistema
・Histórico de conversas passadas
・Todas as chamadas de ferramentas e suas saídas
・Conteúdos dos arquivos carregados
Em outras palavras, quanto mais longa a sessão, mais informações se acumulam neste contexto.
■ O que é 𝗱𝗲𝘁𝗲𝗿𝗶𝗼𝗿𝗮çã𝗼 𝗱𝗲 𝗰𝗼𝗻𝘁𝗲𝘅𝘁𝗼?
Um conceito importante aqui é "deterioração de contexto" (context rot).
À medida que o contexto cresce, a atenção do modelo é dispersa por muitos tokens, e informações antigas ou irrelevantes se tornam ruído que começa a interferir na tarefa atual.
De acordo com Thariq, a deterioração de contexto é observada a partir de cerca de 300.000 a 400.000 tokens no modelo de 1 milhão de tokens. No entanto, isso não é uma regra rígida, pois depende muito da tarefa.
Como a janela de contexto tem um limite máximo, quando você se aproxima do limite, precisa resumir o trabalho anterior e continuar em um novo contexto. Esse processo é chamado de "compactação".
■ Cada turno é um "Ponto de Virada"
O que o Claude Code deve fazer depois de concluir uma tarefa? Este é, na verdade, o ponto de decisão mais importante.
Thariq lista cinco opções:
𝟭. 𝗖𝗼𝗻𝘁𝗶𝗻𝘂𝗮𝗿
Envie a próxima mensagem na mesma sessão. A escolha mais natural.
𝟮. /𝗿𝗲𝘄𝗶𝗻𝗱 (Pressione Esc Esc duas vezes)
Volte para uma mensagem passada e recomece a partir dali. As mensagens subsequentes são removidas do contexto.
𝟯. /𝗰𝗹𝗲𝗮𝗿 (Nova Sessão)
Resuma as informações importantes você mesmo e inicie uma nova sessão.
𝟰. /𝗰𝗼𝗺𝗽𝗮𝗰𝘁
Peça ao modelo para resumir a conversa até agora e continuar com base nesse resumo.
𝟱. 𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝗲𝘀
Delegue o próximo bloco de trabalho a um agente com seu próprio contexto limpo, retornando apenas o resultado para a sessão pai.
■ Quando iniciar uma nova sessão
Graças à janela de contexto de 1 milhão de tokens, tarefas longas como construir um aplicativo full-stack do zero agora podem ser executadas de forma mais estável.
No entanto, só porque ainda há espaço no contexto não significa que você deva continuar na mesma sessão.
A regra prática de Thariq é simples:
🔥 "Se você está começando uma nova tarefa, deve iniciar uma nova sessão."
Existem exceções. Por exemplo, escrever documentação imediatamente após implementar um recurso. Se você iniciar uma nova sessão, o Claude Code terá que reler os arquivos que acabou de implementar, o que é lento e custoso. Para tarefas como documentação que não exigem "alta inteligência", é mais eficiente aceitar alguma poluição de contexto e apenas continuar.
■ 𝗿𝗲𝘄𝗶𝗻𝗱 é o recurso mais subestimado
Thariq cita "rewind" como o melhor hábito para um bom gerenciamento de contexto.
No Claude Code, você pode voltar a qualquer mensagem passada e recomeçar pressionando a tecla Esc duas vezes (ou usando o comando /rewind). As mensagens após esse ponto são completamente removidas do contexto.
Considere um cenário específico:
Claude leu cinco arquivos e tentou uma abordagem que falhou.
❌ Reação normal: "Isso não funcionou. Tente X em vez disso."
→ Todo o registro da abordagem falha permanece no contexto.
✅ Maneira melhor: Volte (rewind) para logo após a leitura dos arquivos e dê novas instruções com base no que você aprendeu.
→ "Não use a abordagem A. O módulo foo não expõe isso. Vá direto para B."
Ao fazer isso, os tokens da tentativa e erro fracassada desaparecem, permitindo uma nova tentativa em um estado limpo.
Além disso, usando um recurso de "resumir daqui para frente", o Claude pode resumir seu próprio aprendizado e criar um "memorando do eu passado para o eu futuro".
■ A diferença crítica entre /𝗰𝗼𝗺𝗽𝗮𝗰𝘁 e /𝗰𝗹𝗲𝗮𝗿
Quando uma sessão fica longa, existem duas maneiras de reduzir o peso. Elas parecem semelhantes, mas são completamente diferentes.
【/compact】
・O modelo resume a conversa e substitui o histórico por esse resumo.
・Com perdas — o que é importante fica a critério do Claude.
・Você não precisa escrever nada, mas o Claude pode perder algo.
・Você pode fornecer instruções para guiá-lo (ex: /compact foco na refatoração de autenticação, remova depuração de teste).
【/clear】
・Você mesmo escreve as informações importantes e inicia uma nova sessão.
・Como: "O alvo é o middleware de autenticação, as restrições são X, os arquivos relacionados são A e B, a abordagem Y está excluída."
・Dá trabalho, mas o contexto resultante consiste apenas em informações que você escolheu.
Escolher entre eles é um trade-off entre controle e conveniência.
■ Por que a 𝗰𝗼𝗺𝗽𝗮𝗰𝘁𝗮çã𝗼 falha
Ao usar sessões longas, a qualidade da compactação pode se tornar extremamente baixa.
De acordo com Thariq, a maior causa de uma compactação ruim é "quando o modelo não consegue prever a direção do trabalho."
Exemplo:
Após uma longa sessão de depuração, a autocompactação é acionada e resume a investigação.
→ Se você então disser "Corrija esse aviso no bar.ts também", a informação sobre esse aviso pode ter sido descartada do resumo focado na depuração.
Ainda mais problemático é o dilema de que, devido à deterioração do contexto, o modelo está em seu "estado de inteligência mais baixo" ao executar a compactação. Em outras palavras, o resumo de qualidade mais baixa é gerado no momento em que o resumo mais preciso é necessário.
Agora que temos um contexto de 1 milhão de tokens, a melhor estratégia é executar /compact você mesmo enquanto ainda há espaço, adicionando uma explicação do que fazer em seguida.
■ Quando usar 𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝗲𝘀
Subagentes também são uma forma de gerenciamento de contexto.
Quando o Claude Code cria um subagente com a ferramenta Agent, esse subagente tem sua própria janela de contexto limpa. Ele faz todo o trabalho necessário, resume o resultado e o retorna para a sessão pai.
O critério é simples:
👀 "Vou precisar desta saída da ferramenta novamente mais tarde? Ou apenas a conclusão é suficiente?"
Se apenas a conclusão for suficiente, você deve deixar para um subagente.
O Claude Code chama subagentes automaticamente, mas dar instruções explícitas também é eficaz:
・"Inicie um subagente e verifique os resultados do trabalho com base neste arquivo de especificação."
・"Use um subagente para ler e resumir como o fluxo de autenticação é implementado em outra base de código. Use isso como referência para implementá-lo aqui."
・"Use um subagente para escrever documentação para este recurso a partir do git diff."
Ao não trazer a saída intermediária para o contexto pai, você mantém o contexto limpo.
■ Resumo: 5 Técnicas de Gerenciamento de Contexto
Coisas que você deve sempre decidir antes de enviar a próxima mensagem após o Claude terminar um turno:
- A tarefa mudou? → /clear para uma nova sessão
- A abordagem falhou? → /rewind para voltar ao ponto logo após o carregamento do arquivo
- A sessão está ficando longa? → /compact enquanto ainda há espaço (com direção)
- É uma tarefa com muita saída intermediária? → Delegue para um subagente
- O contexto pode ser usado para tarefas relacionadas? → Continue como está
No futuro, o próprio Claude ajudará com essas decisões, mas por enquanto, os usuários que fazem esses julgamentos podem melhorar significativamente a qualidade da saída do Claude Code.
O gerenciamento de sessão é sutil, mas é uma habilidade que muda fundamentalmente a experiência com o Claude Code 🔥
Para quem achou este artigo útil:
𝗖𝗹𝗮𝘂𝗱𝗲 𝗖𝗼𝗱𝗲 𝗦𝘁𝘂𝗱𝗶𝗼 @ 𝗝𝗮𝗽ã𝗼 (@ClaudeCode_love) é uma conta administrada por três entusiastas do Claude Code.
Publicamos diariamente sobre uso prático de CLI e automação.
Atualmente, estamos co-desenvolvendo um agente de IA com uma empresa de capital aberto.
Nosso conteúdo habitual 👇
・Casos reais de desenvolvimento de produtos usando Claude Code e Claude
・Uso do Claude Code / Vibe Coding / organização de tendências de desenvolvimento
・Informações mais recentes sobre Claude Code do exterior
Da filosofia de desenvolvimento ao design, implementação e melhoria, resumimos informações do exterior e primárias para ajudar você a lançar produtos funcionais, não apenas "terminar de fazer" eles.
Se você tiver interesse, siga-nos e dê uma olhada! Vale a pena!
