---
title: Perguntas frequentes
description: Perguntas comuns sobre o Verdent for VS Code
---



Respostas às perguntas frequentes sobre os recursos, capacidades e uso do Verdent.

---

## Primeiros passos

<Tip>
Conclua o guia de início rápido antes de mergulhar nos recursos avançados, pois ele cobre conceitos essenciais que aparecem ao longo da documentação.
</Tip>

---

## Problemas comuns (top 4)

<Accordion title="Por que não consigo fazer login no Verdent for VS Code?">
**Causa mais comum:** problema de configuração de proxy

**Solução:**
1. Abra as Configurações do VS Code (`Cmd+,` no macOS ou `Ctrl+,` no Windows/Linux)
2. Pesquise por "useProxy" ou "verdent.enableProxy"
3. Ative/desative a configuração de proxy (oposto do estado atual)
4. Tente fazer login novamente

**Explicação:** se você estiver atrás de um firewall corporativo, talvez precise ativar a configuração de proxy. Se estiver em uma rede doméstica, tente desativá-la.
</Accordion>

<Accordion title="Por que não recebi meus créditos de teste gratuito?">
**Erro:** os créditos de teste gratuito não foram recebidos ou o acesso ao teste gratuito foi negado

**Motivo:** uma violação dos termos de serviço foi detectada durante o cadastro

**Solução:** entre em contato com support@verdent.ai para obter ajuda com o acesso ao seu teste gratuito. A equipe de suporte analisará sua conta e ajudará a resolver o problema.
</Accordion>

<Accordion title="Por que meu cadastro falhou?">
**Erro:** o cadastro da conta foi rejeitado ou restringido

**Motivo:** o cadastro violou os termos de serviço do Verdent, resultando em restrição de acesso

**Solução:** entre em contato com support@verdent.ai para obter ajuda. A equipe de suporte pode analisar seu cadastro e orientar sobre como resolver o problema.
</Accordion>

<Accordion title="Por que não consigo encontrar os modelos Claude, GPT ou Gemini?">
**Problema:** não é possível encontrar determinados modelos de IA no menu de seleção de modelos

**Motivo:** restrições baseadas em localização dos provedores de modelos

**Explicação:** alguns provedores de modelos de IA (Anthropic, OpenAI, Google) têm restrições regionais que impedem que certos modelos estejam disponíveis em locais geográficos específicos. Quando isso acontece:
- Os modelos restritos não aparecerão no seu menu de seleção de modelos
- Você ainda pode usar todos os outros modelos disponíveis sem interrupção
- Nenhum impacto na sua assinatura ou créditos

**Verifique os modelos disponíveis:** acesse https://www.verdent.ai/regions para ver quais modelos estão disponíveis na sua região

**Observação:** as restrições regionais são definidas pelos provedores de modelos de IA, não pelo Verdent. O Verdent não pode anular essas restrições.
</Accordion>

---

<Accordion title="O que é o Visual Studio Code?">
O Visual Studio Code é um editor de código gratuito e de código aberto desenvolvido pela Microsoft. É um ambiente de desenvolvimento leve, porém poderoso, que oferece suporte a várias linguagens de programação e recursos como depuração, realce de sintaxe, autocompletar inteligente de código e controle de versão integrado. O Verdent se integra diretamente ao Visual Studio Code como uma extensão, adicionando recursos de codificação com IA ao seu fluxo de trabalho existente.
</Accordion>

<Accordion title="O que é o Verdent for VS Code?">
O Verdent é uma extensão de assistente de codificação com IA para o Visual Studio Code que ajuda na geração, refatoração e depuração de código e na navegação por projetos por meio de conversas em linguagem natural.

**Principais capacidades:**
- Geração e modificação de código via ferramentas de arquivo
- Exploração da base de código com subagentes especializados
- Execução de comandos por meio de integração com bash
- Extensibilidade personalizada via regras e servidores MCP
</Accordion>

<Accordion title="Quais são os requisitos de sistema?">
**Requisitos mínimos:**
- Visual Studio Code 1.90.0 ou superior
- Assinatura ativa do Verdent
- Conexão com a internet

**Suporte a plataformas:** macOS, Windows, Linux, WSL
</Accordion>

<Accordion title="Como começo a usar o Verdent após a instalação?">
1. Instale a extensão Verdent no marketplace do VS Code
2. Faça login com sua conta Verdent quando solicitado
3. Abra qualquer arquivo de código ou projeto
4. Abra a Chat View e comece a conversar com o Verdent

**Sugestão para a primeira tarefa:** peça ao Verdent para explicar a estrutura do seu projeto ou revisar um arquivo específico.
</Accordion>

<Accordion title="Como verifico a versão do meu Visual Studio Code?">
Abra o Visual Studio Code e vá em **Help** → **About** (ou **Code** → **About Visual Studio Code** no macOS). O número da versão é exibido na caixa de diálogo. O Verdent requer o Visual Studio Code versão 1.90.0 ou superior.

Você também pode verificar pela linha de comando:
```bash
code --version
```
</Accordion>

<Accordion title="O que são créditos?">
Consulte [Créditos e planos](/docs/account-billing/credits-and-plans) para a definição compartilhada de créditos, níveis de preços e noções básicas de uso entre os produtos Verdent.
</Accordion>

<Accordion title="O que acontece se meus créditos acabarem?">
Consulte [O que acontece se você ficar sem créditos](/docs/account-billing/run-out-of-credits) para a política de conta compartilhada e as opções de recuperação.
</Accordion>

<Accordion title="O Verdent envia minhas imagens para servidores externos?">
As imagens coladas pela área de transferência ou referenciadas por caminho de arquivo são processadas dentro da sua sessão de conversa. As imagens não são armazenadas permanentemente e são apagadas quando você inicia uma nova conversa. As referências por caminho de arquivo leem a imagem localmente sem fazer upload.
</Accordion>

<Accordion title="O que é o Plan Mode?">
O Plan Mode é um modo de execução somente leitura em que o Verdent analisa código, realiza pesquisas e cria planos de implementação detalhados sem modificar arquivos ou executar comandos. Depois de gerar um plano, o Verdent apresenta duas opções: **Edit** (para solicitar modificações e refinar o plano) ou **Start Building** (para alternar para o Agent Mode e iniciar a execução). O agente pode fazer perguntas de esclarecimento para eliminar incertezas antes da execução. Esse modo é ideal para tarefas complexas em que você deseja revisar a abordagem antes de se comprometer com as mudanças, garantindo alinhamento entre suas expectativas e a solução proposta pelo Verdent.
</Accordion>

<Accordion title="O Plan Mode realmente escreve algum código nos meus arquivos?">
**Não.** O Plan Mode é estritamente somente leitura:

- O Verdent pode ler arquivos, pesquisar código e analisar sua base de código
- **Nenhuma escrita, edição ou exclusão de arquivo** ocorre durante o Plan Mode
- Os planos são exibidos apenas na Chat View
- A execução de código começa somente depois que você aprova explicitamente e alterna para o Agent Mode

**Garantia de segurança:** o Plan Mode não pode modificar seu código acidentalmente. Ele foi projetado para exploração segura e desenvolvimento de estratégias.
</Accordion>

<Accordion title="Como alterno entre o Plan Mode e o Agent Mode?">
**A alternância é instantânea pela Input Box:**

**Para entrar no Plan Mode:**
- Clique no botão **Switch Mode** na Input Box
- Selecione **Plan Mode** no menu suspenso
- OU diga: "Switch to Plan Mode"

**Para sair do Plan Mode:**
- Clique no botão **Switch Mode** na Input Box
- Selecione **Agent Mode** no menu suspenso
- OU escolha **Start Building** após revisar um plano

**Persistência do modo:**
- A escolha do modo persiste dentro da sessão atual
- Novas sessões começam no Agent Mode padrão
- Você pode alternar entre os modos livremente a qualquer momento

**Fluxo de trabalho típico:** Plan Mode → revisar → Agent Mode → executar → voltar ao Plan Mode para o próximo recurso complexo.
</Accordion>

<Accordion title="Como inicio uma nova conversa com contexto limpo?">
Clique no botão "New Session" na barra superior. Isso limpa o histórico da conversa atual e dá ao Verdent uma janela de contexto nova para sua próxima tarefa.
</Accordion>

<Accordion title="Posso usar o Verdent em vários projetos simultaneamente?">
Sim, cada janela do VS Code opera de forma independente. Você pode ter o Verdent aberto em vários projetos, e cada um mantém seu próprio contexto de conversa separado.
</Accordion>

<Accordion title="O Verdent funciona com GitHub, GitLab, Bitbucket e outras plataformas Git?">
Sim. O Verdent usa comandos Git padrão, então funciona com qualquer repositório Git, independentemente da plataforma de hospedagem. Para criar pull requests, o Verdent usa o CLI `gh`, que requer o GitHub, mas todas as outras operações Git funcionam universalmente.
</Accordion>

---

## Ferramentas e capacidades

<Accordion title="Com quais formatos de arquivo o Verdent pode trabalhar?">
**Suportados:** todos os formatos de arquivo baseados em texto, incluindo:
- Código-fonte (JavaScript, Python, TypeScript, Java, Go, etc.)
- Arquivos de configuração (JSON, YAML, TOML, XML, ENV)
- Documentação (Markdown, HTML, LaTeX)
- Arquivos de build (package.json, Makefile, requirements.txt)

**Não suportados:** arquivos binários (imagens, vídeos, PDFs, binários compilados, documentos do Office)

**Solução alternativa:** referencie arquivos binários no código, mas as modificações exigem ferramentas externas.
</Accordion>

<Accordion title="Quais linguagens de programação o Verdent suporta melhor?">
**Suporte excelente:**
- JavaScript, TypeScript, Python, React, Vue, Angular
- Node.js, Go, Java/Spring, C#/.NET
- Swift, Kotlin, Flutter

**Suporte muito bom:** Rust, C/C++, Ruby, R

**Bom suporte:** PHP, Assembly, Julia

Linguagens comuns têm suporte mais forte devido à ampla quantidade de dados de treinamento.
</Accordion>

<Accordion title="Como o Verdent lê e modifica arquivos?">
Três ferramentas de operação de arquivos:
- **file_read:** lê arquivos completos ou intervalos de linhas específicos
- **file_edit:** substitui padrões de texto específicos (modificações direcionadas)
- **file_write:** cria novos arquivos ou reescreve arquivos completos

**Prática recomendada:** use `file_edit` para modificações e `file_write` apenas para arquivos novos.
</Accordion>

<Accordion title="O que é execução de comandos?">
Executar comandos de terminal ou scripts de shell através do Verdent, incluindo operações como rodar testes, instalar pacotes ou executar comandos de build. A execução de comandos requer aprovação na maioria dos Permission Modes para evitar mudanças não intencionais no sistema.
</Accordion>

<Accordion title="O Verdent pode executar comandos no meu terminal?">
Sim, usando a ferramenta `bash`. O Verdent pode executar comandos de terminal com:
- Tempo limite máximo: 120 segundos (2 minutos)
- Encadeamento de comandos com `&&`
- Suporte multiplataforma (bash no Unix, PowerShell no Windows)

**Segurança:** os comandos são executados com suas permissões de usuário. Use o Manual Accept Mode para revisar antes da execução.
</Accordion>

<Accordion title="Por quanto tempo os comandos bash podem ser executados?">
**Tempo limite máximo:** 120 segundos (2 minutos)

Comandos que excederem 2 minutos serão encerrados automaticamente. Para operações mais longas, considere:

**Alternativas:**
- Divida em comandos menores: `bash("task1") && bash("task2")`
- Divida em operações menores
- Execute em segundo plano e verifique os resultados separadamente
</Accordion>

<Accordion title="O que é o ciclo Multipass de gerar-testar-reparar?">
Um processo de verificação iterativo em que o código é gerado, testado e reparado até passar em testes abrangentes. O Verdent executa testes automaticamente, analisa falhas, corrige problemas e testa novamente em várias passagens até que o código funcione corretamente. Isso entrega código pronto para produção, não apenas sugestões. Cada resultado inclui resumos detalhados e diffs de código mostrando exatamente o que mudou.
</Accordion>

<Check>
Os ciclos de teste Multipass corrigem e testam o código automaticamente até que ele passe, e é assim que o Verdent garante a prontidão para produção.
</Check>

---

## Subagentes e execução

<Accordion title="O que são subagentes e quando devo usá-los?">
Subagentes são agentes de IA especializados com janelas de contexto isoladas para tarefas específicas.

**Subagentes integrados:**
- **@Explorer:** pesquisas na base de código, perguntas sobre arquitetura
- **@Verifier:** verificações rápidas de validação
- **@Code-reviewer:** revisões de segurança e qualidade

**Quando usar:** delegue tarefas de pesquisa, validação ou revisão para economizar contexto da conversa principal.

**Como criar subagentes personalizados:**

Crie um arquivo markdown em `~/.verdent/subagents/`:

```markdown
---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]
```

**Casos de uso:** expertise específica de domínio (finanças, saúde), fluxos de trabalho de equipe, especialistas em tecnologia.
</Accordion>

<Accordion title="O que é poluição de contexto?">
Quando ações e informações anteriores no contexto criam padrões comportamentais não intencionais que afetam tarefas futuras. Por exemplo, se você atualiza código repetidamente e depois o implanta, o agente pode começar a associar todas as atualizações de código a uma implantação imediata, mesmo quando você está apenas experimentando. Os subagentes evitam a poluição de contexto operando com janelas de contexto isoladas, permitindo que cada tarefa especializada comece com contexto limpo e evitando contaminação cruzada entre diferentes tipos de trabalho.
</Accordion>

<Accordion title="Como sei em qual modo de execução estou atualmente?">
Observe a caixa de entrada na parte inferior do painel do Verdent. O botão "Switch Permission" exibe seu modo atual (por exemplo, "Manual", "Auto", "Plan"). Você pode clicar nele para alternar os modos.
</Accordion>

<Accordion title="Qual é a diferença entre o Auto-Run Mode e o Manual Accept Mode?">
**Auto-Run Mode:**
- As operações de arquivo são executadas automaticamente sem aprovação
- Os comandos ainda exigem permissão
- Fluxo de trabalho mais rápido para bases de código confiáveis
- Ideal para projetos individuais com controle de versão

**Manual Accept Mode:**
- Revise e aprove cada operação protegida
- Mais seguro para bases de código compartilhadas ou produção
- Veja exatamente o que será executado antes da execução

Alterne os modos pelas Configurações ou pela paleta de comandos.
</Accordion>

<Accordion title="O que são operações seguras?">
Operações que apenas leem dados sem fazer alterações: leituras de arquivos e pesquisas na web. Elas são aprovadas automaticamente no Auto-Run Mode, enquanto edições de arquivos e execução de comandos ainda exigem aprovação por segurança.
</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 os modos instantaneamente pelo botão **Switch Permission** na Input Box. A maioria dos usuários alterna entre os modos com base no contexto da tarefa (por exemplo, Plan Mode para recursos complexos, Auto-Run para correções rápidas).
</Accordion>

<Accordion title="Quando devo usar o agente Explorer em vez de carregar arquivos diretamente?">
Use o agente Explorer para tarefas de descoberta e pesquisa sem consumir o contexto principal. Carregue arquivos diretamente com @-mentions apenas quando precisar modificá-los. O Explorer é ideal para perguntas do tipo "encontre todos os arquivos que...", enquanto as @-mentions são para tarefas do tipo "atualize este arquivo específico".
</Accordion>

<Accordion title="Posso criar subagentes personalizados para o meu projeto?">
Sim! Crie subagentes personalizados em `~/.verdent/subagents/`:

```markdown
---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]
```

**Casos de uso:** expertise específica de domínio (finanças, saúde), fluxos de trabalho de equipe, especialistas em tecnologia.
</Accordion>

<Accordion title="Posso interromper o Verdent no meio de uma tarefa de várias etapas?">
Sim. Você pode interromper a execução a qualquer momento. O Verdent concluirá a etapa atual em que está trabalhando e depois parará. O progresso até esse ponto é preservado. Você pode revisar o que foi feito, fazer ajustes e continuar ou adotar uma abordagem diferente.
</Accordion>

<Accordion title="Como sei o que o Verdent está fazendo agora em uma tarefa longa?">
Observe a lista de tarefas (todo list). Ela mostra o status em tempo real com um item marcado como "in progress" a qualquer momento. O item ativo mostra exatamente em que o Verdent está trabalhando no momento. Os itens concluídos são marcados como feitos, e os itens pendentes mostram o que falta.
</Accordion>

<Accordion title="O Verdent faz commit das minhas alterações automaticamente?">
Não. O Verdent só cria commits quando você os solicita explicitamente. Você mantém controle total sobre quando as alterações são commitadas. Basta dizer "Stage all changes and create a commit" quando estiver pronto.
</Accordion>

<Accordion title="O Verdent fará push para repositórios remotos sem perguntar?">
Não. O Verdent só faz push para repositórios remotos quando você solicita explicitamente. Todas as operações Git (commit, push, merge, rebase) exigem sua instrução explícita por segurança.
</Accordion>

---

## Personalização e integração

<Accordion title="Como personalizo o comportamento do Verdent para a minha equipe?">
Três métodos de personalização:

1. **VERDENT.md:** preferências globais pessoais (`~/.verdent/VERDENT.md`)
2. **AGENTS.md:** padrões da equipe específicos do projeto (raiz do projeto, controlado por versão)
3. **plan_rules.md:** formato de saída do Plan Mode (`~/.verdent/plan_rules.md`)

O AGENTS.md prevalece sobre o VERDENT.md para manter a consistência da equipe.
</Accordion>

<Accordion title="Quando as alterações de configuração entram em vigor?">
A maioria das configurações do Verdent é aplicada imediatamente, sem necessidade de reiniciar:

- **Modos de permissão:** alterne instantaneamente pela Input Box
- **Presets de modelo:** aplicados na próxima solicitação
- **Arquivos de regras:** aplicados a novas conversas (salvar dispara o recarregamento)
- **Subagentes:** 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 do 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="O que é o MCP e como o uso?">
O Model Context Protocol (MCP) estende o Verdent com ferramentas e serviços externos:

**Configuração:** `~/.verdent/mcp.json` em Configurações → Servidores MCP

**Capacidades:**
- Conexões com bancos de dados (PostgreSQL, MySQL, MongoDB)
- Serviços de nuvem (AWS, Azure, GCP)
- Ferramentas de gerenciamento de projetos (Jira, Linear)
- Pipelines de CI/CD (Jenkins, GitHub Actions)

**Status:** a documentação de integração do MCP está em desenvolvimento. Entre em contato com support@verdent.ai para obter ajuda com a configuração.
</Accordion>

---

## Práticas recomendadas e desempenho

<Tip>
Monitore o uso de créditos no User Center para acompanhar os padrões de consumo e otimizar seu fluxo de trabalho com eficiência.
</Tip>

<Accordion title="O que é um token?">
A unidade de medida das janelas de contexto. Tokens representam partes de texto (palavras, partes de palavras ou caracteres) que o modelo de IA processa. Os limites de contexto são medidos em tokens, em vez de caracteres ou palavras, e conversas típicas consomem milhares de tokens.
</Accordion>

<Accordion title="O que conta para a minha janela de contexto?">
Tudo na sua sessão: todas as mensagens da conversa, o conteúdo de arquivos carregados no contexto, saídas de ferramentas (resultados de grep/pesquisa, leituras de arquivos), prompts e instruções de sistema e definições de servidores MCP. Cada um deles consome tokens da sua capacidade total de contexto.
</Accordion>

<Accordion title="Qual é a diferença entre janelas de contexto de 200K e 1M?">
Os modelos padrão (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) têm janelas de contexto de `200K` tokens, suficientes para a maioria das tarefas. O Claude Sonnet 4.5 oferece um contexto estendido de `1M` tokens (5x maior) para grandes bases de código com arquivos `1000+`, refatoração complexa de múltiplos arquivos ou longas sessões de desenvolvimento. O contexto de `1M` é ativado automaticamente quando a entrada excede `200K` tokens ou pode ser selecionado explicitamente.
</Accordion>

<Accordion title="Quantos arquivos posso carregar com segurança no contexto?">
Não há limite fixo de arquivos — depende do tamanho dos arquivos e da contagem total de tokens. Para contextos de `200K`, evite carregar `20+` arquivos grandes (`>1000` linhas cada). Concentre-se em arquivos diretamente relevantes para sua tarefa atual. Use `@-mentions` de forma seletiva e aproveite a documentação `AGENTS.md` em vez de carregar muitos arquivos de exemplo. Com o contexto `1M`, a seleção de arquivos se torna muito menos crítica.
</Accordion>

<Accordion title="Como sei quando estou me aproximando dos limites de contexto?">
Os sinais incluem tempos de resposta mais lentos, sessões em execução por várias horas ou muitos arquivos grandes carregados. Monitore a duração da sua sessão e a contagem de arquivos. Quando notar degradação de desempenho, conclua sua tarefa atual, faça commit do seu progresso e inicie uma nova sessão com contexto limpo.
</Accordion>

<Accordion title="Como evito o esgotamento da janela de contexto?">
**Estratégias:**
1. **Leitura estratégica de arquivos:** use intervalos de linhas para arquivos grandes
2. **Delegue a subagentes:** Explorer/Verifier para pesquisa em segundo plano
3. **Pesquise antes de ler:** use `grep_file` para identificar arquivos relevantes
4. **Divida operações:** use `todo_update` para acompanhar tarefas de várias etapas

**Regra prática:** arquivos com mais de 500 linhas devem usar intervalos de linhas.
</Accordion>

<Accordion title="Devo redefinir o contexto manualmente ou o Verdent fará isso automaticamente?">
Você precisa iniciar manualmente uma nova sessão para redefinir o contexto — o Verdent não limpa o contexto automaticamente. Prática recomendada: redefina após concluir uma unidade atômica de trabalho, testar e fazer commit no controle de versão. Para contextos de `1M` tokens, as redefinições são necessárias com muito menos frequência.
</Accordion>

<Accordion title="Redefinir o contexto perderá meu trabalho?">
Não — redefinir o contexto apenas limpa o histórico da conversa e os arquivos carregados da memória. Suas alterações reais de código, commits e modificações de arquivos são preservados. Sempre faça commit do seu trabalho no controle de versão antes de redefinir o contexto por segurança. Redefina → inicie uma nova sessão → continue trabalhando na próxima tarefa.
</Accordion>

<Accordion title="Quão específicos devem ser meus prompts?">
Seja específico o suficiente para eliminar ambiguidades, mas não explique demais detalhes óbvios. Inclua: caminhos exatos de arquivos, abordagem de implementação, resultados esperados e restrições. Ruim: "Fix the code" — vago demais. Bom: "Add input validation to the email field in `ContactForm.js` to reject invalid email formats" — escopo e objetivo claros. Na dúvida, prefira ser mais específico.
</Accordion>

<Accordion title="Qual é a diferença entre @-mentions e o carregamento automático de arquivos?">
O Verdent carrega automaticamente arquivos mencionados pelo nome nos prompts e arquivos relacionados no mesmo diretório. As `@-mentions` (`@filename.js`) garantem explicitamente que um arquivo esteja no contexto, o que é crítico ao trabalhar com arquivos fortemente acoplados, referenciar padrões de um arquivo para aplicar em outro ou quando a detecção automática pode perder contexto em grandes bases de código. Sempre use `@-mentions` ao pedir ao Verdent para "seguir o mesmo padrão de..." para garantir a referência exata do código.
</Accordion>

<Accordion title="Preciso repetir o contexto do projeto em cada prompt durante uma sessão?">
Não — o Verdent mantém o contexto da conversa dentro de uma sessão, então você não precisa repetir detalhes de arquitetura ou convenções já discutidos. No entanto, para restrições críticas ou quando as sessões ficam longas (`100+` mensagens), reafirme o contexto importante. Melhor abordagem: use regras de projeto (`AGENTS.md`) para documentar contexto persistente, como stack de tecnologia, padrões de código e padrões — assim você nunca precisará repeti-los.
</Accordion>

<Accordion title="E se o Verdent não entender ou não seguir meu prompt corretamente?">
Use refinamento iterativo: revise a saída, identifique o que está errado e forneça correções em um prompt subsequente. Exemplo: "The validation logic is good, but use Joi schema validation instead of manual checks. Match the validation pattern in `ProductController.js`." Você também pode pedir explicações: "Why did you use Redux instead of Context API?" e depois refinar com base no entendimento. Não repita o mesmo prompt — ajuste com base no que falhou.
</Accordion>

<Accordion title="Quando devo usar o Plan Mode em vez do modo normal?">
Use o Plan Mode para: grandes refatorações ou mudanças arquiteturais, modificações de múltiplos arquivos em que você quer revisar o escopo antes da execução, tarefas complexas em que você está incerto sobre os requisitos, ou quando quiser que o Verdent o entreviste com perguntas de esclarecimento antes da implementação. Pule o Plan Mode para: tarefas simples e bem definidas, correções rápidas de bugs ou operações de rotina. O Plan Mode adiciona sobrecarga, mas evita erros custosos em trabalhos complexos.
</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 de rotina e tarefas de alta frequência
- Quando a velocidade importa mais que a profundidade

**Use Balance (1x baseline) — Padrão:**
- Desenvolvimento geral e codificação do dia a dia
- Implementação de recursos e revisões de código
- Desempenho equilibrado para a maioria dos cenários

**Use Performance (0,5x de eficiência, 2x de custo):**
- Decisões arquiteturais complexas
- Grandes bases de código que exigem contexto extenso (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 o Performance apenas ao atingir limites de contexto ou ao precisar de raciocínio profundo.
</Accordion>

---

## Solução de problemas

<Accordion title="Como soluciono problemas de firewall ou conexão?">
Se o Verdent não conseguir se conectar aos serviços de IA, verifique estes problemas comuns:

**Teste a conectividade básica:**
- Verifique se você tem acesso ativo à internet
- Tente acessar outros serviços HTTPS para confirmar que as conexões de saída funcionam

**Ambientes corporativos/empresariais:**
- Entre em contato com o administrador da sua rede para colocar os endpoints API do Verdent na lista de permissões
- Garanta que o tráfego HTTPS de saída seja permitido pelo firewall
- Verifique se os servidores proxy estão configurados corretamente para repassar as requisições API
- A inspeção SSL/TLS pode precisar de exceções para os endpoints Verdent

**Sintomas comuns:**
- A extensão parece travar ou expirar
- Falhas de autenticação apesar de credenciais corretas

Se os problemas persistirem após a configuração do firewall, entre em contato com o suporte do Verdent para obter detalhes específicos de endpoints a serem incluídos na lista de permissões.
</Accordion>

<Accordion title="Minhas regras do AGENTS.md não estão sendo aplicadas. Por quê?">
**Verifique:**
- **Localização:** arquivo no diretório raiz do projeto
- **Sintaxe:** Markdown válido
- **Especificidade:** as regras são diretivas ("Always use..." e não "Try to...")
- **Teste novo:** inicie uma nova conversa para testar a aplicação

**Precedência:** o AGENTS.md prevalece sobre o VERDENT.md para comportamento específico do projeto.
</Accordion>

<Accordion title="Como corrijo erros do tipo 'file_edit failed to find exact match'?">
**Causas:**
- Texto alterado desde a última leitura
- Diferenças de espaços em branco (espaços vs tabs)
- String não única no arquivo

**Soluções:**
- Leia o arquivo novamente para obter o conteúdo atual
- Forneça uma string de contexto maior para garantir unicidade
- Use `replace_all=true` para várias strings idênticas
- Verifique se o file_path está correto
</Accordion>

<Accordion title="Por que meu subagente personalizado não está sendo invocado automaticamente?">
**Verifique:**
- **Localização:** arquivo em `~/.verdent/subagents/[name].md`
- **Política de invocação:** a política estrita exige @-mention explícita
- **Frontmatter YAML:** sintaxe válida
- **Diretrizes de "quando usar":** correspondem ao padrão da sua solicitação

**Teste:** use uma @-mention explícita para verificar se o subagente funciona: `@your-subagent do task`
</Accordion>

---

## Veja também

<CardGroup cols={2}>
  <Card title="Referência de ferramentas" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Capacidades completas das ferramentas
  </Card>
  <Card title="Solução de problemas" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/common-issues">
    Problemas comuns e soluções
  </Card>
</CardGroup>