Guida rapida

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

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

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

Visita la pagina dell'estensione Verdent e seleziona Install.

Apri Visual Studio Code
Premi Ctrl+Shift+X (o Cmd+Shift+X su macOS)
Cerca "Verdent"
Seleziona Install

code --install-extension verdentai.verdent

Passo 2: inizia a usare Verdent

Apri Visual Studio Code

Apri Visual Studio Code nella cartella del tuo progetto.

Accedi a Verdent

Seleziona l'icona Verdent nella barra laterale o premi Ctrl+L (Windows/Linux) / Cmd+L (macOS).

Accedi

Accedi quando richiesto per autenticarti con il tuo account Verdent.

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

Ora facciamo creare qualcosa a Verdent. Prova questa attività semplice:

Create a hello_world.txt file with a greeting message

Cosa succede:

Verdent propone la modificaVedrai un'anteprima che mostra il file da creare e il suo contenuto
Richiesta di autorizzazione In Auto Run Mode (l'impostazione predefinita), Verdent approverà automaticamente la creazione del file
Approvi la modifica Seleziona "Accept" o approva la modifica
File creatoVerdent 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

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:

Verdent analizza il tuo progettoLegge i file e comprende la struttura e i requisiti del progetto
Crea un piano dettagliatoMostra quali tecnologie usare, quali pagine creare e come strutturare il sito web
Nessuna modificaPlan Mode è in sola lettura. Verdent non può modificare i file finché non lo approvi esplicitamente
Chiarimenti interattiviVerdent 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

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

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

Inizia con prompt esplorativi

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.

Sii specifico nelle tue richieste

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.

Usa Plan Mode per codice sconosciuto

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.

Scomponi le attività complesse in passaggi

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.

Sfrutta le @-menzioni per il contesto

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

Usa i sottoagenti per attività specializzate

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

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:

Verifica che la connessione a internet sia attiva
Controlla che le impostazioni di firewall/proxy consentano HTTPS verso i servizi Verdent
Conferma di avere crediti residui nel Centro utenti
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

Community Discord: 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

Come faccio a sapere in quale modalità di esecuzione mi trovo?

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

Cosa succede se esaurisco i crediti?

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.

Posso usare Verdent in più progetti contemporaneamente?

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.

Come avvio una nuova conversazione con contesto pulito?

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