Le modalità di permessi di Claude Code e la modalità Plan, spiegate

La prima volta che Claude Code chiede "Do you want to proceed?" per la quinta volta di fila, le persone fanno una di due cose. Alcune cliccano Yes senza leggere. Altre rinunciano a Claude Code perché continua a interromperle. Sono lo stesso errore: trattano il permesso come un'impostazione fissa invece che come una scelta da fare per ogni tipo di lavoro.

Questa guida spiega ogni modalità, mostra come passare dall'una all'altra con un solo tasto e ti dà una regola semplice per scegliere quella giusta. Tratta anche la modalità Plan, la funzione più utile e meno usata dai principianti.

Cosa controlla una modalità di permessi

Quando Claude Code vuole fare qualcosa che potrebbe cambiare il tuo computer, come modificare un file o eseguire un comando, succede una di due cose. Lo fa subito, oppure si ferma e te lo chiede. La modalità di permessi della sessione decide quale.

La modalità vale per la sessione in cui ti trovi. Non cambia il tuo account né gli altri progetti. Puoi cambiarla in qualsiasi momento senza perdere la conversazione.

Le modalità in sintesi

Claude Code ha sei modalità. Ne userai tre quasi ogni giorno.

Le scritture in luoghi protetti, come la cartella .git, .claude, il file di avvio della shell e .mcp.json, sono trattate in modo più rigoroso in ogni modalità tranne bypass.

Cambia modalità con Shift+Tab

Non devi ricordare nulla di tutto questo per nome. Premi Shift+Tab dentro una sessione e la modalità cambia. La barra di stato in basso mostra dove sei arrivato.

Puoi anche scegliere una modalità quando avvii Claude Code, ed è così che raggiungi quelle fuori dal ciclo:

$ claude --permission-mode plan$ claude --permission-mode acceptEdits$ claude --permission-mode dontAsk

Per rendere una modalità quella standard, imposta permissions.defaultMode in un file di impostazioni. Due dei valori, auto e bypassPermissions, vengono ignorati se impostati nei file di impostazioni del progetto stesso.

In quale modalità parte una sessione?

Dipende da come esegui Claude Code e da quale versione hai.

Se una sessione seleziona auto ma auto non è disponibile per te, parte in Manuale. Il punto è controllare la barra di stato invece di dare per scontato. Se non dice ciò che ti aspetti, premi Shift+Tab.

Manuale: approvi ogni passaggio

In modalità Manuale Claude può leggere liberamente i tuoi file, e chiede prima di modificare un file o eseguire un comando. È la modalità giusta quando sei alle prime armi, quando il codice è delicato o quando non conosci bene il progetto.

Il costo sono le interruzioni. Il vantaggio è che non succede nulla che tu non abbia visto. Per una prima sessione, parti da qui e osserva cosa chiede Claude. Capisci in fretta quali richieste sono di routine.

Accetta modifiche: iterazioni rapide su codice che rivedrai

La modalità Accetta modifiche (Accept edits) permette a Claude di cambiare i file nella cartella del progetto e di eseguire comandi comuni sui file senza chiedere. Continua a chiedere per gli altri comandi e per qualsiasi cosa fuori dalla tua cartella.

È la modalità per lavorare su codice che pensi di leggere dopo. Descrivi una modifica, Claude la fa e tu rivedi il diff nel tuo editor o con git. Fa risparmiare più clic con il minor rischio.

Modalità Plan: prima pensa, poi cambia

In modalità Plan, Claude legge i tuoi file ed esplora il progetto, poi scrive un piano. Non può modificare i tuoi file sorgente finché non approvi quel piano.

La modalità Plan dà il meglio quando una modifica tocca molti file, quando non capisci ancora il codice o quando un errore costerebbe caro. Cinque minuti passati a leggere un piano spesso fanno risparmiare un'ora a disfare una modifica sbagliata.

Modalità Auto: meno interruzioni, con un controllo di sicurezza

La modalità Auto è per i compiti lunghi che non vuoi sorvegliare. Invece di chiederti conferma per ogni azione, un modello separato rivede ogni azione in background e blocca quelle rischiose.

L'ordine è semplice. Le regole che imposti si applicano per prime. Leggere e modificare i file nel tuo progetto è approvato automaticamente. Tutto il resto passa al modello revisore, e se blocca qualcosa, Claude ne riceve il motivo e prova un'altra strada.

• Bloccato per impostazione predefinita: scaricare ed eseguire uno script da internet, inviare dati sensibili a indirizzi esterni, fare deploy in produzione o eseguire migrazioni, force push, hard reset che buttano via lavoro e unire una pull request che nessuno ha approvato.
• Consentito per impostazione predefinita: il lavoro sui file locali nel tuo progetto, l'installazione delle dipendenze elencate nei tuoi lock file, le richieste web di sola lettura e il push sui rami del repository corrente (tranne i rami indicati come destinazioni di deploy).

Se il revisore blocca tre azioni di fila, o venti in totale, la modalità auto si ferma e Claude torna a chiedere a te. Approvare l'azione per cui chiede fa riprendere la modalità auto. Le azioni bloccate sono elencate sotto /permissions, nella scheda Recently denied.

La modalità auto richiede un modello supportato e può essere disattivata da un amministratore nei piani Team ed Enterprise. Per questo controlli la barra di stato.

Non chiedere e bypass: per script e macchine isolate

Due modalità esistono per l'automazione, e non sono per il lavoro di tutti i giorni.

Non chiedere (Don't ask) rifiuta tutto ciò che normalmente chiederebbe. La sessione non aspetta mai te, ed esegue solo ciò che hai pre-approvato. Si adatta a script bloccati e CI, dove elenchi esattamente cosa è consentito:

$ claude -p 'run the test suite' --permission-mode dontAsk --allowedTools 'Bash(npm test)' 'Read'

Bypass dei permessi (Bypass permissions) salta ogni controllo, compresa la protezione delle cartelle sensibili. Le regole di divieto (deny) si applicano ancora e poche azioni critiche chiedono comunque conferma. Esiste per ambienti isolati come un container o una macchina virtuale senza accesso a internet, perché non offre alcuna protezione contro un'istruzione malevola nascosta in un file o in una pagina web. Non puoi passarci da una sessione che non è partita con questa modalità abilitata, e al primo avvio Claude Code ti chiede di assumerti la responsabilità.

Le regole stanno sopra le modalità

Una modalità fissa la base. Puoi aggiungere regole per comandi precisi, e valgono in ogni modalità che controlla i permessi:

• Le regole allow pre-approvano uno strumento o un comando, per esempio Bash(npm test).
• Le regole ask impongono una richiesta, anche in modalità auto.
• Le regole deny bloccano un'azione in ogni modalità, compresa bypass.

Le regole stanno nei file di impostazioni: ~/.claude/settings.json per te, .claude/settings.json per il progetto e .claude/settings.local.json per le modifiche private. Una regola allow stretta come Bash(npm test) è la prima migliore da aggiungere, perché eseguirai i test di continuo.

Dentro Claude Tutorial

Decidere quanto delegare è una competenza

Scegliere cosa affidare e cosa continuare a rivedere è il giudizio che l'app costruisce attraverso molti compiti, e vale ben oltre il codice.

In arrivo

Scarica suApp Store

DISPONIBILE SUGoogle Play

Quale modalità devo usare?

Abbina la modalità alla situazione, non all'abitudine.

Un buon ritmo predefinito per una modifica vera: prima pianifica, approva il piano, lascia lavorare Claude in Accetta modifiche o auto, poi rivedi tu il diff. Tratta ciò che esce come la pull request di un collega.

Domande frequenti

Come cambio modalità di permessi in Claude Code?

Premi Shift+Tab dentro una sessione per passare da una modalità all'altra. Parti con una modalità specifica usando claude --permission-mode <name>, oppure imposta un valore predefinito con permissions.defaultMode nelle impostazioni.

Cos'è la modalità Plan in Claude Code?

Una modalità in cui Claude legge ed esplora il tuo progetto e scrive un piano, ma non può modificare i tuoi file finché non approvi il piano. Si attiva con Shift+Tab, con /plan prima di una richiesta o con --permission-mode plan.

La modalità auto è sicura?

È più sicura che approvare alla cieca, perché un modello separato controlla ogni azione e blocca quelle rischiose come i deploy in produzione e i force push. Non è una garanzia. Tieni il lavoro in git e rivedi il risultato.

Cosa fa la modalità Accetta modifiche?

Permette a Claude di modificare file ed eseguire comandi comuni sui file come mkdir, mv e cp dentro il tuo progetto senza chiedere. Gli altri comandi continuano a chiedere.

Perché Claude Code continua a chiedere il permesso?

Molto probabilmente sei in modalità Manuale, oppure Claude sta toccando qualcosa fuori dal tuo progetto o una cartella protetta. Controlla la barra di stato e aggiungi una regola allow per i comandi di cui ti fidi, come il comando dei test.

Cos'è --dangerously-skip-permissions?

Lo stesso della modalità bypass dei permessi. Salta tutte le richieste e i controlli e va usato solo in ambienti isolati.

La tua checklist sui permessi

Continua a leggere

• Claude Code per principianti: installa, accedi ed esegui il tuo primo compito se questa è la tua prima sessione.
• CLAUDE.md spiegato: insegna il tuo progetto a Claude Code una volta sola per smettere di ripetere le stesse istruzioni.
• Buone pratiche per Claude Code: abitudini che migliorano i risultati per prompt, controlli e gestione del contesto.
• Come fare modifiche su più file con Claude Code per una modifica con piano iniziale, nella pratica.