# Gerenciamento de contexto (/pt/docs/verdent-for-vscode/best-practices/context)
> Gerencie o contexto de forma eficaz para obter melhores resultados
***
O gerenciamento eficaz de contexto garante que o Verdent tenha as informações certas no momento certo, evitando a degradação de desempenho causada pela sobrecarga de contexto.
### O que você vai aprender [#o-que-você-vai-aprender]
* Entender as janelas de contexto e seus limites
* Selecionar arquivos de forma estratégica para um contexto ideal
* Reconhecer a sobrecarga de contexto e reagir a ela
* Quando reiniciar o contexto para obter melhor desempenho
* Como a organização do espaço de trabalho afeta o contexto
***
## Entendendo as janelas de contexto [#entendendo-as-janelas-de-contexto]
O tamanho da janela de contexto do Verdent for VS Code depende do modelo utilizado.
A maioria dos modelos usa janelas de contexto padrão de `200K`:
* **Claude 4.5 Sonnet** — Equilibrado para tarefas complexas
* **Claude 4.5 Haiku** — Rápido e eficiente
* **GPT-5** — Excelente para raciocínio (Beta)
* **GPT-5-Codex** — Otimizado para programação (Beta)
**Capacidade:**
* \~`200,000` tokens de capacidade total de memória
* Suficiente para a maioria das tarefas de desenvolvimento e projetos de tamanho médio
**O que está incluído:**
* Todas as mensagens da conversa
* Conteúdos de arquivos carregados no contexto
* Saídas e respostas de ferramentas
* Prompts e instruções do sistema
* Definições de servidor MCP
**Desempenho:**
* Degrada significativamente ao se aproximar dos limites
* Fique atento aos sinais de sobrecarga de contexto (respostas mais lentas, saídas menos precisas)
* Reinicie o contexto com mais frequência para obter desempenho ideal
O Claude Sonnet 4.5 oferece contexto estendido (`1M` tokens) quando selecionado explicitamente ou quando a entrada excede `200K` tokens.
**Capacidade:**
* `1,000,000` tokens de memória total
* 5x maior que os modelos padrão
**Benefícios:**
* Perfeito para carregar bases de código grandes inteiras sem fragmentação
* Elimina a maioria das preocupações com gerenciamento de contexto em projetos grandes
* Trabalhe por mais tempo antes de atingir os limites de contexto
* Menos reinícios de sessão necessários
**Quando usar:**
* Bases de código grandes com `1000+` arquivos
* Refatoração complexa de múltiplos arquivos em projetos inteiros
* Sessões longas de desenvolvimento abrangendo várias tarefas relacionadas
* Quando você deseja minimizar a sobrecarga de gerenciamento de contexto
***
## Seleção estratégica de arquivos [#seleção-estratégica-de-arquivos]
Seja estratégico na seleção de arquivos para otimizar o uso do contexto e evitar atingir os limites.
Comece com menos arquivos e adicione mais apenas quando necessário; o Verdent sempre pode ler arquivos adicionais durante a conversa.
### Use menções com @ para inclusão explícita [#use-menções-com--para-inclusão-explícita]
```
@filename.js
```
O Verdent carrega arquivos relacionados automaticamente, mas `@-mentions` garante um contexto exato. Seja seletivo — inclua apenas arquivos diretamente relevantes para a tarefa atual.
### Monitore o uso do contexto [#monitore-o-uso-do-contexto]
* Fique atento à degradação de desempenho à medida que as sessões ficam mais longas
* Esteja ciente do tamanho da conversa e da quantidade de arquivos
* Remova arquivos desnecessários do contexto sempre que possível
### Evite a sobrecarga de contexto [#evite-a-sobrecarga-de-contexto]
* Divida tarefas grandes em partes menores com menos arquivos por tarefa
* Concentre-se apenas em arquivos relacionados — não carregue toda a base de código de uma vez
* Use o gerenciamento de servidores MCP para desativar integrações não utilizadas
### Boas práticas [#boas-práticas]
* Inclua apenas arquivos que precisam ser modificados ou referenciados
* Faça referência a padrões existentes em vez de carregar arquivos de exemplo
* Para bases de código grandes, trabalhe em um módulo de cada vez
* Use a documentação do projeto (`AGENTS.md`) em vez de carregar muitos arquivos
* Evite o último quinto da janela de contexto em tarefas que exigem muita memória
### Para contexto estendido (1M tokens) [#para-contexto-estendido-1m-tokens]
A seleção de arquivos se torna muito menos crítica — você muitas vezes consegue carregar repositórios de projeto inteiros sem atingir os limites.
***
## Reconhecendo a sobrecarga de contexto [#reconhecendo-a-sobrecarga-de-contexto]
**Sinais:**
* Respostas menos precisas ou incompletas
* Detalhes importantes do início da conversa estão faltando
* Dificuldade em manter a consistência ao longo de sessões longas
* Confusão sobre mudanças recentes ou contexto
**Exemplos concretos:**
* Sugere soluções que você já rejeitou anteriormente na sessão
* Ignora convenções de código que você estabeleceu `20` mensagens atrás
* Gera código que entra em conflito com mudanças feitas anteriormente na conversa
* Propõe implementações que não correspondem à arquitetura do seu projeto discutida anteriormente
**Sinal principal:** as respostas do Verdent ficam menos precisas ou inconsistentes
**Sinais:**
* Tempos de resposta visivelmente mais lentos
* Atrasos maiores no processamento antes do início das respostas
* Aumento da latência entre mensagens
**Exemplos concretos:**
* Respostas que normalmente levam `5-10` segundos agora levam `30+` segundos
* Atraso visível antes de o indicador de digitação aparecer depois de você enviar uma mensagem
* As respostas em streaming começam muito mais devagar que o habitual
* A execução de ferramentas (leitura de arquivos, buscas) leva visivelmente mais tempo
**Sinal principal:** as respostas levam significativamente mais tempo que o habitual
**Sinais:**
* Pedidos para esclarecer informações já fornecidas
* Esquecimento de padrões ou convenções estabelecidos anteriormente
* Incapacidade de referenciar arquivos ou código discutidos anteriormente
* Perguntas redundantes sobre a estrutura do projeto
**Exemplos concretos:**
* Pergunta "Qual framework você está usando?" quando você especificou React `30` mensagens atrás
* Solicita caminhos de arquivo que você já `@-mentioned` várias vezes
* Não lembra a convenção de nomenclatura que você estabeleceu no início da sessão
* Reexplica conceitos ou abordagens que você já rejeitou com justificativas
**Sinal principal:** o Verdent pergunta sobre coisas já discutidas
**Sinais:**
* Aproximação do último quinto do limite de `200K` tokens (\~`160K+` tokens usados)
* Conversas longas com muitas leituras de arquivos e saídas de ferramentas
* Vários servidores MCP ativados com definições de ferramentas pesadas
* Arquivos grandes carregados no contexto repetidamente
**Exemplos concretos:**
* A sessão está em andamento há `2+` horas com `100+` mensagens
* Você carregou `20+` arquivos com `@-mentions` ao longo da conversa
* Vários arquivos grandes (`>1000` linhas cada) estão no contexto
* Você tem `5+` servidores MCP ativados com definições de ferramentas extensas
* A conversa inclui muitos resultados de grep/busca e leituras de arquivos
**Sinal principal:** sessões muito longas com uso extenso de arquivos/ferramentas
**Quando agir:** a degradação de desempenho é seu principal sinal. Se as respostas do Verdent ficarem menos precisas, mais lentas ou inconsistentes, inicie uma nova sessão ou use estratégias de gerenciamento de contexto.
Se as respostas do Verdent ficarem vagas ou repetitivas, pode estar ocorrendo sobrecarga de contexto. Reinicie a conversa para restaurar o desempenho completo.
**Observação:** com o contexto de `1M` tokens (Claude Sonnet 4.5), esses problemas são muito menos comuns.
***
## Quando reiniciar o contexto [#quando-reiniciar-o-contexto]
* Tempos de resposta visivelmente mais lentos
* Respostas menos precisas ou inconsistentes
* O Verdent esquecendo contexto ou padrões anteriores
* Aproximação dos limites da janela de contexto (fique atento aos sinais de degradação)
**Ação:** inicie uma nova sessão quando a qualidade cair
* Alternância entre recursos ou módulos não relacionados
* Conclusão de uma tarefa e mudança para a próxima
* Após tarefas que exigem muita memória (grandes refatorações, trabalho arquitetural)
* Mudança da fase de pesquisa para a fase de implementação
**Ação:** nova sessão para cada nova tarefa importante
* Após enviar recursos concluídos ao controle de versão
* Entre pontos de verificação lógicos no fluxo de trabalho de desenvolvimento
* Após ciclos de teste-verificação-commit
**Ação:** commit → teste → nova sessão
* Antes de iniciar grandes recursos novos
* Quando o histórico da conversa fica muito longo
* Após concluir alterações em vários arquivos
* Entre diferentes tipos de trabalho (depuração → desenvolvimento de recursos)
**Ação:** inicie uma nova sessão proativamente antes que o contexto se degrade
**Fluxo de trabalho recomendado:** conclua uma unidade atômica de trabalho → teste → commit → limpe o contexto → comece do zero para a próxima tarefa.
**Observação:** inicie uma nova sessão para reiniciar o contexto. Para contextos de `1M` tokens, a limpeza é necessária com muito menos frequência.
***
## Impacto da organização do espaço de trabalho [#impacto-da-organização-do-espaço-de-trabalho]
A organização do espaço de trabalho afeta diretamente a eficiência com que o contexto é utilizado e a facilidade com que o Verdent consegue navegar pela sua base de código.
**Arquivos menores e focados:**
* Muitos arquivos pequenos consomem o contexto de forma mais eficiente do que poucos arquivos grandes
* É mais fácil carregar apenas os módulos relevantes
* Melhor controle granular sobre o que está no contexto
* Reduz a necessidade de carregar arquivos grandes inteiros
**Estrutura de diretórios clara:**
* A organização lógica ajuda o Verdent a localizar arquivos relacionados
* A organização baseada em recursos ou módulos melhora o direcionamento do contexto
* Reduz a necessidade de carregar código não relacionado
**`Documentation in AGENTS.md:`**
* A documentação do projeto substitui a necessidade de carregar muitos arquivos de exemplo
* Padrões arquiteturais descritos uma vez e referenciados repetidamente
* Padrões de código documentados de forma centralizada
* Reduz a sobrecarga de contexto causada por leituras exploratórias de arquivos
**Benefícios:**
* Trabalhe em módulos isolados sem carregar toda a base de código
* Limites claros permitem sessões focadas
* A divisão do trabalho se torna natural ao longo dos limites dos módulos
**Problemas:**
* Arquivos monolíticos forçam o carregamento de contextos grandes inteiros
* Uma estrutura pouco clara exige carregar muitos arquivos para entender a arquitetura
* Preocupações misturadas nos mesmos arquivos desperdiçam contexto com código irrelevante
**Impacto:**
* Problemas frequentes de limite de contexto
* Tokens desperdiçados com código irrelevante
* Dificuldade em isolar o trabalho em módulos específicos
* Necessidade mais frequente de reiniciar sessões
**Antipadrões comuns:**
* Arquivos únicos de `5000+` linhas com várias preocupações
* Estrutura de diretórios plana com `100+` arquivos na raiz
* Nenhuma separação clara entre recursos/módulos
* Falta de documentação centralizada
**Abordagens de refatoração:**
* Divida arquivos grandes em módulos menores e focados
* Organize por recurso ou domínio (não por tipo de arquivo)
* Crie uma hierarquia de diretórios clara
* Extraia código compartilhado para módulos separados
**Documentação:**
* Crie `AGENTS.md` com padrões arquiteturais
* Documente os padrões de código de forma centralizada
* Mantenha arquivos `README` por módulo
* Mantenha as decisões de design documentadas
**Impacto no contexto:** para contextos padrão de `200K` tokens, espaços de trabalho organizados fazem a diferença entre atingir os limites com frequência ou raramente. Para contextos de `1M` tokens, a organização importa menos, mas ainda melhora a eficiência.
***
## Estratégias de otimização de contexto [#estratégias-de-otimização-de-contexto]
A otimização eficaz do contexto combina monitoramento, planejamento estratégico e configuração técnica.
**Fique atento aos sinais de desempenho:**
* Monitore a qualidade e a velocidade das respostas ao longo das sessões
* Note quando as respostas ficam mais lentas ou menos precisas
* Acompanhe manualmente o tamanho da conversa e a quantidade de arquivos
* Seja proativo ao iniciar novas sessões
**O que monitorar:**
* Precisão e consistência das respostas
* Tempo até a primeira resposta (atraso do indicador de digitação)
* Tempo total de conclusão da resposta
* Memória de detalhes anteriores da conversa
**Gerenciamento de subagentes:**
* Desative subagentes personalizados não utilizados quando não forem necessários
* Cada subagente ativado adiciona definições à sobrecarga do sistema
* Mantenha ativados apenas os subagentes em uso ativo
* Reative-os conforme necessário para tarefas específicas
**Limite de ação:** quando você notar `2-3` sinais de degradação, é hora de iniciar uma nova sessão.
Monitore a qualidade das respostas como um indicador antecipado da saúde do contexto; respostas degradadas indicam que é hora de reiniciar.
**Abordagem de divisão:**
* Divida tarefas grandes em partes menores
* Conclua trabalhos relacionados em sessões focadas
* Evite misturar diferentes tipos de tarefa em conversas longas
* Evite o último quinto da janela de contexto em trabalhos que exigem muita memória
**Gerenciamento de sessões:**
* Inicie novas sessões entre tarefas importantes
* Limpe o contexto após commits: teste → verifique → commit → nova sessão
* Use tarefas para o planejamento de várias etapas
* Trabalhe nos itens de tarefa em sessões focadas separadas
**Padrão de boa prática:**
1. Planeje a tarefa no Plan Mode
2. Execute a implementação focada em uma nova sessão
3. Teste e verifique as alterações
4. Faça commit no controle de versão
5. Inicie uma nova sessão para a próxima tarefa
**Isolamento de tarefas:** mantenha a depuração separada do desenvolvimento de recursos e a pesquisa separada da implementação.
**Inclusão estratégica:**
* Use `@-mentions` para inclusão explícita de arquivos apenas quando necessário
* Aproveite a documentação `AGENTS.md` em vez de carregar muitos arquivos
* Trabalhe em um módulo de cada vez em projetos grandes
* Divida arquivos grandes em componentes menores e focados
**Princípios de seleção de arquivos:**
* Inclua apenas arquivos que precisam de modificação ou referência direta
* Prefira a documentação ao carregamento de arquivos de exemplo
* Remova arquivos do contexto quando não forem mais necessários
* Carregue arquivos sob demanda, e não preventivamente
**Tratamento de arquivos grandes:**
* Considere dividir arquivos com mais de `500` linhas
* Extraia utilitários e auxiliares para arquivos separados
* Use limites de módulo claros
* Documente as relações entre arquivos em `AGENTS.md`
**Fluxo de trabalho de otimização:**
Monitore o desempenho → identifique o inchaço da sessão → desative subagentes não utilizados → inicie novas sessões proativamente → concentre-se na qualidade da tarefa
**Prática diária:**
* Inicie cada recurso importante com um contexto novo
* Faça commits com frequência e reinicie entre os commits
* Mantenha as sessões focadas em objetivos únicos
* Revise o uso do contexto em pontos de pausa naturais
**`For Extended Context (1M tokens):`** Com a janela de contexto maior do Claude Sonnet 4.5, a otimização se torna menos crítica — concentre-se na qualidade da tarefa em vez do gerenciamento agressivo de contexto. Ainda assim, boas práticas continuam melhorando a eficiência e a organização.
***
## Perguntas frequentes [#perguntas-frequentes]
Os modelos padrão (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) têm janelas de contexto de `200K` tokens, suficientes para a maioria das tarefas. O Claude Sonnet 4.5 oferece contexto estendido de `1M` tokens (5x maior) para bases de código grandes com `1000+` arquivos, refatoração complexa de múltiplos arquivos ou sessões longas de desenvolvimento. O contexto de `1M` é ativado automaticamente quando a entrada excede `200K` tokens ou pode ser selecionado explicitamente.
Você precisa iniciar manualmente uma nova sessão para reiniciar o contexto — o Verdent não limpa o contexto automaticamente. Boa prática: reinicie após concluir uma unidade atômica de trabalho, testar e fazer commit no controle de versão. Para contextos de `1M` tokens, os reinícios são necessários com muito menos frequência.
Não há um limite fixo de arquivos — depende do tamanho dos arquivos e da contagem total de tokens. Para contextos de `200K`, evite carregar `20+` arquivos grandes (`>1000` linhas cada). Concentre-se em arquivos diretamente relevantes para a tarefa atual. Use `@-mentions` de forma seletiva e aproveite a documentação `AGENTS.md` em vez de carregar muitos arquivos de exemplo. Com o contexto de `1M`, a seleção de arquivos se torna muito menos crítica.
Tudo na sua sessão: todas as mensagens da conversa, conteúdos de arquivos carregados no contexto, saídas de ferramentas (resultados de grep/busca, leituras de arquivos), prompts e instruções do sistema e definições de servidor MCP. Cada um deles consome tokens da sua capacidade total de contexto.
Não — reiniciar o contexto apenas limpa o histórico da conversa e os arquivos carregados na memória. Suas alterações de código reais, commits e modificações de arquivo são preservados. Sempre faça commit do seu trabalho no controle de versão antes de reiniciar o contexto, por segurança. Reinicie → inicie uma nova sessão → continue trabalhando na próxima tarefa.
***
## Veja também [#veja-também]
Boas práticas para escrever prompts eficazes
Entenda os modos de execução e suas implicações de recursos
Monitore o uso de tokens, créditos e desempenho