Passa al contenuto principale

Modalità Piano

Principiante
What you'll learn
  • 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.

Pro tip
  • 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

Pro tip
  • 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.

Guided walkthrough1 of 4
  1. Passa alla modalità in sola lettura, poi descrivi cosa vuoi ottenere.

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).

Premi Invio o Spazio per girare la carta. Usa le frecce sinistra e destra per spostarti tra le carte.Termine mostrato.
1 / 4
Key takeaways
  • 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/4
  1. Cosa può fare Claude Code mentre è in Modalità Piano?
  2. Quando dovresti ricorrere alla Modalità Piano?
  3. Qual è l'ordine corretto del ciclo della Modalità Piano?
  4. In cosa differiscono la Modalità Piano e i Permessi?

Avanti