Otimização de configuração
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
- 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
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
- 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
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
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
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
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:
# 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 committingConfiguraçõ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:
{
"verdent.enableCheckpoints": true
}Prioridade de configuração
Quando as configurações entram em conflito, Verdent aplica esta ordem de prioridade:
- Regras do projeto (AGENTS.md) - Prioridade mais alta (específica do projeto)
- Configurações do espaço de trabalho - configurações no nível do espaço de trabalho do VS Code
- Regras do usuário (VERDENT.md) - Preferências globais do usuário
- Configurações padrão - padrões integrados do Verdent
Personalização específica do projeto
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
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.