# Requisiti di sistema e compatibilità (/it/docs/verdent-for-vscode/getting-started/system-requirements)

> Piattaforme supportate, versioni degli IDE e requisiti di rete



Verdent for VS Code è un'estensione nativa di Visual Studio Code che eredita la compatibilità multipiattaforma di Visual Studio Code senza richiedere installazioni o configurazioni separate per i diversi sistemi operativi.

***

## Sistemi operativi supportati [#sistemi-operativi-supportati]

Verdent for VS Code supporta tutti i sistemi operativi su cui è disponibile Visual Studio Code:

| Sistema operativo | Versioni supportate                                                                            | Architettura          |
| ----------------- | ---------------------------------------------------------------------------------------------- | --------------------- |
| **macOS**         | macOS 11 (Big Sur) e successivi                                                                | Intel e Apple Silicon |
| **Windows**       | Windows 10 (versione 1607+), Windows 11, Windows Server 2016+                                  | Solo a 64 bit         |
| **Linux**         | Ubuntu 20.04+, Debian 10+, Red Hat Enterprise Linux 8+, Fedora, CentOS 8+, openSUSE Leap 15.2+ | x64 e ARM64           |

<Note>
  **Piattaforme deprecate**: il supporto per macOS 10.15 (Catalina) è terminato con Visual Studio Code 1.98 (febbraio 2025). Windows 7 e 8/8.1 non sono più supportati a partire da Visual Studio Code 1.70 (luglio 2022). I sistemi Windows a 32 bit non sono più supportati a partire da Visual Studio Code 1.83 (settembre 2023).
</Note>

### Requisiti per Linux [#requisiti-per-linux]

Per i sistemi Linux, assicurati che la tua distribuzione soddisfi questi requisiti:

* **glibc 2.28 o successiva** (a partire da Visual Studio Code 1.86.1, gennaio 2024)
* **GLIBCXX versione 3.4.25 o successiva**

***

## Versioni di IDE/editor richieste [#versioni-di-ideeditor-richieste]

**Visual Studio Code:**

* È richiesta la versione **1.90.0 o superiore**
* Per la migliore compatibilità è consigliata l'ultima versione stabile

Verdent for VS Code funziona con Visual Studio Code e con gli editor basati su Visual Studio Code (Cursor, VSCodium). Non supporta editor come gli IDE JetBrains, Sublime Text o Vim.

***

## Requisiti hardware [#requisiti-hardware]

### Requisiti minimi [#requisiti-minimi]

| Componente          | Specifica                                                    |
| ------------------- | ------------------------------------------------------------ |
| **RAM**             | 1 GB (4 GB+ consigliati per progetti più grandi)             |
| **Spazio su disco** | \< 500 MB per Visual Studio Code + estensione Verdent        |
| **CPU**             | Qualsiasi processore in grado di eseguire Visual Studio Code |

### Specifiche consigliate [#specifiche-consigliate]

Per prestazioni ottimali, soprattutto quando lavori con codebase di grandi dimensioni o flussi di lavoro multi-agente:

* **RAM**: 8 GB o più
* **CPU**: processore multi-core per l'esecuzione concorrente dei sottoagenti
* **Spazio su disco**: 1 GB+ per la memorizzazione nella cache e l'indicizzazione (se abilitati)

<Tip>
  Le prestazioni migliorano in base alle capacità dell'hardware. I flussi di lavoro multi-agente e il refactoring su larga scala traggono vantaggio da RAM e potenza di elaborazione aggiuntive.
</Tip>

<Warning>
  Le specifiche consigliate sono linee guida generali. Le raccomandazioni hardware ufficiali per le funzionalità specifiche di Verdent (flussi di lavoro multi-agente, cache, indicizzazione) sono in attesa da parte del team di Verdent.
</Warning>

***

## Requisiti di rete [#requisiti-di-rete]

Verdent for VS Code richiede una **connessione a Internet attiva in ogni momento** per funzionare.

### Requisiti di connettività [#requisiti-di-connettività]

* **Tipo di connessione**: connessione Internet a banda larga stabile
* **Protocollo**: connessioni HTTPS in uscita verso gli endpoint API di Verdent
* **Larghezza di banda**: sufficiente per la trasmissione del contesto del codice e lo streaming delle risposte AI

### Considerazioni su firewall e proxy [#considerazioni-su-firewall-e-proxy]

Per gli ambienti aziendali o gli utenti dietro firewall:

**Accesso richiesto:**

* Traffico HTTPS in uscita verso i domini API di Verdent
* Verdent gestisce l'instradamento verso più fornitori di modelli (Claude, GPT-5, Gemini, MiniMax, ecc.)
* Non sono necessarie regole firewall in entrata né port forwarding

**Configurazione aziendale:**

* I firewall aziendali devono consentire il traffico HTTPS in uscita verso gli endpoint di servizio Verdent
* I server proxy dovrebbero lasciar passare le richieste API
* L'ispezione SSL/TLS potrebbe richiedere eccezioni per gli endpoint Verdent

<Warning>
  Senza connettività a Internet, Verdent for VS Code non può elaborare le richieste né fornire alcuna funzionalità assistita dall'AI. L'estensione non funziona offline.
</Warning>

***

## Domande frequenti [#domande-frequenti]

<Accordion title="Come faccio a controllare la versione di Visual Studio Code?">
  Apri Visual Studio Code e vai su **Help** → **About** (oppure **Code** → **About Visual Studio Code** su macOS). Il numero di versione è visualizzato nella finestra di dialogo. Verdent richiede la versione 1.90.0 o superiore di Visual Studio Code.

  Puoi controllare anche da riga di comando:

  ```bash
  code --version
  ```
</Accordion>

<Accordion title="Come faccio a verificare che il mio sistema Linux soddisfi i requisiti?">
  Controlla le versioni di glibc e GLIBCXX usando questi comandi:

  ```bash
  # Check glibc version (need 2.28 or later)
  ldd --version

  # Check GLIBCXX version (need 3.4.25 or later)
  strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX
  ```

  Se la tua distribuzione non soddisfa questi requisiti, potrebbe essere necessario aggiornare a una versione più recente della tua distribuzione Linux.
</Accordion>

<Accordion title="Come faccio a risolvere i problemi di firewall o di connessione?">
  Se Verdent non riesce a connettersi ai servizi AI, controlla questi problemi comuni:

  **Verifica la connettività di base:**

  * Verifica di avere un accesso a Internet attivo
  * Prova ad accedere ad altri servizi HTTPS per confermare che le connessioni in uscita funzionino

  **Ambienti aziendali:**

  * Contatta l'amministratore di rete per inserire nella whitelist gli endpoint API di Verdent
  * Assicurati che il traffico HTTPS in uscita sia consentito attraverso il firewall
  * Controlla se i server proxy sono configurati correttamente per lasciar passare le richieste API
  * L'ispezione SSL/TLS potrebbe richiedere eccezioni per gli endpoint Verdent

  **Sintomi comuni:**

  * L'estensione sembra bloccarsi o va in timeout
  * Errori di autenticazione nonostante le credenziali corrette

  Se i problemi persistono dopo la configurazione del firewall, contatta l'assistenza Verdent per i dettagli specifici sugli endpoint da inserire nella whitelist.
</Accordion>

***

## Vedi anche [#vedi-anche]

<CardGroup cols="2">
  <Card title="Installazione" icon="download" href="/docs/verdent-for-vscode/getting-started/installation">
    Installa Verdent dopo aver verificato i requisiti di sistema
  </Card>

  <Card title="Risoluzione dei problemi" icon="wrench" href="/docs/verdent-for-vscode/help-support/common-issues">
    Risolvi i problemi comuni di installazione e connessione
  </Card>
</CardGroup>