# Configuração e personalização (/pt/docs/verdent-for-vscode/configuration/settings)
> Personalizando o Verdent para se adequar ao seu fluxo de trabalho
Verdent for VS Code oferece amplas opções de configuração para se adaptar ao seu fluxo de trabalho de desenvolvimento, às suas preferências de programação e aos padrões da sua equipe. Configure as opções por meio da interface de configurações nativa do VS Code, personalize atalhos de teclado e crie regras e subagentes para comportamentos especializados.
### O que você vai aprender [#o-que-você-vai-aprender]
* Configurar as opções da extensão VS Code para o Verdent
* Personalizar atalhos de teclado para um fluxo de trabalho eficiente
* Criar e gerenciar regras para um comportamento personalizado do agente
* Construir subagentes personalizados para tarefas especializadas
### Pré-requisitos [#pré-requisitos]
* Verdent for VS Code instalado e autenticado
* Acesso às configurações do VS Code (`Cmd+,` ou `Ctrl+,`)
* Compreensão básica de JSON para arquivos de regras (opcional)
***
## Configurações da extensão VS Code [#configurações-da-extensão-vs-code]
As configurações do Verdent for VS Code são acessadas em vários locais, dependendo do tipo e do escopo da configuração.
### Acessando as configurações [#acessando-as-configurações]
**Configurações da extensão (VS Code nativo):**
1. Abra as configurações do VS Code: `Cmd+,` (macOS) ou `Ctrl+,` (Windows/Linux)
2. Pesquise por "Verdent" na barra de busca de configurações
3. Modifique as configurações da extensão (por exemplo, `verdent.enableCheckpoints`)
**Configurações específicas do Verdent:**
Clique no botão **Settings** na barra superior do Verdent para acessar:
* **Rules** - User Rules, Project Rules, Plan Rules
* **Servidores MCP** - Configurações do Model Context Protocol
* **Subagents** - Gerenciamento de subagentes personalizados
**Controles no chat:**
Muitas configurações podem ser alternadas diretamente na Input Box, na parte inferior do painel do Verdent:
* **Switch Permission** - Manual Accept, Auto-Run, Plan, Skip Permissions
* **Switch Mode** - modos Agent, Plan, Chat
* **Switch/Customize AI Model** - presets Performance, Balance, Efficiency
* **Think Hard Mode** - orçamento máximo de raciocínio para análises complexas
* **Add Context** - anexe arquivos usando @-menções
* **Add Images or Files** - inclua capturas de tela ou documentos
* **Add Subagent** - delegue a subagentes especializados
As alterações nas configurações têm efeito imediato, sem necessidade de reiniciar o VS Code.
***
## Referência das configurações disponíveis da extensão [#referência-das-configurações-disponíveis-da-extensão]
Verdent for VS Code fornece **2 configurações principais de extensão** que podem ser definidas pela interface de configurações do VS Code:
| Configuração | Tipo | Padrão | Descrição |
| --------------------------- | --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `verdent.enableCheckpoints` | `boolean` | `true` | Permite que a extensão salve checkpoints do espaço de trabalho ao longo das tarefas usando git. Pode afetar o desempenho em espaços de trabalho grandes. |
| `verdent.enableProxy` | `boolean` | `true` | Habilita o suporte a proxy para conexões de rede. Necessário para usuários atrás de firewalls corporativos ou servidores proxy. |
Estas são as configurações completas da extensão VS Code para o Verdent. Opções de configuração adicionais (Rules, Subagents, servidores MCP) são gerenciadas pelo menu Settings do Verdent na barra superior da extensão.
***
## Referência dos controles da Input Box [#referência-dos-controles-da-input-box]
A Input Box, na parte inferior do painel do Verdent, oferece acesso rápido aos controles de configuração:
| Controle | Finalidade | Opções |
| ----------------------------- | -------------------------------------- | --------------------------------------------------------------------- |
| **Add Context** | Anexar arquivos usando @-menções | @filename, @foldername |
| **Add Images or Files** | Incluir capturas de tela ou documentos | Enviar imagens, PDFs, arquivos de texto |
| **Add Subagent** | Delegar a agentes especializados | @Verifier, @Explorer, @Code-reviewer, subagentes personalizados |
| **Switch Mode** | Alternar o modo de execução | Agent Mode, Plan Mode, Chat Mode |
| **Switch/Customize AI Model** | Selecionar preset ou modelo específico | Performance (custo 1-2x), Balance (custo 1x), Efficiency (custo 0,3x) |
| **Think Hard Mode** | Habilitar raciocínio estendido | Ativar/desativar para problemas complexos |
| **Switch Permission** | Alterar o nível de permissão | Manual Accept (padrão), Auto-Run, Plan, Skip Permissions |
### Modos de permissão [#modos-de-permissão]
* Toda operação requer aprovação
* Visibilidade e controle completos
* Ideal para aprendizado, bases de código desconhecidas, código de produção
* Comandos requerem aprovação, operações de arquivo são automáticas
* Menos solicitações de permissão
* Ideal para projetos confiáveis, prototipagem rápida
* Análise e planejamento somente leitura
* Nenhuma modificação de código durante o planejamento
* Ideal para mudanças complexas, decisões arquiteturais
* Autonomia total sem solicitações de aprovação
* Execução mais rápida, mas com maior risco
* Ideal para ambientes automatizados, CI/CD
### Presets de modelo [#presets-de-modelo]
* **Custo:** 1x da base
* **Modelos:** Claude-4.5-sonnet
* **Ideal para:** desenvolvimento geral, programação do dia a dia, implementação de funcionalidades
* **Custo:** 1-2x da base do Balance
* **Modelos:** Claude-4.5-sonnet-1m (contexto de 1M de tokens)
* **Ideal para:** arquitetura complexa, bases de código grandes, tarefas que excedem 200k tokens
* **Custo:** 3,2x mais eficiente que o Sonnet (economia de 70% em créditos)
* **Modelos:** Claude-4.5-haiku
* **Ideal para:** correções rápidas, tarefas simples, operações rotineiras
***
## Personalização de atalhos de teclado [#personalização-de-atalhos-de-teclado]
### Atalhos padrão [#atalhos-padrão]
**Atalho principal:**
* **macOS:** `Cmd+L` - abre/foca o painel do Verdent
* **Windows/Linux:** `Ctrl+L` - abre/foca o painel do Verdent
* Comando: `verdent.addToChat`
* Funciona a partir da Command Palette e do contexto do editor
Este é o atalho essencial para acessar o Verdent rapidamente de qualquer lugar no VS Code sem interromper seu fluxo de programação.
**Comandos adicionais:**
Disponíveis pela Command Palette (os atalhos padrão podem ser personalizados):
* `verdent.addFeedBack` - enviar feedback
* `verdent.addTerminalOutputToChat` - adicionar a saída do terminal ao Verdent
* `verdent.addToChatBySearch` - adicionar ao Verdent por busca
* `verdent.centerButtonClicked` - User Center
* `verdent.historyButtonClicked` - Project History
* `verdent.mcpButtonClicked` - adicionar servidor MCP
* `verdent.openInNewTabByParams` - abrir em nova aba
* `verdent.plusButtonClicked` - nova sessão
* `verdent.rulesButtonClicked` - configurações de Rules
* `verdent.SettingClicked` - menu de configurações
* `verdent.subagentButtonClicked` - adicionar subagente
### Personalizando atalhos [#personalizando-atalhos]
Todos os atalhos de teclado do Verdent podem ser personalizados usando o sistema padrão de keybindings do VS Code.
Recomendado para a maioria dos usuários - interface visual para gerenciar atalhos.
Pressione `Cmd+K Cmd+S` (macOS) ou `Ctrl+K Ctrl+S` (Windows/Linux)
Digite "Verdent" na caixa de busca para filtrar os comandos do Verdent
Clique no ícone de lápis ao lado de qualquer comando, pressione a combinação de teclas desejada e pressione Enter para salvar
Para usuários avançados - configuração direta em JSON, compatível com controle de versão.
Pressione `Cmd+Shift+P` (macOS) ou `Ctrl+Shift+P` (Windows/Linux)
Digite "Preferences: Open Keyboard Shortcuts (JSON)" e selecione a opção
```json macOS
{
"key": "cmd+shift+v",
"command": "verdent.addToChat"
}
```
```json Windows/Linux
{
"key": "ctrl+shift+v",
"command": "verdent.addToChat"
}
```
**Escopo da personalização:**
* Todos os comandos do Verdent podem ser remapeados
* Vários atalhos podem ser atribuídos ao mesmo comando
* Os atalhos padrão podem ser removidos
* As alterações são sincronizadas entre máquinas com o Settings Sync do VS Code
### Atalhos específicos por plataforma [#atalhos-específicos-por-plataforma]
Verdent segue as convenções de teclado específicas de cada plataforma do VS Code:
| Plataforma | Padrão de tecla modificadora |
| ----------------- | -------------------------------------------------------- |
| **macOS** | `Cmd` para atalhos primários, `Option` para alternativos |
| **Windows/Linux** | `Ctrl` para atalhos primários, `Alt` para alternativos |
**Padrões comuns:**
* Configurações: `Cmd+,` (macOS) vs `Ctrl+,` (Windows/Linux)
* Command Palette: `Cmd+Shift+P` (macOS) vs `Ctrl+Shift+P` (Windows/Linux)
* Atalhos de teclado: `Cmd+K Cmd+S` (macOS) vs `Ctrl+K Ctrl+S` (Windows/Linux)
***
## Instruções personalizadas e personas [#instruções-personalizadas-e-personas]
Verdent for VS Code oferece dois sistemas para personalizar o comportamento da IA: **Rules** para preferências e diretrizes, e **Subagents** para personas de tarefas especializadas.
### Sistema de Rules [#sistema-de-rules]
As Rules definem como o Verdent se comporta e responde durante as sessões de programação. As Rules são armazenadas em arquivos Markdown e aplicadas continuamente ao longo das conversas.
#### Três tipos de Rules [#três-tipos-de-rules]
**1. User Rules (VERDENT.md):**
* **Local:** `~/.verdent/` (diretório de configuração global)
* **Escopo:** aplicado a todas as conversas em todos os projetos
* **Finalidade:** preferências pessoais de programação, estilo de comunicação, padrões de documentação
**2. Project Rules (AGENTS.md):**
* **Local:** diretório raiz do projeto ou espaço de trabalho
* **Escopo:** aplicado apenas ao projeto atual
* **Controle de versão:** pode ser commitado no git para padrões válidos em toda a equipe
* **Finalidade:** padrões de programação específicos do projeto, padrões arquiteturais, requisitos de testes
**3. Plan Rules (plan\_rules.md):**
* **Local:** `~/.verdent/` (diretório de configuração global)
* **Escopo:** aplicado ao usar o Plan Mode em todos os projetos
* **Finalidade:** personalizar o conteúdo, o formato e o nível de detalhe do plano
#### Criando e editando Rules [#criando-e-editando-rules]
Clique no botão **Settings** na barra superior do Verdent e selecione **Rules** no menu suspenso
Selecione **User Rules**, **Project Rules** ou **Plan Rules** de acordo com suas necessidades
Os arquivos de Rules abrem no editor do VS Code. Use a formatação Markdown para escrever instruções claras e diretivas
Salve o arquivo. As Rules são aplicadas imediatamente nas sessões atuais e futuras - sem necessidade de reiniciar
**Exemplo de User Rules:**
```markdown
# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing code
```
**Exemplo de Project Rules:**
```markdown
## Testing instructions
- Run `pnpm turbo run test --filter ` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes
## PR instructions
- Title format: []
- Always run `pnpm lint` and `pnpm test` before committing
```
#### Armazenamento e aplicação de Rules [#armazenamento-e-aplicação-de-rules]
| Tipo de Rule | Local | Escopo | Controle de versão |
| ------------- | -------------------------- | ----------------------------- | ---------------------------------------------- |
| User Rules | `~/.verdent/VERDENT.md` | Todos os projetos | Pessoal, não compartilhado |
| Project Rules | `<project>/AGENTS.md` | Projeto atual | Pode ser commitado para consistência da equipe |
| Plan Rules | `~/.verdent/plan_rules.md` | Todos os projetos (Plan Mode) | Pessoal, não compartilhado |
**Prioridade de configuração:**
Quando as regras entram em conflito, o Verdent aplica esta ordem de prioridade:
1. **Project Rules (AGENTS.md)** - prioridade máxima (específica do projeto)
2. **User Rules (VERDENT.md)** - preferências globais do usuário
3. **Comportamento padrão** - padrões internos do Verdent
<Tip>
Faça commit do AGENTS.md no controle de versão para compartilhar padrões de programação específicos do projeto com toda a sua equipe. O espaço de trabalho de cada membro da equipe segue automaticamente as regras do projeto, mantendo as preferências individuais por meio do VERDENT.md.
</Tip>
***
## Subagents [#subagents]
Subagents são agentes de IA especializados com prompts de sistema personalizados e janelas de contexto isoladas para lidar com tarefas específicas.
### Subagents integrados [#subagents-integrados]
Verdent inclui três subagentes padrão disponíveis imediatamente, sem configuração:
<Tabs>
<Tab title="@Verifier">
* Verificações e validações rápidas de código
* Validação ágil sem revisão completa
* Use para: verificações rápidas de sanidade, validação de sintaxe, checagens pré-commit
</Tab>
<Tab title="@Explorer">
* Exploração e navegação rápidas pela base de código
* Encontra arquivos e responde perguntas sobre a base de código rapidamente
* Use para: explorar bases de código desconhecidas, encontrar componentes, entender a estrutura
</Tab>
<Tab title="@Code-reviewer">
* Avaliação instantânea da qualidade do código
* Identifica problemas de segurança, manutenibilidade e desempenho
* Use para: revisões pré-commit, auditorias de segurança, otimização de desempenho
</Tab>
</Tabs>
### Criando subagents personalizados [#criando-subagents-personalizados]
<Steps>
<Step title="Acesse as configurações de Subagent">
Clique em **Settings** → **Subagents** na barra superior do Verdent
</Step>
<Step title="Crie um novo subagente">
Crie um novo subagente ou navegue até `~/.verdent/subagents/` e crie um arquivo markdown com frontmatter YAML
</Step>
<Step title="Defina o comportamento do subagente">
Escreva um prompt de sistema que estabeleça a personalidade do subagente, o estilo de interpretação e a abordagem para as tarefas
</Step>
<Step title="Especifique a política de invocação">
Defina quando o subagente deve ser usado (invocação estrita ou flexível)
</Step>
</Steps>
**Formato do arquivo de Subagent:**
```markdown
---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt
You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues
Invocation policy (strict): Only run security-reviewer if user explicitly requests it.
When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment
When NOT to use:
- General code review without security focus
- Opening or reading files without analysis
```
### Gerenciando subagents [#gerenciando-subagents]
Acesse por meio de **Settings → Subagents** para:
* **Edit:** modificar prompts de sistema, permissões de ferramentas, configurações
* **Copy:** duplicar subagentes para variações ou modelos
* **Delete:** remover subagentes não utilizados
* **Enable/Disable:** alternar a disponibilidade sem excluir
### Usando subagents [#usando-subagents]
**Subagents integrados:**
* Referencie com @-menções: `@Verifier`, `@Explorer`, `@Code-reviewer`
* Invocados automaticamente quando os tipos de tarefa adequados são detectados
**Subagents personalizados:**
* Clique no botão **Add Subagent** na Input Box
* Selecione no menu suspenso
* O agente principal delega automaticamente as tarefas adequadas
### Subagent vs Rules [#subagent-vs-rules]
| Aspecto | Rules | Subagents |
| ------------------- | ------------------------------------------ | ---------------------------------------------- |
| **Quando aplicado** | Continuamente, a cada resposta | Sob demanda para tarefas específicas |
| **Contexto** | Janela de contexto principal compartilhada | Contexto isolado e separado |
| **Comportamento** | Preferências e diretrizes | Personas comportamentais específicas de tarefa |
| **Invocação** | Sempre ativo | Delegação automática ou manual |
| **Finalidade** | Definir O QUE você prefere | Definir QUEM lida com as tarefas e COMO |
**Exemplo de fluxo de trabalho:**
1. **User Rule:** "Gerar testes unitários para todas as novas funções"
2. **Agente principal:** detecta a necessidade de geração de testes
3. **Delega ao subagente Test Generator:** abordagem especializada e abrangente de testes
4. **Subagente:** gera uma suíte de testes completa com contexto isolado
5. **Agente principal:** recebe os resultados e continua sem poluição de contexto
<Tip>
Compartilhe subagents com os membros da equipe usando o botão **Copy** em Settings → Subagents, ou compartilhando os arquivos markdown dos subagentes diretamente de `~/.verdent/subagents/`.
</Tip>
***
## Perguntas frequentes (FAQs) [#perguntas-frequentes-faqs]
<Accordion title="Quando as alterações de configuração entram em vigor?">
A maioria das configurações do Verdent é aplicada imediatamente, sem necessidade de reinicialização:
* **Modos de permissão:** alterne instantaneamente pela Input Box
* **Presets de modelo:** aplicados à próxima solicitação
* **Arquivos de Rules:** aplicados a novas conversas (salvar dispara o recarregamento)
* **Subagents:** disponíveis imediatamente após a criação
* **Atalhos de teclado:** aplicados após salvar no VS Code
**Exceção:** as configurações da extensão VS Code (como `verdent.enableCheckpoints`) entram em vigor imediatamente, mas podem exigir a reabertura de arquivos ou sessões para aplicação completa.
</Accordion>
<Accordion title="Qual é a diferença entre Rules e Subagents?">
**Rules** definem O QUE você prefere globalmente:
* Aplicação contínua a todas as conversas
* Padrões de programação, estilo de comunicação, preferências
* Armazenadas em arquivos markdown (VERDENT.md, AGENTS.md, plan\_rules.md)
* Sempre ativas em segundo plano
**Subagents** definem QUEM lida com tarefas específicas e COMO:
* Invocação sob demanda para tipos de tarefa específicos
* Personas comportamentais especializadas com prompts de sistema personalizados
* Janelas de contexto isoladas (não poluem o contexto principal)
* Delegados automaticamente ou manualmente via @-menções
**Exemplo:** uma regra diz "Gerar testes unitários para novas funções". Um subagente Test Generator lida com a criação real dos testes com uma metodologia abrangente de testes.
</Accordion>
<Accordion title="Posso usar vários modos de permissão ao mesmo tempo?">
Não, os modos de permissão são mutuamente exclusivos - você só pode usar UM por vez:
* **Manual Accept** - padrão, controle máximo
* **Auto-Run** - simplificado para projetos confiáveis
* **Plan** - modo de planejamento somente leitura
* **Skip Permissions** - autonomia total
Você pode alternar entre os modos instantaneamente pelo botão **Switch Permission** na Input Box. A maioria dos usuários alterna entre os modos conforme o contexto da tarefa (por exemplo, Plan Mode para funcionalidades complexas, Auto-Run para correções rápidas).
</Accordion>
<Accordion title="Como escolho o preset de modelo certo para minha tarefa?">
Combine o preset de modelo com a complexidade da tarefa e o orçamento:
**Use Efficiency (3,2x mais eficiente que o Sonnet):**
* Correções rápidas de bugs e geração simples de código
* Operações rotineiras e tarefas de alta frequência
* Quando a velocidade importa mais que a profundidade
**Use Balance (1x da base) - padrão:**
* Desenvolvimento geral e programação do dia a dia
* Implementação de funcionalidades e revisões de código
* Desempenho equilibrado para a maioria dos cenários
**Use Performance (0,5x de eficiência, custo 2x):**
* Decisões arquiteturais complexas
* Bases de código grandes que exigem amplo contexto (200k+ tokens)
* Depuração e refatoração sofisticadas
**Dica profissional:** a maioria dos usuários mantém o Balance como padrão e muda para Performance apenas ao atingir limites de contexto ou precisar de raciocínio profundo.
</Accordion>
***
## Veja também [#veja-também]
<CardGroup cols="2">
<Card title="Fluxos de trabalho plan-first" icon="sitemap" href="/docs/verdent-for-vscode/configuration/plan-workflows">
Configure o planejamento de tarefas assistido por IA e os fluxos de trabalho de aprovação
</Card>
<Card title="Otimização de configuração" icon="sliders" href="/docs/verdent-for-vscode/configuration/tuning">
Ajuste as configurações para otimizar velocidade, custo e desempenho
</Card>
</CardGroup>