Tutte le impostazioni

Indice delle impostazioni

Modello e risposte

advisorModel

• Ambito: Any file
• Tipo: stringa, uno degli alias "fable", "opus" o "sonnet", che si risolvono nella versione predefinita attuale di Claude Code per quella famiglia di modelli, oppure un ID di modello completo come "claude-opus-5-5"
• Predefinito: non impostato, quindi l’advisor è disattivato
• Override per sessione: --advisor ha la precedenza su questa chiave per una sessione. CLAUDE_CODE_DISABLE_ADVISOR_TOOL disattiva l’advisor, e questa chiave non può riattivarlo

{
  "advisorModel": "opus"
}

alwaysThinkingEnabled

• Ambito: Any file
• Tipo: Boolean
  • true: nessun effetto; il ragionamento è già attivo
  • false: Claude Code disattiva il ragionamento esteso per ogni sessione
• Predefinito: non impostato, quindi il ragionamento è attivo per i modelli che lo supportano
• Override per sessione: MAX_THINKING_TOKENS ha la precedenza su questa chiave per una sessione: 0 disattiva il ragionamento, con gli stessi limiti di modello e provider di false, e un valore positivo attiva il ragionamento anche quando questa chiave è false. Sui modelli con ragionamento adattivo il numero in sé viene ignorato

{
  "alwaysThinkingEnabled": false
}

availableModels

• Ambito: Any file. Distribuiscila nelle impostazioni gestite per applicarla a un’organizzazione.
• Tipo: array di alias o ID di modello
• Predefinito: non impostato, quindi ogni modello è disponibile

{
  "availableModels": ["sonnet", "haiku"]
}

availableModelsMatch

• Ambito: Managed. Claude Code ignora la chiave nelle impostazioni utente, di progetto e locali e in --settings, mostrando un avviso
• Tipo: stringa, uno tra:
  • "prefix": una voce con un ID di modello consente la sua versione e qualsiasi ID di modello che la estende con un altro segmento
  • "exact": una voce con un ID di modello consente solo la versione che nomina, quindi "claude-opus-5" consente Opus 5 ma non claude-opus-5-5. Una voce come "claude-opus-4-5" consente anche il relativo ID di modello Anthropic con data claude-opus-4-5-20251101. Un alias di famiglia come "opus" consente comunque l’intera famiglia, e le voci best, opusplan e default vengono ignorate
• Predefinito: "prefix"

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

deniedModels

• Ambito: Managed. Claude Code ignora la chiave nelle impostazioni utente, di progetto e locali e in --settings, mostrando un avviso
• Tipo: array di alias o ID di modello
  • Un alias di famiglia come "opus" blocca ogni modello di quella famiglia
  • Un ID di modello come "claude-opus-5-5" blocca quella versione in ogni forma, inclusi gli ID con data e quelli specifici del provider
  • Un ID di modello senza versione minore, come "claude-opus-5", blocca anche le versioni minori successive come Opus 5.5. Scrivi "claude-opus-5-0" per bloccare solo Opus 5
  • Le voci best, opusplan e default vengono ignorate
• Predefinito: non impostato, quindi nessun modello è bloccato

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

effortLevel

• Ambito: Any file
• Tipo: stringa, uno tra:
  • "low": il ragionamento minimo, per attività brevi, circoscritte e sensibili alla latenza che non richiedono molta intelligenza
  • "medium": riduce l’uso di token per lavori attenti ai costi che possono rinunciare a un po’ di intelligenza
  • "high": bilancia uso di token e intelligenza
  • "xhigh": ragionamento più approfondito con una maggiore spesa di token
• Predefinito: non impostato
• Override per sessione: --effort ha la precedenza su questa chiave per una sessione, e CLAUDE_CODE_EFFORT_LEVEL ha la precedenza su entrambi

{
  "effortLevel": "xhigh"
}

enforceAvailableModels

• Ambito: Any file
• Tipo: Boolean
  • true: quando Default si risolverebbe in un modello al di fuori di availableModels, Claude Code lo risolve nel primo modello disponibile dell’elenco
  • false: questa chiave non cambia il modo in cui Default si risolve
• Predefinito: false

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

fallbackModel

• Ambito: Any file
• Tipo: array di alias o ID di modello; "default" si espande nel modello predefinito
• Predefinito: non impostato, quindi una richiesta non riuscita non viene ritentata su un altro modello
• Override per sessione: --fallback-model ha la precedenza su questa chiave per una sessione

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

fastMode

• Ambito: Any file
• Tipo: Boolean
  • true: Claude Code attiva la modalità veloce per le sessioni in cui è disponibile. Su Fable 5.2, devi anche eseguire /fast mentre usi Fable 5.2
  • false: la modalità veloce resta disattivata
• Predefinito: non impostato, quindi la modalità veloce è disattivata
• Override per sessione: CLAUDE_CODE_DISABLE_FAST_MODE disattiva la modalità veloce per una sessione, e questa chiave non può riattivarla

{
  "fastMode": true
}

fastModePerSessionOptIn

• Ambito: Any file
• Tipo: Boolean
  • true: un fastMode: true salvato non attiva più la modalità veloce all’avvio della sessione, quindi ogni persona esegue /fast in ogni sessione in cui la vuole; un fastMode: true passato con --settings vale comunque per quella sessione, a meno che le impostazioni gestite non impostino questa chiave
  • false: un fastMode: true salvato funziona come descritto in fastMode
• Predefinito: false

{
  "fastModePerSessionOptIn": true
}

language

• Ambito: Any file
• Tipo: stringa, qualsiasi nome di lingua, come "japanese", "spanish" o "french"; Claude Code non la convalida
• Predefinito: non impostato; i titoli delle sessioni seguono quindi la lingua della tua conversazione

{
  "language": "japanese"
}

maxEffortLevel

• Ambito: Any file. Distribuiscila nelle impostazioni gestite per applicarla a un’organizzazione. Quando più ambiti impostano un limite, si applica il più basso, quindi un limite impostato in un ambito non può essere alzato da un altro
• Tipo: stringa, uno tra "low", "medium", "high", "xhigh" o "max". Un valore "max" non imposta alcun limite
• Predefinito: non impostato, quindi non si applica alcun limite
• Limiti per modello: aggiungi maxEffortLevel alla voce modelSettings di un modello. Quella voce sostituisce questa chiave per il modello solo all’interno della fonte di impostazioni che imposta entrambe, come le tue impostazioni utente o una fonte gestita. Imposta lì "max" per esentare il modello dal limite di quella fonte; Claude Code applica comunque i limiti delle altre fonti

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

model

• Ambito: Any file
• Tipo: stringa, un alias di modello o un ID di modello completo
• Predefinito: non impostato, quindi Claude Code usa il modello predefinito del tuo account
• Override per sessione: --model ha la precedenza su ANTHROPIC_MODEL, ed entrambi hanno la precedenza su questa chiave per una sessione, anche su un model gestito; un elenco availableModels si applica comunque alla scelta

{
  "model": "claude-sonnet-5"
}

modelOverrides

• Ambito: Any file
• Tipo: oggetto che mappa un ID di modello su un ID di modello del provider
• Predefinito: non impostato

{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
  }
}

modelPicker

• Ambito: User or managed. Claude Code legge la chiave dalle impostazioni gestite, da --settings e dalle impostazioni utente, e la ignora nelle impostazioni di progetto e locali, così un repository che cloni non può rinominare le voci del selettore. La fonte con la precedenza più alta tra queste tre che imposta la chiave fornisce l’intera selezione, e Claude Code non combina mai le selezioni di due fonti.
• Tipo: oggetto con un array options di righe e un Boolean opzionale replaceBuiltInOptions
• Predefinito: non impostato, quindi il selettore mostra la selezione integrata

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

Campi per modelPicker

• Scartata: una riga che Claude Code non può servire, come un modello ritirato o un modello a cui la tua organizzazione non ha accesso
• Disattivata: una riga che non puoi ancora selezionare, mostrata con il motivo
• Nessuna riga rimane: Claude Code mantiene la selezione integrata, filtrata dall’allowlist come di consueto

modelPricing

• Ambito: Managed. Distribuisci la chiave tramite le impostazioni gestite dal server, una policy MDM, un file managed-settings.json o un helper di policy. Claude Code la ignora nelle impostazioni utente, di progetto e locali, in --settings e, su Windows, nel registro HKCU scrivibile dall’utente. Con le impostazioni gestite dal server, ogni sessione riporta i costi al prezzo di listino finché il recupero delle impostazioni di quella sessione non ha confermato l’impostazione. Un’applicazione host che incorpora Claude Code e imposta CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST può fornire una propria tabella tramite l’opzione managedSettings dell’SDK, che Claude Code usa solo quando nessuna fonte gestita imposta la chiave e solo in Claude Code v2.1.246 o successivo.
• Tipo: oggetto con un multiplier opzionale e una mappa overrides opzionale
• Predefinito: non impostato, quindi Claude Code riporta il prezzo di listino, a meno che un’applicazione host non fornisca una tabella

{
  "modelPricing": {
    "multiplier": 0.85,
    "overrides": {
      "claude-sonnet-4-6": {
        "input": 2.4,
        "output": 12,
        "cacheRead": 0.24,
        "cacheWrite": 3
      }
    }
  }
}

Campi per modelPricing

A quali modelli si applica una riga di modelPricing

• L’ID di un modello integrato: una chiave che Claude Code stesso usa per un modello integrato, che si tratti dell’ID del modello stesso, come claude-sonnet-4-6, o del suo ID Bedrock, Agent Platform o Foundry. Claude Code applica la riga a ogni ID di snapshot con data e a ogni ID specifico del provider di quel modello.
• Qualsiasi altra chiave: una chiave che non è l’ID di un modello integrato, come l’alias di un modello del gateway. Claude Code applica la riga solo a quell’ID. Quando un ID di modello corrisponde esattamente a una delle tue chiavi e rientra anche in una riga con chiave l’ID di un modello integrato, Claude Code usa la corrispondenza esatta.
• Un profilo di inferenza applicativo di Bedrock: una volta che Claude Code ha risolto il profilo nel modello verso cui instrada, tramite la tua mappa modelOverrides o la ricerca bedrock:GetInferenceProfile, Claude Code applica al profilo la riga di quel modello.

modelSettings

• Ambito: Any file
• Tipo: oggetto che mappa il nome di un modello su un oggetto con uno qualsiasi di questi campi:
  • effortLevel: uno tra "low", "medium", "high" o "xhigh"
  • maxEffortLevel: il livello di sforzo più alto a cui il modello può essere eseguito
  • autoCompactWindow: un numero di token da 100000 a 1000000, oppure "auto" per la finestra ottimizzata per il modello. /autocompact salva qui. Per quel modello, il valore ha la precedenza su un autoCompactWindow di primo livello nello stesso file di impostazioni. Richiede Claude Code v2.1.288 o successivo
• Predefinito: non impostato

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

outputStyle

• Ambito: Any file
• Tipo: stringa, il nome di uno stile di output integrato o personalizzato
• Predefinito: non impostato, quindi Claude Code usa lo stile predefinito

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

• Ambito: Any file
• Tipo: stringa, uno tra:
  • "5m": la cache dura cinque minuti
  • "1h": la cache dura un’ora
• Predefinito: non impostato, quindi ogni richiesta della conversazione principale ottiene la sua durata predefinita
• Override per sessione: FORCE_PROMPT_CACHING_5M ha la precedenza su tutto il resto, poi CLAUDE_CODE_PROMPT_CACHE_TTL, poi questa chiave e infine ENABLE_PROMPT_CACHING_1H

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

showThinkingSummaries

• Ambito: Any file
• Tipo: Boolean
  • true: vedi i riepiloghi completi del ragionamento quando lo espandi con Ctrl+O
  • false: l’API Anthropic oscura i blocchi di ragionamento e Claude Code mostra un segnaposto compresso
• Predefinito: false

{
  "showThinkingSummaries": true
}

subagentPromptCacheTtl

• Ambito: Any file
• Tipo: stringa, uno tra:
  • "5m": la cache dura cinque minuti
  • "1h": la cache dura un’ora
• Predefinito: non impostato, quindi ciascuna di queste richieste ottiene la sua durata predefinita
• Override per sessione: FORCE_PROMPT_CACHING_5M ha la precedenza su tutto il resto, poi CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, poi questa chiave, poi ENABLE_PROMPT_CACHING_1H, che richiede la durata di un’ora per ogni richiesta. Per sapere dove si colloca il valore nel frontmatter di un subagent, consulta Scegliere il TTL autonomamente

{
  "subagentPromptCacheTtl": "1h"
}

switchModelsOnFlag

• Ambito: Any file. Compare in /config come Switch models when a message is flagged, con le opzioni Switch automatically e Ask each time.
• Tipo: Boolean
  • true: Claude Code passa al modello di fallback e continua
  • false: in una sessione interattiva Claude Code si mette in pausa per permetterti di scegliere tra cambiare modello e modificare il prompt; dove non può essere mostrata alcuna finestra di dialogo, come in un’esecuzione -p, la richiesta segnalata termina con un errore
• Predefinito: non impostato. Claude Code cambia modello automaticamente, anche se in una sessione interattiva potrebbe chiedere prima

{
  "switchModelsOnFlag": false
}

ultracode

• Ambito: Any file
• Tipo: Boolean
  • true: le sessioni si avviano con ultracode attivo quando i workflow dinamici sono abilitati per te e il tuo modello supporta xhigh
  • false: le sessioni si avviano con ultracode disattivato
• Predefinito: non impostato, quindi ultracode è disattivato
• Override per sessione: /effort ultracode attiva ultracode per una sessione senza questa chiave, e /effort ultracode off lo disattiva per una sessione quando questa chiave è true. Anche il flag --effort ultracode lo attiva per una sessione, con sforzo xhigh

{
  "ultracode": true
}

Impostazioni dei permessi

allowManagedPermissionRulesOnly

• La directory .claude/ di un repository
• Le tue directory ~/.claude/skills/ e ~/.claude/commands/, incluse le skill sincronizzate da claude.ai
• Una directory --add-dir
• I plugin dichiarati con un manifest .claude-plugin all’interno di ~/.claude/skills/ o di .claude/skills/ del progetto
• I plugin caricati per una sola sessione, i cui id terminano con @inline, quando valgono tutte queste condizioni:
  • La sessione è una sessione Code o una sessione Cowork, diversa da una sessione cloud, per cui è l’app Claude Desktop stessa ad avviare Claude Code
  • Le tue impostazioni gestite impostano la chiave, non solo le impostazioni padre di un host di incorporamento
  • La sessione esegue Claude Code v2.1.305 o successivo

• Ambito: Managed
• Tipo: Booleano
  • true: le impostazioni gestite diventano l’unica fonte di impostazioni delle regole di permesso
  • false: Claude Code applica le regole di permesso dai file utente, progetto, locale e --settings oltre a quelle gestite
• Predefinito: non impostato, quindi Claude Code applica le regole di permesso dalle impostazioni utente, progetto e locale e da --settings, oltre a quelle gestite

{
  "allowManagedPermissionRulesOnly": true
}

autoMode

• Ambito: User or managed
• Tipo: oggetto con array environment, allow, soft_deny e hard_deny di regole in prosa, più il Booleano classifyAllShell
• Predefinito: non impostato, quindi il classificatore utilizza solo le sue regole integrate

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

autoMode.classifyAllShell

• Ambito: User or managed. Viene letta ovunque venga letto autoMode.
• Tipo: Booleano
  • true: mentre la modalità auto è attiva, Claude Code invia ogni comando Bash e PowerShell attraverso il classificatore e sospende le tue regole di consenso della shell; al di fuori della modalità auto le regole si applicano ancora
  • false: la modalità auto sospende solo le regole di consenso che potrebbero eseguire codice arbitrario, come Bash(*) e Bash(python *); un comando che corrisponde a qualsiasi altra regola di consenso salta il classificatore a meno che non porti con sé domini consentiti per comando, e ogni altro comando shell passa attraverso di esso
• Predefinito: false

{
  "autoMode": {
    "classifyAllShell": true
  }
}

disableAutoMode

• Ambito: Any file. Più utile nelle impostazioni gestite, dove gli utenti non possono sovrascriverla. Accettata anche sotto permissions come permissions.disableAutoMode.
• Tipo: la stringa "disable"
• Predefinito: non impostato

{
  "disableAutoMode": "disable"
}

permissions

• Ambito: Any file
• Tipo: oggetto con allow, ask, deny, additionalDirectories, blockReadsOutsideWorkingDirectories, blockWritesOutsideWorkingDirectories, defaultMode, denyInsteadOfPrompting, disableBypassPermissionsMode e disableAutoMode
• Predefinito: non impostato

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

useAutoModeDuringPlan

• Ambito: User, local, or managed. Un repository non può disattivarla per te.
  • Un false in uno qualsiasi di questi file o in --settings la disattiva, a meno che tu non escluda quel file utente o locale con un’opzione come --setting-sources. Ignorare un file escluso richiede Claude Code v2.1.314 o successivo
• Tipo: Booleano
  • true: equivale a non impostato; quando la modalità auto è disponibile, il classificatore esamina i comandi shell durante la pianificazione
  • false: ricevi una richiesta di permesso per ogni comando al di fuori dell’insieme integrato di sola lettura
• Predefinito: true

{
  "useAutoModeDuringPlan": false
}

permissions.allow

• Ambito: Any file
• Tipo: array di stringhe di regole di permesso
• Predefinito: non impostato
• Override per sessione: --allowedTools aggiunge regole di consenso per una sessione, e una regola di negazione da qualsiasi file di impostazioni blocca comunque uno strumento che nomina

{
  "permissions": {
    "allow": ["Bash(git diff *)", "Read(~/.zshrc)"]
  }
}

Sintassi delle regole di permesso

permissions.ask

• Ambito: Any file
• Tipo: array di stringhe di regole di permesso
• Predefinito: non impostato

{
  "permissions": {
    "ask": ["Bash(git push *)"]
  }
}

permissions.deny

• Ambito: Any file
• Tipo: array di stringhe di regole di permesso
• Predefinito: non impostato
• Override per sessione: --disallowedTools aggiunge regole di negazione per una sessione insieme a questa chiave

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

permissions.additionalDirectories

• Ambito: Any file, con limiti sull’accesso in scrittura della sandbox concesso dalle voci di progetto e locali
• Tipo: array di percorsi di directory
• Predefinito: non impostato
• Override per sessione: --add-dir e /add-dir aggiungono directory per una sessione insieme a questa chiave

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

permissions.blockReadsOutsideWorkingDirectories

• Azioni che nessuna modalità approva automaticamente spiega quando un comando shell che legge un tale percorso ti chiede conferma
• Comandi in sandbox sotto il blocco spiega cosa può leggere un comando in sandbox

• Ambito: Any file. Un true in qualsiasi file si applica, quindi un repository può attivare il blocco per se stesso ma non può rimuovere il tuo.
• Tipo: Booleano
  • true: gli strumenti di file di Claude rifiutano le letture al di fuori delle directory di lavoro
  • false: equivale a non impostato; il blocco si applica comunque se un altro file imposta true
• Predefinito: non impostato, quindi le letture al di fuori delle directory di lavoro seguono la tua modalità di permesso

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

Comandi in sandbox sotto il blocco

• L’isolamento del file system è disattivato tramite sandbox.filesystem.disabled
• allowManagedReadPathsOnly è impostato
• Il percorso della directory in cui hai avviato Claude Code contiene un carattere glob come *, ? o [

• ~/.gitconfig
• I file config, ignore e attributes sotto $XDG_CONFIG_HOME/git, che per impostazione predefinita è ~/.config/git
• I file che la tua configurazione git globale nomina tramite [include], [includeIf], core.excludesFile o core.attributesFile

permissions.blockWritesOutsideWorkingDirectories

• Ambito: Any file. Un true in qualsiasi file caricato dalla sessione si applica, quindi un repository può attivare il blocco per se stesso ma non può rimuovere il tuo. In una sessione cloud, Claude Code potrebbe non applicare la chiave, perché gli strumenti di file vengono eseguiti in un container che costituisce esso stesso il confine.
• Tipo: Booleano
  • true: attiva il blocco
  • false: equivale a non impostato; il blocco si applica comunque se un altro file imposta true
• Predefinito: non impostato, quindi le scritture al di fuori delle directory di lavoro seguono la tua modalità di permesso. Il blocco è attivo anche finché Claude Code non riesce a leggere l’oggetto permissions nelle tue impostazioni gestite.

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

Cosa rifiuta il blocco delle scritture e cosa rimane scrivibile

• File di impostazioni di Claude Code: Claude Code rifiuta queste scritture anche all’interno delle directory di lavoro, perché un file di impostazioni può rimuovere il blocco. Modifica tu stesso i file di impostazioni.
• Una directory aggiunta solo dalle impostazioni del repository: una che additionalDirectories elenca solo in .claude/settings.json, o in .claude/settings.local.json a meno che git non segnali quel file come non tracciato
• Il worktree di un subagent: le modifiche ai file di un subagent isolation: worktree vengono rifiutate quando il suo worktree si trova al di fuori delle directory di lavoro
• Memoria automatica in una directory scelta dal repository: una directory che autoMemoryDirectory nomina nelle impostazioni del repository

Far passare una directory attraverso il blocco delle letture o delle scritture

permissions.defaultMode

• Ambito: Any file. auto e bypassPermissions non hanno effetto dalle impostazioni di progetto o locali, quindi impostali invece in ~/.claude/settings.json. Prima della v2.1.257, bypassPermissions aveva effetto da qualsiasi file. Per le conversazioni avviate dall’estensione VS Code, Claude Code legge solo i valori utente, gestiti e --settings.
• Tipo: stringa, uno di:
  • "default": Claude Code esegue senza chiedere solo le letture
  • "acceptEdits": Claude Code esegue senza chiedere anche modifiche ai file e comandi comuni del file system come mkdir e mv
  • "plan": Claude Code legge e pianifica ma blocca le modifiche finché non approvi un piano
  • "auto": Claude Code procede senza richieste di conferma di routine; prima che vengano eseguite azioni come comandi shell e richieste di rete, un classificatore in background verifica che siano in linea con la tua richiesta
  • "dontAsk": Claude Code nega automaticamente ogni chiamata per cui altrimenti chiederebbe conferma, anche se un mod che hai installato può comunque approvare alcune di queste chiamate. Le letture di file all’interno delle tue directory di lavoro, le altre azioni che non richiedono approvazione e gli strumenti pre-approvati vengono comunque eseguiti, eccetto le letture da percorsi di rete
  • "bypassPermissions": Claude Code esegue tutto senza chiedere
  • "manual": un alias per "default"
• Predefinito: non impostato
• Override per sessione: --permission-mode e il suo equivalente --dangerously-skip-permissions per bypassPermissions hanno la precedenza su questa chiave per una sessione

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

permissions.denyInsteadOfPrompting

• Ambito: User or managed, e --settings. Un repository non può impostarla per te.
• Tipo: Booleano
  • true: Claude Code nega le chiamate per cui altrimenti chiederebbe conferma
  • false: equivale a non impostato; le chiamate vengono comunque negate se un’altra di queste fonti imposta true
• Predefinito: non impostato, quindi una chiamata che richiede approvazione ti chiede conferma

{
  "permissions": {
    "defaultMode": "auto",
    "denyInsteadOfPrompting": true
  }
}

Cos’altro blocca denyInsteadOfPrompting

• Strumenti di domanda e di piano: Claude Code esclude AskUserQuestion, EnterPlanMode e ExitPlanMode, quindi una sessione in plan mode non può uscirne da sola. Un membro di un team di agenti mantiene EnterPlanMode e ExitPlanMode
• Elicitation MCP: Claude Code annulla una richiesta di elicitation a meno che un hook Elicitation non vi risponda
• Host dei permessi: Claude Code non interpella la tua callback canUseTool né --permission-prompt-tool. Per approvare le chiamate da codice, rispondi da un hook PermissionRequest. Alcune chiamate vengono negate prima che venga interpellato qualsiasi hook, come una rimozione di percorsi critici in modalità auto non coperta da alcuna regola ask.
• Avviso di fatturazione del classificatore: dove l’avviso sulle richieste del classificatore fatturate aprirebbe una finestra di dialogo, Claude Code non lo mostra e nega le azioni che richiedono quelle richieste

Messaggi da denyInsteadOfPrompting

Permission for this tool use was denied. It requires approval, and this session has no approval surface

no approval surface in this session; permission request denied automatically

20 actions were refused and no work went ahead in between, so Claude stopped.

permissions.disableBypassPermissionsMode

• Ambito: Any file. Tipicamente impostata nelle impostazioni gestite per applicare la policy dell’organizzazione.
• Tipo: la stringa "disable"
• Predefinito: non impostato
• Override per sessione: questa chiave ha la precedenza su --dangerously-skip-permissions, che Claude Code rifiuta finché la chiave è impostata

{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

skipAutoPermissionPrompt

• Ambito: User or managed. Un repository non può impostarla per te.
• Tipo: Booleano
  • true: Claude Code salta l’avviso
  • false: equivale a non impostato; l’avviso appare una volta a meno che un altro di questi file non imposti true
• Predefinito: non impostato, quindi l’avviso appare una volta

{
  "skipAutoPermissionPrompt": true
}

skipDangerousModePermissionPrompt

• Ambito: User, local, or managed, e i file passati con --settings. Le sessioni in background considerano solo le impostazioni utente e gestite. Un repository non attendibile non può saltare la finestra di dialogo per te.
• Tipo: Booleano
  • true: Claude Code salta la finestra di dialogo di conferma prima che una sessione entri in modalità bypassPermissions
  • false: equivale a non impostato; la finestra di dialogo appare a meno che un altro di questi file non imposti true
• Predefinito: non impostato, quindi la finestra di dialogo appare

{
  "skipDangerousModePermissionPrompt": true
}

Impostazioni sandbox

sandbox

• Scope: Any file
• Tipo: oggetto con enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, allowNestedUserNamespaces, bwrapPath, socatPath, ignoreViolations e ripgrep, più gli oggetti filesystem, network e credentials
• Default: non impostato, quindi Claude Code esegue i comandi senza sandbox

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

sandbox.enabled

• Scope: Any file, con limiti sulle impostazioni di progetto e locali
• Type: Boolean
  • true: Claude Code mette in sandbox i comandi Bash
  • false: i comandi Bash vengono eseguiti senza sandbox
• Default: false

{
  "sandbox": {
    "enabled": true
  }
}

sandbox.failIfUnavailable

• Scope: Any file, con limiti sulle impostazioni di progetto e locali
• Tipo: booleano
  • true: Claude Code termina con un errore all’avvio quando sandbox.enabled è true ma la sandbox non riesce ad avviarsi. Se la sandbox supera quel controllo e poi non riesce a inizializzarsi, la sessione continua e Claude Code rifiuta ogni comando in sandbox
  • false: Claude Code esegue i comandi fuori dalla sandbox quando la sandbox non riesce ad avviarsi
• Default: false

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}

sandbox.autoAllowBashIfSandboxed

• Scope: Any file
• Type: Boolean
  • true: Claude Code esegue i comandi Bash in sandbox senza una richiesta di permesso, tranne nei casi descritti in Auto-allow mode; CLAUDE_CODE_SUBPROCESS_ENV_SCRUB disattiva l’auto-consentimento
  • false: i comandi in sandbox seguono il flusso di permessi regolare, quindi decidono le tue regole allow e la modalità di permesso. La scheda Mode di /sandbox chiama questa modalità di permessi regolari
• Default: true

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": false
  }
}

sandbox.excludedCommands

• Scope: Any file, con limiti sulle impostazioni di progetto e locali
• Type: array di pattern di comando
• Default: non impostato, quindi nessun comando è escluso

{
  "sandbox": {
    "excludedCommands": ["docker *"]
  }
}

• Un comando che inizia con sudo, eval o xargs
• Un cd, pushd o popd, ovunque appaia nella chiamata
• Una sostituzione di comando, una subshell o un blocco di controllo di flusso come if o for
• Un reindirizzamento, come docker build . > build.log o un heredoc <<EOF, diverso da uno che si limita a duplicare un descrittore di file, come fa 2>&1
• Un nome di comando che proviene da una variabile
• Un git clone, git init, git worktree add, git worktree move o git bundle create con un argomento di percorso che è assoluto, inizia con ~ o contiene un segmento ..

sandbox.allowUnsandboxedCommands