Installazione

Questa guida ti accompagna nell'installazione di Verdent for VS Code dal Visual Studio Code Marketplace e nel completamento dell'autenticazione iniziale.

Requisiti

Prima di installare Verdent, assicurati che il tuo sistema soddisfi questi prerequisiti:

Requisiti di sistema

Visual Studio Code: versione 1.90.0 o superiore
Sistema operativo: macOS 11+, Windows 10+ o Linux (Ubuntu 20.04+, Debian 10+, RHEL 8+)
Connessione a Internet: è necessaria una connessione attiva per la comunicazione con il servizio AI

Opzionali ma consigliati

Git: per l'integrazione con il controllo di versione e il tracciamento delle modifiche al codice

Consulta Requisiti di sistema per informazioni dettagliate sulla compatibilità.

Installazione dell'estensione

Verdent for VS Code è distribuito tramite il Visual Studio Code Marketplace.

Visita il Marketplace

Vai alla pagina dell'estensione Verdent nel tuo browser.

Seleziona Install

Seleziona il pulsante Install nella pagina del marketplace.

Apri in VS Code

VS Code si aprirà automaticamente e avvierà il processo di installazione.

Apri VS Code

Avvia Visual Studio Code sul tuo computer.

Accedi alle estensioni

Seleziona l'icona Extensions nella barra laterale sinistra (icona con quattro quadrati) oppure premi:

macOS: Cmd+Shift+X
Windows/Linux: Ctrl+Shift+X

Cerca Verdent

Digita "Verdent" nella casella di ricerca in cima al pannello Extensions. Cerca "Verdent" di Verdent AI tra i risultati.

Installa

Seleziona il pulsante Install accanto all'estensione Verdent. L'installazione richiede in genere pochi secondi.

code --install-extension verdentai.verdent

Questo metodo è utile per:

Script di configurazione automatizzata
Installazioni su server remoti tramite SSH
Configurazione di ambienti CI/CD
Installazione rapida su più macchine

Se usi VS Code Settings Sync, Verdent verrà installato automaticamente sulle nuove macchine quando sincronizzi l'elenco delle estensioni.

Autenticazione e configurazione

Dopo l'installazione, dovrai autenticarti con il tuo account Verdent per iniziare a usare l'estensione.

Apri Verdent

Dopo l'installazione, seleziona l'icona Verdent nella barra laterale di VS Code. Vedrai le opzioni Sign In / Sign Up.

Accedi

Seleziona Sign In. VS Code mostrerà un popup con la domanda "Do you want Code to open the external website?" - seleziona Open.

Autenticazione nel browser

Il browser si aprirà sulla pagina di autenticazione di Verdent. Accedi con le credenziali del tuo account Verdent (email/password o provider OAuth come Google, GitHub, ecc.).

Autorizza VS Code

Concedi a VS Code l'accesso al tuo account Verdent quando richiesto.

Torna a VS Code

Torna a VS Code al termine dell'autenticazione. Il pannello Verdent mostrerà ora l'interfaccia di input.

Tempo totale: 2-3 minuti per l'installazione e la configurazione complete.

Configurazione iniziale (opzionale)

Verdent for VS Code è progettato per l'uso immediato dopo l'autenticazione, con una configurazione minima richiesta.

Impostazioni predefinite:

Modalità dei permessi: Auto-Run Mode (approvazione automatica per un funzionamento sicuro)
Preset del modello: Balance (mix ottimale di prestazioni e costi)
Gestione del contesto: automatica

Personalizzazione opzionale:

Puoi modificare queste impostazioni in un secondo momento tramite il pannello Verdent:

Modalità dei permessi - Scegli Manual Accept, Auto-Run, Plan Mode o Skip Permissions
Selezione del modello - Seleziona i preset Performance, Balance, Efficiency o modelli specifici
Impostazioni del workspace - Configura le preferenze specifiche del progetto

La maggior parte degli utenti può iniziare a usare Verdent subito dopo aver effettuato l'accesso, senza alcuna configurazione aggiuntiva. Le impostazioni avanzate possono essere modificate secondo necessità.

Verifica dell'installazione

Conferma che l'installazione funzioni correttamente con questi semplici controlli:

Verifica visiva

Icona nella barra laterale - Cerca l'icona Verdent nella barra laterale di VS Code (lato sinistro)
Elenco delle estensioni - Apri il pannello Extensions (Cmd+Shift+X / Ctrl+Shift+X) e verifica che "Verdent" risulti installato con un segno di spunta

Verifica funzionale

Apri il pannello Verdent

Seleziona l'icona Verdent nella barra laterale oppure premi Cmd+L (macOS) / Ctrl+L (Windows/Linux).

Invia un prompt di prova

Prova una richiesta semplice come "Spiega cosa contiene questo workspace" nella casella di input.

Ricevi una risposta

Verdent dovrebbe analizzare il tuo workspace e fornire una risposta in pochi secondi.

Indicatori di successo:

Icona Verdent visibile nella barra laterale
Account autenticato con successo
Possibilità di inviare prompt e ricevere risposte

Risoluzione dei problemi

Se la verifica non va a buon fine, prova queste soluzioni:

Problema	Soluzione
Icona nella barra laterale mancante	Riavvia VS Code o controlla la presenza di aggiornamenti dell'estensione
I prompt non rispondono	Controlla la connessione a Internet e le impostazioni del firewall
Estensione non trovata	Assicurati che la versione di VS Code sia 1.90.0 o superiore

Verdent richiede una connessione a Internet attiva. Se i prompt non rispondono, verifica la connettività di rete e che la configurazione del firewall consenta il traffico HTTPS in uscita verso gli endpoint API di Verdent.