Installazione
Guida passo passo all'installazione e configurazione di Verdent
Questa guida ti accompagna nel download di Verdent, nell'installazione specifica per la tua piattaforma e nell'autenticazione con il tuo account Verdent.
Requisiti
Prima di installare Verdent, assicurati che il tuo sistema soddisfi questi prerequisiti:
Requisiti di sistema
- Sistema operativo: macOS 11+ o Windows 10+ (64 bit). Consulta Sistemi operativi supportati per i dettagli completi sulla compatibilità.
- Git: Versione 2.20 o superiore. Verdent usa i worktree di Git per isolare i workspace. La cartella del tuo progetto non deve necessariamente essere un repository Git, ma alcune funzionalità richiedono Git e Verdent può guidarti a inizializzare un repo quando serve.
- macOS: Git viene fornito con gli Xcode Command Line Tools. Installalo con
xcode-select --install, oppure usa Homebrew:brew install git. - Windows: Scarica l'installer ufficiale da git-scm.com/download/win e accetta le opzioni predefinite.
- Verifica con
git --versionin un terminale.
- macOS: Git viene fornito con gli Xcode Command Line Tools. Installalo con
- Connessione a Internet: È richiesta una connessione attiva per la comunicazione con il servizio AI
Facoltativo ma consigliato
- Spazio su disco: Almeno 2 GB liberi (di più consigliato per repository di grandi dimensioni, worktree e caching)
Download
Scarica Verdent dal sito ufficiale:
Seleziona il tuo sistema operativo per scaricare l'installer appropriato.
Installazione su macOS
Download
Scarica il file .dmg da verdent.ai/download
Apri il DMG
Fai doppio clic sul file .dmg scaricato per montarlo
Installa
Trascina l'icona di Verdent nella cartella Applicazioni
Avvia
Apri Applicazioni e fai doppio clic su Verdent
Approvazione di sicurezza
Se richiesto, apri System Settings → Privacy & Security (macOS 13+) oppure System Preferences → Security & Privacy (macOS precedenti) e seleziona Open Anyway
Versioni di macOS supportate:
- macOS 11 (Big Sur) e successive
- Supporto per Intel e Apple Silicon
Installazione su Windows
Download
Scarica l'installer .exe da verdent.ai/download
Esegui l'installer
Fai doppio clic sul file .exe scaricato
Richiesta UAC
Seleziona Yes quando richiesto dal Controllo dell'account utente
Opzioni di installazione
Segui le istruzioni dell'installer (alcune build potrebbero non offrire una directory di installazione personalizzata)
Completa
Seleziona Install e attendi il completamento
Avvia
Seleziona Finish per avviare Verdent, oppure trovalo nel menu Start
Versioni di Windows supportate:
- Windows 10
- Windows 11
- Solo 64 bit
Autenticazione e configurazione
Dopo l'installazione, dovrai autenticarti con il tuo account Verdent per iniziare a usare l'applicazione.
Autenticazione iniziale
Avvia Verdent
Apri Verdent da Applicazioni (macOS) o dal menu Start (Windows). Compare la schermata di benvenuto.
Accedi
Seleziona Sign In. Il browser si aprirà sulla pagina di autenticazione di Verdent.
Autenticazione nel browser
Accedi con le credenziali del tuo account Verdent (email/password o provider OAuth come Google, GitHub, ecc.).
Torna all'app
Torna a Verdent al termine dell'autenticazione. Vedrai l'interfaccia principale.
Apri un progetto
Scegli Open Project per selezionare una directory, oppure Recent Projects se stai tornando.
Verifica dell'installazione
Conferma che l'installazione funzioni correttamente con questi semplici controlli:
Verifica visiva
- Icona dell'applicazione - Verdent compare in Applicazioni (macOS) o nel menu Start (Windows)
- Accesso effettuato - Dopo l'autenticazione puoi vedere lo stato del tuo account nell'app (ad esempio avatar/email)
Verifica funzionale
Apri un progetto
Apri una directory in Verdent.
Invia un prompt di prova
Prova una richiesta semplice come "Spiega cosa contiene questo progetto" nella casella di input.
Ricevi una risposta
Verdent dovrebbe analizzare il tuo progetto e fornire una risposta a breve.
Indicatori di successo:
- Verdent si avvia senza errori
- Account autenticato correttamente
- Puoi inviare prompt e ricevere risposte
Verdent richiede una connessione Internet attiva per le funzionalità AI. Se i prompt non ricevono risposta, verifica la connettività di rete e assicurati che il firewall consenta le connessioni HTTPS in uscita verso gli endpoint API di Verdent.
Risoluzione dei problemi di installazione
Problema: "Verdent cannot be opened because it is from an unidentified developer"
Soluzione:
- Apri System Settings → Privacy & Security (macOS 13+) oppure System Preferences → Security & Privacy (macOS precedenti)
- Trova il messaggio di avviso relativo a Verdent
- Seleziona Open Anyway
- Conferma selezionando Open
Problema: Windows Defender blocca l'installazione
Soluzione:
- Seleziona More info nel popup di SmartScreen
- Se hai scaricato Verdent dal sito ufficiale e ti fidi della fonte, seleziona Run anyway
- Prosegui con l'installazione
Domande frequenti
Posso installare Verdent insieme all'estensione VS Code?
Sì. Verdent e l'estensione VS Code sono applicazioni indipendenti. Puoi usarle entrambe e condividono lo stesso pool di crediti e lo stesso account.
Come aggiorno Verdent?
Verdent controlla automaticamente la disponibilità di aggiornamenti all'avvio. Quando è disponibile un aggiornamento:
- Compare una notifica
- Seleziona Update per scaricare e installare
- Riavvia l'applicazione
Puoi anche controllare manualmente dal menu dell'app (ad esempio: Help → Check for Updates).
Come disinstallo Verdent?
macOS: Trascina Verdent da Applicazioni nel Cestino
Windows: Usa Settings → Apps → Verdent → Uninstall oppure Control Panel → Programs and Features