Modalità di pianificazione di Claude Code: come usarla e quando fa risparmiare tempo e token

Cosa fa la modalità pianificazione di Claude Code

La modalità pianificazione separa la proposta di una modifica dalla sua implementazione. Claude analizza l'attività, propone un approccio e attende l'approvazione, così puoi esaminare e modificare il piano prima di procedere.

La FAQ per gli utenti di Claude Code, datata 7 agosto 2026, descrive plan come una pianificazione in sola lettura che attende l'approvazione. Questo la rende utile quando vuoi verificare che Claude abbia compreso un'attività prima di autorizzarne l'implementazione.

La sola lettura non implica l'assenza di strumenti. Claude può leggere file e usare strumenti di sola lettura durante la pianificazione. La cronologia delle versioni disponibile al 14 agosto 2026 include una correzione per le chiamate a strumenti di sola lettura nelle sessioni che iniziano in modalità di pianificazione. Sarebbe quindi fuorviante affermare che la pianificazione impedisce tutti i comandi o qualsiasi ispezione del repository.

Modalità di pianificazione e altre modalità di autorizzazione

La pianificazione determina se Claude sta proponendo il lavoro o procedendo con la sua esecuzione. La modalità di autorizzazione usata per l'implementazione determina quali azioni richiedono approvazione.

Alla data di pubblicazione, il nome visualizzato per la precedente modalità di autorizzazione default è Manuale. La versione 2.1.200 ha introdotto questa modifica al nome visualizzato e ha accettato manual insieme a default nelle relative impostazioni di configurazione e della riga di comando.

Come entrare e uscire dalla modalità di pianificazione

Ci sono tre modi utili per accedervi: passare da una modalità di autorizzazione all'altra durante una sessione, usare /plan, oppure avviare Claude Code con il flag della modalità di pianificazione.

Usa Shift+Tab durante una sessione

Premi Shift+Tab per passare da una modalità di autorizzazione all'altra finché non viene selezionata la modalità di pianificazione. Dallo stato iniziale ordinario descritto nella guida di Anthropic di aprile 15, la prima pressione attiva acceptEdits e la seconda attiva la modalità di pianificazione.

Considera «premi due volte» come una descrizione di quello stato iniziale, anziché come una regola universale. La sessione potrebbe già trovarsi in una modalità diversa, quindi controlla quella selezionata mentre passi da una modalità all'altra.

Per uscire dalla modalità di pianificazione, usa Shift+Tab per passare alla modalità di autorizzazione che desideri usare per l'implementazione. Esamina prima il piano, poi procedi con il lavoro concordato in quella modalità.

Accedi direttamente con /plan

All'interno di una sessione, usa:

/plan

Puoi anche includere subito l'attività:

/plan fix the auth bug

L'argomento della descrizione è stato aggiunto nella versione v2.1.72 il 10 marzo 2026. Attiva la modalità di pianificazione e avvia la pianificazione di quell'attività, permettendoti di indicare sia la modalità sia l'attività in un unico comando.

Avvia una nuova sessione in modalità di pianificazione

Per iniziare con la pianificazione selezionata, esegui:

claude --permission-mode plan

È utile quando sai già che l'attività richiede un'indagine e una revisione prima dell'implementazione. Per informazioni correlate sull'uso della riga di comando, consulta la riferimento della CLI di Claude Code.

Questi metodi di accesso portano allo stesso flusso di pianificazione. Scegli la scorciatoia per una conversazione in corso, /plan quando vuoi un comando esplicito e il flag di avvio quando la pianificazione deve essere la modalità iniziale della sessione.

Crea un piano pronto per l'implementazione

Un piano utile di Claude Code dovrebbe rendere facile valutare la modifica proposta. Fornisci a Claude un contesto sufficiente per individuare il codice pertinente e criteri di accettazione sufficienti per capire cosa significa implementare con successo.

La guida al contesto e a prompt migliori consiglia di fornire riferimenti ai file pertinenti e di esaminare il piano nella conversazione prima di cambiare modalità e implementare un passaggio.

Fornisci percorsi noti e criteri di accettazione

Fai riferimento ai file con @path/to/file quando sai già dove si trova il codice pertinente. La guida afferma che fornire questi riferimenti è più veloce e usa meno token rispetto a lasciare che Claude individui i file.

Abbina questi percorsi a una definizione concreta del risultato atteso. Per un bug di autenticazione, ad esempio, potresti descrivere il comportamento errato, indicare i file pertinenti e specificare il comportamento che ti aspetti dopo la correzione. È un suggerimento su come formulare un'attività, non un'affermazione relativa a un repository specifico.

Informazioni utili da includere:

• Il comportamento da modificare.
• I file pertinenti che conosci già.
• I vincoli sull'ambito della modifica.
• I criteri di accettazione per il lavoro completato.

L'obiettivo è ridurre l'incertezza prima dell'implementazione. Una descrizione dettagliata del risultato desiderato è più utile che chiedere un piano senza spiegare cosa deve ottenere la modifica.

Esamina il piano prima di approvarlo

Verifica che l'approccio proposto risponda al comportamento richiesto e rimanga entro l'ambito previsto. Per un lavoro che coinvolge più file, esamina come i passaggi si collegano tra loro prima di consentire l'esecuzione delle modifiche.

Se il piano riflette un fraintendimento, correggilo nella conversazione. Le indicazioni di Anthropic prevedono esplicitamente la revisione e l'adattamento del piano prima di cambiare modalità e implementare un passaggio.

L'approvazione segna il passaggio dalla revisione dell'approccio all'esecuzione dell'implementazione. La modalità di autorizzazione selezionata per l'implementazione continua a contare: approvare un piano non rende la modalità Manuale, acceptEditse auto equivalenti.

Quando la pianificazione fa risparmiare tempo e token

La modalità di pianificazione di Claude Code è particolarmente utile quando risolvere presto le incertezze può evitare lavoro di implementazione superfluo. Le modifiche che coinvolgono più file sono buone candidate, perché un'ipotesi errata può influire su diverse parti della modifica proposta.

I meccanismi di risparmio supportati dalle fonti sono specifici: individuare i fraintendimenti prima che si traducano in un diff esteso, ridurre i cicli di revisione definendo fin dall'inizio il risultato atteso ed evitare ricerche superflue di file fornendo percorsi noti.

Usa la pianificazione quando l'ambito richiede una revisione

Valuta la modalità di pianificazione quando un'attività coinvolge diversi file o quando devi confermare l'approccio prima di iniziare le modifiche. Esaminare il piano ti permette di restringere l'ambito, correggere le ipotesi o cambiare l'ordine del lavoro.

Per una modifica piccola e chiaramente specificata, valuta se un ciclo di pianificazione separato risolverebbe un'incertezza significativa. Se il file interessato e il comportamento richiesto sono già chiari, una conversazione di pianificazione prolungata potrebbe offrire meno vantaggi.

È una valutazione del flusso di lavoro, non un benchmark. Il documento di ricerca non stabilisce una soglia misurata oltre la quale la pianificazione diventa più veloce.

Mantieni precise le affermazioni sui token

La pianificazione aggiunge una fase di lavoro prima dell'implementazione. Il suo potenziale vantaggio deriva dall'evitare lavoro che altrimenti verrebbe ripetuto o scartato.

Questa distinzione conta quando si valuta l'uso dei token. La documentazione conferma che fornire il percorso di un file noto permette di risparmiare token nelle ricerche. Anche la revisione del piano può aiutare a ridurre fraintendimenti e cicli di revisione, ma le prove disponibili non quantificano il risparmio netto della modalità di pianificazione.

Non è stato accertato alcun benchmark ufficiale precedente alla data limite che sostenga una riduzione percentuale fissa del tempo o dei token. Le prove fornite non attestano neppure un prezzo o una quota di utilizzo separati per la modalità di pianificazione.

Usa la pianificazione per migliorare la qualità del passaggio di implementazione successivo e valuta i risparmi in termini di ricerche e revisioni evitate. Per una trattazione più ampia di questo obiettivo, consulta come ridurre l'uso dei token di Claude.

Modalità di pianificazione, opusplan e cancellazione del contesto

La modalità di autorizzazione e la selezione del modello sono scelte separate. Entrare nella modalità di pianificazione seleziona il comportamento di pianificazione; una configurazione di pianificazione con Opus determina quale modello gestisce quel lavoro.

Cosa opusplan significa

La versione 1.0.77 ha introdotto Modalità di pianificazione con Opus in /model, usando Opus per la pianificazione e Sonnet negli altri casi. Il registro delle modifiche alla data limite del 14 agosto 2026 documenta anche l'alias opusplan .

Non considerare opusplan un sinonimo della modalità di autorizzazione plan . Il primo riguarda la selezione del modello per la pianificazione e le altre attività; la seconda riguarda la pianificazione in sola lettura e l'approvazione.

Le versioni esatte dei modelli e gli eventuali risparmi risultanti dipendono dalla configurazione. Le prove fornite non stabiliscono una percentuale di risparmio fissa per questa configurazione. La guida ai modelli di Claude Code offre un punto di riferimento per approfondire la selezione del modello separatamente dalle impostazioni di autorizzazione.

Conviene cancellare il contesto prima dell'implementazione?

La cancellazione del contesto è facoltativa. La versione 2.1.81, rilasciata il 20 marzo 2026, ha nascosto per impostazione predefinita l'opzione «cancella contesto» nella fase di approvazione del piano.

Per ripristinare questa opzione, usa l'impostazione:

{
  "showClearContextOnPlanAccept": true
}

La Note di rilascio della v2.1.81 documentano questa modifica. Ripristinare l'opzione la rende disponibile al momento dell'approvazione del piano; le prove non dimostrano che cancellare il contesto faccia sempre risparmiare token o migliori l'implementazione.

Imposta la pianificazione come predefinita

Se desideri abitualmente esaminare un approccio prima dell'implementazione, puoi configurare la modalità di pianificazione come predefinita:

{
  "permissions": {
    "defaultMode": "plan"
  }
}

A discussione nel repository del 28 luglio 2025 colloca questa configurazione in ~/.claude/settings.json.

È necessaria una precisazione sulla fonte: l'esempio datato è un commento della community nel repository ufficiale di Anthropic. La documentazione ufficiale attuale sulle modalità di autorizzazione conferma la configurazione, ma la data della sua revisione storica è incerta.

Usa il flag di avvio quando vuoi la pianificazione per una singola sessione. Valuta l'impostazione predefinita quando esaminare prima un piano fa parte del tuo flusso di lavoro abituale. In entrambi i casi, puoi esaminare e adattare l'approccio proposto, poi cambiare modalità per l'implementazione.

Punti chiave

• La modalità di pianificazione è una pianificazione in sola lettura con un passaggio di approvazione. Può esaminare i file e utilizzare strumenti di sola lettura mentre prepara l'approccio.
• Accedi con Shift+Tab, /plan, oppure claude --permission-mode plan; il numero di pressioni della scorciatoia dipende dalla modalità iniziale.
• Fornisci i percorsi dei file noti e i criteri di accettazione per ridurre le ricerche e i cicli di revisione.
• La pianificazione è particolarmente utile per esaminare modifiche che interessano più file, ma non esiste una percentuale fissa accertata di risparmio di tempo o token.
• opusplan riguarda la selezione del modello, mentre la cancellazione del contesto è un'impostazione facoltativa dell'approvazione del piano.

FAQ

Come si entra e si esce dalla modalità di pianificazione con Shift+Tab?

Premi Shift+Tab per scorrere le modalità di autorizzazione fino a selezionare la modalità di pianificazione. Per uscirne, passa alla modalità che vuoi usare per l'implementazione; il numero di pressioni dipende dalla modalità corrente della sessione.

La modalità di pianificazione può leggere file o eseguire comandi della shell?

La modalità di pianificazione può leggere file e utilizzare strumenti di sola lettura mentre prepara un piano. Dire che blocca ogni comando è inesatto, ma il suo comportamento documentato consiste nella pianificazione in sola lettura, che attende l'approvazione prima dell'implementazione.

Come si avvia ogni sessione in modalità di pianificazione?

Imposta permissions.defaultMode a "plan" in ~/.claude/settings.json, come mostrato nella discussione datata nel repository. Per una singola sessione, avvia Claude Code con claude --permission-mode plan.

La modalità di pianificazione fa risparmiare token?

Fornire i percorsi dei file noti fa risparmiare token di ricerca e definire criteri di accettazione può ridurre i cicli di revisione. La pianificazione stessa aggiunge lavoro, quindi il risparmio netto dipende da ciò che aiuta a evitare; le evidenze fornite non stabiliscono alcuna percentuale fissa né un benchmark ufficiale del risparmio netto.