---
title: "Guia de início rápido"
description: "Comece a usar o Verdent em minutos"
---

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

<Tabs>
  <Tab title="Visual Studio Code Marketplace">
    Acesse a [página da extensão Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) e clique em **Install**.
  </Tab>
  <Tab title="Painel de extensões">
    1. Abra o Visual Studio Code
    2. Pressione `Ctrl+Shift+X` (ou `Cmd+Shift+X` no macOS)
    3. Pesquise por "Verdent"
    4. Clique em **Install**
  </Tab>
  <Tab title="Linha de comando">
    ```bash
    code --install-extension verdentai.verdent
    ```
  </Tab>
</Tabs>

---

## Etapa 2: Comece a usar o Verdent

<Steps>
  <Step title="Abra o Visual Studio Code">
    Abra o Visual Studio Code na pasta do seu projeto.
  </Step>
  <Step title="Acesse o Verdent">
    Clique no ícone do Verdent na barra lateral ou pressione `Ctrl+L` (Windows/Linux) / `Cmd+L` (macOS).
  </Step>
  <Step title="Faça login">
    Faça login quando solicitado para autenticar com sua conta do Verdent.
  </Step>
</Steps>

---

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

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

---

## 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:**

1. **O Verdent propõe a alteração**Você verá uma prévia mostrando o arquivo a ser criado e seu conteúdo
2. **Solicitação de permissão**  No Auto Run Mode (o padrão), o Verdent aprovará automaticamente ao criar o arquivo
3. **Você aprova** Clique em "Accept" ou aprove a alteração
4. **Arquivo criado**O 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.

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

---

## 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:**

1. **O Verdent analisa seu projeto**Ele lê os arquivos e entende a estrutura e os requisitos do seu projeto
2. **Cria um plano detalhado**Mostra quais tecnologias usar, quais páginas criar e como estruturar o site
3. **Nenhuma modificação**O Plan Mode é somente leitura. O Verdent não pode modificar arquivos até que você aprove explicitamente
4. **Esclarecimento interativo**O 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

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

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

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

---

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

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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
  ```
</Accordion>

---

## Problemas comuns

<Tabs>
  <Tab title="A extensão não aparece na barra lateral">
    **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.
  </Tab>
  <Tab title="Os prompts não recebem respostas">
    **Solução:**

    1. Verifique se a conexão com a internet está ativa
    2. Verifique se as configurações de firewall/proxy permitem HTTPS para os serviços do Verdent
    3. Confirme se você tem créditos restantes no User Center
    4. Tente um prompt mais simples para testar a conectividade
  </Tab>
  <Tab title="As solicitações de permissão são muito frequentes">
    **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.
  </Tab>
</Tabs>

---

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

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

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

---

## Próximos passos

Você instalou o Verdent, concluiu sua primeira tarefa e aprendeu o fluxo de trabalho principal. Veja para onde ir em seguida:

<CardGroup cols={2}>
  <Card title="Conceitos principais" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    Entenda os subagentes, a arquitetura multiagente e o gerenciamento de contexto
  </Card>
  <Card title="Fluxos de trabalho comuns" icon="code" href="/docs/verdent-for-vscode/common-workflows/multi-step-tasks">
    Guias passo a passo para tarefas com várias etapas, grandes bases de código e controle de versão
  </Card>
</CardGroup>