# Domande frequenti (/it/docs/verdent-for-vscode/help-support/faqs)

> Domande comuni su Verdent for VS Code



Risposte alle domande frequenti sulle funzionalità, le capacità e l'utilizzo di Verdent.

***

## Per iniziare [#per-iniziare]

<Tip>
  Completa la guida Quick Start prima di addentrarti nelle funzionalità avanzate: illustra i concetti essenziali che ricorrono in tutta la documentazione.
</Tip>

***

## Problemi comuni (i primi 4) [#problemi-comuni-i-primi-4]

<Accordion title="Perché non riesco ad accedere a Verdent for VS Code?">
  **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.
</Accordion>

<Accordion title="Perché non ho ricevuto i crediti della prova gratuita?">
  **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](mailto: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.
</Accordion>

<Accordion title="Perché la mia registrazione non è andata a buon fine?">
  **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](mailto:support@verdent.ai) per ricevere assistenza. Il team di supporto può esaminare la tua registrazione e fornirti indicazioni su come risolvere il problema.
</Accordion>

<Accordion title="Perché non trovo i modelli Claude, GPT o Gemini?">
  **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](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.
</Accordion>

***

<Accordion title="Che cos'è Visual Studio Code?">
  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.
</Accordion>

<Accordion title="Che cos'è Verdent for VS Code?">
  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
</Accordion>

<Accordion title="Quali sono i requisiti di sistema?">
  **Requisiti minimi:**

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

  **Piattaforme supportate:** macOS, Windows, Linux, WSL
</Accordion>

<Accordion title="Come inizio a usare Verdent dopo l'installazione?">
  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.
</Accordion>

<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 è mostrato nella finestra di dialogo. Verdent richiede Visual Studio Code versione 1.90.0 o successiva.

  Puoi anche verificare da riga di comando:

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

<Accordion title="Cosa sono i crediti?">
  Consulta [Credits & Plans](/docs/account-billing/credits-and-plans) per la definizione condivisa dei crediti, dei livelli di prezzo e delle nozioni di base sull'utilizzo comuni a tutti i prodotti Verdent.
</Accordion>

<Accordion title="Cosa succede se finisco i crediti?">
  Consulta [What Happens If You Run Out of Credits](/docs/account-billing/run-out-of-credits) per la policy condivisa dell'account e le opzioni di recupero.
</Accordion>

<Accordion title="Verdent carica le mie immagini su server esterni?">
  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.
</Accordion>

<Accordion title="Che cos'è Plan Mode?">
  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.
</Accordion>

<Accordion title="Plan Mode scrive davvero codice nei miei file?">
  **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.
</Accordion>

<Accordion title="Come passo da Plan Mode a Agent Mode?">
  **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.
</Accordion>

<Accordion title="Come avvio una nuova conversazione con contesto pulito?">
  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à.
</Accordion>

<Accordion title="Posso usare Verdent in più progetti contemporaneamente?">
  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.
</Accordion>

<Accordion title="Verdent funziona con GitHub, GitLab, Bitbucket e altre piattaforme Git?">
  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.
</Accordion>

***

## Strumenti e capacità [#strumenti-e-capacità]

<Accordion title="Con quali formati di file può lavorare Verdent?">
  **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.
</Accordion>

<Accordion title="Quali linguaggi di programmazione supporta meglio Verdent?">
  **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.
</Accordion>

<Accordion title="Come legge e modifica i file Verdent?">
  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.
</Accordion>

<Accordion title="Che cos'è l'esecuzione dei comandi?">
  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.
</Accordion>

<Accordion title="Verdent può eseguire comandi nel mio terminale?">
  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.
</Accordion>

<Accordion title="Per quanto tempo possono essere eseguiti i comandi bash?">
  **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
</Accordion>

<Accordion title="Che cos'è il ciclo Multipass Generate-Test-Repair?">
  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.
</Accordion>

<Check>
  I cicli di test Multipass correggono e ritestano automaticamente il codice finché non supera i test: è così che Verdent garantisce la prontezza per la produzione.
</Check>

***

## Sottoagenti ed esecuzione [#sottoagenti-ed-esecuzione]

<Accordion title="Cosa sono i sottoagenti e quando dovrei usarli?">
  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/`:

  ```markdown
  ---
  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.
</Accordion>

<Accordion title="Che cos'è l'inquinamento del contesto?">
  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.
</Accordion>

<Accordion title="Come faccio a sapere in quale modalità di esecuzione mi trovo?">
  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à.
</Accordion>

<Accordion title="Qual è la differenza tra Auto-Run Mode e Manual Accept Mode?">
  **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.
</Accordion>

<Accordion title="Cosa sono le operazioni sicure?">
  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.
</Accordion>

<Accordion title="Posso usare più modalità di autorizzazione contemporaneamente?">
  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).
</Accordion>

<Accordion title="Quando dovrei usare l'agente Explorer invece di caricare i file direttamente?">
  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".
</Accordion>

<Accordion title="Posso creare sottoagenti personalizzati per il mio progetto?">
  Sì! Crea sottoagenti personalizzati in `~/.verdent/subagents/`:

  ```markdown
  ---
  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.
</Accordion>

<Accordion title="Posso fermare Verdent a metà di un'attività composta da più passaggi?">
  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.
</Accordion>

<Accordion title="Come faccio a sapere cosa sta facendo Verdent in questo momento durante un'attività lunga?">
  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.
</Accordion>

<Accordion title="Verdent esegue automaticamente il commit delle mie modifiche?">
  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.
</Accordion>

<Accordion title="Verdent farà push verso i repository remoti senza chiedere?">
  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.
</Accordion>

***

## Personalizzazione e integrazione [#personalizzazione-e-integrazione]

<Accordion title="Come personalizzo il comportamento di Verdent per il mio team?">
  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.
</Accordion>

<Accordion title="Quando hanno effetto le modifiche alla configurazione?">
  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.
</Accordion>

<Accordion title="Che cos'è MCP e come lo uso?">
  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](mailto:support@verdent.ai) per assistenza sulla configurazione.
</Accordion>

***

## Buone pratiche e prestazioni [#buone-pratiche-e-prestazioni]

<Tip>
  Monitora l'utilizzo dei crediti nello User Center per tenere traccia dei pattern di consumo e ottimizzare il tuo flusso di lavoro in termini di efficienza.
</Tip>

<Accordion title="Che cos'è un token?">
  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.
</Accordion>

<Accordion title="Cosa conta ai fini della mia finestra di contesto?">
  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.
</Accordion>

<Accordion title="Qual è la differenza tra finestre di contesto da 200K e da 1M?">
  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.
</Accordion>

<Accordion title="Quanti file posso caricare nel contesto in sicurezza?">
  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.
</Accordion>

<Accordion title="Come faccio a capire quando mi sto avvicinando ai limiti di contesto?">
  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.
</Accordion>

<Accordion title="Come evito l'esaurimento della finestra di contesto?">
  **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.
</Accordion>

<Accordion title="Devo reimpostare manualmente il contesto o lo farà automaticamente Verdent?">
  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.
</Accordion>

<Accordion title="Reimpostare il contesto mi farà perdere il lavoro?">
  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.
</Accordion>

<Accordion title="Quanto devono essere specifici i miei prompt?">
  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à.
</Accordion>

<Accordion title="Qual è la differenza tra @-menzioni e caricamento automatico dei file?">
  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.
</Accordion>

<Accordion title="Devo ripetere il contesto del progetto in ogni prompt durante una sessione?">
  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.
</Accordion>

<Accordion title="Cosa faccio se Verdent non comprende o non segue correttamente il mio prompt?">
  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.
</Accordion>

<Accordion title="Quando dovrei usare Plan Mode invece della modalità normale?">
  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.
</Accordion>

<Accordion title="Come scelgo il preset del modello giusto per la mia attività?">
  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.
</Accordion>

***

## Risoluzione dei problemi [#risoluzione-dei-problemi]

<Accordion title="Come risolvo i problemi di firewall o connessione?">
  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.
</Accordion>

<Accordion title="Le mie regole AGENTS.md non vengono applicate. Perché?">
  **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.
</Accordion>

<Accordion title="Come risolvo gli errori 'file_edit failed to find exact match'?">
  **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
</Accordion>

<Accordion title="Perché il mio sottoagente personalizzato non si attiva automaticamente?">
  **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`
</Accordion>

***

## Vedi anche [#vedi-anche]

<CardGroup cols="2">
  <Card title="Riferimento agli strumenti" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Capacità complete degli strumenti
  </Card>

  <Card title="Risoluzione dei problemi" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/common-issues">
    Problemi comuni e soluzioni
  </Card>
</CardGroup>