90 90
91Il flag `--model` e la variabile di ambiente `ANTHROPIC_MODEL` si applicano solo alla sessione che avviate con essi. Per eseguire modelli diversi in terminali diversi contemporaneamente, avviate ciascuno con il proprio flag `--model` piuttosto che passare con `/model`.91Il flag `--model` e la variabile di ambiente `ANTHROPIC_MODEL` si applicano solo alla sessione che avviate con essi. Per eseguire modelli diversi in terminali diversi contemporaneamente, avviate ciascuno con il proprio flag `--model` piuttosto che passare con `/model`.
92 92
93Le sessioni riprese avviate con `claude --resume`, `--continue`, o il selettore `/resume` mantengono il modello che stavano utilizzando quando la trascrizione è stata salvata, indipendentemente dall'impostazione `model` corrente. Se quel modello è stato ritirato, la sessione ricade nell'ordine di precedenza normale. Questo impedisce che la scelta `/model` di un'altra sessione cambi il modello al ripristino.93Le sessioni riprese avviate con `claude --resume`, `--continue`, o il selettore `/resume` mantengono il modello che stavano utilizzando quando la trascrizione è stata salvata, indipendentemente dall'impostazione `model` corrente. Se quel modello è stato ritirato o è escluso da [`availableModels`](#restrict-model-selection), la sessione ricade nell'ordine di precedenza normale. Questo impedisce che la scelta `/model` di un'altra sessione cambi il modello al ripristino.
94 94
95Quando il modello attivo all'avvio proviene dalle impostazioni del progetto o gestite piuttosto che dalla propria selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Eseguire `/model` per eseguire l'override; l'impostazione del progetto o gestita si riapplica al prossimo avvio.95Quando il modello attivo all'avvio proviene dalle impostazioni del progetto o gestite piuttosto che dalla propria selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Eseguire `/model` per eseguire l'override; l'impostazione del progetto o gestita si riapplica al prossimo avvio.
96 96
121 Limitare la selezione del modello121 Limitare la selezione del modello
122</h2>122</h2>
123 123
124Gli amministratori aziendali possono utilizzare `availableModels` nelle [impostazioni gestite o di policy](/it/settings#settings-files) per limitare quali modelli gli utenti possono selezionare.124Gli amministratori aziendali possono utilizzare `availableModels` nelle [impostazioni gestite o di policy](/it/settings#settings-files) per limitare quali modelli gli utenti possono selezionare. Le voci corrispondono a una famiglia di modelli come `sonnet`, un prefisso di versione come `claude-sonnet-4-5`, o un ID modello completo come `claude-sonnet-4-5-20250929`.
125 125
126Quando `availableModels` è impostato, l'elenco di autorizzazione si applica ovunque un utente possa specificare un modello:126Quando `availableModels` è impostato, l'elenco di autorizzazione si applica ovunque un utente possa specificare un modello:
127 127
128* **Modello della sessione principale**: `/model`, il flag `--model` e la variabile di ambiente `ANTHROPIC_MODEL`128* **Modello della sessione principale**: `/model`, il flag `--model`, la variabile di ambiente `ANTHROPIC_MODEL`, l'impostazione `model` e il modello ripristinato quando [si riprende una sessione](#setting-your-model)
129* **Risoluzione alias**: {/* min-version: 2.1.176 */}le variabili di ambiente `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` e `ANTHROPIC_DEFAULT_FABLE_MODEL` non possono reindirizzare un alias consentito a un modello al di fuori dell'elenco129* **Risoluzione alias**: {/* min-version: 2.1.176 */}le variabili di ambiente `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` e `ANTHROPIC_DEFAULT_FABLE_MODEL` non possono reindirizzare un alias consentito a un modello al di fuori dell'elenco
130* **Modalità veloce**: {/* min-version: 2.1.176 */}`/fast` rifiuta di attivare/disattivare quando comporterebbe un passaggio implicito a un modello Opus al di fuori dell'elenco, con il messaggio "is not in your organization's allowed models"130* **Modalità veloce**: {/* min-version: 2.1.176 */}`/fast` rifiuta di attivare/disattivare quando comporterebbe un passaggio implicito a un modello Opus al di fuori dell'elenco, con il messaggio "is not in your organization's allowed models"
131* **Modelli dei subagent**: il campo `model` nel [frontmatter del subagent](/it/sub-agents#choose-a-model), il parametro `model` dello strumento Agent, il selettore di modelli in `/agents` e `CLAUDE_CODE_SUBAGENT_MODEL`131* **Modelli dei subagent**: il campo `model` nel [frontmatter del subagent](/it/sub-agents#choose-a-model), il parametro `model` dello strumento Agent, il selettore di modelli in `/agents` e `CLAUDE_CODE_SUBAGENT_MODEL`
132* **Modello Advisor**: l'impostazione [`advisorModel`](/it/advisor) configurata132* **Modelli di skill e comando**: il frontmatter `model` in [skill e comandi](/it/skills)
133* **Catene di fallback**: gli elementi di una [catena di modelli di fallback](#fallback-model-chains) al di fuori dell'elenco vengono eliminati133* **Modello Advisor**: l'impostazione [`advisorModel`](/it/advisor) configurata e il flag `--advisor`
134* **Modello dell'agente di background**: il modello selezionato nel [selettore di dispatch](/it/agent-view)
134 135
135Il passaggio a un modello bloccato con `/model` viene rifiutato con un errore, mentre un flag `--model` bloccato o un valore `ANTHROPIC_MODEL` viene sostituito all'avvio con un avviso che nomina sia i modelli richiesti che quelli sostituiti, e la sessione inizia sul modello predefinito. Un override di subagent o advisor bloccato ritorna al modello ereditato o predefinito piuttosto che non riuscire nella richiesta.136Il passaggio a un modello bloccato con `/model` viene rifiutato con un errore, mentre un flag `--model` bloccato, `ANTHROPIC_MODEL` o un valore dell'impostazione `model` viene sostituito all'avvio con un avviso che nomina sia i modelli richiesti che quelli sostituiti, e la sessione inizia sul modello predefinito. Un override di subagent, skill o comando bloccato ritorna al modello ereditato o predefinito piuttosto che non riuscire nella richiesta; un'impostazione `advisorModel` bloccata disabilita l'advisor per la sessione, mentre un valore del flag `--advisor` bloccato esce con un errore all'avvio. I modelli esclusi sono nascosti dal selettore `/model`.
137
138I cambiamenti automatici del modello vengono controllati allo stesso modo: gli elementi di una [catena di modelli di fallback](#fallback-model-chains) al di fuori dell'elenco di autorizzazione vengono eliminati, un aggiornamento in modalità plan come [`opusplan`](#opusplan-model-setting) a un modello escluso viene saltato in modo che la pianificazione continui sul modello della sessione, e un [fallback automatico del modello](#automatic-model-fallback) il cui target è escluso non viene eseguito, quindi la richiesta contrassegnata termina con un rifiuto. L'abilitazione della [modalità veloce](/it/fast-mode) viene rifiutata quando il modello su cui la sessione verrebbe eseguita in seguito è al di fuori dell'elenco di autorizzazione.
136 139
137```json theme={null}140```json theme={null}
138{141{
140}143}
141```144```
142 145
146<h3 id="surface-coverage">
147 Copertura della superficie
148</h3>
149
150Ogni superficie applica l'elenco di autorizzazione che riceve. Il meccanismo di consegna che raggiunge ogni superficie differisce:
151
152| Meccanismo di consegna | CLI e IDE | Sessioni locali desktop | Sessioni web, mobile e cloud | Agent SDK e non interattive | Cowork |
153| :---------------------------------------------------------------------------------------------- | :-------- | :---------------------- | :--------------------------- | :-------------------------- | :------------------------- |
154| [Impostazioni gestite dal server](/it/server-managed-settings) dalla console di amministrazione | Applicate | Applicate | Applicate | Applicate | Non consegnate |
155| [File di impostazioni gestite o MDM](/it/settings#settings-files) | Applicate | Applicate | Non consegnate | Applicate | Applicate dove distribuite |
156
157* Le sessioni cloud, su [Claude Code sul web](/it/claude-code-on-the-web) o nell'app Desktop, vengono eseguite su VM gestite da Anthropic: le impostazioni distribuite al vostro dispositivo non le raggiungono, quindi consegnate l'elenco di autorizzazione tramite impostazioni gestite dal server. Un cambio di modello a metà sessione in una sessione cloud viene rifiutato quando il modello richiesto è escluso dall'elenco di autorizzazione. Il rifiuto lato server alla creazione della sessione si applica alle [restrizioni del modello dell'organizzazione](#organization-model-restrictions), non alla chiave delle impostazioni `availableModels`.
158* Cowork, la scheda agentic-work nell'app Claude Desktop, non è una superficie Claude Code e non riceve impostazioni gestite dal server per progettazione. Un file di impostazioni gestite si applica alle sessioni Cowork quando è presente dove la sessione viene eseguita; le sessioni Cowork remote vengono eseguite su VM gestite da Anthropic, dove un file distribuito dal dispositivo non è presente.
159* Le sessioni su [provider di terze parti](/it/server-managed-settings#platform-availability) come Bedrock, Vertex AI, Foundry e [Claude Platform su AWS](/it/claude-platform-on-aws) non ricevono impostazioni gestite dal server, quindi consegnate l'elenco di autorizzazione tramite MDM o file di impostazioni gestite lì.
160* La consegna gestita dal server richiede anche che la sessione si autentichi con un accesso all'organizzazione o una chiave API configurata direttamente. Le flotte che generano chiavi solo tramite uno script [`apiKeyHelper`](/it/settings#available-settings) dovrebbero consegnare l'elenco di autorizzazione tramite MDM o file di impostazioni gestite.
161* La scheda Desktop Code ospita anche [sessioni SSH](/it/desktop#ssh-sessions), che leggono il file di impostazioni gestite dall'host remoto su cui vengono eseguite. Vedere [Impostazioni gestite desktop](/it/desktop#managed-settings).
162* I selettori di modelli su claude.ai e nell'app Desktop nascondono o disabilitano i modelli esclusi dall'elenco di autorizzazione della vostra organizzazione. Lo stato del selettore è una comodità per gli utenti; l'applicazione avviene nella sessione.
163
143<h3 id="default-model-behavior">164<h3 id="default-model-behavior">
144 Comportamento del modello predefinito165 Comportamento del modello predefinito
145</h3>166</h3>
146 167
147Per impostazione predefinita, l'opzione Predefinito nel selettore di modelli non è interessata da `availableModels`. Rimane disponibile e rappresenta il valore predefinito di runtime del sistema [in base al livello di sottoscrizione dell'utente](#default-model-setting).168L'opzione Predefinito nel selettore di modelli non è interessata da `availableModels` a meno che [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) non sia anche impostato. Da solo, `availableModels` lascia Predefinito disponibile, risolvendo al valore predefinito di runtime del sistema [in base al livello di sottoscrizione dell'utente](#default-model-setting). Se il valore predefinito del livello è un modello che intendete limitare, impostare anche `enforceAvailableModels`.
148 169
149Per estendere l'elenco di autorizzazione all'opzione Predefinito, impostare `enforceAvailableModels` su `true` nelle impostazioni gestite o di policy insieme a un elenco `availableModels` non vuoto. Quando il valore predefinito del livello non è nell'elenco di autorizzazione, Predefinito si risolve nella prima voce consentita invece del valore predefinito del livello. Questo richiede Claude Code v2.1.175 o successivo.170Un array `availableModels` vuoto non attiva mai l'applicazione del modello Predefinito: con `availableModels: []`, le selezioni di modelli denominati vengono bloccate ma il modello Predefinito per il tipo di account rimane utilizzabile indipendentemente da `enforceAvailableModels`.
150 171
151Un array `availableModels` vuoto non attiva mai l'applicazione. Anche con `availableModels: []`, gli utenti possono comunque utilizzare Claude Code con il modello Predefinito per il loro livello indipendentemente da `enforceAvailableModels`.172<h3 id="enforce-the-allowlist-for-the-default-model">
173 Applicare l'elenco di autorizzazione per il modello Predefinito
174</h3>
175
176Impostare `enforceAvailableModels: true` insieme a un `availableModels` non vuoto nelle impostazioni gestite per estendere l'elenco di autorizzazione all'opzione Predefinito. Questo richiede Claude Code v2.1.175 o successivo.
177
178```json theme={null}
179{
180 "availableModels": ["sonnet", "haiku"],
181 "enforceAvailableModels": true
182}
183```
184
185Quando il modello predefinito per il tipo di account dell'utente non è nell'elenco di autorizzazione, l'opzione Predefinito si risolve invece nella prima voce `availableModels` che nomina un modello consentito e disponibile, e la riga Predefinito del selettore `/model` mostra quel modello. Questo si applica ovunque il valore predefinito viene raggiunto: avvio della sessione, selezione di Predefinito in `/model`, la parola chiave `"default"` nelle [catene di modelli di fallback](#fallback-model-chains) e il fallback utilizzato quando una selezione esclusa viene eliminata.
186
187`enforceAvailableModels` non ha effetto quando `availableModels` non è impostato o è vuoto: con `availableModels: []`, il modello Predefinito per il tipo di account rimane utilizzabile, quindi l'impostazione non può bloccare gli utenti da ogni modello. Quando `availableModels` è non vuoto ma nessuna voce si risolve a un modello consentito e disponibile, l'applicazione si degrada e Predefinito ricade al valore predefinito del tipo di account, con un avviso visibile solo sotto `--debug`. Mantenere almeno una voce garantita disponibile nell'elenco per evitare questo.
188
189Distribuire entrambe le chiavi nella [fonte gestita con precedenza più alta](/it/settings#settings-precedence): le fonti gestite distribuite dall'amministratore non si uniscono, quindi una coppia posizionata in un file di impostazioni gestite viene ignorata quando la console di amministrazione consegna qualsiasi impostazione.
152 190
153<h3 id="control-the-model-users-run-on">191<h3 id="control-the-model-users-run-on">
154 Controllare il modello su cui gli utenti eseguono192 Controllare il modello su cui gli utenti eseguono
155</h3>193</h3>
156 194
157L'impostazione `model` è una selezione iniziale, non un'applicazione. Imposta quale modello è attivo quando una sessione inizia, ma gli utenti possono comunque aprire `/model` e scegliere Predefinito, che si risolve nel valore predefinito del sistema per il loro livello indipendentemente da ciò che `model` è impostato.195L'impostazione `model` è una selezione iniziale, non un'applicazione. Imposta quale modello è attivo quando una sessione inizia, ma gli utenti possono comunque aprire `/model` e scegliere Predefinito, che si risolve al valore predefinito del sistema per il loro livello indipendentemente da ciò che `model` è impostato, a meno che [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) non lo reindizzi.
158 196
159Per controllare completamente l'esperienza del modello, combinare queste impostazioni:197Per controllare completamente l'esperienza del modello, combinare queste impostazioni:
160 198
182 Comportamento di unione220 Comportamento di unione
183</h3>221</h3>
184 222
185Quando `availableModels` è impostato nelle impostazioni utente, progetto e locali solamente, gli array vengono uniti e deduplicati su questi livelli.223Quando la [fonte di impostazioni gestite con precedenza più alta](/it/server-managed-settings#settings-precedence) definisce `availableModels`, solo quell'elenco si applica: le voci nelle impostazioni utente, progetto o locali non possono estenderlo, e le fonti gestite distribuite dall'amministratore non si uniscono tra loro, quindi un elenco distribuito in un file di impostazioni gestite viene ignorato quando le impostazioni gestite dal server consegnano qualsiasi chiave. Altrimenti, gli elenchi dalle impostazioni utente, progetto e locali vengono [concatenati e deduplicati](/it/settings#settings-precedence) come altre impostazioni di array. {/* min-version: 2.1.175 */}A partire da Claude Code v2.1.175, l'elenco gestito sostituisce le voci di precedenza inferiore; le versioni precedenti le uniscono.
186 224
187Quando `availableModels` è impostato nelle impostazioni gestite o di policy, il valore gestito o di policy sostituisce completamente il risultato unito: le voci aggiunte nelle impostazioni utente o progetto non possono ampliarlo. Le impostazioni gestite e di policy sostituiscono i valori di precedenza inferiore per `enforceAvailableModels` allo stesso modo. A partire da Claude Code v2.1.175, questo è l'unico modo per applicare un elenco di autorizzazione rigoroso; le versioni precedenti uniscono l'elenco gestito con le voci di precedenza inferiore.225All'interno dell'elenco effettivo, una voce che nomina un modello specifico in una famiglia, sia un prefisso di versione che un ID modello completo, disabilita la voce wildcard della famiglia: `["sonnet", "claude-sonnet-4-5"]` consente solo le versioni Sonnet 4.5, non ogni modello Sonnet.
188 226
189<h3 id="mantle-model-ids">227<h3 id="mantle-model-ids">
190 ID di modello Mantle228 ID di modello Mantle
191</h3>229</h3>
192 230
193Quando l'[endpoint Bedrock Mantle](/it/amazon-bedrock#use-the-mantle-endpoint) è abilitato, le voci in `availableModels` che iniziano con `anthropic.` vengono aggiunte al selettore `/model` come opzioni personalizzate e instradate all'endpoint Mantle. L'impostazione limita comunque il selettore alle voci elencate, quindi includere gli alias standard insieme a qualsiasi ID Mantle.231Quando l'[endpoint Bedrock Mantle](/it/amazon-bedrock#use-the-mantle-endpoint) è abilitato, le voci in `availableModels` che iniziano con `anthropic.` vengono aggiunte al selettore `/model` come opzioni personalizzate e instradate all'endpoint Mantle. Questa è un'eccezione alla corrispondenza degli alias descritta in [Fissare i modelli per le distribuzioni di terze parti](#pin-models-for-third-party-deployments). L'impostazione limita comunque il selettore alle voci elencate, e un ID Mantle incorpora un nome di famiglia, quindi conta come una voce specifica e disabilita il wildcard della famiglia: insieme a qualsiasi ID Mantle, elencare i prefissi di versione o gli ID completi che desiderate mantenere selezionabili. Vedere [Comportamento di unione](#merge-behavior).
232
233<h3 id="organization-model-restrictions">
234 Restrizioni del modello dell'organizzazione
235</h3>
236
237Utilizzare l'interruttore della Console invece di `availableModels` quando i vostri membri si autenticano tramite l'API Anthropic e desiderate un interruttore a livello di organizzazione senza distribuire file di impostazioni. Gli amministratori dell'organizzazione limitano quali modelli i membri possono eseguire disabilitando i singoli modelli nella Claude Console. Questa restrizione viene consegnata con i diritti dell'account quando Claude Code si autentica, separata da qualsiasi elenco `availableModels` nelle impostazioni, e il server applica la stessa restrizione indipendentemente quando una sessione viene creata. Richiede Claude Code v2.1.187 o successivo.
238
239Un modello limitato è nascosto dal selettore `/model`. Selezionarlo per nome con `--model`, la variabile di ambiente `ANTHROPIC_MODEL` o l'impostazione `model` mostra l'avviso `Model "<name>" is restricted by your organization's settings. Using <model> instead.` e la sessione inizia su un modello consentito. Digitare `/model <name>` per un modello limitato viene rifiutato con `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` e la sessione mantiene il suo modello attuale.
240
241I due meccanismi si compongono: un modello è selezionabile solo quando è consentito da `availableModels` e non è limitato dall'organizzazione. Le restrizioni dell'organizzazione vengono consegnate alle sessioni sull'API Anthropic e alle distribuzioni [LLM gateway](/it/llm-gateway). Le sessioni su Bedrock, Vertex AI, Foundry e Claude Platform su AWS non le ricevono, quindi utilizzate `availableModels` su quei provider invece.
194 242
195<h2 id="special-model-behavior">243<h2 id="special-model-behavior">
196 Comportamento speciale del modello244 Comportamento speciale del modello
209 257
210Enterprise pay-as-you-go significa un'organizzazione Enterprise fatturata per utilizzo piuttosto che per posto di abbonamento.258Enterprise pay-as-you-go significa un'organizzazione Enterprise fatturata per utilizzo piuttosto che per posto di abbonamento.
211 259
260Quando le impostazioni gestite [applicano l'elenco consentito per il modello predefinito](#enforce-the-allowlist-for-the-default-model) e il valore predefinito del tipo di account non è in `availableModels`, `default` si risolve nel valore predefinito applicato invece del valore predefinito del tipo di account sopra.
261
212Fable 5 non è il modello predefinito su alcun tipo di account. Le sessioni utilizzano Fable 5 solo dopo che lo scegliete, con `/model fable`, un'impostazione `model`, o l'alias `best` dove Fable 5 è disponibile. Sceglierlo con `/model` lo salva come modello selezionato nelle impostazioni utente, quindi le sessioni successive iniziano su Fable 5 fino a quando non cambiate modello.262Fable 5 non è il modello predefinito su alcun tipo di account. Le sessioni utilizzano Fable 5 solo dopo che lo scegliete, con `/model fable`, un'impostazione `model`, o l'alias `best` dove Fable 5 è disponibile. Sceglierlo con `/model` lo salva come modello selezionato nelle impostazioni utente, quindi le sessioni successive iniziano su Fable 5 fino a quando non cambiate modello.
213 263
214<h3 id="opusplan-model-setting">264<h3 id="opusplan-model-setting">
267 317
268La sessione continua quindi su quel modello Opus. Per tornare a Fable 5, eseguire `/model fable`.318La sessione continua quindi su quel modello Opus. Per tornare a Fable 5, eseguire `/model fable`.
269 319
320Il target di fallback viene controllato rispetto a [`availableModels`](#restrict-model-selection). Quando è bloccato, non si verifica alcun fallback. Il rifiuto emerge come un errore normale e il modello della sessione rimane invariato.
321
270<h4 id="check-what-triggered-fallback">322<h4 id="check-what-triggered-fallback">
271 Verificare cosa ha attivato il fallback323 Verificare cosa ha attivato il fallback
272</h4>324</h4>
286* Se entrambi i modelli contrassegnano la stessa richiesta, potete modificare il prompt e riprovare, o avviare una nuova sessione.338* Se entrambi i modelli contrassegnano la stessa richiesta, potete modificare il prompt e riprovare, o avviare una nuova sessione.
287* Su sessioni mobili [Claude Code sul web](/it/claude-code-on-the-web), la modifica e il nuovo tentativo non sono supportati. Passate i modelli o continuate la sessione da un browser desktop o dall'app desktop.339* Su sessioni mobili [Claude Code sul web](/it/claude-code-on-the-web), la modifica e il nuovo tentativo non sono supportati. Passate i modelli o continuate la sessione da un browser desktop o dall'app desktop.
288* In [modalità non interattiva](/it/cli-reference#cli-flags) e integrazioni SDK che non possono mostrare il prompt, una richiesta contrassegnata termina il turno con un rifiuto.340* In [modalità non interattiva](/it/cli-reference#cli-flags) e integrazioni SDK che non possono mostrare il prompt, una richiesta contrassegnata termina il turno con un rifiuto.
341* Quando il target di fallback è bloccato da [`availableModels`](#restrict-model-selection), il prompt non viene mostrato. La richiesta contrassegnata termina con il rifiuto, lo stesso del fallback automatico quando il target è bloccato.
289 342
290<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">343<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">
291 Abilitare il fallback su Bedrock, Vertex AI e Foundry344 Abilitare il fallback su Bedrock, Vertex AI e Foundry
452 505
453La voce personalizzata appare in fondo al selettore `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` e `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` sono facoltativi. Se omessi, l'ID del modello viene utilizzato come nome e la descrizione per impostazione predefinita è `Custom model (<model-id>)`.506La voce personalizzata appare in fondo al selettore `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` e `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` sono facoltativi. Se omessi, l'ID del modello viene utilizzato come nome e la descrizione per impostazione predefinita è `Custom model (<model-id>)`.
454 507
455Claude Code salta la convalida per l'ID del modello impostato in `ANTHROPIC_CUSTOM_MODEL_OPTION`, quindi è possibile utilizzare qualsiasi stringa che l'endpoint API accetta.508Claude Code salta la convalida per l'ID del modello impostato in `ANTHROPIC_CUSTOM_MODEL_OPTION`, quindi è possibile utilizzare qualsiasi stringa che l'endpoint API accetta. Quando [`availableModels`](#restrict-model-selection) è impostato, includere l'ID del modello personalizzato anche nell'elenco di autorizzazione: la voce personalizzata viene filtrata dal selettore e una selezione `--model` di essa viene rifiutata come qualsiasi altro modello escluso. Un ID personalizzato che incorpora un nome di famiglia, come `my-gateway/claude-opus-4-7`, conta come una voce specifica per quella famiglia e disabilita il suo wildcard, quindi elencare anche le versioni che intendete mantenere selezionabili. Vedere [Comportamento di unione](#merge-behavior).
456 509
457<h2 id="environment-variables">510<h2 id="environment-variables">
458 Variabili di ambiente511 Variabili di ambiente
505* Il suffisso viene letto per variabile, non per modello. Su Bedrock, Vertex e Foundry, un ID di modello senza `[1m]` in una variabile utilizza il contesto 200K anche se un'altra variabile imposta lo stesso modello con il suffisso.558* Il suffisso viene letto per variabile, non per modello. Su Bedrock, Vertex e Foundry, un ID di modello senza `[1m]` in una variabile utilizza il contesto 200K anche se un'altra variabile imposta lo stesso modello con il suffisso.
506 559
507<Note>560<Note>
508 L'elenco di autorizzazione `settings.availableModels` si applica comunque quando si utilizzano provider di terze parti. Il filtraggio corrisponde all'alias del modello come `opus`, al prefisso della versione come `claude-opus-4-8`, o all'ID del modello completo. Qualsiasi suffisso `[1m]` viene rimosso sia dalla voce dell'elenco di autorizzazione che dal modello richiesto prima della corrispondenza, quindi una voce di `claude-opus-4-8` consente sia le righe Opus standard che quelle con contesto 1M. I prefissi specifici del provider come `us.anthropic.` non vengono rimossi: elencare la stessa forma in `availableModels` che il selettore mostra, o mapparla tramite [`modelOverrides`](#override-model-ids-per-version).561 Un elenco di autorizzazione `availableModels` fornito tramite [MDM o un file di impostazioni gestite](/it/settings#settings-files) si applica comunque quando si utilizzano provider di terze parti; [le impostazioni gestite dal server non vengono fornite lì](/it/server-managed-settings#platform-availability). Il filtraggio corrisponde a un alias di modello come `opus`, a un prefisso di versione come `claude-opus-4-8`, o all'ID di modello completo in forma di provider. I prefissi specifici del provider come `us.anthropic.` non vengono rimossi, quindi per consentire un modello specifico, elencare lo stesso ID in forma di provider che il selettore mostra, o mapparlo tramite [`modelOverrides`](#override-model-ids-per-version). Qualsiasi suffisso `[1m]` viene rimosso sia dalla voce dell'elenco di autorizzazione che dal modello richiesto prima della corrispondenza.
509</Note>562</Note>
510 563
511<h3 id="customize-pinned-model-display-and-capabilities">564<h3 id="customize-pinned-model-display-and-capabilities">
572 625
573Gli override sostituiscono gli ID di modello incorporati che supportano ogni voce nel selettore `/model`. Su Bedrock, gli override hanno la precedenza su qualsiasi profilo di inferenza che Claude Code scopre automaticamente all'avvio. I valori forniti direttamente tramite `ANTHROPIC_MODEL`, `--model` o le variabili di ambiente `ANTHROPIC_DEFAULT_*_MODEL` vengono passati al provider così come sono e non vengono trasformati da `modelOverrides`.626Gli override sostituiscono gli ID di modello incorporati che supportano ogni voce nel selettore `/model`. Su Bedrock, gli override hanno la precedenza su qualsiasi profilo di inferenza che Claude Code scopre automaticamente all'avvio. I valori forniti direttamente tramite `ANTHROPIC_MODEL`, `--model` o le variabili di ambiente `ANTHROPIC_DEFAULT_*_MODEL` vengono passati al provider così come sono e non vengono trasformati da `modelOverrides`.
574 627
575`modelOverrides` funziona insieme a `availableModels`. L'elenco di autorizzazione viene valutato rispetto all'ID di modello Anthropic, non al valore di override, quindi una voce come `"opus"` in `availableModels` continua a corrispondere anche quando le versioni di Opus sono mappate a ARN.628`modelOverrides` funziona insieme a `availableModels`. L'elenco di autorizzazione viene valutato rispetto all'ID di modello Anthropic, non al valore di override, quindi una voce come `"opus"` in `availableModels` continua a corrispondere anche quando le versioni di Opus sono mappate a ARN. Quando `enforceAvailableModels` è impostato nelle impostazioni gestite, il Default applicato si risolve tramite `modelOverrides` dalla [fonte gestita con precedenza più alta](/it/server-managed-settings#settings-precedence) solo. Il mapping di un amministratore, come una versione fissata a un ARN di profilo di inferenza, viene rispettato nel Default applicato. Gli override dalle impostazioni utente o progetto non lo influenzano.
576 629
577<h3 id="prompt-caching-configuration">630<h3 id="prompt-caching-configuration">
578 Configurazione della prompt caching631 Configurazione della prompt caching
