--- title: "Configuração e personalização" description: "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 - 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 - 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 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 **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 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 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 - 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 - **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 ### 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 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 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 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 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 **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 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 | 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 são agentes de IA especializados com prompts de sistema personalizados e janelas de contexto isoladas para lidar com tarefas específicas. ### 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 <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 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 **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 | 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) <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 <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>