# Installazione (/it/docs/verdent-manager/getting-started/installation)

> 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 [#requisiti]

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

### Requisiti di sistema [#requisiti-di-sistema]

* **Sistema operativo**: macOS 11+ o Windows 10+ (64 bit). Consulta [Sistemi operativi supportati](/docs/verdent-manager/getting-started/supported-operating-systems) 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](https://git-scm.com/download/win) e accetta le opzioni predefinite.
  * Verifica con `git --version` in un terminale.
* **Connessione a Internet**: È richiesta una connessione attiva per la comunicazione con il servizio AI

### Facoltativo ma consigliato [#facoltativo-ma-consigliato]

* **Spazio su disco**: Almeno 2 GB liberi (di più consigliato per repository di grandi dimensioni, worktree e caching)

***

## Download [#download]

Scarica Verdent dal sito ufficiale:

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

Seleziona il tuo sistema operativo per scaricare l'installer appropriato.

***

## Installazione su macOS [#installazione-su-macos]

<Steps>
  <Step title="Download">
    Scarica il file `.dmg` da [verdent.ai/download](https://verdent.ai/download)
  </Step>

  <Step title="Apri il DMG">
    Fai doppio clic sul file `.dmg` scaricato per montarlo
  </Step>

  <Step title="Installa">
    Trascina l'icona di Verdent nella cartella Applicazioni
  </Step>

  <Step title="Avvia">
    Apri Applicazioni e fai doppio clic su Verdent
  </Step>

  <Step title="Approvazione di sicurezza">
    Se richiesto, apri **System Settings → Privacy & Security** (macOS 13+) oppure **System Preferences → Security & Privacy** (macOS precedenti) e seleziona **Open Anyway**
  </Step>
</Steps>

**Versioni di macOS supportate:**

* macOS 11 (Big Sur) e successive
* Supporto per Intel e Apple Silicon

***

## Installazione su Windows [#installazione-su-windows]

<Steps>
  <Step title="Download">
    Scarica l'installer `.exe` da [verdent.ai/download](https://verdent.ai/download)
  </Step>

  <Step title="Esegui l'installer">
    Fai doppio clic sul file `.exe` scaricato
  </Step>

  <Step title="Richiesta UAC">
    Seleziona **Yes** quando richiesto dal Controllo dell'account utente
  </Step>

  <Step title="Opzioni di installazione">
    Segui le istruzioni dell'installer (alcune build potrebbero non offrire una directory di installazione personalizzata)
  </Step>

  <Step title="Completa">
    Seleziona **Install** e attendi il completamento
  </Step>

  <Step title="Avvia">
    Seleziona **Finish** per avviare Verdent, oppure trovalo nel menu Start
  </Step>
</Steps>

**Versioni di Windows supportate:**

* Windows 10
* Windows 11
* Solo 64 bit

***

## Autenticazione e configurazione [#autenticazione-e-configurazione]

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

### Autenticazione iniziale [#autenticazione-iniziale]

<Steps>
  <Step title="Avvia Verdent">
    Apri Verdent da Applicazioni (macOS) o dal menu Start (Windows). Compare la schermata di benvenuto.
  </Step>

  <Step title="Accedi">
    Seleziona **Sign In**. Il browser si aprirà sulla pagina di autenticazione di Verdent.
  </Step>

  <Step title="Autenticazione nel browser">
    Accedi con le credenziali del tuo account Verdent (email/password o provider OAuth come Google, GitHub, ecc.).
  </Step>

  <Step title="Torna all'app">
    Torna a Verdent al termine dell'autenticazione. Vedrai l'interfaccia principale.
  </Step>

  <Step title="Apri un progetto">
    Scegli **Open Project** per selezionare una directory, oppure **Recent Projects** se stai tornando.
  </Step>
</Steps>

***

## Verifica dell'installazione [#verifica-dellinstallazione]

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

### Verifica visiva [#verifica-visiva]

1. **Icona dell'applicazione** - Verdent compare in Applicazioni (macOS) o nel menu Start (Windows)
2. **Accesso effettuato** - Dopo l'autenticazione puoi vedere lo stato del tuo account nell'app (ad esempio avatar/email)

### Verifica funzionale [#verifica-funzionale]

<Steps>
  <Step title="Apri un progetto">
    Apri una directory in Verdent.
  </Step>

  <Step title="Invia un prompt di prova">
    Prova una richiesta semplice come "Spiega cosa contiene questo progetto" nella casella di input.
  </Step>

  <Step title="Ricevi una risposta">
    Verdent dovrebbe analizzare il tuo progetto e fornire una risposta a breve.
  </Step>
</Steps>

**Indicatori di successo:**

* Verdent si avvia senza errori
* Account autenticato correttamente
* Puoi inviare prompt e ricevere risposte

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

***

## Risoluzione dei problemi di installazione [#risoluzione-dei-problemi-di-installazione]

<Tabs>
  <Tab title="Sicurezza macOS">
    **Problema:** "Verdent cannot be opened because it is from an unidentified developer"

    **Soluzione:**

    1. Apri **System Settings → Privacy & Security** (macOS 13+) oppure **System Preferences → Security & Privacy** (macOS precedenti)
    2. Trova il messaggio di avviso relativo a Verdent
    3. Seleziona **Open Anyway**
    4. Conferma selezionando **Open**
  </Tab>

  <Tab title="Windows Defender">
    **Problema:** Windows Defender blocca l'installazione

    **Soluzione:**

    1. Seleziona **More info** nel popup di SmartScreen
    2. Se hai scaricato Verdent dal sito ufficiale e ti fidi della fonte, seleziona **Run anyway**
    3. Prosegui con l'installazione
  </Tab>
</Tabs>

***

## Domande frequenti [#domande-frequenti]

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="Come aggiorno Verdent?">
    Verdent controlla automaticamente la disponibilità di aggiornamenti all'avvio. Quando è disponibile un aggiornamento:

    1. Compare una notifica
    2. Seleziona **Update** per scaricare e installare
    3. Riavvia l'applicazione

    Puoi anche controllare manualmente dal menu dell'app (ad esempio: **Help → Check for Updates**).
  </Accordion>

  <Accordion title="Come disinstallo Verdent?">
    **macOS:** Trascina Verdent da Applicazioni nel Cestino

    **Windows:** Usa **Settings → Apps → Verdent → Uninstall** oppure **Control Panel → Programs and Features**
  </Accordion>
</AccordionGroup>

***

## Prossimi passi [#prossimi-passi]

<CardGroup cols="2">
  <Card title="Avvio rapido" icon="rocket" href="/docs/verdent-manager/getting-started/quick-start">
    Aggiungi il tuo primo progetto e assegna un'attività
  </Card>

  <Card title="Manager" icon="user-tie" href="/docs/verdent-manager/core-features/manager">
    Scopri come Manager pianifica, distribuisce e monitora il lavoro
  </Card>
</CardGroup>