# Guida rapida (/it/docs/verdent-for-vscode/getting-started/quick-start) > Inizia a usare Verdent in pochi minuti Questa guida rapida ti permetterà di usare il flusso di lavoro Plan-Verify-Code di Verdent in meno di 15 minuti. Installerai l'estensione, completerai la tua prima attività e capirai il flusso di lavoro di base quando lavori con Verdent for VS Code. ### Cosa imparerai [#cosa-imparerai] * Installare Verdent for VS Code dal marketplace * Autenticarti e verificare la configurazione * Completare la tua prima attività assistita dall'AI * Comprendere le modalità di esecuzione (Manual Accept, Auto-Run, Plan Mode) * Usare le funzionalità essenziali per la programmazione quotidiana ### Prerequisiti [#prerequisiti] Prima di iniziare, assicurati di avere: * Visual Studio Code installato sul tuo sistema * Una connessione a internet attiva * Un account con abbonamento Verdent (oppure inizia con la prova gratuita di 7 giorni) *** ## Passo 1: installa Verdent [#passo-1-installa-verdent] Visita la [pagina dell'estensione Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) e seleziona **Install**. 1. Apri Visual Studio Code 2. Premi `Ctrl+Shift+X` (o `Cmd+Shift+X` su macOS) 3. Cerca "Verdent" 4. Seleziona **Install** ```bash code --install-extension verdentai.verdent ``` *** ## Passo 2: inizia a usare Verdent [#passo-2-inizia-a-usare-verdent] Apri Visual Studio Code nella cartella del tuo progetto. Seleziona l'icona Verdent nella barra laterale o premi `Ctrl+L` (Windows/Linux) / `Cmd+L` (macOS). Accedi quando richiesto per autenticarti con il tuo account Verdent. *** ## Passo 3: la tua prima attività [#passo-3-la-tua-prima-attività] Iniziamo con un'attività semplice e non distruttiva che mostra la comprensione del tuo workspace da parte di Verdent. **Apri un progetto in VS Code**, poi prova uno di questi prompt nella casella di input di Verdent: ``` What kind of project is this? ``` Verdent analizzerà la struttura del tuo workspace, leggerà i file principali e spiegherà su che tipo di applicazione stai lavorando. Questo dimostra la consapevolezza del contesto senza apportare alcuna modifica. **Dovresti vedere:** * Verdent analizzare i file nel tuo workspace * Un riepilogo del tipo di progetto, delle tecnologie e della struttura * Nessuna modifica ai file (analisi in sola lettura) **Prova questi prompt di approfondimento:** ``` Explain what this project does ``` ``` What dependencies does this project have? ``` ``` Show me the main entry point of this application ``` Ogni prompt ti aiuta a verificare che Verdent possa accedere al tuo workspace e comprenda la tua codebase. Questi prompt esplorativi sono perfetti per comprendere codebase sconosciute. Verdent legge i file quando necessario, senza richiederti di aggiungere manualmente il contesto. *** ## Passo 4: la tua prima modifica al codice [#passo-4-la-tua-prima-modifica-al-codice] Ora facciamo creare qualcosa a Verdent. Prova questa attività semplice: ``` Create a hello_world.txt file with a greeting message ``` **Cosa succede:** 1. **Verdent propone la modifica**Vedrai un'anteprima che mostra il file da creare e il suo contenuto 2. **Richiesta di autorizzazione** In Auto Run Mode (l'impostazione predefinita), Verdent approverà automaticamente la creazione del file 3. **Approvi la modifica** Seleziona "Accept" o approva la modifica 4. **File creato**Verdent crea il file e conferma il completamento **Comprendere le autorizzazioni:** Manual Accept Mode garantisce che nessuna modifica indesiderata avvenga senza la tua approvazione. Vedrai richieste di autorizzazione per: * Modifiche e creazioni di file * Esecuzione di comandi * Uso di strumenti (primo utilizzo di ciascun tipo di strumento) Questo ti dà pieno controllo e ti aiuta a capire quali operazioni esegue Verdent per le diverse attività. Manual Accept Mode è il punto di partenza consigliato per i nuovi utenti. Una volta acquisita dimestichezza, puoi passare a Auto-Run Mode o Plan Mode per flussi di lavoro diversi. *** ## Passo 5: usare Plan Mode per attività complesse [#passo-5-usare-plan-mode-per-attività-complesse] Plan Mode è la modalità di pianificazione in sola lettura di Verdent, in cui puoi rivedere gli approcci prima dell'esecuzione. Proviamola: **Passa a Plan Mode:** Seleziona il pulsante **Switch Mode** nella casella di input e scegli **Plan Mode** **Prova un'attività di pianificazione:** ``` Suggest ways to build a website for my project ``` **Cosa succede:** 1. **Verdent analizza il tuo progetto**Legge i file e comprende la struttura e i requisiti del progetto 2. **Crea un piano dettagliato**Mostra quali tecnologie usare, quali pagine creare e come strutturare il sito web 3. **Nessuna modifica**Plan Mode è in sola lettura. Verdent non può modificare i file finché non lo approvi esplicitamente 4. **Chiarimenti interattivi**Verdent può porre domande su preferenze di design, pubblico di riferimento o funzionalità prima di finalizzare il piano **Perché usare Plan Mode:** * **Esplorazione sicura** - Comprendi codebase sconosciute senza modifiche accidentali * **Revisione del codice** - Analizza qualità e architettura prima di apportare modifiche * **Pianificazione strategica** - Scomponi attività complesse in passaggi rivedibili * **Riduzione dell'incertezza** - Verdent pone domande di chiarimento per eliminare le ambiguità Usa Plan Mode per qualsiasi attività in cui vuoi rivedere l'approccio prima di procedere con l'esecuzione. È particolarmente utile quando vuoi capire come Verdent ragiona sulla tua codebase. **Per eseguire il piano:** Dopo aver rivisto il piano, Verdent presenta due opzioni: * Scegli **Edit** per richiedere modifiche o porre domande di chiarimento * Scegli **Start Building** per passare a Agent Mode e avviare l'esecuzione *** ## Passo 6: comprendere le modalità di esecuzione [#passo-6-comprendere-le-modalità-di-esecuzione] Verdent offre diverse modalità di esecuzione per adattarsi a flussi di lavoro differenti: **Modalità di autorizzazione:** | Modalità | Descrizione | Quando usarla | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | **Manual Accept** | Richiede l'autorizzazione al primo utilizzo di ciascuno strumento | Apprendimento e sviluppo generale con il massimo controllo | | **Auto-Run**(predefinita) | Accetta automaticamente le operazioni sicure (lettura di file, ricerche web); le modifiche ai file e i comandi richiedono comunque l'approvazione | Progetti affidabili e prototipazione rapida | | **Plan Mode** | Modalità in sola lettura per analisi e pianificazione senza modifiche ai file | Attività complesse e revisione del codice | | **Skip Permissions** | Funzionamento completamente autonomo che ignora tutte le richieste | Ambienti isolati e sicuri come test automatizzati o sandbox | **Modalità aggiuntiva:** * **Think Hard Mode** - Budget di ragionamento massimo per ragionamenti complessi e decisioni architetturali Skip Permissions Mode rimuove tutti i controlli di sicurezza. Usalo solo in ambienti isolati e usa e getta, in cui gli errori non hanno conseguenze. *** ## Azioni essenziali [#azioni-essenziali] Ecco le azioni principali che userai quotidianamente in Verdent for VS Code: | Azione | Come accedervi | Descrizione | | --------------------- | ----------------------------------------------------------- | --------------------------------------------------------- | | Apri Verdent | `Cmd+L` / `Ctrl+L` o seleziona l'icona nella barra laterale | Apre il pannello Verdent | | Nuova sessione | Seleziona "New Session" nella barra superiore | Avvia una nuova conversazione con contesto pulito | | Aggiungi contesto | Seleziona il pulsante "Add Context" | Fai riferimento ai file con le @-menzioni | | Aggiungi immagini | Seleziona il pulsante "Add Images or Files" | Carica screenshot, mockup o diagrammi | | Cambia modalità | Seleziona il pulsante "Switch Mode" | Alterna le modalità Agent/Plan/Chat | | Cambia modello | Seleziona il selettore del modello | Scegli i preset Performance/Balance/Efficiency | | Think Hard | Seleziona il pulsante "Think Hard Mode" | Abilita il ragionamento esteso per attività complesse | | Cambia autorizzazioni | Seleziona il pulsante "Switch Permission" | Cambia la modalità di autorizzazione | | Visualizza cronologia | Seleziona "Project History" nella barra superiore | Sfoglia le sessioni passate | | Centro utenti | Seleziona "User Center" nella barra superiore | Controlla il saldo crediti e le informazioni dell'account | | Impostazioni | Seleziona "Settings" nella barra superiore | Configura server MCP, sottoagenti, regole | *** ## Suggerimenti per principianti [#suggerimenti-per-principianti] Prima di apportare modifiche, lascia che Verdent comprenda la tua codebase: ``` Analyze the database schema ``` ``` Explain the authentication flow ``` Questo costruisce il contesto di Verdent sul tuo progetto e lo aiuta a fornire suggerimenti migliori. Invece di: "correggi il bug" Prova: "correggi il bug di login in `LoginForm.tsx` dove gli utenti vedono una schermata vuota dopo aver inserito credenziali errate" I prompt specifici portano a soluzioni più accurate e a meno iterazioni. Quando lavori con codice che non comprendi appieno, usa prima Plan Mode: ``` Refactor the authentication module to use async/await instead of callbacks ``` Rivedi il piano, scegli **Edit** per porre domande di chiarimento e affinare, poi scegli **Start Building** quando sei sicuro. Per funzionalità in più passaggi, procedi in modo incrementale: ``` 1. Create a new database table for user profiles ``` Poi, al completamento: ``` 2. Create an API endpoint to get and update profiles ``` Questo mantiene la chiarezza e ti permette di verificare ogni passaggio. Fai riferimento esplicito ai file quando necessario: ``` @components/UserProfile.tsx refactor this component to use hooks ``` In questo modo Verdent si concentra sul contesto giusto per la tua attività. Verdent include tre sottoagenti integrati: * `@Explorer` - Esplorazione rapida della codebase e ricerca dei file * `@Verifier` - Convalida e controlli rapidi del codice * `@Code-reviewer` - Revisione completa di sicurezza e qualità Esempio: ``` @Explorer find all API endpoints in this project ``` *** ## Problemi comuni [#problemi-comuni] **Soluzione:** Riavvia VS Code. Se manca ancora, verifica l'installazione nel pannello delle estensioni (`Cmd+Shift+X` / `Ctrl+Shift+X`) e conferma che "Verdent" compaia nell'elenco. **Soluzione:** 1. Verifica che la connessione a internet sia attiva 2. Controlla che le impostazioni di firewall/proxy consentano HTTPS verso i servizi Verdent 3. Conferma di avere crediti residui nel Centro utenti 4. Prova un prompt più semplice per testare la connettività **Soluzione:** Passa a Auto-Run Mode usando il pulsante "Switch Permission". Questo approva automaticamente le operazioni di lettura sicure, chiedendo comunque l'approvazione per le modifiche ai file e i comandi. *** ## Ottenere aiuto [#ottenere-aiuto] * **Community Discord**: [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq) - Community attiva con supporto in tempo reale * **Documentazione**: Sfoglia le altre guide in questa documentazione * **Feedback**: Usa il pulsante Feedback nella barra superiore di Verdent per segnalare problemi o suggerire miglioramenti *** ## Domande frequenti [#domande-frequenti] Guarda la casella di input in fondo al pannello Verdent. Il pulsante "Switch Permission" mostra la modalità attuale (ad es. "Manual", "Auto", "Plan"). Puoi selezionarlo per cambiare modalità. Le richieste standard basate sui crediti si interrompono quando il saldo raggiunge lo zero. Attendi il rinnovo del prossimo ciclo di fatturazione oppure acquista una ricarica di crediti una tantum per continuare. Sì, ogni finestra VS Code funziona in modo indipendente. Puoi avere Verdent aperto in più progetti, e ciascuno mantiene il proprio contesto di conversazione separato. Seleziona il pulsante "New Session" nella barra superiore. Questo cancella la cronologia della conversazione attuale e offre a Verdent una nuova finestra di contesto per la tua prossima attività. *** ## Prossimi passi [#prossimi-passi] Hai installato Verdent, completato la tua prima attività e appreso il flusso di lavoro di base. Ecco dove proseguire: Comprendi i sottoagenti, l'architettura multi-agente e la gestione del contesto Guide passo passo per attività in più passaggi, codebase di grandi dimensioni e controllo di versione