Workbranch › Guide

Come usare la plan mode in Claude Code

Lasciare che Claude Code modifichi subito i file è veloce, finché non prende la strada sbagliata su dieci file. La plan mode (modalità piano) lo fa prima studiare e poi presentarti un piano, e nella maggior parte delle configurazioni non può modificare i tuoi file finché non approvi. Ecco come attivarla, rivedere il piano e capire quando ne vale la pena.

Aggiornato 30 ottobre 2026

Tasti e nomi delle opzioni qui sotto sono stati verificati sulla documentazione di Claude Code di Anthropic a ottobre 2026. La formulazione delle opzioni può cambiare da una versione all'altra.

Cosa fa la plan mode

La plan mode è una delle modalità di permesso di Claude Code. In questa modalità Claude può leggere i tuoi file ed eseguire comandi di shell per capire il codice, poi scrive un piano per la modifica. Le modifiche al tuo codice sono bloccate finché non approvi quel piano. Valuti l'approccio una volta sola, all'inizio, invece di giudicare una modifica dopo l'altra.

Attivare la plan mode

Ci sono quattro modi, a seconda di quanto spesso ti serve.

• Durante la sessione: premi Shift+Tab per scorrere le modalità finché la barra di stato non indica ⏸ plan mode on. Premendolo di nuovo esci dalla plan mode senza approvare nulla.
• Insieme a un compito: inizia il prompt con /plan, per esempio /plan add rate limiting to the login endpoint.
• All'avvio: esegui claude --permission-mode plan.
• Come predefinita del progetto: nel file .claude/settings.json del progetto imposta "defaultMode": "plan" dentro "permissions". Nell'estensione per VS Code imposta invece claudeCode.initialPermissionMode su plan nelle impostazioni utente, perché VS Code non legge l'impostazione del progetto per la modalità iniziale.

Rivedere e approvare il piano

1. Con la plan mode attiva, descrivi il compito e come dovrebbe essere un buon risultato. Cita i file o i vincoli che già conosci.
2. Lascia che Claude esplori. Legge il codice e può eseguire comandi; a seconda della configurazione, alcuni comandi chiedono la tua approvazione.
3. Leggi il piano che presenta. Controlla quali file vuole modificare, l'ordine dei passaggi e come verificherà il risultato.
4. Per cambiare il piano tu stesso, premi Ctrl+G. Il piano si apre nel tuo editor di testo predefinito; salvalo e Claude lavora sulla tua versione.
5. Scegli un'opzione:
   • Yes, and use auto mode (sì, e usa la modalità auto; appare come Yes, auto-accept edits quando la modalità auto non è disponibile): approvi e lasci che Claude faccia le modifiche senza chiedere ogni volta.
   • Yes, manually approve edits (sì, approva le modifiche manualmente): approvi, ma controlli ogni modifica.
   • No, keep planning: resti in plan mode e dici a Claude cosa cambiare.

Approvando esci dalla plan mode e passi alla modalità che hai scelto, e Claude si mette al lavoro. La sessione riceve anche un titolo generato, se non le hai già dato un nome. Se l'impostazione showClearContextOnPlanAccept è attiva, compare una prima opzione in più che approva il piano e cancella la conversazione di pianificazione.

Quando usare la plan mode

• Modifiche su più file, come un refactoring o una nuova funzione, dove un approccio sbagliato costa caro da annullare.
• Codice che non conosci ancora. Anthropic suggerisce la plan mode per esplorare un codebase prima di modificarlo.
• Lavori in cui vuoi dire la tua sull'approccio: correggi il piano con Ctrl+G prima che venga toccato qualsiasi file.
• Di solito non serve per correzioni piccole e ovvie come un refuso, dove rivedere un piano richiede più tempo della modifica stessa.

Mettere i comandi di test e le convenzioni in un file CLAUDE.md dà al piano materiale migliore su cui lavorare.

Da sapere

• Claude Code è incluso nei piani Pro e Max, nello stesso abbonamento delle app di Claude; per i membri Team ed Enterprise c'è un articolo di assistenza separato.
• Come vengono gestiti i comandi di shell durante la pianificazione dipende dalla sessione: se la modalità auto è disponibile, per impostazione predefinita li valuta un classificatore; altrimenti, i comandi fuori dall'insieme integrato di sola lettura chiedono prima.
• I file dei piani vengono salvati in ~/.claude/plans/, a meno che plansDirectory non indichi un'altra cartella.
• Un'eccezione al blocco delle modifiche: in una sessione interattiva nel terminale in cui è disponibile la modalità bypass permissions, a Claude viene comunque detto di limitarsi a pianificare, ma Claude Code non lo impone, quindi una modifica tentata durante la pianificazione può partire senza richiesta. Nelle esecuzioni con -p, nell'Agent SDK e nel pannello chat di VS Code il blocco vale sempre.

Se non funziona

• Shift+Tab non arriva alla plan mode. Continua a premerlo: scorre tutte le modalità. Cerca ⏸ plan mode on nella barra di stato.
• Claude ha iniziato a modificare dopo il piano. È normale una volta che scegli un'opzione Yes. Scegli No, keep planning se non sei pronto.
• In VS Code la predefinita del progetto non viene applicata. Usa l'impostazione utente claudeCode.initialPermissionMode.
• Ctrl+G apre un programma che non ti aspettavi. Il piano si apre in quello che è impostato come editor di testo predefinito, quindi cambia quell'impostazione se ne vuoi un altro.

Conserva i punti aperti del piano

Un piano fa spesso emergere decisioni e attività di follow-up che durano più della sessione. Con il plugin Workbranch per Claude Code, esegui /workbranch:save e Claude archivia i compiti, le decisioni e le domande aperte della sessione in un progetto Workbranch. Workbranch offre una prova gratuita di 3 giorni su app.workbranch.ai.

Fonti

• Permission modes (Claude Code Docs, verificato il 2026-10-30)
• Common workflows (Claude Code Docs, verificato il 2026-10-30)
• Commands (Claude Code Docs, verificato il 2026-10-30)
• Use Claude Code with your Pro or Max plan (Claude Help Center, verificato il 2026-10-30)

Domande frequenti