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

Este guia orienta você no download do Verdent, na conclusão da instalação específica de cada plataforma e na autenticação com sua conta Verdent.

---

## Requisitos

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

### Requisitos de sistema

* **Sistema operacional**: macOS 11+ ou Windows 10+ (64 bits). Consulte [Sistemas operacionais suportados](/docs/verdent-manager/getting-started/supported-operating-systems) para todos os detalhes de compatibilidade.
* **Git**: Versão 2.20 ou superior. O Verdent usa worktrees do Git para isolar espaços de trabalho. Sua pasta de projeto não precisa ser um repositório Git, mas alguns recursos exigem Git e o Verdent pode orientá-lo a inicializar um repositório quando necessário.
  - **macOS:** O Git vem com as Xcode Command Line Tools. Instale com `xcode-select --install` ou use o Homebrew: `brew install git`.
  - **Windows:** Baixe o instalador oficial em [git-scm.com/download/win](https://git-scm.com/download/win) e aceite as opções padrão.
  - Verifique com `git --version` em um terminal.
* **Conexão com a internet**: Conexão ativa necessária para a comunicação com o serviço de IA

### Opcional, mas recomendado

* **Espaço em disco**: Pelo menos 2 GB livres (mais é recomendado para repositórios grandes, worktrees e cache)

---

## Download

Baixe o Verdent no site oficial:

**[verdent.ai/download](https://verdent.ai/download)**

Selecione seu sistema operacional para baixar o instalador apropriado.

---

## Instalação no macOS

<Steps>
  <Step title="Baixar">
    Baixe o arquivo `.dmg` em [verdent.ai/download](https://verdent.ai/download)
  </Step>
  <Step title="Abrir o DMG">
    Clique duas vezes no arquivo `.dmg` baixado para montá-lo
  </Step>
  <Step title="Instalar">
    Arraste o ícone do Verdent para a pasta Aplicativos
  </Step>
  <Step title="Iniciar">
    Abra a pasta Aplicativos e clique duas vezes no Verdent
  </Step>
  <Step title="Aprovação de segurança">
    Se solicitado, abra **Ajustes do Sistema → Privacidade e Segurança** (macOS 13+) ou **Preferências do Sistema → Segurança e Privacidade** (macOS anteriores) e clique em **Abrir mesmo assim**
  </Step>
</Steps>

**Versões do macOS suportadas:**
- macOS 11 (Big Sur) e posteriores
- Suporte a Intel e Apple Silicon

---

## Instalação no Windows

<Steps>
  <Step title="Baixar">
    Baixe o instalador `.exe` em [verdent.ai/download](https://verdent.ai/download)
  </Step>
  <Step title="Executar o instalador">
    Clique duas vezes no arquivo `.exe` baixado
  </Step>
  <Step title="Prompt do UAC">
    Clique em **Sim** quando solicitado pelo Controle de Conta de Usuário
  </Step>
  <Step title="Opções de instalação">
    Siga as instruções do instalador (algumas versões podem não oferecer um diretório de instalação personalizado)
  </Step>
  <Step title="Concluir">
    Clique em **Instalar** e aguarde a conclusão
  </Step>
  <Step title="Iniciar">
    Clique em **Concluir** para iniciar o Verdent ou encontre-o no Menu Iniciar
  </Step>
</Steps>

**Versões do Windows suportadas:**
- Windows 10
- Windows 11
- Apenas 64 bits

---

## Autenticação e configuração

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

### Autenticação inicial

<Steps>
  <Step title="Iniciar o Verdent">
    Abra o Verdent em Aplicativos (macOS) ou no Menu Iniciar (Windows). A tela de boas-vindas aparece.
  </Step>

  <Step title="Entrar">
    Clique em **Entrar**. Seu navegador abrirá a página de autenticação do Verdent.
  </Step>

  <Step title="Autenticação no navegador">
    Entre com as credenciais da sua conta Verdent (e-mail/senha ou provedores OAuth como Google, GitHub etc.).
  </Step>

  <Step title="Retornar ao app">
    Retorne ao Verdent assim que a autenticação for concluída. Você verá a interface principal.
  </Step>

  <Step title="Abrir projeto">
    Escolha **Abrir projeto** para selecionar um diretório, ou **Projetos recentes** se estiver retornando.
  </Step>
</Steps>

---

## Verificando a instalação

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

### Verificação visual

1. **Ícone do aplicativo** - O Verdent aparece em Aplicativos (macOS) ou no Menu Iniciar (Windows)
2. **Conectado** - Você pode ver o status da sua conta no app após a autenticação (por exemplo, avatar/e-mail)

### Verificação funcional

<Steps>
  <Step title="Abrir projeto">
    Abra um diretório no Verdent.
  </Step>

  <Step title="Enviar prompt de teste">
    Tente uma solicitação simples como "Explique o que este projeto contém" na caixa de entrada.
  </Step>

  <Step title="Receber resposta">
    O Verdent deve analisar seu projeto e fornecer uma resposta em breve.
  </Step>
</Steps>

**Indicadores de sucesso:**

* O Verdent inicia sem erros
* Conta autenticada com sucesso
* Você consegue enviar prompts e receber respostas

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

---

## Solução de problemas de instalação

<Tabs>
  <Tab title="Segurança do macOS">
    **Problema:** "O Verdent não pode ser aberto porque é de um desenvolvedor não identificado"

    **Solução:**
    1. Abra **Ajustes do Sistema → Privacidade e Segurança** (macOS 13+) ou **Preferências do Sistema → Segurança e Privacidade** (macOS anteriores)
    2. Encontre a mensagem de aviso do Verdent
    3. Clique em **Abrir mesmo assim**
    4. Confirme clicando em **Abrir**
  </Tab>
  <Tab title="Windows Defender">
    **Problema:** O Windows Defender bloqueia a instalação

    **Solução:**
    1. Clique em **Mais informações** no pop-up do SmartScreen
    2. Se você baixou o Verdent no site oficial e confia na fonte, clique em **Executar assim mesmo**
    3. Continue a instalação
  </Tab>
</Tabs>

---

## Perguntas frequentes

<AccordionGroup>
<Accordion title="Posso instalar o Verdent junto com a extensão VS Code?">
Sim. O Verdent e a extensão VS Code são aplicativos independentes. Você pode usar ambos, e eles compartilham o mesmo conjunto de créditos e conta.
</Accordion>

<Accordion title="Como atualizo o Verdent?">
O Verdent verifica atualizações automaticamente na inicialização. Quando uma atualização está disponível:
1. Uma notificação aparece
2. Clique em **Atualizar** para baixar e instalar
3. Reinicie o aplicativo

Você também pode verificar manualmente no menu do app (por exemplo: **Ajuda → Verificar atualizações**).
</Accordion>

<Accordion title="Como desinstalo o Verdent?">
**macOS:** Arraste o Verdent de Aplicativos para a Lixeira

**Windows:** Use **Configurações → Aplicativos → Verdent → Desinstalar** ou **Painel de Controle → Programas e Recursos**
</Accordion>
</AccordionGroup>

---

## Próximos passos

<CardGroup cols={2}>
  <Card title="Início rápido" icon="rocket" href="/docs/verdent-manager/getting-started/quick-start">
    Adicione seu primeiro projeto e atribua uma tarefa
  </Card>
  <Card title="Manager" icon="user-tie" href="/docs/verdent-manager/core-features/manager">
    Aprenda como o Manager planeja, distribui e acompanha o trabalho
  </Card>
</CardGroup>