Modalità Piano
- Spiegare cosa fa la Modalità Piano e perché è in sola lettura
- Decidere quando pianificare prima e quando puoi saltare il passaggio
- Percorrere il ciclo investiga-proponi-approva-esegui
- Distinguere la Modalità Piano dai Permessi e usarli insieme
L'idea di fondo
Immagina di consegnare le chiavi di casa a un artigiano oppure di chiedergli prima di fare un sopralluogo e mettere per iscritto cosa cambierebbe. La Modalità Piano è il sopralluogo.
La Modalità Piano rende Claude Code in sola lettura: può esplorare il tuo codebase, eseguire ricerche e ragionare — ma non modificherà i file né eseguirà comandi che alterano lo stato. Produce invece un piano e attende la tua approvazione.
- Sola lettura significa che Claude PENSA ma non AGISCE — nessuna modifica ai file, nessun comando che altera lo stato, finché non dici via.
Perché è il modo più sicuro per iniziare
Per qualsiasi cosa grande, rischiosa o sconosciuta, vuoi vedere cosa Claude intende fare prima che tocchi il tuo repository. La Modalità Piano separa il pensare dal fare:
Il vantaggio: cogli le assunzioni sbagliate prima che diventino codice sbagliato.
Quando usarla
- SEMPRE per cambiamenti grandi o su più file, migrazioni o refactoring
- Quando lavori in un codebase che non conosci ancora del tutto
- Quando vuoi un piano revisionabile da condividere con un collega
Per modifiche minuscole e ovvie puoi saltarla — ma nel dubbio, pianifica prima.
Come funziona in pratica
Segui il ciclo. Ogni passo guadagna il successivo — Claude passa a modificare solo dopo la tua approvazione.
- Passa alla modalità in sola lettura, poi descrivi cosa vuoi ottenere.
- Legge i file pertinenti e pone domande di chiarimento.
- I file da cambiare, l'approccio e come verificare il risultato.
- Solo dopo l'approvazione Claude passa a effettuare le modifiche.
Provala tu stesso
Copia questo in una vera sessione di pianificazione e osserva il ciclo svolgersi:
Avvia una sessione di pianificazione
I want to migrate our auth from sessions to JWT. Stay in Plan Mode: investigate the current setup, ask anything you need, then propose a step-by-step plan with files to change and how to verify — don't edit anything yet.
:::tip Abbinala a CLAUDE.md Un buon CLAUDE.md rende i piani più affilati — Claude pianifica avendo già a mente le tue convenzioni e protezioni. :::
Modalità Piano contro Permessi
Una classica confusione. Risolvono problemi diversi e lavorano insieme:
- Modalità Piano = "investiga e proponi, non agire ancora". (Questa pagina.)
- Permessi = una volta in azione, quali azioni sono consentite senza chiedere.
Pensala come se agire ora (Modalità Piano) contro quali azioni sono consentite una volta in azione (Permessi).
- La Modalità Piano è in sola lettura: Claude esplora e propone ma non modifica mai né esegue comandi che alterano lo stato finché non approvi
- Usala per impostazione predefinita per lavori grandi, rischiosi o sconosciuti; salta solo le modifiche minuscole e ovvie
- Il ciclo è investiga, poi proponi, poi approva/affina, poi esegui
- La Modalità Piano governa SE agire ora; i Permessi governano QUALI azioni sono consentite una volta in azione
Mettiti alla prova
0/4Avanti
- Permessi e modalità dei permessi
- Gestione del contesto — mantieni efficaci le sessioni lunghe
- Tutorial: personalizza Claude Code per un repository reale