Passa al contenuto principale

Plan Mode

Principiante
What you'll learn
  • Spiegare cosa blocca Plan Mode — e cosa lascia comunque eseguire a Claude
  • Entrare e uscire da Plan Mode in tre modi diversi
  • Percorrere il ciclo investiga-proponi-approva-esegui
  • Distinguere Plan Mode 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. Plan Mode è il sopralluogo.

Plan Mode dice a Claude di studiare e proporre le modifiche senza farle: legge i file, esegue comandi shell per esplorare e scrive un piano — ma non modifica il tuo codice sorgente. Le modifiche restano bloccate finché non approvi il piano.

Pro tip
  • Plan Mode significa che Claude INVESTIGA ma non CAMBIA il tuo codice sorgente — produce un piano e attende il tuo via.

Non è strettamente in sola lettura​

Esplorare a volte richiede un comando, quindi Plan Mode riguarda il non modificare, non il non eseguire. Cosa accade a un comando shell durante la pianificazione dipende dalla sessione — vince il primo caso che corrisponde:

Guided walkthrough1 of 3
  1. I blocchi di Plan Mode NON vengono imposti. Claude riceve comunque l'istruzione di pianificare senza modificare, ma una modifica o un comando che tenta durante la pianificazione viene eseguito senza chiedere conferma. Plan Mode mantiene i suoi blocchi in tutti gli altri casi: le esecuzioni headless con -p, l'Agent SDK e il pannello di chat dell'estensione VS Code.
Watch out
  • Se hai avviato con --allow-dangerously-skip-permissions, Plan Mode è un'istruzione forte più che una barriera rigida. Trattalo come una convenzione di pianificazione, non come una sandbox.

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. Plan Mode 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. Premi Shift+Tab per scorrere le modalità dei permessi finché la barra di stato non mostra 'plan mode on', oppure fai precedere un singolo prompt da /plan. Per partire già da lì, avvia con claude --permission-mode plan. Poi descrivi cosa vuoi ottenere.

Per uscire da Plan Mode senza approvare un piano, premi di nuovo Shift+Tab. Per renderla l'impostazione predefinita delle sessioni di terminale di un progetto, imposta defaultMode su plan in .claude/settings.json — vedi Impostazioni.

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.
Abbinala a CLAUDE.md

Un buon CLAUDE.md rende i piani più affilati — Claude pianifica avendo già a mente le tue convenzioni e protezioni.

Plan Mode contro Permessi​

Una classica confusione. Risolvono problemi diversi e lavorano insieme:

  • Plan Mode = «investiga e proponi, non modificare ancora». (Questa pagina.)
  • Permessi = una volta in azione, quali azioni sono consentite senza chiedere.

Pensala come se agire ora (Plan Mode) 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 / 5
Key takeaways
  • Plan Mode è studia-e-proponi: Claude legge ed esegue comandi esplorativi ma non modifica il tuo codice sorgente finché non approvi il piano
  • Non è strettamente in sola lettura — durante la pianificazione i comandi vengono esaminati dal classificatore, sottoposti alla tua approvazione oppure (con bypass permissions disponibile in un terminale interattivo) sbloccati del tutto
  • Entra con Shift+Tab, con il prefisso /plan o con --permission-mode plan; approvando la sessione passa alla modalità indicata dall'opzione di approvazione scelta
  • Usala per impostazione predefinita per lavori grandi, rischiosi o sconosciuti; salta solo le modifiche minuscole e ovvie
  • Plan Mode 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 Plan Mode?
  2. Quando dovresti ricorrere a Plan Mode?
  3. Qual è l'ordine corretto del ciclo di Plan Mode?
  4. In cosa differiscono Plan Mode e i Permessi?

Avanti​