Le modalità dei permessi di Claude Code spiegate (default, acceptEdits, plan, bypassPermissions)

01Le sei modalità in breve

default è il nome usato nelle impostazioni, negli hook e nel flag --permission-mode. La CLI, le estensioni per IDE e l'app desktop la chiamano Manuale, e la CLI accetta manual come alias.

02Come cambiare modalità

Nel terminal, premi Shift+Tab. Il ciclo passa per default, acceptEdits, plan e poi le eventuali modalità opzionali consentite dalla sessione. dontAsk non compare mai nel ciclo: la imposti solo con il flag.

Per avviare una sessione in una modalità:

claude --permission-mode plan

Per rendere una modalità quella predefinita, impostala in ~/.claude/settings.json:

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

Il flag ha la precedenza sull'impostazione, e l'impostazione su quella predefinita integrata. C'è una restrizione da conoscere: auto e bypassPermissions non hanno effetto se impostate nel .claude/settings.json o nel .claude/settings.local.json di un progetto. Un repository non può metterti in bypass di nascosto. Imposta queste due nelle impostazioni utente, oppure passa il flag.

In che modalità parte una nuova sessione

Le versioni recenti di Claude Code (v2.1.283 o successive) avviano le sessioni interattive nel terminal e in VS Code in auto quando la modalità auto è disponibile, a meno che le tue impostazioni non dicano altro. claude -p e le esecuzioni dell'Agent SDK partono in default. Se non hai mai scelto una modalità e ti chiedi perché vedi così pochi prompt, ecco il motivo.

03Le modalità nel dettaglio

default (Manuale)

Claude può leggere i file senza chiedere. Modifiche, comandi shell e accesso alla rete mostrano ciascuno un prompt. Su un prompt Bash, "Yes, and don't ask again" salva una regola allow in .claude/settings.local.json, così quel comando non chiederà più nulla in questo repository. Le approvazioni per le modifiche ai file durano fino alla fine della sessione.

acceptEdits

Le modifiche e i comandi semplici sui file (mkdir, touch, rm, rmdir, mv, cp, sed) nella directory di lavoro vengono eseguiti senza prompt. Gli altri comandi shell chiedono comunque. Un buon compromesso quando segui il diff in tempo reale.

plan

Claude esplora con letture e comandi in sola lettura, poi presenta un piano. Nel tuo codice non viene modificato nulla finché non lo approvi. Usala con codice che non conosci o per modifiche rischiose.

auto

Un modello separato esamina ogni azione prima che venga eseguita e blocca quelle che vanno oltre la tua richiesta, toccano infrastruttura che non riconosce o sembrano guidate da contenuti ostili. Le regole ask esplicite mostrano comunque il prompt. Se il classificatore blocca tre azioni di fila o venti in una sessione, la modalità auto si mette in pausa e tornano i prompt normali. Per usare le parole di Anthropic, la modalità auto "riduce i prompt di autorizzazione ma non garantisce la sicurezza".

dontAsk

Tutto ciò che richiederebbe un prompt viene negato. Vengono eseguite solo le regole allow e le azioni che non richiedono mai approvazione. Esiste per script e CI, dove non c'è nessuno a rispondere.

bypassPermissions e --dangerously-skip-permissions

--dangerously-skip-permissions equivale a --permission-mode bypassPermissions. I prompt vengono saltati, anche per le scritture su percorsi protetti come .git e .claude. Alcune cose mostrano comunque un prompt o vengono negate in ogni modalità, tra cui le regole ask esplicite, AskUserQuestion e alcuni comandi rm pericolosi. Le regole deny bloccano comunque.

Anthropic consiglia di usarla solo in container, VM o dev container senza accesso a internet. Su Mac e Linux, Claude Code si rifiuta di partire in questa modalità come root o con sudo fuori da una sandbox riconosciuta. Se vuoi solo avere il bypass disponibile, senza attivarlo, --allow-dangerously-skip-permissions lo aggiunge al ciclo di Shift+Tab senza passarci.

04Le regole si sommano alle modalità

Le modalità definiscono la base. Le regole di autorizzazione nelle impostazioni la rifiniscono:

{
  "permissions": {
    "allow": ["Bash(npm run test *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"]
  }
}

Le regole vengono valutate nell'ordine deny, poi ask, poi allow, e decide la prima che corrisponde. Le regole deny bloccano in ogni modalità, compresa bypassPermissions. Le regole allow non hanno effetto in bypassPermissions, perché lì è già tutto consentito. Esegui /permissions per vedere tutte le regole e il file da cui provengono.

Anche gli hook possono intervenire. Un hook PreToolUse può bloccare una chiamata a un tool in qualsiasi modalità. Un hook PermissionRequest può rispondere a un prompt al posto tuo, ma non può scavalcare una regola deny. La guida a PermissionRequest spiega come fare.

05Scegliere una modalità quando ti allontani

Di solito si ricorre a --dangerously-skip-permissions perché si vuole lasciare Claude al lavoro senza ritrovare la sessione bloccata su un prompt. Il problema è reale, ma la modalità bypass lo risolve eliminando del tutto il tuo controllo, e sulla tua macchina.

Alcune combinazioni più sicure:

• Regole allow per i comandi noiosi. Aggiungi i comandi di test, lint e build ad allow, tieni ask su git push e sui deploy, e resta in default o acceptEdits.
• Modalità auto per i task lunghi in cui accetti che sia un classificatore a giudicare le azioni di routine.
• Fatti arrivare il prompt ovunque tu sia. Tieni una modalità che chiede conferma e rispondi dal telefono ai pochi prompt che contano.

L'ultima è quella che fa Claude Code Notifier. È uno strumento indipendente, non realizzato da Anthropic. Il suo tool da riga di comando, ccn, gira come hook di Claude Code su Mac, Windows e Linux. Quando Claude Code sta per chiedere un permesso e tu non sei alla tastiera, la richiesta arriva al tuo telefono iPhone o Android associato, dove puoi consentire una volta, consentire per la sessione o negare. Vede solo i prompt che Claude Code avrebbe mostrato comunque, quindi sono sempre la modalità e le tue regole a decidere cosa va chiesto. In modalità auto ricevi meno richieste; in bypassPermissions nessuna, anche se gli avvisi "Claude ha finito" e le domande arrivano comunque. La guida all'approvazione da telefono spiega la configurazione, e Approvare dal telefono è sicuro? ne descrive i rischi.

06FAQ