Perguntas frequentes

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.

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.

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.

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.

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.

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

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

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.

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:

code --version

Consulte Créditos e planos para a definição compartilhada de créditos, níveis de preços e noções básicas de uso entre os produtos Verdent.

Consulte O que acontece se você ficar sem créditos para a política de conta compartilhada e as opções de recuperação.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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/:

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

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.

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.

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.

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.

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

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

Sim! Crie subagentes personalizados em ~/.verdent/subagents/:

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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