O que é janela de contexto?
A janela de contexto é a quantidade máxima de texto que um modelo de linguagem consegue considerar em uma única requisição, medida em tokens. Instruções de sistema, definições de ferramentas, histórico da conversa, arquivos que o agente leu e saídas de comandos precisam caber nela.
O que enche o contexto de um agente de código
Cada requisição de um agente é uma base fixa mais um histórico que não para de crescer.
- O system prompt e as definições de ferramentas, incluindo as ferramentas de servidores MCP.
- Arquivos de instruções do projeto, como CLAUDE.md ou AGENTS.md.
- Histórico da conversa: suas mensagens e as respostas do agente.
- Arquivos lidos e saídas de comandos, muitas vezes o item mais pesado.
O que acontece quando ela enche
O modelo relê o contexto inteiro a cada turno. Quando a janela se aproxima do limite, os agentes resumem a conversa e descartam detalhes antigos. O Claude Code chama isso de compaction, e você mesmo pode acioná-la com /compact. O resumo ajuda, mas alguns detalhes se perdem. O /clear apaga a conversa inteira.
Uma janela maior não resolve
Os modelos atuais têm janelas de centenas de milhares de tokens. Mesmo assim, um contexto mais longo deixa cada turno mais lento e mais caro, e o modelo pode deixar passar detalhes enterrados em um contexto longo. Manter o contexto pequeno e relevante costuma funcionar melhor do que contar com uma janela grande.
Usando bem o contexto
Alguns hábitos mantêm o contexto limpo por mais tempo.
- Comece uma nova conversa quando uma tarefa terminar.
- Desligue os servidores MCP que você não usa.
- Peça ao agente para ler a parte relevante de um arquivo, não o arquivo inteiro.
- Passe pesquisas longas para subagentes, para que só um resumo volte.
Contexto no AgentVera
O AgentVera deixa o contexto visível e oferece várias formas de reduzi-lo.
- O painel do agente mostra o tamanho do contexto ao vivo; rode o /compact à mão ou automaticamente a partir de um limite que você define.
- Perfis de contexto: o Lean reduz a primeira requisição do Claude Code de cerca de 34,4 mil para 13,3 mil tokens.
- As smart tools bloqueiam a releitura de um arquivo que já está no contexto e não mudou, e mostram primeiro a estrutura de arquivos grandes.
- O mapa do projeto permite que os agentes encontrem o código relevante sem ler arquivo após arquivo.
- Economia de tokensPerfis de contexto, saída de comandos mais curta com RTK, tamanho do contexto ao vivo e auto-compact, ativados por padrão para todo agente.
- Mapa do projetoOs agentes encontram os arquivos relevantes, quem os usa e os testes sem ler arquivo por arquivo.
- Ferramentas inteligentesCortam leituras repetidas, execuções completas de testes e comandos repetidos antes que cheguem ao modelo.
Perguntas frequentes
O que acontece quando a janela de contexto enche?
O agente resume a conversa e continua, ou não consegue ir adiante. O Claude Code compacta automaticamente, e alguns detalhes antigos podem se perder no resumo.
A janela de contexto é a mesma coisa que o limite de uso?
Não. A janela de contexto é quanto texto cabe em uma requisição. Os limites de uso definem quanto você pode usar em um período de tempo.
Qual a diferença entre /compact e /clear?
O /compact resume a conversa e continua a partir do resumo. O /clear apaga a conversa e o agente começa do zero.
Uma janela de contexto maior dá resultados melhores?
Nem sempre. Cabe mais texto, mas contexto desnecessário custa mais e pode distrair o modelo.