---
title: Otimização de configuração
description: 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

<Tabs>
  <Tab title="Skip Permissions (Velocidade)">
    - Autonomia total sem prompts de aprovação
    - Sem interrupções para permissões
    - Maior risco - use apenas em ambientes automatizados
  </Tab>
  <Tab title="Auto-Run (Equilibrado)">
    - 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
  </Tab>
  <Tab title="Manual Accept (Profundidade)">
    - 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
  </Tab>
  <Tab title="Plan (Revisão)">
    - Planejamento estratégico antes da execução
    - Fase de análise somente leitura
    - Revise e aprove antes de qualquer alteração
  </Tab>
</Tabs>

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

<Tabs>
  <Tab title="Crítico para velocidade">
    **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
  </Tab>
  <Tab title="Crítico para profundidade">
    **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
  </Tab>
  <Tab title="Abordagem híbrida">
    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.
  </Tab>
</Tabs>

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

---

## 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:**

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

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

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

### Gerenciamento de contexto para projetos grandes

<Tabs>
  <Tab title="Subagentes">
    - 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
  </Tab>
  <Tab title="Seleção de arquivos">
    - 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
  </Tab>
  <Tab title="Divisão de tarefas">
    - 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
  </Tab>
  <Tab title="Plan Mode">
    - 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
  </Tab>
</Tabs>

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

<Tip>
Ative checkpoints seletivamente apenas para tarefas críticas; o uso excessivo de checkpoints torna os fluxos de trabalho mais lentos sem agregar valor.
</Tip>

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

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

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

---

## Veja também

<CardGroup cols={2}>
  <Card title="Configurações" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    Opções de configuração completas e seleção de modelo
  </Card>
  <Card title="Monitoramento de recursos" icon="chart-line" href="/docs/verdent-for-vscode/resource-management/monitoring">
    Monitore o desempenho e otimize o uso de tokens
  </Card>
</CardGroup>
