# O que é janela de contexto?

URL: https://agentvera.dev/pt/glossary/context-window/

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 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.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/