Domande frequenti

Causa più comune: problema di configurazione del proxy

Soluzione:

1. Apri le impostazioni di VS Code (Cmd+, su macOS oppure Ctrl+, su Windows/Linux)
2. Cerca "useProxy" o "verdent.enableProxy"
3. Attiva/disattiva l'impostazione del proxy (l'opposto dello stato attuale)
4. Prova di nuovo ad accedere

Spiegazione: se sei dietro un firewall aziendale, potresti dover attivare l'impostazione del proxy. Se sei su una rete domestica, prova a disattivarla.

Errore: i crediti della prova gratuita non sono stati ricevuti o l'accesso alla prova gratuita è stato negato

Motivo: durante la registrazione è stata rilevata una violazione dei termini di servizio

Soluzione: contatta support@verdent.ai per ricevere assistenza sull'accesso alla prova gratuita. Il team di supporto esaminerà il tuo account e ti aiuterà a risolvere il problema.

Errore: la registrazione dell'account è stata rifiutata o limitata

Motivo: la registrazione ha violato i termini di servizio di Verdent, con conseguente restrizione dell'accesso

Soluzione: contatta support@verdent.ai per ricevere assistenza. Il team di supporto può esaminare la tua registrazione e fornirti indicazioni su come risolvere il problema.

Problema: non riesci a trovare alcuni modelli AI nel menu di selezione dei modelli

Motivo: restrizioni basate sulla posizione geografica imposte dai provider dei modelli

Spiegazione: alcuni provider di modelli AI (Anthropic, OpenAI, Google) applicano restrizioni regionali che impediscono la disponibilità di determinati modelli in specifiche aree geografiche. In questi casi:

• I modelli soggetti a restrizioni non compaiono nel menu di selezione dei modelli
• Puoi comunque utilizzare tutti gli altri modelli disponibili senza interruzioni
• Nessun impatto sul tuo abbonamento o sui tuoi crediti

Controlla i modelli disponibili: visita https://www.verdent.ai/regions per vedere quali modelli sono disponibili nella tua regione

Nota: le restrizioni regionali sono stabilite dai provider dei modelli AI, non da Verdent. Verdent non può ignorare queste restrizioni.

Visual Studio Code è un editor di codice gratuito e open source sviluppato da Microsoft. È un ambiente di sviluppo leggero ma potente che supporta numerosi linguaggi di programmazione e offre funzionalità come debug, evidenziazione della sintassi, completamento intelligente del codice e controllo di versione integrato. Verdent si integra direttamente in Visual Studio Code come estensione, aggiungendo funzionalità di programmazione basate sull'AI al tuo flusso di lavoro esistente.

Verdent è un'estensione di assistente di programmazione AI per Visual Studio Code che aiuta con la generazione di codice, il refactoring, il debug e la navigazione del progetto tramite conversazioni in linguaggio naturale.

Capacità principali:

• Generazione e modifica del codice tramite strumenti sui file
• Esplorazione del codebase con sottoagenti specializzati
• Esecuzione di comandi tramite l'integrazione con bash
• Estensibilità personalizzata tramite regole e server MCP

Requisiti minimi:

• Visual Studio Code 1.90.0 o versione successiva
• Abbonamento Verdent attivo
• Connessione a Internet

Piattaforme supportate: macOS, Windows, Linux, WSL

1. Installa l'estensione Verdent dal marketplace di VS Code
2. Accedi con il tuo account Verdent quando richiesto
3. Apri un file di codice o un progetto qualsiasi
4. Apri la Chat View e inizia a conversare con Verdent

Suggerimento per la prima attività: chiedi a Verdent di spiegare la struttura del tuo progetto o di rivedere un file specifico.

Apri Visual Studio Code e vai su Help → About (oppure Code → About Visual Studio Code su macOS). Il numero di versione è mostrato nella finestra di dialogo. Verdent richiede Visual Studio Code versione 1.90.0 o successiva.

Puoi anche verificare da riga di comando:

code --version

Consulta Credits & Plans per la definizione condivisa dei crediti, dei livelli di prezzo e delle nozioni di base sull'utilizzo comuni a tutti i prodotti Verdent.

Consulta What Happens If You Run Out of Credits per la policy condivisa dell'account e le opzioni di recupero.

Le immagini incollate dagli appunti o referenziate tramite percorso file vengono elaborate all'interno della tua sessione di conversazione. Le immagini non vengono archiviate in modo permanente e vengono eliminate quando avvii una nuova conversazione. I riferimenti tramite percorso file leggono l'immagine in locale senza caricarla.

Plan Mode è una modalità di esecuzione in sola lettura in cui Verdent analizza il codice, svolge ricerche e crea piani di implementazione dettagliati senza modificare file o eseguire comandi. Dopo aver generato un piano, Verdent presenta due opzioni: Edit (per richiedere modifiche e affinare il piano) oppure Start Building (per passare a Agent Mode e iniziare l'esecuzione). L'agente può porre domande di chiarimento per eliminare le incertezze prima dell'esecuzione. Questa modalità è ideale per attività complesse in cui vuoi rivedere l'approccio prima di impegnarti nelle modifiche, garantendo l'allineamento tra le tue aspettative e la soluzione proposta da Verdent.

No. Plan Mode è rigorosamente in sola lettura:

• Verdent può leggere file, cercare nel codice e analizzare il tuo codebase
• Nessuna scrittura, modifica o eliminazione di file avviene durante Plan Mode
• I piani vengono mostrati solo nella Chat View
• L'esecuzione del codice inizia solo dopo che approvi esplicitamente e passi a Agent Mode

Garanzia di sicurezza: Plan Mode non può modificare accidentalmente il tuo codice. È progettato per un'esplorazione sicura e per lo sviluppo della strategia.

Il passaggio è istantaneo tramite l'Input Box:

Per entrare in Plan Mode:

• Seleziona il pulsante Switch Mode nell'Input Box
• Seleziona Plan Mode dal menu a discesa
• OPPURE scrivi: "Switch to Plan Mode"

Per uscire da Plan Mode:

• Seleziona il pulsante Switch Mode nell'Input Box
• Seleziona Agent Mode dal menu a discesa
• OPPURE scegli Start Building dopo aver rivisto un piano

Persistenza della modalità:

• La scelta della modalità persiste all'interno della sessione corrente
• Le nuove sessioni iniziano nella Agent Mode predefinita
• Puoi cambiare modalità liberamente in qualsiasi momento

Flusso di lavoro tipico: Plan Mode → revisione → Agent Mode → esecuzione → ritorno a Plan Mode per la successiva funzionalità complessa.

Seleziona il pulsante "New Session" nella barra superiore. In questo modo la cronologia della conversazione corrente viene cancellata e Verdent dispone di una nuova finestra di contesto per la tua prossima attività.

Sì, ogni finestra di VS Code funziona in modo indipendente. Puoi avere Verdent aperto in più progetti e ciascuno mantiene il proprio contesto di conversazione separato.

Sì. Verdent utilizza comandi Git standard, quindi funziona con qualsiasi repository Git indipendentemente dalla piattaforma di hosting. Per creare pull request, Verdent utilizza la CLI gh che richiede GitHub, ma tutte le altre operazioni Git funzionano universalmente.

Supportati: tutti i formati di file basati su testo, tra cui:

• Codice sorgente (JavaScript, Python, TypeScript, Java, Go, ecc.)
• File di configurazione (JSON, YAML, TOML, XML, ENV)
• Documentazione (Markdown, HTML, LaTeX)
• File di build (package.json, Makefile, requirements.txt)

Non supportati: file binari (immagini, video, PDF, binari compilati, documenti Office)

Soluzione alternativa: puoi fare riferimento ai file binari nel codice, ma le modifiche richiedono strumenti esterni.

Supporto eccellente:

• JavaScript, TypeScript, Python, React, Vue, Angular
• Node.js, Go, Java/Spring, C#/.NET
• Swift, Kotlin, Flutter

Supporto molto buono: Rust, C/C++, Ruby, R

Supporto buono: PHP, Assembly, Julia

I linguaggi più diffusi hanno un supporto più solido grazie all'ampia quantità di dati di addestramento.

Tre strumenti per le operazioni sui file:

• file_read: legge file completi o intervalli di righe specifici
• file_edit: sostituisce pattern di testo specifici (modifiche mirate)
• file_write: crea nuovi file o riscrive completamente i file

Buona pratica: usa file_edit per le modifiche, file_write solo per i nuovi file.

L'esecuzione di comandi del terminale o script di shell tramite Verdent, incluse operazioni come l'esecuzione di test, l'installazione di pacchetti o l'esecuzione di comandi di build. L'esecuzione dei comandi richiede l'approvazione nella maggior parte delle modalità di autorizzazione per evitare modifiche indesiderate al sistema.

Sì, tramite lo strumento bash. Verdent può eseguire comandi del terminale con:

• Timeout massimo: 120 secondi (2 minuti)
• Concatenamento di comandi con &&
• Supporto multipiattaforma (bash su Unix, PowerShell su Windows)

Sicurezza: i comandi vengono eseguiti con le tue autorizzazioni utente. Usa Manual Accept Mode per rivederli prima dell'esecuzione.

Timeout massimo: 120 secondi (2 minuti)

I comandi che superano i 2 minuti verranno terminati automaticamente. Per operazioni più lunghe, considera:

Alternative:

• Suddividi in comandi più piccoli: bash("task1") && bash("task2")
• Suddividi in operazioni più piccole
• Esegui in background e controlla i risultati separatamente

Un processo di verifica iterativo in cui il codice viene generato, testato e riparato finché non supera test completi. Verdent esegue automaticamente i test, analizza gli errori, corregge i problemi e riesegue i test in più passaggi finché il codice non funziona correttamente. In questo modo fornisce codice pronto per la produzione, non semplici suggerimenti. Ogni risultato include riepiloghi dettagliati e diff del codice che mostrano esattamente cosa è cambiato.

I sottoagenti sono agenti AI specializzati con finestre di contesto isolate per attività specifiche.

Sottoagenti integrati:

• @Explorer: ricerche nel codebase, domande sull'architettura
• @Verifier: controlli di convalida rapidi
• @Code-reviewer: revisioni di sicurezza e qualità

Quando usarli: delega attività di ricerca, convalida o revisione per risparmiare contesto nella conversazione principale.

Come creare sottoagenti personalizzati:

Crea un file markdown in ~/.verdent/subagents/:

---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]

Casi d'uso: competenze specifiche di un dominio (finanza, sanità), flussi di lavoro di team, specialisti tecnologici.

Si verifica quando azioni e informazioni precedenti nel contesto creano pattern comportamentali indesiderati che influenzano le attività future. Ad esempio, se aggiorni ripetutamente il codice e poi lo distribuisci, l'agente potrebbe iniziare ad associare tutti gli aggiornamenti del codice a una distribuzione immediata, anche quando stai solo sperimentando. I sottoagenti prevengono l'inquinamento del contesto operando con finestre di contesto isolate, consentendo a ogni attività specializzata di partire con un contesto pulito ed evitando la contaminazione incrociata tra diversi tipi di lavoro.

Guarda l'input box in fondo al pannello di Verdent. Il pulsante "Switch Permission" mostra la tua modalità attuale (ad esempio "Manual", "Auto", "Plan"). Puoi selezionarlo per cambiare modalità.

Auto-Run Mode:

• Le operazioni sui file vengono eseguite automaticamente senza approvazione
• I comandi richiedono comunque l'autorizzazione
• Flusso di lavoro più veloce per codebase fidati
• Ideale per progetti individuali con controllo di versione

Manual Accept Mode:

• Rivedi e approvi ogni operazione protetta
• Più sicuro per codebase condivisi o in produzione
• Vedi esattamente cosa verrà eseguito prima dell'esecuzione

Cambia modalità tramite le impostazioni o la command palette.

Operazioni che si limitano a leggere dati senza apportare modifiche: letture di file e ricerche sul web. Queste vengono approvate automaticamente in Auto-Run Mode, mentre le modifiche ai file e l'esecuzione di comandi richiedono comunque l'approvazione per sicurezza.

No, le modalità di autorizzazione sono mutuamente esclusive: puoi usarne solo UNA alla volta:

• Manual Accept - Predefinita, massimo controllo
• Auto-Run - Ottimizzata per progetti fidati
• Plan - Modalità di pianificazione in sola lettura
• Skip Permissions - Autonomia completa

Puoi cambiare modalità istantaneamente tramite il pulsante Switch Permission nell'Input Box. La maggior parte degli utenti passa da una modalità all'altra in base al contesto dell'attività (ad esempio, Plan Mode per le funzionalità complesse, Auto-Run per le correzioni rapide).

Usa l'agente Explorer per le attività di scoperta e ricerca senza consumare il contesto principale. Carica i file direttamente con le @-menzioni solo quando devi modificarli. Explorer è ideale per domande del tipo "trova tutti i file che...", mentre le @-menzioni servono per attività del tipo "aggiorna questo file specifico".

Sì! Crea sottoagenti personalizzati in ~/.verdent/subagents/:

---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]

Casi d'uso: competenze specifiche di un dominio (finanza, sanità), flussi di lavoro di team, specialisti tecnologici.

Sì. Puoi interrompere l'esecuzione in qualsiasi momento. Verdent completerà il passaggio a cui sta lavorando e poi si fermerà. I progressi fino a quel punto vengono conservati. Puoi rivedere ciò che è stato fatto, apportare modifiche e continuare oppure adottare un approccio diverso.

Osserva la todo list. Mostra lo stato in tempo reale con un elemento contrassegnato come "in progress" alla volta. L'elemento attivo indica esattamente su cosa sta lavorando Verdent al momento. Gli elementi completati sono contrassegnati come conclusi e quelli in sospeso mostrano cosa resta da fare.

No. Verdent crea commit solo quando li richiedi esplicitamente. Mantieni il pieno controllo su quando eseguire il commit delle modifiche. Basta chiedere "Stage all changes and create a commit" quando sei pronto.

No. Verdent esegue il push verso i repository remoti solo quando lo richiedi esplicitamente. Tutte le operazioni Git (commit, push, merge, rebase) richiedono una tua istruzione esplicita per sicurezza.

Tre metodi di personalizzazione:

1. VERDENT.md: preferenze globali personali (~/.verdent/VERDENT.md)
2. AGENTS.md: standard di team specifici del progetto (radice del progetto, sotto controllo di versione)
3. plan_rules.md: formato di output di Plan Mode (~/.verdent/plan_rules.md)

AGENTS.md ha la precedenza su VERDENT.md per garantire coerenza nel team.

La maggior parte delle impostazioni di Verdent si applica immediatamente senza richiedere un riavvio:

• Modalità di autorizzazione: cambia istantaneamente tramite l'Input Box
• Preset dei modelli: si applicano alla richiesta successiva
• File di regole: si applicano alle nuove conversazioni (il salvataggio attiva il ricaricamento)
• Sottoagenti: disponibili immediatamente dopo la creazione
• Scorciatoie da tastiera: si applicano dopo il salvataggio in VS Code

Eccezione: le impostazioni dell'estensione VS Code (come verdent.enableCheckpoints) hanno effetto immediato ma potrebbero richiedere la riapertura di file o sessioni per essere applicate completamente.

Il Model Context Protocol (MCP) estende Verdent con strumenti e servizi esterni:

Configurazione: ~/.verdent/mcp.json tramite Settings → server MCP

Capacità:

• Connessioni a database (PostgreSQL, MySQL, MongoDB)
• Servizi cloud (AWS, Azure, GCP)
• Strumenti di project management (Jira, Linear)
• Pipeline CI/CD (Jenkins, GitHub Actions)

Stato: la documentazione sull'integrazione MCP è in sviluppo. Contatta support@verdent.ai per assistenza sulla configurazione.

L'unità di misura per le finestre di contesto. I token rappresentano frammenti di testo (parole, parti di parole o caratteri) che il modello AI elabora. I limiti di contesto si misurano in token anziché in caratteri o parole, e le conversazioni tipiche consumano migliaia di token.

Tutto ciò che è presente nella tua sessione: tutti i messaggi della conversazione, i contenuti dei file caricati nel contesto, gli output degli strumenti (risultati di grep/ricerca, letture di file), i prompt e le istruzioni di sistema e le definizioni dei server MCP. Ognuno di questi elementi consuma token dalla capacità totale del tuo contesto.

I modelli standard (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) hanno finestre di contesto da 200K token, sufficienti per la maggior parte delle attività. Claude Sonnet 4.5 offre un contesto esteso da 1M token (5 volte più grande) per codebase di grandi dimensioni con file 1000+, refactoring complessi su più file o lunghe sessioni di sviluppo. Il contesto 1M si attiva automaticamente quando l'input supera i 200K token oppure può essere selezionato esplicitamente.

Non esiste un limite fisso di file: dipende dalle dimensioni dei file e dal numero totale di token. Per i contesti da 200K, evita di caricare 20+ file di grandi dimensioni (>1000 righe ciascuno). Concentrati sui file direttamente rilevanti per la tua attività corrente. Usa @-mentions in modo selettivo e sfrutta la documentazione AGENTS.md invece di caricare molti file di esempio. Con il contesto 1M, la selezione dei file diventa molto meno critica.

I segnali includono tempi di risposta più lenti, sessioni in esecuzione per diverse ore o molti file di grandi dimensioni caricati. Monitora la durata della sessione e il numero di file. Quando noti un degrado delle prestazioni, completa l'attività corrente, esegui il commit dei tuoi progressi e avvia una nuova sessione con contesto pulito.

Strategie:

1. Lettura strategica dei file: usa intervalli di righe per i file di grandi dimensioni
2. Delega ai sottoagenti: Explorer/Verifier per la ricerca in background
3. Cerca prima di leggere: usa grep_file per identificare i file rilevanti
4. Suddividi le operazioni: usa todo_update per tenere traccia delle attività su più passaggi

Regola pratica: per i file oltre le 500 righe conviene usare gli intervalli di righe.

Devi avviare manualmente una nuova sessione per reimpostare il contesto: Verdent non cancella automaticamente il contesto. Buona pratica: reimposta dopo aver completato un'unità di lavoro atomica, averla testata e averne eseguito il commit nel controllo di versione. Per i contesti da 1M token, le reimpostazioni sono necessarie molto meno di frequente.

No: la reimpostazione del contesto cancella solo la cronologia della conversazione e i file caricati dalla memoria. Le tue effettive modifiche al codice, i commit e le modifiche ai file vengono conservati. Esegui sempre il commit del tuo lavoro nel controllo di versione prima di reimpostare il contesto, per sicurezza. Reimposta → avvia una nuova sessione → continua a lavorare sull'attività successiva.

Devono essere abbastanza specifici da eliminare le ambiguità, ma senza spiegare eccessivamente dettagli ovvi. Includi: percorsi file esatti, approccio di implementazione, risultati attesi e vincoli. Sbagliato: "Fix the code" - troppo vago. Corretto: "Add input validation to the email field in ContactForm.js to reject invalid email formats" - ambito e obiettivo chiari. Nel dubbio, meglio peccare di maggiore specificità.

Verdent carica automaticamente i file menzionati per nome nei prompt e i file correlati nella stessa directory. Le @-mentions (@filename.js) garantiscono esplicitamente che un file sia nel contesto, il che è fondamentale quando lavori con file strettamente accoppiati, quando fai riferimento a pattern di un file da applicare in un altro o quando il rilevamento automatico potrebbe non cogliere il contesto in codebase di grandi dimensioni. Usa sempre le @-mentions quando chiedi a Verdent di "seguire lo stesso pattern di..." per garantire un riferimento esatto al codice.

No: Verdent mantiene il contesto della conversazione all'interno di una sessione, quindi non devi ripetere i dettagli dell'architettura o le convenzioni già discusse. Tuttavia, per vincoli critici o quando le sessioni diventano lunghe (100+ messaggi), ribadisci il contesto importante. Approccio migliore: usa le regole di progetto (AGENTS.md) per documentare il contesto persistente come stack tecnologico, standard di codifica e pattern, così non dovrai mai ripeterli.

Usa il perfezionamento iterativo: rivedi l'output, individua cosa non va, poi fornisci correzioni in un prompt successivo. Esempio: "La logica di validazione è buona, ma usa la validazione dello schema Joi invece dei controlli manuali. Segui il pattern di validazione in ProductController.js." Puoi anche chiedere spiegazioni: "Perché hai usato Redux invece di Context API?" e poi perfezionare in base a quanto compreso. Non ripetere lo stesso prompt: modificalo in base a ciò che non ha funzionato.

Usa Plan Mode per: refactoring di grandi dimensioni o modifiche architetturali, modifiche su più file in cui vuoi rivedere l'ambito prima dell'esecuzione, attività complesse per cui non sei sicuro dei requisiti, o quando vuoi che Verdent ti ponga domande di chiarimento prima dell'implementazione. Evita Plan Mode per: attività semplici e ben definite, correzioni rapide di bug o operazioni di routine. Plan Mode aggiunge un po' di overhead ma previene errori costosi nel lavoro complesso.

Abbina il preset del modello alla complessità dell'attività e al budget:

Usa Efficiency (3,2 volte più efficiente di Sonnet):

• Correzioni rapide di bug e generazione di codice semplice
• Operazioni di routine e attività ad alta frequenza
• Quando la velocità conta più della profondità

Usa Balance (baseline 1x) - Predefinito:

• Sviluppo generico e codifica quotidiana
• Implementazione di funzionalità e revisioni del codice
• Prestazioni bilanciate per la maggior parte degli scenari

Usa Performance (efficienza 0,5x, costo 2x):

• Decisioni architetturali complesse
• Codebase di grandi dimensioni che richiedono un contesto esteso (oltre 200k token)
• Debug e refactoring sofisticati

Consiglio da esperto: la maggior parte degli utenti mantiene Balance come impostazione predefinita e passa a Performance solo quando raggiunge i limiti di contesto o ha bisogno di un ragionamento approfondito.

Se Verdent non riesce a connettersi ai servizi AI, verifica questi problemi comuni:

Testa la connettività di base:

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

Ambienti aziendali/enterprise:

• 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
• Verifica che i server proxy siano configurati correttamente per far 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 il supporto di Verdent per i dettagli specifici degli endpoint da inserire nella whitelist.

Controlla:

• Posizione: file nella directory radice del progetto
• Sintassi: Markdown valido
• Specificità: le regole sono direttive ("Always use..." e non "Try to...")
• Test pulito: avvia una nuova conversazione per testarne l'applicazione

Precedenza: AGENTS.md ha la precedenza su VERDENT.md per il comportamento specifico del progetto.

Cause:

• Il testo è cambiato dall'ultima lettura
• Differenze negli spazi bianchi (spazi vs tab)
• La stringa non è univoca nel file

Soluzioni:

• Leggi di nuovo il file per ottenere il contenuto attuale
• Fornisci una stringa di contesto più ampia per garantire l'univocità
• Usa replace_all=true per stringhe identiche multiple
• Verifica che file_path sia corretto

Controlla:

• Posizione: file in ~/.verdent/subagents/[name].md
• Policy di invocazione: una policy rigorosa richiede una @-menzione esplicita
• Frontmatter YAML: sintassi valida
• Linee guida "When to use": devono corrispondere al pattern della tua richiesta

Test: usa una @-menzione esplicita per verificare che il sottoagente funzioni: @your-subagent do task