Instalação

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

Acesse o Marketplace

Navegue até a página da extensão Verdent no seu navegador.

Clique em Install

Clique no botão Install na página do marketplace.

Abra no VS Code

O VS Code abrirá automaticamente e iniciará o processo de instalação.

Abra o VS Code

Inicie o Visual Studio Code no seu computador.

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

Pesquise por Verdent

Digite "Verdent" na caixa de pesquisa no topo do painel de extensões. Procure por "Verdent" da Verdent AI nos resultados.

Instale

Clique no botão Install ao lado da extensão Verdent. A instalação normalmente leva alguns segundos.

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

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.

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.

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.

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.

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

Autorize o VS Code

Conceda ao VS Code acesso à sua conta Verdent quando solicitado.

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.

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

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.

Verificando a instalação

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

Verificação visual

Ícone na barra lateral - procure pelo ícone do Verdent na barra lateral do VS Code (lado esquerdo)
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

Abra o painel do Verdent

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

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.

Receba uma resposta

O Verdent deve analisar seu espaço de trabalho e fornecer uma resposta em segundos.

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

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.