# Ottimizzazione della configurazione (/it/docs/verdent-for-vscode/configuration/tuning)

> Ottimizzare Verdent per il tuo flusso di lavoro



Ottimizza Verdent for VS Code per bilanciare velocità, costo e accuratezza in base alle esigenze del tuo flusso di lavoro. Configura i preset dei modelli, le modalità di esecuzione e le strategie di gestione del contesto per prestazioni ottimali.

### Aree di ottimizzazione [#aree-di-ottimizzazione]

* Selezione del preset del modello per bilanciare costo e prestazioni
* Configurazione della modalità di esecuzione per l'efficienza del flusso di lavoro
* Gestione del contesto per basi di codice di grandi dimensioni
* Personalizzazione a livello di progetto e di workspace

***

## Regolare le impostazioni per il tuo flusso di lavoro [#regolare-le-impostazioni-per-il-tuo-flusso-di-lavoro]

### Selezione del preset del modello [#selezione-del-preset-del-modello]

Scegli il preset del modello più adatto in base alla complessità dell'attività e al budget:

| Preset                    | Costo                              | Efficienza dei costi                    | Ideale per                                                  |
| ------------------------- | ---------------------------------- | --------------------------------------- | ----------------------------------------------------------- |
| **Efficiency**            | \~0,3x Balance (riduzione del 70%) | 3,2x più efficiente di Sonnet           | Attività semplici, correzioni rapide, prototipazione veloce |
| **Balance** (predefinito) | 1x baseline                        | 1x baseline                             | Attività di sviluppo generali, coding quotidiano            |
| **Performance**           | 1-2x Balance                       | Efficienza 0,5x (costo 2x, contesto 1M) | Decisioni architetturali complesse, refactoring intricati   |

**Modelli aggiuntivi:**

* **Claude-4.5-sonnet:** modello generico bilanciato (1x baseline)
* **Claude-4.5-sonnet-1m:** contesto esteso per attività complesse (efficienza 0,5x, costo 2x quando l'input supera i 200k token)
* **Claude-4.5-haiku:** il più veloce ed economico (3,2x più efficiente di Sonnet)
* **GPT-5 / GPT-5-codex:** focus su ragionamento e creatività (Beta, 1,3x più efficiente di Sonnet)
* **Minimax-m2:** veloce ed economico (Beta, gratuito fino al 10 novembre)

### Configurazione della modalità di esecuzione [#configurazione-della-modalità-di-esecuzione]

<Tabs>
  <Tab title="Salta permessi (velocità)">
    * Piena autonomia senza richieste di approvazione
    * Nessuna interruzione per i permessi
    * Rischio massimo: usala solo in ambienti automatizzati
  </Tab>

  <Tab title="Esecuzione automatica (bilanciato)">
    * I comandi richiedono approvazione, le operazioni sui file sono automatiche
    * Meno richieste di permesso
    * Rischio inferiore, mantenendo la sicurezza per le operazioni pericolose
  </Tab>

  <Tab title="Accettazione manuale (accuratezza)">
    * Ogni operazione richiede approvazione
    * Visibilità e controllo completi
    * La più lenta ma la più sicura: ideale per l'apprendimento e il codice di produzione
  </Tab>

  <Tab title="Plan (revisione)">
    * Pianificazione strategica prima dell'esecuzione
    * Fase di analisi in sola lettura
    * Rivedi e approva prima di qualsiasi modifica
  </Tab>
</Tabs>

### Think Hard Mode [#think-hard-mode]

Attivala per attività di ragionamento complesse:

* **Accuratezza:** massima profondità di ragionamento per problemi sofisticati
* **Velocità:** più lenta a causa del budget di ragionamento esteso
* **Ideale per:** decisioni architetturali, debug complesso, analisi intricate

***

## Compromessi tra velocità e accuratezza [#compromessi-tra-velocità-e-accuratezza]

Bilancia la velocità di esecuzione con la profondità di analisi in base alle esigenze dell'attività.

<Tabs>
  <Tab title="Velocità critica">
    **Configurazione:**

    * **Modello:** preset Efficiency (Claude-4.5-haiku)
    * **Modalità permessi:** Auto-Run Mode
    * **Modalità di esecuzione:** Agent Mode per l'esecuzione diretta
    * **Casi d'uso:** correzioni rapide, operazioni di routine, attività semplici

    **Vantaggi:**

    * Tempi di risposta più rapidi
    * Interruzioni minime
    * Riduzione dei costi del 70% rispetto al preset Balance
  </Tab>

  <Tab title="Accuratezza critica">
    **Configurazione:**

    * **Modello:** preset Performance (Claude-4.5-sonnet-1m)
    * **Modalità permessi:** Manual Accept Mode
    * **Modalità di esecuzione:** Plan Mode per la revisione strategica
    * **Think Hard:** attivo per un ragionamento sofisticato
    * **Casi d'uso:** funzionalità complesse, codice di produzione, decisioni architetturali

    **Vantaggi:**

    * Finestra di contesto massima (1M token)
    * Visibilità e controllo completi
    * Ragionamento approfondito per problemi complessi
    * Revisione prima dell'esecuzione
  </Tab>

  <Tab title="Approccio ibrido">
    La maggior parte degli utenti trae vantaggio dal passare da una configurazione all'altra a seconda del contesto:

    * **Correzioni rapide:** Efficiency + Agent Mode
    * **Funzionalità complesse:** Balance/Performance + Plan Mode
    * **Esplorazione:** Plan Mode per la strategia, poi Agent Mode per l'esecuzione

    **Strategia:** adatta la configurazione al tipo di attività invece di usare un approccio universale.
  </Tab>
</Tabs>

<Tip>
  Usa Auto-Run Mode per i progetti affidabili così da ridurre le richieste di permesso mantenendo la sicurezza per le operazioni pericolose. Questo snellisce il flusso di lavoro senza sacrificare le protezioni critiche.
</Tip>

***

## Configurazione a livello di workspace [#configurazione-a-livello-di-workspace]

Verdent supporta la configurazione per progetto e per workspace per garantire coerenza a livello di team.

### Configurazione specifica del progetto [#configurazione-specifica-del-progetto]

**Regole del progetto (AGENTS.md):**

* **Posizione:** directory root del progetto o cartella del workspace
* **Ambito:** applicata solo al progetto corrente
* **Controllo di versione:** effettua il commit in git per standard condivisi dal team
* **Contenuto:** standard di codifica, requisiti di test, pattern architetturali

**Esempio:**

```markdown filename="AGENTS.md"
# Project Rules

## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern

## Testing
- All endpoints require input validation
- Run tests before committing
```

### Impostazioni del workspace di VS Code [#impostazioni-del-workspace-di-vs-code]

Configura le impostazioni dell'estensione a livello di workspace:

**Posizione:** `.vscode/settings.json` nella root del workspace

**Esempio:**

```json filename=".vscode/settings.json"
{
  "verdent.enableCheckpoints": true
}
```

### Priorità di configurazione [#priorità-di-configurazione]

In caso di conflitto tra configurazioni, Verdent applica questo ordine di priorità:

1. **Regole del progetto (AGENTS.md)** - priorità massima (specifiche del progetto)
2. **Impostazioni del workspace** - impostazioni a livello di workspace di VS Code
3. **Regole utente (VERDENT.md)** - preferenze utente globali
4. **Impostazioni predefinite** - impostazioni predefinite integrate di Verdent

***

## Personalizzazione specifica del progetto [#personalizzazione-specifica-del-progetto]

### Gestione del contesto per progetti di grandi dimensioni [#gestione-del-contesto-per-progetti-di-grandi-dimensioni]

<Tabs>
  <Tab title="Sottoagenti">
    * Delega le operazioni complesse ai sottoagenti con finestre di contesto separate
    * Solo i risultati dei sottoagenti consumano il contesto principale, non l'intero processo
    * Evita che il contesto principale si riempia di dettagli implementativi
  </Tab>

  <Tab title="Selezione dei file">
    * Aggiungi esplicitamente solo i file pertinenti usando `@filename`
    * Evita di caricare inutilmente l'intero progetto nel contesto
    * Concentra l'analisi su componenti specifici
  </Tab>

  <Tab title="Suddivisione delle attività">
    * Suddividi le attività di grandi dimensioni in blocchi più piccoli e completabili
    * Avvia nuove sessioni per funzionalità o componenti distinti
    * I punti di interruzione naturali prevengono l'esaurimento del contesto
  </Tab>

  <Tab title="Plan Mode">
    * Rivedi l'approccio prima di consumare contesto per l'esecuzione
    * Riduce lo spreco di contesto su implementazioni errate
    * Plan Mode ha una gestione del contesto separata
  </Tab>
</Tabs>

### Ottimizzazione delle prestazioni [#ottimizzazione-delle-prestazioni]

**Attiva i checkpoint in modo selettivo:**

L'impostazione `verdent.enableCheckpoints` usa git per il controllo di versione:

* Può influire sulle prestazioni nei repository molto grandi
* Attivala solo quando serve la funzionalità di checkpoint
* Disattivala per ottenere le massime prestazioni su basi di codice di grandi dimensioni

<Tip>
  Attiva i checkpoint in modo selettivo solo per le attività critiche: un checkpoint eccessivo rallenta i flussi di lavoro senza aggiungere valore.
</Tip>

**Selezione del modello:**

* Usa il preset Efficiency (Haiku) per attività semplici e isolate
* Riserva il preset Performance (Sonnet-1M) alle operazioni con molto contesto
* Usa il preset Balance per il lavoro generale

**Modalità di esecuzione:**

* Auto-Run Mode riduce il contesto consumato dalle richieste di permesso
* Skip Permissions Mode massimizza l'efficienza per gli ambienti automatizzati

<Note>
  Gli scenari multi-workspace applicano automaticamente le regole di progetto appropriate quando si passa da un workspace all'altro. Non è richiesto alcun cambio di configurazione manuale.
</Note>

<Tip>
  Le configurazioni multi-workspace ti permettono di ottimizzare le impostazioni per tipo di progetto, sviluppo vs produzione, monorepo vs microservizi.
</Tip>

***

## Vedi anche [#vedi-anche]

<CardGroup cols="2">
  <Card title="Impostazioni di configurazione" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    Opzioni di configurazione complete e selezione del modello
  </Card>

  <Card title="Monitoraggio delle risorse" icon="chart-line" href="/docs/verdent-for-vscode/resource-management/monitoring">
    Monitora le prestazioni e ottimizza l'utilizzo dei token
  </Card>
</CardGroup>
