---
title: "Instalação"
description: "Guia passo a passo para instalar e configurar o Verdent"
---

Este guia orienta você na instalação do Verdent for VS Code a partir do Marketplace do Visual Studio Code e na conclusão da autenticação inicial.

---

## Requisitos

Antes de instalar o Verdent, verifique se o seu sistema atende a estes pré-requisitos:

### Requisitos de sistema

- **Visual Studio Code**: versão 1.90.0 ou superior
- **Sistema operacional**: macOS 11+, Windows 10+ ou Linux (Ubuntu 20.04+, Debian 10+, RHEL 8+)
- **Conexão com a internet**: conexão ativa necessária para a comunicação com o serviço de IA

### Opcional, mas recomendado

- **Git**: para integração com controle de versão e rastreamento de alterações no código

Consulte [Requisitos de sistema](/docs/verdent-for-vscode/getting-started/system-requirements) para obter informações detalhadas sobre compatibilidade.

---

## Instalando a extensão

O Verdent for VS Code é distribuído através do Marketplace do Visual Studio Code.

<Tabs>
  <Tab title="Marketplace do VS Code">
    <Steps>
      <Step title="Acesse o Marketplace">
        Navegue até a [página da extensão Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) no seu navegador.
      </Step>
      <Step title="Clique em Install">
        Clique no botão **Install** na página do marketplace.
      </Step>
      <Step title="Abra no VS Code">
        O VS Code abrirá automaticamente e iniciará o processo de instalação.
      </Step>
    </Steps>
  </Tab>
  <Tab title="Painel de extensões">
    <Steps>
      <Step title="Abra o VS Code">
        Inicie o Visual Studio Code no seu computador.
      </Step>
      <Step title="Acesse as extensões">
        Clique no ícone de extensões na barra lateral esquerda (ícone de quatro quadrados) ou pressione:

        - **macOS**: `Cmd+Shift+X`
        - **Windows/Linux**: `Ctrl+Shift+X`
      </Step>
      <Step title="Pesquise por Verdent">
        Digite "Verdent" na caixa de pesquisa no topo do painel de extensões. Procure por "Verdent" da Verdent AI nos resultados.
      </Step>
      <Step title="Instale">
        Clique no botão **Install** ao lado da extensão Verdent. A instalação normalmente leva alguns segundos.
      </Step>
    </Steps>
  </Tab>
  <Tab title="Linha de comando">
    ```bash
    code --install-extension verdentai.verdent
    ```

    Este método é útil para:

    - Scripts de configuração automatizada
    - Instalações em servidores remotos via SSH
    - Configuração de ambientes CI/CD
    - Instalação rápida em várias máquinas
  </Tab>
</Tabs>

<Tip>
  Se você usa o Settings Sync do VS Code, o Verdent será instalado automaticamente em novas máquinas quando você sincronizar sua lista de extensões.
</Tip>

---

## Autenticação e configuração

Após a instalação, você precisará se autenticar com sua conta Verdent para começar a usar a extensão.

### Autenticação inicial

<Steps>
  <Step title="Abra o Verdent">
    Após a instalação, clique no ícone do Verdent na barra lateral do VS Code. Você verá as opções Sign In / Sign Up.
  </Step>
  <Step title="Faça login">
    Clique em **Sign In**. O VS Code exibirá um pop-up perguntando "Do you want Code to open the external website?" — clique em **Open**.
  </Step>
  <Step title="Autenticação no navegador">
    Seu navegador abrirá na página de autenticação do Verdent. Faça login com as credenciais da sua conta Verdent (e-mail/senha ou provedores OAuth como Google, GitHub etc.).
  </Step>
  <Step title="Autorize o VS Code">
    Conceda ao VS Code acesso à sua conta Verdent quando solicitado.
  </Step>
  <Step title="Volte ao VS Code">
    Retorne ao VS Code assim que a autenticação for concluída. O painel do Verdent exibirá agora a interface de entrada.
  </Step>
</Steps>

**Tempo total:** 2 a 3 minutos para a instalação e configuração completas.

### Configuração inicial (opcional)

O Verdent for VS Code foi projetado para uso imediato após a autenticação, exigindo configuração mínima.

**Configurações padrão:**

- **Permission Mode**: Auto-Run Mode (aprovação automática para operações seguras)
- **Predefinição de modelo**: Balance (combinação ideal de desempenho/custo)
- **Gerenciamento de contexto**: automático

**Personalização opcional:**

Você pode ajustar essas configurações posteriormente pelo painel do Verdent:

- **Permission Mode** - escolha Manual Accept, Auto-Run, Plan Mode ou Skip Permissions
- **Seleção de modelo** - selecione as predefinições Performance, Balance, Efficiency ou modelos específicos
- **Configurações do espaço de trabalho** - configure preferências específicas do projeto

<Note>
  A maioria dos usuários pode começar a usar o Verdent imediatamente após fazer login, sem nenhuma configuração adicional. As configurações avançadas podem ser ajustadas conforme necessário.
</Note>

---

## Verificando a instalação

Confirme se a instalação está funcionando corretamente com estas verificações simples:

### Verificação visual

1. **Ícone na barra lateral** - procure pelo ícone do Verdent na barra lateral do VS Code (lado esquerdo)
2. **Lista de extensões** - abra o painel de extensões (`Cmd+Shift+X` / `Ctrl+Shift+X`) e confirme que "Verdent" aparece como instalada com uma marca de verificação

### Verificação funcional

<Steps>
  <Step title="Abra o painel do Verdent">
    Clique no ícone do Verdent na barra lateral ou pressione `Cmd+L` (macOS) / `Ctrl+L` (Windows/Linux).
  </Step>
  <Step title="Envie um prompt de teste">
    Tente uma solicitação simples como "Explique o que este espaço de trabalho contém" na caixa de entrada.
  </Step>
  <Step title="Receba uma resposta">
    O Verdent deve analisar seu espaço de trabalho e fornecer uma resposta em segundos.
  </Step>
</Steps>

**Indicadores de sucesso:**

- Ícone do Verdent visível na barra lateral
- Conta autenticada com sucesso
- Capacidade de enviar prompts e receber respostas

### Solução de problemas

Se a verificação falhar, tente estas soluções:

| Problema              | Solução                                        |
| --------------------- | ----------------------------------------------- |
| Ícone da barra lateral ausente  | Reinicie o VS Code ou verifique se há atualizações da extensão  |
| Prompts não respondem | Verifique a conexão com a internet e as configurações do firewall |
| Extensão não encontrada   | Verifique se a versão do VS Code é 1.90.0 ou superior      |

<Warning>
  O Verdent requer uma conexão ativa com a internet. Se os prompts não estiverem respondendo, verifique sua conectividade de rede e se a configuração do firewall permite HTTPS de saída para os endpoints de API do Verdent.
</Warning>

---

## Próximos passos

<CardGroup cols={2}>
  <Card title="Início rápido" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    Conclua sua primeira tarefa com o Verdent em 5 minutos
  </Card>
  <Card title="Conceitos fundamentais" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    Entenda os subagentes, modos de execução e a arquitetura multiagente
  </Card>
</CardGroup>