Guia de início rápido

Este guia de início rápido fará você usar o fluxo de trabalho Plan-Verify-Code do Verdent em menos de 15 minutos. Você vai instalar a extensão, concluir sua primeira tarefa e entender o fluxo de trabalho principal ao trabalhar com o Verdent for VS Code.

O que você vai aprender

Instalar o Verdent for VS Code a partir do marketplace
Autenticar e verificar sua configuração
Concluir sua primeira tarefa assistida por IA
Entender os modos de execução (Manual Accept, Auto-Run, Plan Mode)
Usar recursos essenciais para o desenvolvimento diário

Pré-requisitos

Antes de começar, certifique-se de ter:

O Visual Studio Code instalado no seu sistema
Uma conexão ativa com a internet
Uma conta de assinatura do Verdent (ou comece com o teste gratuito de 7 dias)

Etapa 1: Instale o Verdent

Acesse a página da extensão Verdent e clique em Install.

Abra o Visual Studio Code
Pressione Ctrl+Shift+X (ou Cmd+Shift+X no macOS)
Pesquise por "Verdent"
Clique em Install

code --install-extension verdentai.verdent

Etapa 2: Comece a usar o Verdent

Abra o Visual Studio Code

Abra o Visual Studio Code na pasta do seu projeto.

Acesse o Verdent

Clique no ícone do Verdent na barra lateral ou pressione Ctrl+L (Windows/Linux) / Cmd+L (macOS).

Faça login

Faça login quando solicitado para autenticar com sua conta do Verdent.

Etapa 3: Sua primeira tarefa

Vamos começar com uma tarefa simples e não destrutiva que demonstra a compreensão que o Verdent tem do seu espaço de trabalho.

Abra um projeto no VS Code e experimente um destes prompts na caixa de entrada do Verdent:

What kind of project is this?

O Verdent analisará a estrutura do seu espaço de trabalho, lerá os arquivos principais e explicará que tipo de aplicativo você está desenvolvendo. Isso demonstra a percepção de contexto sem fazer qualquer alteração.

Você deve ver:

O Verdent analisando os arquivos do seu espaço de trabalho
Um resumo do tipo de projeto, tecnologias e estrutura
Nenhuma modificação de arquivo (análise somente leitura)

Experimente estes prompts de acompanhamento:

Explain what this project does

What dependencies does this project have?

Show me the main entry point of this application

Cada prompt ajuda você a verificar se o Verdent consegue acessar seu espaço de trabalho e entende sua base de código.

Esses prompts exploratórios são perfeitos para entender bases de código desconhecidas. O Verdent lê os arquivos conforme necessário sem exigir que você adicione contexto manualmente.

Etapa 4: Fazendo sua primeira alteração de código

Agora vamos fazer o Verdent criar algo. Experimente esta tarefa simples:

Create a hello_world.txt file with a greeting message

O que acontece:

O Verdent propõe a alteraçãoVocê verá uma prévia mostrando o arquivo a ser criado e seu conteúdo
Solicitação de permissão No Auto Run Mode (o padrão), o Verdent aprovará automaticamente ao criar o arquivo
Você aprova Clique em "Accept" ou aprove a alteração
Arquivo criadoO Verdent cria o arquivo e confirma a conclusão

Entendendo as permissões:

O Manual Accept Mode garante que nenhuma modificação indesejada ocorra sem sua aprovação. Você verá solicitações de permissão para:

Edições e criações de arquivos
Execuções de comandos
Uso de ferramentas (primeiro uso de cada tipo de ferramenta)

Isso lhe dá controle total e ajuda você a aprender quais operações o Verdent realiza para diferentes tarefas.

O Manual Accept Mode é o ponto de partida recomendado para novos usuários. Quando estiver confortável, você pode mudar para Auto-Run Mode ou Plan Mode para diferentes fluxos de trabalho.

Etapa 5: Usando o Plan Mode para tarefas complexas

O Plan Mode é o modo de planejamento somente leitura do Verdent, onde você pode revisar abordagens antes da execução. Vamos experimentá-lo:

Mude para o Plan Mode:

Clique no botão Switch Mode na caixa de entrada e selecione Plan Mode

Experimente uma tarefa de planejamento:

Suggest ways to build a website for my project

O que acontece:

O Verdent analisa seu projetoEle lê os arquivos e entende a estrutura e os requisitos do seu projeto
Cria um plano detalhadoMostra quais tecnologias usar, quais páginas criar e como estruturar o site
Nenhuma modificaçãoO Plan Mode é somente leitura. O Verdent não pode modificar arquivos até que você aprove explicitamente
Esclarecimento interativoO Verdent pode fazer perguntas sobre preferências de design, público-alvo ou recursos antes de finalizar o plano

Por que usar o Plan Mode:

Exploração segura - Entenda bases de código desconhecidas sem alterações acidentais
Revisão de código - Analise a qualidade e a arquitetura antes de fazer modificações
Planejamento estratégico - Divida tarefas complexas em etapas revisáveis
Redução de incertezas - O Verdent faz perguntas esclarecedoras para remover ambiguidades

Use o Plan Mode para qualquer tarefa em que você queira revisar a abordagem antes de se comprometer com a execução. Ele é especialmente valioso ao aprender como o Verdent pensa sobre sua base de código.

Para executar o plano:

Após revisar o plano, o Verdent apresenta duas opções:

Escolha Edit para solicitar modificações ou fazer perguntas esclarecedoras
Escolha Start Building para mudar para o Agent Mode e iniciar a execução

Etapa 6: Entendendo os modos de execução

O Verdent oferece vários modos de execução para se adequar a diferentes fluxos de trabalho:

Modos de permissão:

Modo	Descrição	Quando usar
Manual Accept	Solicita permissão no primeiro uso de cada ferramenta	Aprendizado e desenvolvimento geral com controle máximo
Auto-Run(padrão)	Aceita automaticamente operações seguras (leituras de arquivos, buscas na web); edições de arquivos e comandos ainda exigem aprovação	Projetos confiáveis e prototipagem rápida
Plan Mode	Modo somente leitura para análise e planejamento sem modificações de arquivos	Tarefas complexas e revisão de código
Skip Permissions	Operação totalmente autônoma ignorando todas as solicitações	Ambientes isolados e seguros, como testes automatizados ou sandboxes

Additional Mode:

Think Hard Mode - Orçamento máximo de raciocínio para reflexões complexas e decisões arquiteturais

O Skip Permissions Mode remove todas as verificações de segurança. Use apenas em ambientes isolados e descartáveis, onde erros não têm consequências.

Ações essenciais

Aqui estão as principais ações que você usará diariamente no Verdent for VS Code:

Ação	Como acessar	Descrição
Abrir o Verdent	`Cmd+L` / `Ctrl+L` ou clique no ícone da barra lateral	Abre o painel do Verdent
New Session	Clique em "New Session" na barra superior	Inicia uma nova conversa com contexto limpo
Add Context	Clique no botão "Add Context"	Faça referência a arquivos com menções @
Add Images	Clique no botão "Add Images or Files"	Carregue capturas de tela, mockups ou diagramas
Switch Mode	Clique no botão "Switch Mode"	Alterne entre os modos Agent/Plan/Chat
Change Model	Clique no seletor de modelo	Escolha as predefinições Performance/Balance/Efficiency
Think Hard	Clique no botão "Think Hard Mode"	Habilite o raciocínio estendido para tarefas complexas
Switch Permissions	Clique no botão "Switch Permission"	Altere o modo de permissão
View History	Clique em "Project History" na barra superior	Navegue pelas sessões anteriores
User Center	Clique em "User Center" na barra superior	Verifique o saldo de créditos e as informações da conta
Settings	Clique em "Settings" na barra superior	Configure servidores MCP, subagentes, regras

Dicas profissionais para iniciantes

Comece com prompts exploratórios

Antes de fazer alterações, deixe o Verdent entender sua base de código:

Analyze the database schema

Explain the authentication flow

Isso constrói o contexto do Verdent sobre seu projeto e o ajuda a fazer sugestões melhores.

Seja específico em suas solicitações

Em vez de: "corrija o bug"

Tente: "corrija o bug de login em LoginForm.tsx onde os usuários veem uma tela em branco após inserir credenciais incorretas"

Prompts específicos levam a soluções mais precisas e menos iterações.

Use o Plan Mode para código desconhecido

Ao trabalhar com código que você não entende totalmente, use primeiro o Plan Mode:

Refactor the authentication module to use async/await instead of callbacks

Revise o plano, escolha Edit para fazer perguntas esclarecedoras e refinar e, em seguida, escolha Start Building quando estiver confiante.

Divida tarefas complexas em etapas

Para recursos com várias etapas, trabalhe de forma incremental:

1. Create a new database table for user profiles

Depois, após a conclusão:

2. Create an API endpoint to get and update profiles

Isso mantém a clareza e permite que você verifique cada etapa.

Aproveite as menções @ para contexto

Faça referência explícita a arquivos quando necessário:

@components/UserProfile.tsx refactor this component to use hooks

Isso garante que o Verdent se concentre no contexto certo para sua tarefa.

Use subagentes para tarefas especializadas

O Verdent inclui três subagentes integrados:

@Explorer - Exploração rápida da base de código e descoberta de arquivos
@Verifier - Validação e verificações rápidas de código
@Code-reviewer - Revisão abrangente de segurança e qualidade

Exemplo:

@Explorer find all API endpoints in this project

Problemas comuns

Solução: Reinicie o VS Code. Se ainda estiver ausente, verifique a instalação no painel de extensões (Cmd+Shift+X / Ctrl+Shift+X) e confirme se "Verdent" aparece na lista.

Solução:

Verifique se a conexão com a internet está ativa
Verifique se as configurações de firewall/proxy permitem HTTPS para os serviços do Verdent
Confirme se você tem créditos restantes no User Center
Tente um prompt mais simples para testar a conectividade

Solução: Mude para o Auto-Run Mode usando o botão "Switch Permission". Isso aprova automaticamente operações de leitura seguras, ainda solicitando aprovação para edições de arquivos e comandos.

Como obter ajuda

Comunidade no Discord: https://discord.com/invite/NGjXEZcbJq - Comunidade ativa com suporte em tempo real
Documentação: Navegue por outros guias nesta documentação
Feedback: Use o botão Feedback na barra superior do Verdent para relatar problemas ou sugerir melhorias

Perguntas frequentes

Como sei em qual modo de execução estou no momento?

Observe a caixa de entrada na parte inferior do painel do Verdent. O botão "Switch Permission" exibe o modo atual (por exemplo, "Manual", "Auto", "Plan"). Você pode clicar nele para alternar os modos.

O que acontece se eu ficar sem créditos?

As solicitações padrão baseadas em créditos param quando seu saldo chega a zero. Aguarde a renovação do próximo ciclo de faturamento ou compre uma recarga avulsa para continuar.

Posso usar o Verdent em vários projetos simultaneamente?

Sim, cada janela do VS Code funciona 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.

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 oferece ao Verdent uma janela de contexto nova para sua próxima tarefa.