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

> Guida passo passo per installare e configurare Verdent



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

***

## Requisiti [#requisiti]

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

### Requisiti di sistema [#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 [#opzionali-ma-consigliati]

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

Consulta [Requisiti di sistema](/docs/verdent-for-vscode/getting-started/system-requirements) per informazioni dettagliate sulla compatibilità.

***

## Installazione dell'estensione [#installazione-dellestensione]

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

<Tabs>
  <Tab title="VS Code Marketplace">
    <Steps>
      <Step title="Visita il Marketplace">
        Vai alla [pagina dell'estensione Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) nel tuo browser.
      </Step>

      <Step title="Seleziona Install">
        Seleziona il pulsante **Install** nella pagina del marketplace.
      </Step>

      <Step title="Apri in VS Code">
        VS Code si aprirà automaticamente e avvierà il processo di installazione.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Pannello delle estensioni">
    <Steps>
      <Step title="Apri VS Code">
        Avvia Visual Studio Code sul tuo computer.
      </Step>

      <Step title="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`
      </Step>

      <Step title="Cerca Verdent">
        Digita "Verdent" nella casella di ricerca in cima al pannello Extensions. Cerca "Verdent" di Verdent AI tra i risultati.
      </Step>

      <Step title="Installa">
        Seleziona il pulsante **Install** accanto all'estensione Verdent. L'installazione richiede in genere pochi secondi.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Riga di comando">
    ```bash
    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
  </Tab>
</Tabs>

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

***

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

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

### Autenticazione iniziale [#autenticazione-iniziale]

<Steps>
  <Step title="Apri Verdent">
    Dopo l'installazione, seleziona l'icona Verdent nella barra laterale di VS Code. Vedrai le opzioni Sign In / Sign Up.
  </Step>

  <Step title="Accedi">
    Seleziona **Sign In**. VS Code mostrerà un popup con la domanda "Do you want Code to open the external website?" - seleziona **Open**.
  </Step>

  <Step title="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.).
  </Step>

  <Step title="Autorizza VS Code">
    Concedi a VS Code l'accesso al tuo account Verdent quando richiesto.
  </Step>

  <Step title="Torna a VS Code">
    Torna a VS Code al termine dell'autenticazione. Il pannello Verdent mostrerà ora l'interfaccia di input.
  </Step>
</Steps>

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

### Configurazione iniziale (opzionale) [#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

<Note>
  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à.
</Note>

***

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

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

### Verifica visiva [#verifica-visiva]

1. **Icona nella barra laterale** - Cerca l'icona Verdent nella barra laterale di VS Code (lato sinistro)
2. **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 [#verifica-funzionale]

<Steps>
  <Step title="Apri il pannello Verdent">
    Seleziona l'icona Verdent nella barra laterale oppure premi `Cmd+L` (macOS) / `Ctrl+L` (Windows/Linux).
  </Step>

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

  <Step title="Ricevi una risposta">
    Verdent dovrebbe analizzare il tuo workspace e fornire una risposta in pochi secondi.
  </Step>
</Steps>

**Indicatori di successo:**

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

### Risoluzione dei problemi [#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             |

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

***

## Passaggi successivi [#passaggi-successivi]

<CardGroup cols="2">
  <Card title="Avvio rapido" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    Completa la tua prima attività con Verdent in 5 minuti
  </Card>

  <Card title="Concetti fondamentali" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    Comprendi i sottoagenti, le modalità di esecuzione e l'architettura multi-agente
  </Card>
</CardGroup>