605 Quando gli edits hanno effetto605 Quando gli edits hanno effetto
606</h3>606</h3>
607 607
608Claude Code osserva i vostri file di impostazioni e li ricarica quando cambiano, quindi applica la maggior parte degli edits alla sessione in esecuzione senza un riavvio, inclusi gli edits a `permissions`, `hooks` e helper di credenziali come `apiKeyHelper`. Il ricaricamento copre le impostazioni utente, progetto, locale e gestite, e Claude Code esegue l'[hook `ConfigChange`](/docs/it/hooks#configchange) per ogni modifica di file di impostazioni che rileva, non per le impostazioni gestite che arrivano da MDM o dalla console claude.ai. Le impostazioni gestite che arrivano attraverso MDM o dalla console claude.ai raggiungono una sessione in esecuzione secondo una pianificazione piuttosto che al salvataggio; la [tabella di consegna](/docs/it/managed-settings#choose-a-delivery-mechanism) la fornisce per fonte.608Claude Code osserva i vostri file di impostazioni e li ricarica quando cambiano, quindi applica la maggior parte degli edits alla sessione in esecuzione senza un riavvio, inclusi gli edits a `permissions`, `hooks` e helper di credenziali come `apiKeyHelper`. Claude Code anche carica un file di impostazioni che create a metà sessione se la sua cartella esisteva quando la sessione è iniziata. Per la cartella `.claude/` del progetto, carica il file anche quando create la cartella nella stessa sessione.
609
610Il ricaricamento copre le impostazioni utente, progetto, locale e gestite, e Claude Code esegue l'[hook `ConfigChange`](/docs/it/hooks#configchange) per ogni modifica di file di impostazioni che rileva, non per le impostazioni gestite che arrivano da MDM o dalla console claude.ai. Le impostazioni gestite che arrivano attraverso MDM o dalla console claude.ai raggiungono una sessione in esecuzione secondo una pianificazione piuttosto che al salvataggio; la [tabella di consegna](/docs/it/managed-settings#choose-a-delivery-mechanism) la fornisce per fonte.
609 611
610Claude Code legge alcune chiavi solo una volta, all'avvio della sessione, quindi un edit a una di esse non raggiunge la sessione in esecuzione. Le chiavi lato amministratore che attendono anche un riavvio, come `requiredMinimumVersion`, sono elencate sotto [dove e quando si applica una politica](/docs/it/managed-settings#where-and-when-a-policy-applies). Quelle che è più probabile che modifichiate a metà sessione:612Claude Code legge alcune chiavi solo una volta, all'avvio della sessione, quindi un edit a una di esse non raggiunge la sessione in esecuzione. Le chiavi lato amministratore che attendono anche un riavvio, come `requiredMinimumVersion`, sono elencate sotto [dove e quando si applica una politica](/docs/it/managed-settings#where-and-when-a-policy-applies). Quelle che è più probabile che modifichiate a metà sessione:
611 613
651 Precedenza delle impostazioni653 Precedenza delle impostazioni
652</h2>654</h2>
653 655
654Quando la stessa chiave appare in più di un posto, Claude Code usa il valore dal livello più alto che la imposta. Lo stack sottostante mostra i livelli, il più alto in alto; una chiave a un livello più alto ignora la stessa chiave ovunque sotto.656Quando la stessa chiave appare in più di un posto, Claude Code utilizza il valore dal livello più alto che la imposta. Lo stack sottostante mostra i livelli, il più alto in alto; una chiave a un livello più alto sostituisce la stessa chiave ovunque al di sotto.
655 657
656<SettingsPrecedence />658<SettingsPrecedence />
657 659
658In ordine, precedenza più alta prima:660In ordine, dalla precedenza più alta in primo luogo:
659 661
6601. **Impostazioni gestite**: impostazioni che la vostra organizzazione distribuisce, da un file `managed-settings.json`, una politica MDM, o [impostazioni gestite dal server](/docs/it/server-managed-settings) dalla console claude.ai. Nulla di quello che impostate le ignora: una chiave che passate con `--settings` non ignora la stessa chiave gestita, e un flag come `--model` sceglie solo dai modelli che la vostra organizzazione consente. Un `model` gestito imposta il modello con cui ogni sessione inizia, e potete comunque cambiare con `/model`; il blocco è [`availableModels`](/docs/it/settings-reference#availablemodels), che vincola `/model`, `--model` e la chiave `model` nei vostri file. Quando la vostra organizzazione fornisce più di una fonte gestita, le regole per [precedenza all'interno del livello gestito](/docs/it/managed-settings#precedence-within-the-managed-tier) dicono cosa Claude Code legge da ognuna.6621. **Impostazioni gestite**: impostazioni che la tua organizzazione distribuisce, tramite un file `managed-settings.json`, una policy MDM, o [impostazioni gestite dal server](/docs/it/server-managed-settings) dalla console claude.ai. Nulla di quello che imposti le sostituisce: una chiave che passi con `--settings` non sostituisce la stessa chiave gestita, e un flag come `--model` sceglie solo dai modelli che la tua organizzazione consente. Un `model` gestito imposta il modello con cui inizia ogni sessione, e puoi comunque passare a `/model`; il blocco è [`availableModels`](/docs/it/settings-reference#availablemodels), che vincola `/model`, `--model`, e la chiave `model` nei tuoi file. Quando la tua organizzazione fornisce più di una fonte gestita, le regole per la [precedenza all'interno del livello gestito](/docs/it/managed-settings#precedence-within-the-managed-tier) dicono cosa Claude Code legge da ciascuna.
6612. **Argomenti della riga di comando**: flag che passate quando avviate `claude` da un terminale, per una sessione; vedere [Modificate un'impostazione per una sessione](#change-a-setting-for-one-session). Claude Code unisce JSON che passate con `--settings <file-or-json>` con i vostri file di impostazioni secondo le stesse regole degli altri livelli: prende una chiave che impostate qui sopra la stessa chiave nelle impostazioni locale, progetto o utente, e mantiene il valore di livello inferiore per una chiave che omettete.6632. **Argomenti della riga di comando**: flag che passi quando avvii `claude` da un terminale, per una sessione; vedi [Cambia un'impostazione per una sessione](#change-a-setting-for-one-session). Claude Code unisce il JSON che passi con `--settings <file-or-json>` con i tuoi file di impostazioni secondo le stesse regole degli altri livelli: prende una chiave che imposti qui rispetto alla stessa chiave nelle impostazioni locali, di progetto o utente, e mantiene il valore di livello inferiore per una chiave che ometti.
6623. **Impostazioni di progetto locale** (`.claude/settings.local.json`): le vostre impostazioni personali per questo progetto.6643. **Impostazioni locali del progetto** (`.claude/settings.local.json`): le tue impostazioni personali per questo progetto.
6634. **Impostazioni di progetto condivise** (`.claude/settings.json`): impostazioni che il vostro team controlla nel controllo del codice sorgente.6654. **Impostazioni di progetto condivise** (`.claude/settings.json`): impostazioni che il tuo team inserisce nel controllo del codice sorgente.
6645. **Impostazioni utente** (`~/.claude/settings.json`): le vostre impostazioni personali per ogni progetto.6665. **Impostazioni utente** (`~/.claude/settings.json`): le tue impostazioni personali per ogni progetto.
665 667
666Le variabili di ambiente non sono un livello in questo stack. Quando un comportamento ha sia una variabile shell che una chiave di impostazioni, quale si applica è deciso per coppia, non per livello: `ANTHROPIC_MODEL` esportato nella vostra shell si applica sopra la chiave `model` da qualsiasi file, mentre `ANTHROPIC_DEFAULT_MODEL` si applica solo quando nessun file imposta `model`. La [referenza delle variabili di ambiente](/docs/it/env-vars#precedence) dice quali chiavi hanno una coppia e quale Claude Code legge prima. Un blocco `env` dentro un file di impostazioni è una chiave ordinaria e segue i livelli sopra.668Le variabili di ambiente non sono un livello in questo stack. Quando un comportamento ha sia una variabile di shell che una chiave di impostazione, quale si applica è deciso per coppia, non per livello: `ANTHROPIC_MODEL` esportato nella tua shell si applica rispetto alla chiave `model` da qualsiasi file, mentre `ANTHROPIC_DEFAULT_MODEL` si applica solo quando nessun file imposta `model`. Il [riferimento delle variabili di ambiente](/docs/it/env-vars#precedence) dice quali chiavi hanno una coppia e quale Claude Code legge per primo. Un blocco `env` all'interno di un file di impostazioni è una chiave ordinaria e segue i livelli sopra.
667 669
668Per poche chiavi sensibili alla sicurezza, Claude Code onora un valore più rigoroso da un livello inferiore sopra un valore gestito; [Eccezioni alla precedenza delle impostazioni gestite](#exceptions-to-managed-settings-precedence) le elenca.670Per alcune chiavi sensibili alla sicurezza, Claude Code onora un valore più restrittivo da un livello inferiore rispetto a un valore gestito; [Eccezioni alla precedenza delle impostazioni gestite](#exceptions-to-managed-settings-precedence) le elenca.
669 671
670<h3 id="lists-merge-instead-of-overriding">672<h3 id="lists-merge-instead-of-overriding">
671 Gli elenchi si uniscono invece di ignorarsi673 Gli elenchi si uniscono invece di sostituirsi
672</h3>674</h3>
673 675
674Quando impostate la stessa chiave di elenco, come `permissions.allow`, in più di un file, Claude Code combina gli elenchi invece di sceglierne uno, quindi ogni file può aggiungere voci senza rimuovere quelle di un altro file. Quattro chiavi che contengono elenchi di modelli o voci per-modello seguono le loro regole:676Quando imposti la stessa chiave di elenco, come `permissions.allow`, in più di un file, Claude Code combina gli elenchi invece di sceglierne uno, così ogni file può aggiungere voci senza rimuovere quelle di un altro file. Quattro chiavi che contengono elenchi di modelli o voci per modello seguono le loro proprie regole:
675 677
676* [`fallbackModel`](/docs/it/settings-reference#fallbackmodel) è una catena ordinata dove la posizione ha significato, quindi Claude Code prende l'intero valore dal file con la precedenza più alta che la definisce.678* [`fallbackModel`](/docs/it/settings-reference#fallbackmodel) è una catena ordinata in cui la posizione ha significato, quindi Claude Code prende l'intero valore dal file con la precedenza più alta che lo definisce.
677* [`modelPicker`](/docs/it/settings-reference#modelpicker) contiene un elenco ordinato di righe più un flag di sostituzione, quindi Claude Code non unisce mai righe da due fonti. Prende l'intero valore dal più alto tra le impostazioni gestite, `--settings` e le impostazioni utente che la definisce, e ignora la chiave nelle impostazioni di progetto e locale. Richiede Claude Code v2.1.242 o successivo.679* [`modelPicker`](/docs/it/settings-reference#modelpicker) contiene un elenco ordinato di righe più un flag di sostituzione, quindi Claude Code non unisce mai righe da due fonti. Prende l'intero valore dal più alto tra impostazioni gestite, `--settings`, e impostazioni utente che lo definisce, e ignora la chiave nelle impostazioni di progetto e locali. Richiede Claude Code v2.1.242 o successivo.
678* [`availableModels`](/docs/it/settings-reference#availablemodels): quando le impostazioni gestite che Claude Code applica la definiscono, Claude Code applica quell'elenco così com'è e ignora le voci che aggiungete nelle impostazioni utente, progetto o locale, a meno che un'app che incorpora Claude Code non fornisca il suo elenco di modelli; vedere [Eccezioni alla precedenza delle impostazioni gestite](#exceptions-to-managed-settings-precedence). Tra le fonti gestite l'elenco non si unisce mai neanche; [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) dice quale elenco della fonte si applica. Tra gli ambiti non gestiti Claude Code unisce gli array come al solito.680* [`availableModels`](/docs/it/settings-reference#availablemodels): quando le impostazioni gestite che Claude Code applica lo definiscono, Claude Code applica quell'elenco così com'è e ignora le voci che aggiungi nelle impostazioni utente, di progetto o locali, a meno che un'app che incorpora Claude Code non fornisca il suo elenco di modelli; vedi [Eccezioni alla precedenza delle impostazioni gestite](#exceptions-to-managed-settings-precedence). Tra le fonti gestite l'elenco non si unisce mai; [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) dice quale elenco della fonte si applica. Tra gli ambiti non gestiti Claude Code unisce gli array come al solito.
679* [`modelSettings`](/docs/it/settings-reference#modelsettings): Claude Code lo risolve un modello alla volta, insieme a [`effortLevel`](/docs/it/settings-reference#effortlevel). La voce `modelSettings` dice quale file il valore si applica a un modello.681* [`modelSettings`](/docs/it/settings-reference#modelsettings): Claude Code lo risolve un modello alla volta, insieme a [`effortLevel`](/docs/it/settings-reference#effortlevel). La voce `modelSettings` indica quale valore del file si applica a un modello.
680 682
681<span id="examples" />683<span id="examples" />
682 684
684 Esempi di precedenza686 Esempi di precedenza
685</h3>687</h3>
686 688
687Mentre Claude lavora, Claude Code mostra un suggerimento di una riga sotto lo spinner, come "Usate /config per modificare la vostra modalità di permesso predefinita (inclusa la modalità Piano)". Supponiamo che volete quei suggerimenti spenti, quindi impostate [`spinnerTipsEnabled`](/docs/it/settings-reference#spinnertipsenabled) a `false` in `~/.claude/settings.json`. Ogni scenario sottostante è qualcosa che può riattivarli, e cosa potete fare al riguardo.689Mentre Claude lavora, Claude Code mostra un suggerimento di una riga sotto lo spinner, come "Usa /config per cambiare la tua modalità di autorizzazione predefinita (inclusa Plan Mode)". Supponiamo che tu voglia disattivare questi suggerimenti, quindi imposti [`spinnerTipsEnabled`](/docs/it/settings-reference#spinnertipsenabled) a `false` in `~/.claude/settings.json`. Ogni scenario sottostante è qualcosa che può riattivarli, e cosa puoi fare al riguardo.
688 690
689<h4 id="team-settings-override-personal-settings">691<h4 id="team-settings-override-personal-settings">
690 Le impostazioni del team ignorano le impostazioni personali692 Le impostazioni del team sostituiscono le impostazioni personali
691</h4>693</h4>
692 694
693Il `.claude/settings.json` del vostro team lo imposta a `true`. Claude Code usa il valore del progetto perché il progetto condiviso si trova sopra l'utente, quindi vedete i suggerimenti in quel progetto e da nessun'altra parte.695Il `.claude/settings.json` del tuo team lo imposta a `true`. Claude Code utilizza il valore del progetto perché il progetto condiviso si trova sopra l'utente, quindi vedi i suggerimenti in quel progetto e da nessun'altra parte.
694 696
695Potete recuperare il vostro valore: aggiungete `"spinnerTipsEnabled": false` a `.claude/settings.local.json` in quel progetto. Il progetto locale si trova sopra il progetto condiviso, quindi le vostre sessioni lì smettono di mostrare i suggerimenti e le sessioni dei vostri compagni di squadra non cambiano.697Puoi recuperare il tuo valore: aggiungi `"spinnerTipsEnabled": false` a `.claude/settings.local.json` in quel progetto. Il progetto locale si trova sopra il progetto condiviso, quindi le tue sessioni lì smettono di mostrare suggerimenti e le sessioni dei tuoi compagni di squadra non cambiano.
696 698
697<h4 id="organization-settings-override-everything">699<h4 id="organization-settings-override-everything">
698 Le impostazioni dell'organizzazione ignorano tutto700 Le impostazioni dell'organizzazione sostituiscono tutto
699</h4>701</h4>
700 702
701Le impostazioni gestite della vostra organizzazione lo impostano a `true`. Nulla di quello che mettete nelle impostazioni utente, progetto o locale spegne i suggerimenti, e neanche `--settings`. Gestito è il livello più alto.703Le impostazioni gestite della tua organizzazione lo impostano a `true`. Nulla di quello che metti nelle impostazioni utente, di progetto o locali disattiva i suggerimenti, e nemmeno `--settings`. Gestito è il livello più alto.
702 704
703Non potete recuperare il vostro valore. Eseguite `/status` per vedere quale fonte gestita si applica, e chiedete al vostro amministratore se la politica dovrebbe cambiare.705Non puoi recuperare il tuo valore. Esegui `/status` per vedere quale fonte gestita si applica, e chiedi al tuo amministratore se la policy dovrebbe cambiare.
704 706
705<h4 id="the-command-line-overrides-your-files-for-one-session">707<h4 id="the-command-line-overrides-your-files-for-one-session">
706 La riga di comando ignora i vostri file per una sessione708 La riga di comando sostituisce i tuoi file per una sessione
707</h4>709</h4>
708 710
709Avete avviato la sessione con `claude --settings '{"spinnerTipsEnabled": true}'`. La riga di comando si trova sopra ogni file tranne gestito, quindi quella sessione mostra i suggerimenti anche se i vostri file dicono `false`.711Hai avviato la sessione con `claude --settings '{"spinnerTipsEnabled": true}'`. La riga di comando si trova sopra ogni file tranne gestito, quindi quella sessione mostra suggerimenti anche se i tuoi file dicono `false`.
710 712
711Recuperate il vostro valore nella sessione successiva; `--settings` dura una sessione e non scrive in alcun file.713Recuperi il tuo valore nella sessione successiva; `--settings` dura una sessione e non scrive in nessun file.
712 714
713<h4 id="a-flag-or-environment-variable-sets-the-same-thing">715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">
714 Un flag o una variabile di ambiente imposta la stessa cosa716 Un flag o una variabile di ambiente imposta la stessa cosa
715</h4>717</h4>
716 718
717Alcune chiavi hanno un flag della riga di comando o una variabile di ambiente che ignora il valore delle impostazioni indipendentemente da quale file lo ha impostato: `ANTHROPIC_MODEL` ignora l'impostazione [`model`](/docs/it/settings-reference#model), e `--model` ignora entrambi per una sessione.719Alcune chiavi hanno un flag della riga di comando o una variabile di ambiente che sostituisce il valore delle impostazioni indipendentemente da quale file lo ha impostato: `ANTHROPIC_MODEL` sostituisce l'impostazione [`model`](/docs/it/settings-reference#model), e `--model` sostituisce entrambi per una sessione.
718 720
719Se potete recuperare il vostro valore dipende dalla chiave: annullate la variabile o eliminate il flag, e controllate la voce della chiave sulla [referenza delle impostazioni](/docs/it/settings-reference) e la riga della variabile sulla [referenza delle variabili di ambiente](/docs/it/env-vars) per quale Claude Code usa.721Se puoi recuperare il tuo valore dipende dalla chiave: annulla l'impostazione della variabile o elimina il flag, e controlla la voce della chiave nel [riferimento delle impostazioni](/docs/it/settings-reference) e la riga della variabile nel [riferimento delle variabili di ambiente](/docs/it/env-vars) per sapere quale Claude Code utilizza.
720 722
721<span id="keys-ignored-in-a-repository-file" />723<span id="keys-ignored-in-a-repository-file" />
722 724
727<span id="which-value-applies-in-common-situations" />729<span id="which-value-applies-in-common-situations" />
728 730
729<h3 id="troubleshoot-a-setting-that-doesn’t-apply">731<h3 id="troubleshoot-a-setting-that-doesn’t-apply">
730 Risolvete i problemi di un'impostazione che non si applica732 Risolvi i problemi di un'impostazione che non si applica
731</h3>733</h3>
732 734
733Quando impostate una chiave e Claude Code non si comporta come se l'aveste fatto, iniziate con `/status` per vedere quali file ha caricato, quindi trovate il vostro sintomo sottostante. [Debug della vostra configurazione](/docs/it/debug-your-config) copre i controlli più ampi, incluso un test di configurazione pulita.735Quando imposti una chiave e Claude Code non si comporta come se l'avessi fatto, inizia con `/status` per vedere quali file ha caricato, quindi trova il tuo sintomo di seguito. [Debug della tua configurazione](/docs/it/debug-your-config) copre i controlli più ampi, incluso un test di configurazione pulita.
734 736
735<h4 id="a-value-you-set-is-ignored">737<h4 id="a-value-you-set-is-ignored">
736 Un valore che impostate è ignorato738 Un valore che hai impostato viene ignorato
737</h4>739</h4>
738 740
739Qualcos'altro imposta la stessa chiave, il file non può impostare quel valore, o il file non è stato caricato:741Qualcos'altro sta impostando la stessa chiave, il file non può impostare quel valore, o il file non è stato caricato:
740 742
741* **Un livello più alto lo imposta.** Un altro file di impostazioni, un flag `--settings`, o una fonte gestita imposta la chiave sopra la vostra; lo [stack](#settings-precedence) dice quale. Un flag o una variabile di ambiente può anche ignorare la chiave per conto suo, deciso chiave per chiave; la voce della chiave sulla [referenza delle impostazioni](/docs/it/settings-reference) dice quale Claude Code usa, e la voce [`env`](/docs/it/settings-reference#env) copre un valore `env` gestito rispetto a un'esportazione shell.743* **Un livello più alto lo imposta.** Un altro file di impostazioni, un flag `--settings`, o una fonte gestita imposta la chiave sopra la tua; lo [stack](#settings-precedence) dice quale. Un flag o una variabile di ambiente può anche sostituire la chiave di per sé, deciso chiave per chiave; la voce della chiave nel [riferimento delle impostazioni](/docs/it/settings-reference) dice quale Claude Code utilizza, e la [voce `env`](/docs/it/settings-reference#env) copre un valore `env` gestito rispetto a un'esportazione di shell.
742* **Una chiave di sicurezza mantiene il suo valore rigoroso.** Per poche chiavi Claude Code onora il valore restrittivo da qualsiasi file, quindi un progetto `true` per [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) rimane acceso; vedere [Eccezioni alla precedenza delle impostazioni gestite](#exceptions-to-managed-settings-precedence).744* **Una chiave di sicurezza mantiene il suo valore restrittivo.** Per alcune chiavi Claude Code onora il valore restrittivo da qualsiasi file, quindi un `true` di progetto per [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) rimane attivo; vedi [Eccezioni alla precedenza delle impostazioni gestite](#exceptions-to-managed-settings-precedence).
743* **Il file non può impostare quel valore.** I valori [`permissions.defaultMode`](/docs/it/settings-reference#permissions-defaultmode) `auto` e `bypassPermissions` non hanno effetto dalle impostazioni di progetto o locale; impostateli nelle impostazioni utente o gestite invece, o passate `--permission-mode` per una sessione. Prima della v2.1.257, `bypassPermissions` aveva effetto da qualsiasi file.745* **Il file non può impostare quel valore.** I valori [`permissions.defaultMode`](/docs/it/settings-reference#permissions-defaultmode) `auto` e `bypassPermissions` non hanno effetto dalle impostazioni di progetto o locali; impostali invece nelle impostazioni utente o gestite, o passa `--permission-mode` per una sessione. Prima della v2.1.257, `bypassPermissions` aveva effetto da qualsiasi file.
744* **Il file è rotto.** JSON non valido o un valore rifiutato fa sì che Claude Code salti il file o la voce; vedere [Riparate un file di impostazioni rotto](#fix-a-broken-settings-file).746* **Il file è rotto.** JSON non valido o un valore rifiutato fa sì che Claude Code salti il file o la voce; vedi [Ripara un file di impostazioni rotto](#fix-a-broken-settings-file).
745 747
746<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">748<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">
747 Una modifica che avete fatto in Claude Code è persa nelle nuove sessioni749 Una modifica che hai fatto in Claude Code viene persa nelle nuove sessioni
748</h4>750</h4>
749 751
750Quando salvate una scelta per le nuove sessioni da dentro Claude Code, come un modello predefinito con `/model`, Claude Code la scrive nel vostro file di impostazioni utente, `~/.claude/settings.json`. Se non potete scrivere in quel file, ad esempio perché un altro strumento lo genera o lo collega a una copia di sola lettura, la modifica si applica alla sessione corrente e è persa nella successiva. Impostate la chiave nello strumento che genera il file, o sostituite il file con uno in cui potete scrivere.752Quando salvi una scelta per le nuove sessioni dall'interno di Claude Code, come un modello predefinito con `/model`, Claude Code la scrive nel tuo file di impostazioni utente, `~/.claude/settings.json`. Se non puoi scrivere in quel file, ad esempio perché un altro strumento lo genera o lo collega a una copia di sola lettura, la modifica si applica alla sessione corrente e scompare nella successiva. Imposta la chiave nello strumento che genera il file, o sostituisci il file con uno in cui puoi scrivere.
751 753
752Se potete scrivere nel file e la modifica comunque non dura, controllate se la modifica era [solo per una sessione](#change-a-setting-for-one-session) o [un livello più alto imposta la stessa chiave](#a-value-you-set-is-ignored). Per la chiave `model`, [Una nuova sessione inizia su un modello diverso da quello che avete scelto](/docs/it/model-config#a-new-session-starts-on-a-different-model-than-you-picked) elenca più cause.754Se puoi scrivere nel file e la modifica comunque non dura, controlla se la modifica era [solo per una sessione](#change-a-setting-for-one-session) o [un livello più alto imposta la stessa chiave](#a-value-you-set-is-ignored). Per la chiave `model`, [Una nuova sessione inizia su un modello diverso da quello che hai scelto](/docs/it/model-config#a-new-session-starts-on-a-different-model-than-you-picked) elenca più cause.
753 755
754<h4 id="a-managed-change-hasn’t-reached-you">756<h4 id="a-managed-change-hasn’t-reached-you">
755 Una modifica gestita non vi ha raggiunto757 Una modifica gestita non ti ha raggiunto
756</h4>758</h4>
757 759
758Le fonti gestite raggiungono una sessione in esecuzione secondo la pianificazione nella [tabella di consegna](/docs/it/managed-settings#choose-a-delivery-mechanism), quindi riavviate prima la sessione. Se `/status` allora nomina una fonte diversa da quella che il vostro amministratore ha modificato, una fonte con priorità più alta si applica; [Come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) fornisce l'ordine.760Le fonti gestite raggiungono una sessione in esecuzione secondo la pianificazione nella [tabella di consegna](/docs/it/managed-settings#choose-a-delivery-mechanism), quindi riavvia prima la sessione. Se `/status` quindi nomina una fonte diversa da quella che il tuo amministratore ha modificato, una fonte con priorità più alta si applica; [Come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) fornisce l'ordine.
759 761
760<h4 id="a-committed-key-doesn’t-reach-teammates">762<h4 id="a-committed-key-doesn’t-reach-teammates">
761 Una chiave committata non raggiunge i compagni di squadra763 Una chiave impegnata non raggiunge i compagni di squadra
762</h4>764</h4>
763 765
764Due cose impediscono a una chiave in `.claude/settings.json` di applicarsi per tutti coloro che la clonano:766Due cose impediscono a una chiave in `.claude/settings.json` di applicarsi per tutti coloro che la clonano:
765 767
766* **Claude Code ignora la chiave in un file di repository.** Cercate `User, local, or managed`, `User or managed`, `Managed`, o `Global config` nella colonna Scope dell'[indice delle impostazioni](/docs/it/settings-reference#settings-index); quelle chiavi non si applicano mai dal file condiviso, a parte [`autoContinueAtUsageLimit`](/docs/it/settings-reference#autocontinueatusagelimit), che un file di repository può comunque spegnere: mentre il file imposta la chiave e nessun valore utente, `--settings` o gestito lo fa, Claude Code legge l'impostazione come spenta. Le chiavi `Global config` si applicano solo da `~/.claude.json`.768* **Claude Code ignora la chiave in un file di repository.** Cerca `User, local, or managed`, `User or managed`, `Managed`, o `Global config` nella colonna Scope dell'[indice delle impostazioni](/docs/it/settings-reference#settings-index); quelle chiavi non si applicano mai dal file condiviso, a parte [`autoContinueAtUsageLimit`](/docs/it/settings-reference#autocontinueatusagelimit), che un file di repository può comunque disattivare: mentre il file imposta la chiave e nessun valore utente, `--settings`, o gestito lo fa, Claude Code legge l'impostazione come disattivata. Le chiavi `Global config` si applicano solo da `~/.claude.json`.
767* **La chiave attende la fiducia.** Le regole `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces` e la maggior parte dei valori [`env`](/docs/it/settings-reference#env) si applicano solo dopo che ogni compagno di squadra [fidia della cartella](/docs/it/permissions#project-allow-rules-and-workspace-trust). Fino ad allora vedono comunque i prompt e non ottengono i plugin da un marketplace che il file dichiara. Le regole `deny` e `ask` si applicano subito.769* **La chiave attende la fiducia.** Le regole `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces`, e la maggior parte dei valori [`env`](/docs/it/settings-reference#env) si applicano solo dopo che ogni compagno di squadra [affida la cartella](/docs/it/permissions#project-allow-rules-and-workspace-trust). Fino ad allora vedono ancora i prompt e non ottengono plugin da un marketplace che il file dichiara. Le regole `deny` e `ask` si applicano subito.
768 770
769<h4 id="permission-rules-combine-differently-than-you-expected">771<h4 id="permission-rules-combine-differently-than-you-expected">
770 Le regole di permesso si combinano diversamente da come vi aspettate772 Le regole di autorizzazione si combinano diversamente da quanto ti aspettavi
771</h4>773</h4>
772 774
773* **Avete scelto "Sì, e non chiedere di nuovo" su un prompt di permesso ma ricevete comunque il prompt per lo stesso strumento.** Quella scelta ha salvato una regola `allow` nel vostro file locale, e una regola `allow` lì non supera una regola `ask` da un file di progetto o gestito; [come le regole di permesso si combinano](/docs/it/permissions#settings-precedence) spiega l'ordine. Nell'estensione VS Code la scheda di approvazione vi permette di scegliere il file di destinazione, incluso il file condiviso del progetto, che cambia la regola per tutti; nella CLI, Claude Code scrive solo nel vostro file locale.775* **Hai scelto "Sì, e non chiedere di nuovo" su un prompt di autorizzazione ma ricevi comunque un prompt per lo stesso strumento.** Quella scelta ha salvato una regola `allow` nel tuo file locale, e una regola `allow` lì non supera una regola `ask` da un file di progetto o gestito; [come si combinano le regole di autorizzazione](/docs/it/permissions#settings-precedence) spiega l'ordine. Nell'estensione VS Code la scheda di approvazione ti permette di scegliere il file di destinazione, incluso il file condiviso del progetto, che cambia la regola per tutti; nella CLI, Claude Code scrive solo nel tuo file locale.
774* **Le regole allow della vostra organizzazione si applicano comunque insieme alle vostre.** È previsto: Claude Code unisce [`permissions.allow`](/docs/it/settings-reference#permissions-allow) tra gli ambiti, a meno che la vostra organizzazione non imposti [`allowManagedPermissionRulesOnly`](/docs/it/settings-reference#allowmanagedpermissionrulesonly).776* **Le regole di autorizzazione della tua organizzazione si applicano ancora insieme alle tue.** È previsto: Claude Code unisce [`permissions.allow`](/docs/it/settings-reference#permissions-allow) tra gli ambiti, a meno che la tua organizzazione non imposti [`allowManagedPermissionRulesOnly`](/docs/it/settings-reference#allowmanagedpermissionrulesonly).
775 777
776<span id="security-keys-where-the-stricter-value-applies" />778<span id="security-keys-where-the-stricter-value-applies" />
777 779
779 Eccezioni alla precedenza delle impostazioni gestite781 Eccezioni alla precedenza delle impostazioni gestite
780</h3>782</h3>
781 783
782Per poche chiavi sensibili alla sicurezza, Claude Code onora un valore restrittivo da un ambito che altrimenti non potrebbe ignorare le impostazioni gestite. Trovate la chiave in questa tabella per vedere quale valore onora e da dove.784Per alcune chiavi i cui valori limitano una sessione, Claude Code onora un valore restrittivo da un ambito che altrimenti non potrebbe sostituire le impostazioni gestite. Trova la chiave in questa tabella per vedere quale valore onora e da dove.
783 785
784| Chiave | Valore che Claude Code onora | Note |786| Chiave | Valore che Claude Code onora | Note |
785| :------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |787| :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
786| [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) | `true` da qualsiasi ambito | Onorato anche quando una fonte gestita imposta `false` |788| [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) | `true` da qualsiasi ambito | Onorato anche quando una fonte gestita imposta `false` |
787| [`enableArtifact`](/docs/it/settings-reference#enableartifact) | `false` da qualsiasi ambito, e `disableArtifact: true` da qualsiasi ambito | Onorato anche quando una fonte gestita imposta `true`; nulla riattiva lo [strumento Artifact](/docs/it/artifacts#disable-artifacts). Richiede Claude Code v2.1.242 o successivo |789| [`enableArtifact`](/docs/it/settings-reference#enableartifact) | `false` da qualsiasi ambito, e `disableArtifact: true` da qualsiasi ambito | Onorato anche quando una fonte gestita imposta `true`; nulla riattiva lo [strumento Artifact](/docs/it/artifacts#disable-artifacts). Richiede Claude Code v2.1.242 o successivo |
788| [`isolatePeerMachines`](/docs/it/settings-reference#isolatepeermachines) | `true` da qualsiasi ambito | Onorato anche quando una fonte gestita imposta `false` |790| [`isolatePeerMachines`](/docs/it/settings-reference#isolatepeermachines) | `true` da qualsiasi ambito | Onorato anche quando una fonte gestita imposta `false` |
789| [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) | `false` da `.claude/settings.json` o `.claude/settings.local.json` | Onorato anche quando una fonte gestita imposta `true`; un progetto o locale `true` è ignorato |791| [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) | `false` da `.claude/settings.json` o `.claude/settings.local.json` | Onorato anche quando una fonte gestita imposta `true`; un `true` di progetto o locale viene ignorato |
790| [`crossSessionInbound`](/docs/it/settings-reference#crosssessioninbound) | Un valore più rigoroso da `.claude/settings.json` o `.claude/settings.local.json`, sulla scala `accept` \< `hold` \< `refuse` | Onorato sopra i valori gestiti, `--settings` e utente; un valore di progetto o locale che non è più rigoroso è ignorato |792| [`crossSessionInbound`](/docs/it/settings-reference#crosssessioninbound) | Un valore più restrittivo da `.claude/settings.json` o `.claude/settings.local.json`, sulla scala `accept` \< `hold` \< `refuse` | Onorato rispetto ai valori gestiti, `--settings`, e utente; un valore di progetto o locale che non è più restrittivo viene ignorato |
791| [`useAutoModeDuringPlan`](/docs/it/settings-reference#useautomodeduringplan) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Onorato anche quando la fonte gestita vincente imposta `true`; un `false` in `.claude/settings.json` è ignorato |793| [`useAutoModeDuringPlan`](/docs/it/settings-reference#useautomodeduringplan) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json`, o `.claude/settings.local.json` | Onorato anche quando la fonte gestita vincente imposta `true`; un `false` in `.claude/settings.json` viene ignorato |
792| [`syncClaudeAiSkills`](/docs/it/settings-reference#syncclaudeaiskills) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Onorato anche quando la fonte gestita vincente imposta `true`; un `false` in `.claude/settings.json` è ignorato |794| [`syncClaudeAiSkills`](/docs/it/settings-reference#syncclaudeaiskills) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json`, o `.claude/settings.local.json` | Onorato anche quando la fonte gestita vincente imposta `true`; un `false` in `.claude/settings.json` viene ignorato |
795| [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) | Un limite inferiore da qualsiasi ambito, incluso `--settings` | Onorato anche quando le impostazioni gestite che Claude Code applica impostano un limite superiore; si applica il limite più basso. Richiede Claude Code v2.1.267 o successivo |
793 796
794Un'app che esegue Claude Code dentro se stessa e imposta [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars) è anche un'eccezione. Claude Code prende la configurazione del modello di quell'app sopra le chiavi `model`, `fallbackModel` e `modelOverrides` da ogni fonte gestita, e sopra le variabili di selezione del modello in un blocco `env` gestito, come `ANTHROPIC_MODEL` e la famiglia `ANTHROPIC_DEFAULT_*_MODEL`. Claude Code mantiene un [`availableModels`](/docs/it/settings-reference#availablemodels) gestito in vigore a meno che l'app non fornisca il suo.797Un'app che esegue Claude Code al suo interno e imposta [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars) è anche un'eccezione. Claude Code prende la configurazione del modello di quell'app rispetto alle chiavi `model`, `fallbackModel`, `modelPicker`, e `modelOverrides` da ogni fonte gestita, e rispetto alle variabili di selezione del modello in un blocco `env` gestito, come `ANTHROPIC_MODEL` e la famiglia `ANTHROPIC_DEFAULT_*_MODEL`. Claude Code mantiene un elenco di autorizzazione [`availableModels`](/docs/it/settings-reference#availablemodels) gestito in vigore a meno che l'app non fornisca il suo.
795 798
796<h2 id="settings-in-cloud-sessions">799<h2 id="settings-in-cloud-sessions">
797 Impostazioni nelle sessioni cloud800 Impostazioni nelle sessioni cloud