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 do 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 com 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
■ Conceitos básicos da 𝗷𝗮𝗻𝗲𝗹𝗮 𝗱𝗲 𝗰𝗼𝗻𝘁𝗲𝘅𝘁𝗼
Primeiro, como pré-requisito, a janela de contexto do Claude Code é de 1 milhão de tokens.
O contexto inclui tudo isso:
・Prompt do sistema
・Histórico de conversas anteriores
・Todas as chamadas de ferramentas e suas saídas
・Conteúdo dos arquivos carregados
Em outras palavras, quanto mais longa a sessão, mais informações se acumulam nesse contexto.
■ O que é 𝗿𝗼𝘁𝗮𝗰̧𝗮̃𝗼 𝗱𝗲 𝗰𝗼𝗻𝘁𝗲𝘅𝘁𝗼?
Um conceito importante aqui é a "rotação de contexto" (context rot).
À medida que o contexto cresce, a atenção do modelo se 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 o Thariq, a rotaçã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 desse 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? Na verdade, este é o ponto de decisão mais importante.
O Thariq lista cinco opções:
𝟭. 𝗖𝗼𝗻𝘁𝗶𝗻𝘂𝗮𝗿
Enviar a próxima mensagem na mesma sessão. A escolha mais natural.
𝟮. /𝗿𝗲𝘄𝗶𝗻𝗱 (Duplo toque em Esc Esc)
Voltar para uma mensagem passada e reiniciar a partir dali. As mensagens subsequentes são removidas do contexto.
𝟯. /𝗰𝗹𝗲𝗮𝗿 (Nova Sessão)
Resumir você mesmo as informações importantes e iniciar uma sessão nova.
𝟰. /𝗰𝗼𝗺𝗽𝗮𝗰𝘁
Fazer o modelo resumir a conversa até agora e continuar com base nesse resumo.
𝟱. 𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝗲𝘀
Delegar 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 do 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 uma funcionalidade. 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 no contexto e apenas continuar.
■ 𝗿𝗲𝘄𝗶𝗻𝗱 é o recurso mais subestimado
O Thariq cita o "rewind" como o melhor hábito para um bom gerenciamento de contexto.
No Claude Code, você pode voltar a qualquer mensagem passada e reiniciar tocando duas vezes na tecla Esc (ou usando o comando /rewind). As mensagens após esse ponto são completamente removidas do contexto.
Considere um cenário específico:
O 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 que falhou permanece no contexto.
✅ Maneira melhor: Voltar (rewind) para logo após a leitura dos arquivos e dar 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 que falhou 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 focus on auth refactor, remove test debugging).
【/clear】
・Você mesmo escreve as informações importantes e inicia uma sessão nova.
・Tipo: "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 nas 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 o 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ê 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 à rotação de 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 a seguir.
■ 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 da saída desta 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 a documentação desta funcionalidade 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 depois que 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 você ainda tem espaço (com direcionamento)
- É 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 da 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 o 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 tiver interesse, siga e dê uma olhada! Vale a pena!
