Una modalità di autorizzazione di Claude Code decide quali azioni l'agente può compiere senza fermarsi a chiedere. Ce ne sono quattro: plan legge ma non modifica nulla, default chiede conferma prima di modifiche e comandi in base alle tue regole di autorizzazione, acceptEdits applica le modifiche ai file senza chiedere ma continua a chiedere per i comandi, e bypassPermissions non chiede nulla. Sceglierne una è una dichiarazione di quanta fiducia riponi nell'agente in questa directory.
Questa dichiarazione si complica non appena la persona che digita la richiesta non è il proprietario della macchina. Questo post spiega le modalità per come le definisce Claude Code, e poi cosa cambia in una stanza condivisa.
Le quattro modalità
plan. L'agente legge i file, cerca e ragiona, e produce un piano. Non modifica né esegue nulla. È la modalità pensata per “dimmi cosa faresti” e per consentire a qualcuno di esplorare una codebase che non dovrebbe poter modificare.
default. L'agente chiede prima di ogni modifica e di ogni comando, a meno che le tue regole di autorizzazione non consentano già quello strumento o pattern specifico. Ottimo per il pairing, dove stai osservando e ogni prompt rappresenta una decisione reale.
acceptEdits. Le modifiche ai file passano senza prompt; per i comandi viene ancora chiesta conferma. Utile in un repository in cui annullare una modifica errata costa poco (è sotto controllo di versione), ma eseguire il comando sbagliato no.
bypassPermissions. Non chiede nulla. L'indicazione di Anthropic è di riservarlo ad ambienti isolati ed effimeri, perché un'istruzione errata o iniettata viene eseguita con tutti i tuoi privilegi locali.
La scala da plan a bypassPermissions, e le quattro azioni che si mettono in pausa indipendentemente dalla modalità quando l'agente è condiviso.
Perché le modalità riguardano le directory, non le persone
Una modalità di autorizzazione viene impostata per una sessione, il che in pratica significa per una working directory. È l'unità giusta quando sei da solo: il repository della documentazione può girare in acceptEdits, quello dell'infrastruttura in default, un esperimento usa-e-getta in bypassPermissions.
Smette di essere sufficiente quando una seconda persona può inviare richieste. La sua richiesta viene eseguita con la modalità della tua sessione. Un co-founder che deve solo leggere il codice ora lo sta modificando perché la settimana scorsa hai impostato acceptEdits per te stesso. Non c'è alcuna dimensione per persona nella modalità in sé.
Cosa cambia in una stanza
In una stanza muti l'agente ha ancora una modalità di autorizzazione di Claude Code, scelta quando crei l'agente per una directory. A questa si sovrappongono due elementi.
Per-person permission. Ogni richiesta proveniente da qualcuno diverso dal proprietario viene approvata singolarmente, oppure è coperta da un'autorizzazione permanente “always allow” concessa a quella persona per quell'agente. Puoi revocare l'autorizzazione permanente in qualsiasi momento; le richieste in coda di quella persona vengono annullate.
Quattro azioni che si mettono sempre in pausa. Indipendentemente dalla modalità e dall'autorizzazione concessa, fare push su un branch condiviso, eliminare risorse, spendere denaro e toccare credenziali richiedono l'intervento del proprietario. Persino un agente in bypassPermissions qui si mette in pausa quando la richiesta proviene da qualcun altro. La motivazione è spiegata in quattro azioni su cui un agente dovrebbe sempre chiedere conferma.
Una mappatura pratica
- Esplorazione per altri: crea l'agente in
plan. Gli ospiti possono fare domande, nulla cambia su disco. - Lavoro quotidiano con persone di cui ti fidi:
acceptEdits, con un'autorizzazione permanente per queste persone. I comandi chiedono ancora conferma; le quattro azioni continuano a mettersi in pausa. - La tua sandbox usa-e-getta:
bypassPermissionsva benissimo perché nessun altro è nella stanza. Nel momento in cui inviti qualcuno, riconsidera la scelta. - Qualsiasi cosa contenga credenziali di produzione nella directory:
default, nessuna autorizzazione permanente e un agente separato per le parti che non necessitano di tali credenziali.
Domande frequenti
Una stanza sovrascrive la modalità di Claude Code? No. La modalità continua a governare cosa fa l'agente all'interno di un'esecuzione. La stanza aggiunge chi può avviare un'esecuzione e quali azioni vanno in pausa a prescindere.
Chi invia la richiesta può scegliere la modalità? No. È il proprietario a sceglierla per ogni agente. Chi invia la richiesta può richiedere un comportamento in sola lettura nella propria richiesta, e il proprietario può rispondere a un'approvazione con “continue read-only”.
bypassPermissions è mai accettabile per un agente condiviso? Solo per directory in cui non può accadere nulla di irreversibile, e anche in quel caso le quattro azioni si mettono in pausa. Un articolo a parte approfondisce perché bypassPermissions va bene per te ed è pericoloso per tutti gli altri.
E per quanto riguarda Codex? Codex ha le proprie impostazioni di approvazione con una struttura simile. In una stanza, le autorizzazioni per persona e le quattro azioni che vanno sempre in pausa si applicano allo stesso modo.
Imposta la modalità per la directory, imposta l'autorizzazione per la persona e lascia che le quattro azioni chiedano conferma. Questo è l'intero modello. Dai una stanza al tuo agente per vederlo all'opera.
Pubblicato il