Risposta breve: la modalità piano è una modalità di permessi di Claude Code in cui il modello esplora il tuo codice e propone un approccio senza toccare i file. La documentazione di Anthropic lo descrive con precisione: in modalità piano Claude legge i file ed esegue comandi shell di sola lettura per esplorare, ma non modifica i file sorgente e, dove è disponibile la modalità auto, vengono eseguiti anche i comandi approvati dal classificatore. Nella CLI e nell’estensione per VS Code compare come Plan. Ci si arriva premendo Shift+Tab per scorrere le modalità di permessi, oppure avviando la sessione con claude --permission-mode plan. Non costa nulla in più: è una modalità, non una funzione a pagamento.
Cosa comprende
La modalità piano convive con le altre modalità di permessi di Claude Code, e vale la pena conoscere le differenze perché determinano quanta supervisione servirà.
Anthropic documenta le modalità così. default, indicata come Manuale nella CLI, nelle estensioni per VS Code e JetBrains e nell’app desktop, chiede il permesso al primo uso di ogni strumento. acceptEdits accetta automaticamente le modifiche ai file e i comandi di filesystem più comuni come mkdir, touch, mv e cp per i percorsi nella directory di lavoro o in additionalDirectories. plan esplora senza modificare. auto approva automaticamente le chiamate agli strumenti, con controlli di sicurezza in background che verificano la coerenza delle azioni con la tua richiesta. dontAsk nega automaticamente gli strumenti se non pre-approvati. bypassPermissions salta le richieste di permesso tranne per le azioni che nessuna modalità approva da sola.
Quello che ottieni in modalità piano è accesso completo in lettura e nessun accesso in scrittura. Claude può aprire file, seguire gli import, eseguire comandi shell di sola lettura per capire il progetto e costruirsi un quadro fedele del funzionamento prima di proporre una modifica. Quello che non può fare è modificare il tuo sorgente.
Proprio quel vincolo è tutto il valore. Il fallimento più costoso nella programmazione con agenti non è una risposta sbagliata, sono venti modifiche sicure nella direzione sbagliata che poi devi disfare.
Come attivare la modalità piano
Tre strade, a seconda di come lavori.
- Scorrere con Shift+Tab. Anthropic documenta questo tasto come scorrimento tra default, acceptEdits, plan e, quando disponibili, bypassPermissions e poi auto. Da auto, la prima pressione riporta a default. Su Windows, Alt+M fa lo stesso quando il runtime Node o Bun non abilita la modalità di input VT.
- Avviare la sessione già in modalità piano. Passa il flag:
claude --permission-mode plan. Il riferimento della CLI nota che questo consente di iniziare in un’altra modalità come plan e passare a bypassPermissions in seguito. - Impostarla come predefinita per le sessioni delegate. Lo stesso riferimento documenta il passaggio di
--permission-modeinsieme a--model,--efforto--agentper impostare i valori predefiniti delle sessioni delegate, utile quando lanci lavoro in background.
Controlla l’indicatore di modalità prima di descrivere un’attività. L’errore più comune con la modalità piano è dare per scontato di esserci quando non è così.
Lo schema ricerca, piano, implementazione
Lo schema che sfrutta meglio questa modalità ha tre fasi distinte, e la disciplina sta nel tenerle separate.
Ricerca. In modalità piano, chiedi a Claude di indagare invece che di riparare. “Spiega come funziona l’autenticazione in questo codice, dove vengono rinnovati i token e cosa succede quando il rinnovo fallisce.” Stai comprando un modello mentale fedele, e puoi confrontarlo con quello che già sai: è il tuo controllo sulla solidità di tutto il resto.
Piano. Sempre in modalità piano, chiedi un approccio: quali file cambiano, in quale ordine, quali sono i rischi, cosa va testato. Chiedi di scrivere quel piano in un file Markdown, così sopravvive alla sessione e può essere riletto da qualcun altro. Un buon piano nomina i file, fissa la sequenza ed è esplicito su ciò di cui non è sicuro.
Implementazione. Cambia modalità ed esegui rispetto al piano concordato. Poiché il piano è scritto, puoi verificare ogni passo confrontandolo con esso invece di rileggere un diff enorme senza punti di riferimento.
La documentazione sui flussi di lavoro comuni copre anche la delega della ricerca ai subagenti, che si combina naturalmente con questo schema: l’esplorazione è esattamente il tipo di lavoro che merita un contesto separato.
Cosa contiene davvero un buon piano
La maggior parte dei piani deludenti delude perché la richiesta era poco specificata. Un piano su cui vale la pena implementare contiene cinque cose, e chiederle esplicitamente cambia parecchio il risultato.
Nomina i file. “Aggiorna il middleware di autenticazione” non è un piano; “modifica src/auth/middleware.ts e src/auth/refresh.ts, aggiungi un test in tests/auth/refresh.test.ts” lo è.
Indica una sequenza con una motivazione. Fare la migrazione prima della modifica al codice, o il contrario, è di solito una decisione con conseguenze, e un piano che non spiega l’ordine non ci ha ragionato.
Individua cosa potrebbe rompersi. Quali chiamanti dipendono dal comportamento attuale, cosa succede alle richieste in corso durante un rilascio, se la modifica è retrocompatibile.
Dice di cosa non è sicuro. È la sezione più preziosa e quella che devi chiedere espressamente. Un modello che elenca tre assunzioni che non ha potuto verificare dal codice ti sta dando esattamente la lista da controllare di persona.
Definisce la verifica. Come saprai che la modifica ha funzionato, espresso come test o comportamento osservabile invece che come “dovrebbe funzionare”.
Chiedi questi cinque punti e il piano diventa un documento che puoi passare a un collega, non un paragrafo di intenzioni.
Valore e confronto tra modalità
| Modalità | Scrive file | Ideale per | Rischio principale |
|---|---|---|---|
| default (Manuale) | Solo dopo richiesta ogni volta | Lavoro attento su codice non familiare | Stanchezza da richieste e approvazione automatica |
| plan | No | Capire, progettare, rivedere un approccio | Dimenticarsi di uscirne |
| acceptEdits | Sì, in automatico | Modifiche meccaniche ben delimitate | Modifiche non riviste |
| auto | Sì, con controlli di sicurezza | Lavoro ripetitivo di fiducia | Fiducia eccessiva su modifiche importanti |
| bypassPermissions | Sì, senza richieste | Sandbox e ambienti usa e getta | Tutto |
Il confronto che conta di più è plan contro acceptEdits, perché sono le due tra cui si alterna davvero. Usa plan quando non sai ancora quale sia la modifica giusta. Usa acceptEdits quando lo sai e il lavoro è meccanico.
C’è anche un argomento di costo. Le sessioni lunghe con agenti consumano contesto, e il contesto è ciò che consuma la tua quota d’uso. Una sessione che modifica per venti minuti nella direzione sbagliata e poi torna indietro costa molto più di una che dedica cinque minuti alla lettura e poi esegue in modo pulito. La documentazione di Anthropic sui costi di Claude Code spiega come funziona l’utilizzo nel terminale, e l’indicatore di contesto in tempo reale è il numero da tenere d’occhio.
Piani, fatturazione e cosa verificare
La modalità piano non è di per sé un livello a pagamento, e l’accesso a Claude Code dipende dal tuo abbonamento. La documentazione di supporto di Anthropic spiega che gli abbonati Pro e Max autenticano Claude Code con le stesse credenziali che usano per Claude, quindi un abbonamento copre entrambi.
Cose da confermare sul sito ufficiale prima di farci affidamento:
- Quali piani includono Claude Code e con quale livello di utilizzo. La pagina dei prezzi elenca Free, Pro, Max 5x e Max 20x, con Max descritto come 5 o 20 volte l’utilizzo di Pro.
- Il tuo ciclo di fatturazione e se si applica il mensile o l’annuale.
- Se sulla tua macchina è impostata una variabile d’ambiente
ANTHROPIC_API_KEY. Anthropic segnala che in quel caso Claude Code usa quella chiave per autenticarsi invece dell’abbonamento, il che significa fatturazione a token anziché consumo del piano. - Eventuali impostazioni di policy a livello di organizzazione se sei su un piano Team o Enterprise, dato che le modalità di permessi possono essere limitate centralmente.
Avvertenze sui prezzi
Prezzi, nomi dei piani e quote d’uso cambiano, e nulla in questa pagina va inteso come un preventivo attuale. Verifica i prezzi correnti sul sito ufficiale prima di impegnarti.
Due ulteriori avvertenze vanno dette chiaramente. Primo, la disponibilità delle singole modalità varia: la documentazione di Anthropic nota che bypassPermissions e auto compaiono nel ciclo solo “quando disponibili”, il che dipende dalla tua versione e dalle impostazioni della tua organizzazione. Secondo, alcune etichette e alias dipendono dalla versione, e l’etichetta Manuale è documentata a partire da una specifica versione di Claude Code. Se il tuo indicatore non corrisponde a quanto leggi qui, aggiorna prima di dare per scontato che qualcosa sia rotto.
Risoluzione dei problemi della modalità piano
- Claude ha modificato i file lo stesso. Non eri in modalità piano. Controlla l’indicatore e ricorda che Shift+Tab scorre invece di commutare, quindi una pressione di troppo ti porta oltre.
- Il piano è vago. I piani vaghi seguono richieste vaghe. Chiedi file nominati, una sequenza ordinata e un elenco esplicito delle incertezze.
- Continua a chiedere di eseguire comandi. La modalità piano consente comandi shell di sola lettura. Un comando che non considera di sola lettura chiederà comunque il permesso, ed è la modalità che funziona correttamente.
- Il piano è sparito a fine sessione. Chiedilo come file Markdown nel repository. Un piano che resta nello scrollback è un piano che perderai.
- Shift+Tab non fa nulla su Windows. Anthropic documenta Alt+M come alternativa quando il runtime Node o Bun non abilita la modalità di input VT.
Prodotto, corso, app e piattaforma nella pratica
Ci sono tre strade per diventare bravi in questo, e servono a persone diverse. La documentazione del prodotto è autorevole e sintetica, il che funziona bene se sai già cosa cerchi. Sperimentare nel proprio repository insegna i tuoi specifici modi di sbagliare, ma lentamente. Un corso strutturato dà la sequenza e il vocabolario, ed è la strada più rapida per chi non ha ancora formato abitudini.
I team che ricavano di più da questa modalità trattano il piano come il risultato della prima sessione, non come premessa al lavoro vero. Un piano scritto può essere riletto da un collega, contestato e corretto prima che cambi una sola riga, ed è un punto molto più economico dove fermare una cattiva idea rispetto a una pull request.
Farlo bene è più una competenza nel guidare questi strumenti che una funzione al loro interno: sapere quanto contesto fornire, come chiedere un piano verificabile invece che plausibile, e dove la sicurezza del modello supera quello che sa davvero del tuo sistema. Impararlo in una sequenza strutturata è più veloce che scoprirlo sessione dopo sessione, e si trasferisce a ogni strumento con agenti invece che a un solo prodotto. Se vuoi un percorso strutturato, esplora le lezioni di Coursiv e verifica i dettagli dei piani correnti sul sito ufficiale.
Domande frequenti
Claude può modificare i file in modalità piano?
Come attivo la modalità piano?
claude --permission-mode plan. Su Windows, Alt+M scorre le modalità nei runtime che non abilitano la modalità di input VT.La modalità piano costa di più?
La modalità piano fa risparmiare utilizzo?
Il prossimo passo
Alla prossima attività non banale, parti in modalità piano e chiedi l’approccio come file Markdown prima che venga modificato qualsiasi cosa. Leggilo per davvero, correggi le due cose che ha frainteso del tuo sistema e solo allora cambia modalità e implementa rispetto a quello. Quasi tutti quelli che ci provano una volta smettono di lavorare in altro modo, perché il piano trasforma un diff enorme e non verificabile in una sequenza di passi che avevi già approvato.