# Otimização de configuração (/pt/docs/verdent-for-vscode/configuration/tuning)
> Otimizando Verdent para o seu fluxo de trabalho
Otimize Verdent for VS Code para equilibrar velocidade, custo e profundidade de acordo com os requisitos do seu fluxo de trabalho. Configure presets de modelo, modos de execução e estratégias de gerenciamento de contexto para um desempenho ideal.
### Áreas de otimização [#áreas-de-otimização]
* Seleção de preset de modelo para equilibrar custo e desempenho
* Configuração do modo de execução para eficiência do fluxo de trabalho
* Gerenciamento de contexto para bases de código grandes
* Personalização por projeto e por espaço de trabalho
***
## Ajustando configurações para o seu fluxo de trabalho [#ajustando-configurações-para-o-seu-fluxo-de-trabalho]
### Seleção de preset de modelo [#seleção-de-preset-de-modelo]
Escolha o preset de modelo apropriado com base na complexidade da tarefa e no orçamento:
| Preset | Custo | Eficiência de custo | Melhor para |
| -------------------- | ------------------------------- | ------------------------------------------------ | ----------------------------------------------------------- |
| **Efficiency** | \~0,3x Balance (redução de 70%) | 3,2x mais eficiente que o Sonnet | Tarefas simples, correções rápidas, prototipagem ágil |
| **Balance** (Padrão) | 1x base | 1x base | Tarefas de desenvolvimento gerais, codificação do dia a dia |
| **Performance** | 1-2x Balance | 0,5x de eficiência (2x de custo, 1M de contexto) | Decisões arquiteturais complexas, refatoração intrincada |
**Modelos adicionais:**
* **Claude-4.5-sonnet:** Modelo equilibrado de uso geral (1x base)
* **Claude-4.5-sonnet-1m:** Contexto estendido para tarefas complexas (0,5x de eficiência, 2x de custo quando a entrada excede 200k tokens)
* **Claude-4.5-haiku:** O mais rápido e econômico (3,2x mais eficiente que o Sonnet)
* **GPT-5 / GPT-5-codex:** Foco em raciocínio e criatividade (Beta, 1,3x mais eficiente que o Sonnet)
* **Minimax-m2:** Rápido e econômico (Beta, gratuito até 10 de novembro)
### Configuração do modo de execução [#configuração-do-modo-de-execução]
* Autonomia total sem prompts de aprovação
* Sem interrupções para permissões
* Maior risco - use apenas em ambientes automatizados
* Comandos exigem aprovação, operações de arquivo automáticas
* Menos prompts de permissão
* Menor risco, com segurança mantida para operações perigosas
* Toda operação exige aprovação
* Visibilidade e controle completos
* O mais lento, porém o mais seguro - melhor para aprendizado e código de produção
* Planejamento estratégico antes da execução
* Fase de análise somente leitura
* Revise e aprove antes de qualquer alteração
### Think Hard Mode [#think-hard-mode]
Ative para tarefas de raciocínio complexo:
* **Profundidade:** Profundidade máxima de raciocínio para problemas sofisticados
* **Velocidade:** Mais lenta devido ao orçamento estendido de raciocínio
* **Melhor para:** Decisões arquiteturais, depuração complexa, análise intrincada
***
## Compromissos entre velocidade e profundidade [#compromissos-entre-velocidade-e-profundidade]
Equilibre a velocidade de execução com a profundidade da análise de acordo com os requisitos da tarefa.
**Configuração:**
* **Modelo:** preset Efficiency (Claude-4.5-haiku)
* **Modo de permissão:** Auto-Run Mode
* **Modo de execução:** Agent Mode para execução direta
* **Casos de uso:** Correções rápidas, operações de rotina, tarefas simples
**Benefícios:**
* Tempos de resposta mais rápidos
* Interrupções mínimas
* Redução de 70% no custo em relação ao preset Balance
**Configuração:**
* **Modelo:** preset Performance (Claude-4.5-sonnet-1m)
* **Modo de permissão:** Manual Accept Mode
* **Modo de execução:** Plan Mode para revisão estratégica
* **Think Hard:** Ativado para raciocínio sofisticado
* **Casos de uso:** Recursos complexos, código de produção, decisões arquiteturais
**Benefícios:**
* Janela de contexto máxima (1M de tokens)
* Visibilidade e controle completos
* Raciocínio profundo para problemas complexos
* Revisão antes da execução
A maioria dos usuários se beneficia da alternância de contexto entre configurações:
* **Correções rápidas:** Efficiency + Agent Mode
* **Recursos complexos:** Balance/Performance + Plan Mode
* **Exploração:** Plan Mode para estratégia e, em seguida, Agent Mode para execução
**Estratégia:** Adapte a configuração ao tipo de tarefa em vez de usar uma abordagem única para tudo.
Use Auto-Run Mode para projetos confiáveis a fim de reduzir os prompts de permissão, mantendo a segurança para operações perigosas. Isso agiliza o fluxo de trabalho sem sacrificar proteções críticas.
***
## Configuração no nível do espaço de trabalho [#configuração-no-nível-do-espaço-de-trabalho]
Verdent oferece suporte à configuração por projeto e por espaço de trabalho para garantir consistência em toda a equipe.
### Configuração específica do projeto [#configuração-específica-do-projeto]
**Regras do projeto (AGENTS.md):**
* **Localização:** Diretório raiz do projeto ou pasta do espaço de trabalho
* **Escopo:** Aplicado somente ao projeto atual
* **Controle de versão:** Faça commit no git para padrões válidos em toda a equipe
* **Conteúdo:** Padrões de codificação, requisitos de teste, padrões arquiteturais
**Exemplo:**
```markdown filename="AGENTS.md"
# Project Rules
## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern
## Testing
- All endpoints require input validation
- Run tests before committing
```
### Configurações de espaço de trabalho do VS Code [#configurações-de-espaço-de-trabalho-do-vs-code]
Configure as definições da extensão no nível do espaço de trabalho:
**Localização:** `.vscode/settings.json` na raiz do espaço de trabalho
**Exemplo:**
```json filename=".vscode/settings.json"
{
"verdent.enableCheckpoints": true
}
```
### Prioridade de configuração [#prioridade-de-configuração]
Quando as configurações entram em conflito, Verdent aplica esta ordem de prioridade:
1. **Regras do projeto (AGENTS.md)** - Prioridade mais alta (específica do projeto)
2. **Configurações do espaço de trabalho** - configurações no nível do espaço de trabalho do VS Code
3. **Regras do usuário (VERDENT.md)** - Preferências globais do usuário
4. **Configurações padrão** - padrões integrados do Verdent
***
## Personalização específica do projeto [#personalização-específica-do-projeto]
### Gerenciamento de contexto para projetos grandes [#gerenciamento-de-contexto-para-projetos-grandes]
* Delegue operações complexas a subagentes com janelas de contexto separadas
* Apenas os resultados do subagente consomem o contexto principal, não todo o processo
* Evita que o contexto principal se encha de detalhes de implementação
* Adicione explicitamente apenas os arquivos relevantes usando `@filename`
* Evite carregar todo o projeto no contexto desnecessariamente
* Direcione componentes específicos para uma análise focada
* Divida tarefas grandes em partes menores e concluíveis
* Inicie novas sessões para recursos ou componentes distintos
* Pontos de quebra naturais evitam o esgotamento do contexto
* Revise a abordagem antes de consumir o contexto de execução
* Reduz o desperdício de contexto em implementações incorretas
* Plan Mode possui gerenciamento de contexto separado
### Otimização de desempenho [#otimização-de-desempenho]
**Ative checkpoints seletivamente:**
A configuração `verdent.enableCheckpoints` usa o git para controle de versão:
* Pode impactar o desempenho em repositórios muito grandes
* Ative apenas quando a funcionalidade de checkpoint for necessária
* Desative para o máximo desempenho em bases de código grandes
Ative checkpoints seletivamente apenas para tarefas críticas; o uso excessivo de checkpoints torna os fluxos de trabalho mais lentos sem agregar valor.
**Seleção de modelo:**
* Use o preset Efficiency (Haiku) para tarefas simples e isoladas
* Reserve o preset Performance (Sonnet-1M) para operações com muito contexto
* Use o preset Balance para trabalho geral
**Modo de execução:**
* Auto-Run Mode reduz o contexto consumido por prompts de permissão
* Skip Permissions Mode maximiza a eficiência para ambientes automatizados
Cenários com múltiplos espaços de trabalho aplicam automaticamente as regras de projeto apropriadas ao alternar entre espaços de trabalho. Não é necessário trocar a configuração manualmente.
Configurações com múltiplos espaços de trabalho permitem otimizar as definições por tipo de projeto, desenvolvimento vs produção, monorepo vs microsserviços.
***
## Veja também [#veja-também]
Opções de configuração completas e seleção de modelo
Monitore o desempenho e otimize o uso de tokens