A meno che non impostiate ANTHROPIC_DEFAULT_FABLE_MODEL, l'alias fable si risolve in Fable 5.1, tranne nelle sessioni Claude apps gateway dove fable e best si risolvono in Fable 5. Prima della v2.1.257, fable si risolveva in Fable 5 su ogni provider.

Un gateway non configurato per servire claude-fable-5-1 rifiuta le richieste per quel modello. Per utilizzare Fable 5.1 attraverso un gateway che lo serve, selezionarlo con /model claude-fable-5-1.

Dove un alias si risolve in un modello più vecchio, i modelli più recenti sono disponibili selezionando il nome completo del modello esplicitamente o impostando ANTHROPIC_DEFAULT_OPUS_MODEL o ANTHROPIC_DEFAULT_SONNET_MODEL.

Prima della v2.1.219, opus si risolveva in Opus 4.8 sull'API Anthropic dalla v2.1.154, e su Claude Platform on AWS, Amazon Bedrock e Agent Platform di Google Cloud dalla v2.1.207. Prima della v2.1.207, opus si risolveva in Opus 4.7 su Claude Platform on AWS e in Opus 4.6 su Amazon Bedrock e Agent Platform di Google Cloud.

Gli alias puntano alla versione consigliata per il vostro provider e si aggiornano nel tempo. Per fissare una versione specifica, utilizzare il nome completo del modello, ad esempio claude-opus-5, o impostare la variabile di ambiente corrispondente come ANTHROPIC_DEFAULT_OPUS_MODEL.

Lavorare con Fable

Claude Fable 5.1 e Claude Fable 5 sono i modelli più capaci in Claude Code, adatti a compiti più grandi di una singola sessione. Sostengono lunghe sessioni autonome, investigano prima di agire e verificano il loro lavoro più spesso rispetto ai modelli più piccoli. Fable 5.1 è la versione più recente.

Nessuno dei due modelli Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionarne uno esplicitamente:

• Fable 5.1: eseguire /model fable, o avviare con claude --model fable. Nelle sessioni Claude apps gateway, dove l'alias si risolve in Fable 5, eseguire /model claude-fable-5-1 invece.
• Fable 5: selezionarlo per ID del modello. Sull'API Anthropic, eseguire /model claude-fable-5 o avviare con claude --model claude-fable-5. Su altri provider, utilizzare l'ID del modello Fable 5 del vostro provider o fissarlo con ANTHROPIC_DEFAULT_FABLE_MODEL.

Se vi connettete direttamente all'API Anthropic e le vostre impostazioni utente contengono claude-fable-5 o claude-fable-5[1m] come modello, ad esempio perché avete selezionato Fable nel selettore /model prima della v2.1.257, Claude Code cambia quel valore salvato nell'alias fable o fable[1m] la prima volta che eseguite v2.1.257 o successiva. La riga del modello di avvio mostra (auto-updated) una volta. Un valore claude-fable-5 nelle impostazioni di progetto, locali o gestite rimane come è.

Le richieste che i classificatori di sicurezza di un modello Fable contrassegnano, più spesso nei domini della sicurezza informatica e della biologia, attivano il fallback automatico del modello.

Per ottenere il massimo da Fable:

• Descrivete il risultato, non i passaggi: dategli il risultato che desiderate e lasciate che pianifichi il percorso. Per mantenerlo orientato verso quel risultato, impostate un obiettivo.
• Dategli problemi ambigui: le investigazioni delle cause radice, il debug dei disservizi e le decisioni architettoniche sono dove l'investigazione e la verifica extra ripagano.
• Saltate i promemoria di verifica: verifica il suo lavoro con meno sollecitazioni, quindi i promemoria per testare o controllare sono solitamente non necessari.
• Dimensionate i compiti più grandi: dategli lavoro che normalmente dividereste in pezzi. Sostiene lunghe sessioni senza perdere il filo.

Sull'API Anthropic, il selettore /model elenca un modello Fable solo dopo che il server lo segnala come disponibile per la vostra organizzazione. Quando digitate /model fable o un ID del modello Fable, Claude Code controlla la disponibilità direttamente con il server, quindi una selezione digitata può avere successo anche quando il selettore non elenca la voce.

Fable e crediti di utilizzo

A seconda del vostro piano e del livello di posto, l'utilizzo di Fable può fatturare ai crediti di utilizzo invece di attingere ai limiti inclusi nel vostro piano. Quando lo fa, il selettore /model mostra "Requires usage credits" sulla riga Fable. Per gestire i crediti di utilizzo, consultare Add usage credits to your subscription.

Nelle sessioni interattive, Claude Code mostra un prompt di consenso prima che una richiesta Fable fatturi i crediti di utilizzo. I membri dei piani Enterprise con fatturazione organizzativa non vedono il prompt. Potete continuare su Fable utilizzando i crediti di utilizzo o passare al vostro modello predefinito. Potete anche chiudere il prompt:

• Nel selettore /model, mantenete il vostro modello attuale.
• A metà sessione, Claude Code continua il turno sul vostro modello predefinito.

Dopo aver scelto di continuare su Fable utilizzando i crediti di utilizzo, Claude Code non mostra più il prompt.

In una sessione con Remote Control connesso, una sessione in background, o una sessione di un compagno di squadra agent team, nessuno potrebbe essere al terminale, quindi Claude Code tiene il prompt di consenso a metà sessione per la scadenza dialogExpiry, cinque minuti per impostazione predefinita. Se nessuno ha risposto entro la scadenza, Claude Code termina il turno senza inviare la richiesta e aggiunge un avviso alla trascrizione, che il client Remote Control mostra anche. La vostra selezione del modello rimane invariata e Claude Code chiede di nuovo il consenso al vostro prossimo messaggio.

Quello che potete fare mentre il prompt è in attesa dipende dalla sessione:

• Con Remote Control connesso o nella sessione di un compagno di squadra, premete un tasto qualsiasi al terminale per annullare la scadenza, e Claude Code attende la vostra risposta.
• In una sessione in background, rispondete prima della scadenza.
• Se inviate un nuovo messaggio dal client remoto prima che qualcuno abbia digitato al terminale, Claude Code termina il turno allo stesso modo e il vostro nuovo messaggio inizia il turno successivo. Dopo che qualcuno digita al terminale, Claude Code continua ad aspettare la risposta e mette in coda il vostro nuovo messaggio dietro di essa.

In modalità non interattiva con il flag -p e attraverso l'Agent SDK, Claude Code non mostra mai il prompt di consenso. Quando una richiesta Fable lì fatturasse ai crediti di utilizzo, Claude Code la fattura senza chiedere.

Impostazione del vostro modello

Potete configurare il vostro modello in diversi modi, elencati in ordine di priorità:

1. Durante la sessione: utilizzare /model <alias|name> per passare immediatamente, o eseguire /model senza argomenti per aprire il selettore. Consultare quando Claude Code vi chiede di confermare il passaggio
2. All'avvio: avviare con claude --model <alias|name>
3. Variabile di ambiente: impostare ANTHROPIC_MODEL=<alias|name>
4. Impostazioni: configurare permanentemente nel vostro file di impostazioni utilizzando il campo model
5. Valore predefinito per le nuove sessioni: impostare ANTHROPIC_DEFAULT_MODEL=<alias|name>

/model salva la vostra scelta come valore predefinito per le nuove sessioni scrivendo il campo model nelle vostre impostazioni utente. Nel selettore:

• Enter: passa il modello e salva come vostro valore predefinito
• s: passa il modello solo per questa sessione

Digitare /model <name> direttamente si comporta come Enter. Se impostate un modello con /model in modalità non interattiva, con il flag -p, la vostra scelta si applica solo alla sessione attuale e non viene salvata come vostro valore predefinito; /model in quella modalità richiede Claude Code v2.1.205 o successiva. Le impostazioni di progetto e gestite mantengono comunque la precedenza e si riapplicano al prossimo avvio. Un modello predefinito dell'organizzazione che il vostro amministratore ha configurato per ignorare la selezione dell'utente si riapplica anche al prossimo avvio.

Nella v2.1.144 attraverso v2.1.152, /model si applicava solo alla sessione attuale e d nel selettore salvava un valore predefinito.

Il 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 suo flag --model piuttosto che passare con /model.

I prezzi nel selettore /model appaiono quando Claude Code parla con l'API Anthropic, direttamente o attraverso un gateway LLM che lo fa da proxy, e il prezzo su una riga è il prezzo del modello che quella riga seleziona. Su provider di terze parti come Amazon Bedrock e sul gateway Claude apps, il vostro provider o gateway determina quello che pagate, quindi le righe del selettore non mostrano alcun prezzo. Il prezzo è solo un'etichetta di visualizzazione; non influisce su quale modello una riga seleziona o cosa il vostro provider fattura. Prima della v2.1.206, Claude Platform on AWS e le sessioni gateway mostravano i prezzi di listino di Anthropic e una riga poteva mostrare il prezzo di un modello diverso da quello che selezionava.

Le 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 attuale. Se il modello ripristinato è stato ritirato o è escluso da availableModels, la sessione ricade nell'ordine di precedenza normale. Questo impedisce che la scelta /model di un'altra sessione cambi il modello al ripristino. Su provider che utilizzano ID di distribuzione specifici del provider piuttosto che ID del modello Anthropic, come Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry, il modello della trascrizione non viene ripristinato affatto e la sessione risolve il suo modello attraverso l'ordine di precedenza normale.

Un modello che scegliete per il nuovo avvio con --model o ANTHROPIC_MODEL mantiene comunque la precedenza sul modello ripristinato. A partire dalla v2.1.195, lo fa anche una variabile della famiglia ANTHROPIC_DEFAULT_OPUS_MODEL. ANTHROPIC_DEFAULT_MODEL può farlo anche, secondo le condizioni elencate nella sua sezione.

Quando il modello attivo all'avvio proviene dalle impostazioni di progetto o gestite piuttosto che dalla vostra selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Eseguire /model per ignorare; l'impostazione di progetto o gestita si riapplica al prossimo avvio. Su piattaforme che incorporano Claude Code e impostano CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, la configurazione del modello dell'host ha la precedenza sulle impostazioni del modello gestite, mentre un allowlist availableModels gestito rimane in vigore a meno che l'host non fornisca il suo; Exceptions to managed settings precedence dice quali chiavi e variabili l'host ignora.

Se voi o la vostra organizzazione configurate PreModelSwitch hooks, vengono eseguiti prima che un passaggio richiesto si applichi e possono bloccarlo o chiedervi di confermare.

Quando Claude Code non riesce a dire quali hook PreModelSwitch i plugin gestiti della vostra organizzazione forniscono, ad esempio perché un plugin gestito non è riuscito a caricarsi, rifiuta il passaggio piuttosto che applicarlo senza controllo, e controlla di nuovo ad ogni nuovo tentativo. Consultare Model switch was blocked by a PreModelSwitch hook per il messaggio e il recupero.

Quando passate i modelli attraverso il metodo setModel() dell'Agent SDK o da un dispositivo connesso attraverso Remote Control, o un'app come l'Desktop app che esegue il CLI di Claude Code passa per voi, Claude Code controlla che la stringa sia una che riconosce prima di salvarla. Questo controllo richiede Claude Code v2.1.200 o successiva. Controllare una scelta Remote Control richiede Claude Code v2.1.260 o successiva sulla vostra macchina. Sull'API Anthropic, Claude Code riconosce:

• un alias del modello
• una voce dal selettore /model
• qualsiasi nome che inizia con claude-
• un valore che avete configurato voi stessi come opzione del modello personalizzato o in modelOverrides

Claude Code rifiuta una stringa non riconosciuta con Model "<name>" is not a recognized model id. e la sessione mantiene il suo modello attuale, invece di salvare la stringa e fallire alla prossima richiesta. Consultare il riferimento dell'errore per i passaggi di recupero.

Il controllo viene eseguito solo sull'API Anthropic. Su Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry, Claude Platform on AWS, e dietro un gateway LLM o un ANTHROPIC_BASE_URL personalizzato, il vostro provider o gateway definisce i nomi dei modelli, quindi Claude Code passa qualsiasi stringa senza controllarla. Il controllo non copre nemmeno il flag --model, la variabile di ambiente ANTHROPIC_MODEL, o l'impostazione model; un valore digitato male lì produce There's an issue with the selected model alla prima richiesta invece. Claude Code può comunque scrivere la riga diagnostica del modello non riconosciuto al momento della richiesta, su ogni provider.

Quando il modello richiesto ha una data di ritiro programmata o viene automaticamente rimappato a una versione più recente, Claude Code mostra un avviso che nomina il modello richiesto. Le sessioni interattive lo mostrano come un avviso di avvio. Dalla v2.1.182, lo stesso avviso viene scritto su stderr in modalità non interattiva quando si utilizza il formato di output di testo predefinito. Il controllo copre anche un model impostato nel frontmatter del subagent. L'avviso stderr è soppresso per --output-format json e stream-json; leggere il modello effettivo dal campo modelUsage del messaggio di risultato invece.

Ad esempio, avviare una sessione su Opus:

claude --model opus

Quindi passare i modelli dalla sessione:

/model sonnet

File di impostazioni di esempio:

{
    "permissions": {
        "allow": ["Bash(npm run lint)"]
    },
    "model": "opus"
}

Impostare un modello predefinito per le nuove sessioni

Impostare ANTHROPIC_DEFAULT_MODEL=<alias|name> per scegliere il modello su cui le vostre sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva.

Claude Code avvia una nuova sessione sul modello della variabile solo quando nessuno di questi seleziona un modello:

• Il flag --model
• ANTHROPIC_MODEL
• Un valore model in qualsiasi file di impostazioni, inclusa la scelta che salvate con /model
• Un modello predefinito dell'organizzazione

Una scelta che salvate con /model ha la precedenza sulla variabile anche nei lanci successivi. Con ANTHROPIC_MODEL impostato invece, Claude Code ritorna al modello della variabile al prossimo lancio, qualunque cosa abbiate salvato con /model.

Claude Code risolve anche l'opzione Default al modello della variabile, a meno che non si applichi un modello predefinito dell'organizzazione. Quando l'opzione Default si risolve al modello della variabile, la riga Default nel selettore /model mostra l'etichetta Set by ANTHROPIC_DEFAULT_MODEL.

Claude Code ignora la variabile in questi casi e l'opzione Default si risolve come se non l'aveste impostata:

• L'avete impostata su default, inherit, opusplan, o haiku
• enforceAvailableModels è attivo
• availableModels o restrizioni del modello dell'organizzazione escludono il modello
• Il modello non è disponibile per il vostro account

Quando una nuova sessione si avvierebbe sul modello della variabile, una sessione che riprendete con claude --resume, --continue, o il selettore /resume si avvia su di esso anche. Claude Code non ripristina il modello salvato nella trascrizione di quella sessione. Altrimenti Claude Code non utilizza la variabile quando riprendete una sessione.

Una nuova sessione si avvia su un modello diverso da quello che avete scelto

Quando scegliete un modello con /model e la vostra prossima sessione si avvia su qualcos'altro, queste sono le cause solite:

• L'avete scelto per una sessione. Premere s nel selettore, avviare con --model, e eseguire /model in modalità non interattiva si applicano tutti alla sessione attuale e lasciano il vostro valore predefinito salvato da solo.
• Qualcosa con priorità più alta imposta il modello. Un valore model nelle impostazioni di progetto o gestite, ANTHROPIC_MODEL nella vostra shell, o un valore predefinito dell'organizzazione che il vostro amministratore ha impostato per ignorare le scelte dell'utente si applica di nuovo ad ogni lancio. La vostra scelta /model è ancora salvata; è superata. Quando le impostazioni di progetto o gestite impostano il modello, l'intestazione di avvio nomina il file.
• Claude Code non ha potuto salvare la vostra scelta. /model scrive model in ~/.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, il modello che avete scelto dura per la sessione e il prossimo lancio legge il valore vecchio. Impostare model nello strumento che genera il file, o rendere il file scrivibile. Consultare A change you made in Claude Code is lost in new sessions.
• Avete ripreso una sessione. Una sessione che riprendete con claude --resume o --continue solitamente mantiene il modello che stava utilizzando piuttosto che il vostro valore predefinito attuale.

Limitare la selezione del modello

Gli amministratori aziendali possono utilizzare availableModels nelle impostazioni gestite o di policy 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. Un prefisso di versione corrisponde anche a ID modello successivi che lo estendono con un altro segmento, quindi claude-fable-5 consente sia Fable 5 che Fable 5.1, mentre claude-fable-5-1 consente solo Fable 5.1.

Sulle piattaforme che incorporano Claude Code e impostano CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, la configurazione del modello dell'host ha la precedenza rispetto alle impostazioni del modello gestito, mentre un allowlist availableModels gestito rimane in vigore a meno che l'host non fornisca il proprio; Eccezioni alla precedenza delle impostazioni gestite indica quali chiavi e variabili l'host sostituisce.

Quando availableModels è impostato, l'allowlist si applica ovunque un utente possa specificare un modello:

• Modello della sessione principale: /model, il flag --model, la variabile di ambiente ANTHROPIC_MODEL, l'impostazione model, ANTHROPIC_DEFAULT_MODEL, e il modello ripristinato quando si riprende una sessione
• Risoluzione alias: 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
• Modalità veloce: /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"
• Modelli di subagent e teammate: il campo model nel frontmatter di subagent, il parametro model dello strumento Agent, i modelli teammate del team di agent, CLAUDE_CODE_SUBAGENT_MODEL, e, nella versione 2.1.197 e precedenti, il selezionatore di modelli nella procedura guidata /agents
• Modelli di skill e comando: il frontmatter model in skills e commands
• Modello Advisor: l'impostazione advisorModel configurata e il flag --advisor
• Modello di background agent: il modello selezionato nel dispatch picker

Sull'API Anthropic e su Claude Platform on AWS, un alias di famiglia di modelli, opus, sonnet, haiku, o fable, si risolve nel suo modello usuale quando l'allowlist consente quel modello. Quando l'allowlist blocca quel modello, Claude Code sostituisce la versione più recente della famiglia che l'allowlist consente e mostra un avviso che nomina sia i modelli richiesti che quelli sostituiti. Con ["sonnet", "claude-opus-4-6"], ad esempio, sia /model opus che --model opus selezionano Claude Opus 4.6, l'Opus più recente consentito. Prima della versione 2.1.205, un alias la cui versione più recente rilasciata era al di fuori dell'elenco veniva rifiutato o sostituito come qualsiasi altra selezione bloccata, anche quando l'elenco consentiva una versione precedente.

La sostituzione ha bisogno di una versione consentita su cui atterrare: quando l'allowlist non consente alcuna versione della famiglia dell'alias, l'alias segue il comportamento di rifiuto e sostituzione di seguito come qualsiasi altro valore bloccato.

Claude Code gestisce qualsiasi altra selezione bloccata in base a dove il modello è stato impostato:

• /model: Claude Code rifiuta il passaggio con un errore

• Flag --model, ANTHROPIC_MODEL, o l'impostazione model: Claude Code sostituisce il valore all'avvio con un avviso che nomina sia i modelli richiesti che quelli sostituiti, e la sessione inizia sul modello predefinito

• ANTHROPIC_DEFAULT_MODEL: Claude Code ignora la variabile

• Override di subagent o teammate: Claude Code esegue il subagent o il teammate su un modello di fallback piuttosto che far fallire la richiesta. Vedere Scegliere un modello per il fallback del subagent e Specificare teammate e modelli per il fallback del teammate.

  Nelle sessioni interattive, Claude Code ti avverte quando sostituisce il modello di un subagent, da questo fallback o dalla sostituzione della versione più recente consentita di cui sopra, nominando i modelli richiesti e sostituiti; non segnala il fallback di un teammate.

  Dove opera la sostituzione della versione più recente consentita di cui sopra, un alias di famiglia bloccato la segue invece. Prima della versione 2.1.222, un alias ricadeva come qualsiasi altro valore bloccato su ogni provider

• Override di skill o comando: Claude Code ignora l'override, incluso un alias di famiglia bloccato, e lo skill o il comando viene eseguito sul modello della sessione. Uno skill o un comando che viene eseguito in un subagent segue il comportamento del subagent di cui sopra

• Impostazione advisorModel: l'advisor è disabilitato per la sessione

• Flag --advisor: Claude Code esce con un errore all'avvio. In una sessione in background, avvia la sessione senza l'advisor invece di uscire

Claude Code nasconde i modelli esclusi dal selezionatore /model. Un ID modello completo nell'elenco che non ha una riga del selezionatore integrata, come una versione precedente che l'elenco fissa, appare nel selezionatore /model come sua propria riga etichettata, a meno che Claude Code non sostituisca le opzioni integrate con una lineup modelPicker. Prima della versione 2.1.199, tale ID era selezionabile solo digitando /model <id>.

I cambiamenti di modello che Claude Code effettua per tuo conto vengono controllati allo stesso modo:

• Catene di modelli di fallback: le voci al di fuori dell'allowlist vengono eliminate
• Aggiornamenti in Plan Mode: sull'API Anthropic e su Claude Platform on AWS, un aggiornamento come opusplan a un modello escluso utilizza la versione più recente consentita della famiglia di aggiornamento. Su provider con ID modello specifici del provider, e quando nessuna versione è consentita, l'aggiornamento viene saltato e la pianificazione continua sul modello della sessione
• Fallback automatico del modello: un fallback il cui target è escluso non viene eseguito, quindi la richiesta contrassegnata termina con un rifiuto
• Classificatore Auto Mode: il valore predefinito Claude Sonnet 5 del classificatore si applica solo quando l'allowlist consente Sonnet 5. Quando è escluso, il classificatore viene eseguito sul modello della sessione, che l'allowlist già governa, o su un modello Opus quando la sessione viene eseguita su un modello Fable. Su provider diversi dall'API Anthropic, quel fallback Opus viene eseguito sul modello Opus predefinito del provider senza consultare l'allowlist. Richiede Claude Code v2.1.210 o successivo
• Modalità veloce: l'abilitazione della modalità veloce viene rifiutata quando il modello su cui la sessione verrebbe eseguita in seguito è al di fuori dell'allowlist

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

Copertura della superficie

Ogni superficie applica l'allowlist che riceve. Quale meccanismo di consegna raggiunge ogni superficie differisce:

• Le sessioni cloud, su Claude Code sul web o nell'app Desktop, vengono eseguite su VM gestite da Anthropic per impostazione predefinita: le impostazioni distribuite al tuo dispositivo non le raggiungono, quindi consegna l'allowlist tramite impostazioni gestite dal server. Le sessioni che la tua organizzazione instrada a un ambiente self-hosted vengono eseguite sul tuo calcolo e leggono anche il file di impostazioni gestite nell'immagine del runner. Come Claude Code combina le fonti gestite indica quando quel file si applica. Un cambio di modello a metà sessione in una sessione cloud viene rifiutato quando il modello richiesto è escluso dall'allowlist. Il rifiuto lato server alla creazione della sessione si applica alle restrizioni del modello dell'organizzazione, non alla chiave di impostazioni availableModels.
• Cowork, la scheda agentic-work nell'app Claude Desktop, esegue le sue sessioni su Claude Code ma, per progettazione, non riceve impostazioni gestite dal server dalla console di amministrazione claude.ai. 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.
• Le sessioni su provider di terze parti come Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry, e Claude Platform on AWS non ricevono impostazioni gestite dal server, quindi consegna l'allowlist tramite file MDM o impostazioni gestite lì.
• La consegna gestita dal server richiede anche che la sessione si autentichi con un login o chiave idonei. Le flotte che generano chiavi solo tramite uno script apiKeyHelper dovrebbero consegnare l'allowlist tramite file MDM o impostazioni gestite.
• La scheda Desktop Code ospita anche sessioni SSH, che leggono il file di impostazioni gestite dall'host remoto su cui vengono eseguite. Vedere Impostazioni gestite desktop.
• I selezionatori di modelli su claude.ai e nell'app Desktop nascondono o disattivano i modelli esclusi dall'allowlist della tua organizzazione. Lo stato del selezionatore è una comodità per gli utenti; l'applicazione avviene nella sessione.

Comportamento del modello predefinito

Da solo, availableModels lascia l'opzione Predefinito sul valore predefinito di runtime del sistema per l'account fino a quando non imposti anche enforceAvailableModels. Se quel valore predefinito è un modello che intendi limitare, imposta anche enforceAvailableModels.

Un 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.

Applicare l'allowlist per il modello Predefinito

Imposta enforceAvailableModels: true insieme a un availableModels non vuoto nelle impostazioni gestite per estendere l'allowlist all'opzione Predefinito. Ciò richiede Claude Code v2.1.175 o successivo.

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

L'opzione Predefinito si risolve nel valore predefinito del tipo di account, o nel modello predefinito dell'organizzazione quando un amministratore ne ha impostato uno. Quando quel modello non è nell'allowlist, l'opzione Predefinito si risolve invece nella prima voce availableModels che nomina un modello consentito e disponibile, e la riga Predefinito del selezionatore /model mostra quel modello. Questo si applica ovunque il valore predefinito sia raggiunto: avvio della sessione, selezione di Predefinito in /model, la parola chiave "default" nelle catene di modelli di fallback, e il fallback utilizzato quando una selezione esclusa viene eliminata.

enforceAvailableModels rimappa l'opzione Predefinito solo quando availableModels è non 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 in un modello consentito e disponibile, l'applicazione viene saltata e Predefinito si risolve nel valore predefinito del tipo di account, con un avviso visibile solo sotto --debug. Mantieni almeno una voce garantita disponibile nell'elenco per evitare questo.

Distribuisci entrambe le chiavi insieme nella fonte gestita con il ranking più alto che consegni. Per impostazione predefinita Claude Code legge solo quella fonte, quindi una coppia posizionata in un file di impostazioni gestite viene ignorata quando la console di amministrazione consegna qualsiasi impostazione; secondo il merge opt-in in come Claude Code combina le fonti gestite, Claude Code ignora comunque una mappa modelOverrides da una fonte classificata al di sotto di quella che imposta availableModels.

Controllare il modello su cui gli utenti vengono eseguiti

L'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 di runtime del sistema indipendentemente da cosa sia impostato model, a meno che enforceAvailableModels non lo reindizzi.

Per controllare completamente l'esperienza del modello, combina queste impostazioni:

• availableModels: limita quali modelli denominati gli utenti possono passare a
• enforceAvailableModels: estende l'allowlist availableModels all'opzione Predefinito, quindi Predefinito non può risolversi in un modello al di fuori dell'elenco
• model: imposta la selezione del modello iniziale quando una sessione inizia
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: controllano a cosa si risolvono gli alias sonnet, opus, haiku, e fable, e quale versione utilizza il valore predefinito del tipo di account

Questo esempio avvia gli utenti su Sonnet 4.5, limita il selezionatore a Sonnet e Haiku, e assicura che Predefinito si risolva in un modello nell'allowlist piuttosto che nel valore predefinito del tier:

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "enforceAvailableModels": true,
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

Senza enforceAvailableModels o il blocco env, un utente che seleziona Predefinito nel selezionatore ottiene il valore predefinito di runtime piuttosto che la versione fissata in model. Le due impostazioni coprono ambiti diversi: enforceAvailableModels fa sì che Predefinito obbedisca all'allowlist, mentre il blocco env fissa quale versione un alias consentito come sonnet si risolve. Usa enforceAvailableModels da solo quando limitare le famiglie di modelli è sufficiente; aggiungi il blocco env quando hai anche bisogno di fissare una versione specifica.

Comportamento di merge

Quando le impostazioni gestite che Claude Code applica definiscono availableModels, solo quell'elenco si applica, a parte una piattaforma host che fornisce il proprio: le voci nelle impostazioni utente, progetto o locale non possono estenderlo, e Claude Code non unisce mai availableModels tra fonti gestite nemmeno; come Claude Code combina le fonti gestite indica quale elenco della fonte si applica. Altrimenti, gli elenchi dalle impostazioni utente, progetto e locale vengono concatenati e deduplicati come altre impostazioni di array. Prima di Claude Code v2.1.175, le voci da ambiti di precedenza inferiore si univano nell'elenco gestito invece di essere sostituite da esso.

All'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 di Sonnet 4.5, non ogni modello Sonnet.

ID modello Mantle

Quando l'endpoint Amazon Bedrock Mantle è abilitato, le voci in availableModels che iniziano con anthropic. vengono aggiunte al selezionatore /model come opzioni personalizzate e instradate all'endpoint Mantle. Questa è un'eccezione alla corrispondenza dell'alias descritta in Fissare modelli per distribuzioni di terze parti. L'impostazione limita comunque il selezionatore 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, elenca i prefissi di versione o gli ID completi che desideri mantenere selezionabili. Vedere Comportamento di merge.

Restrizioni del modello dell'organizzazione

Gli amministratori dell'organizzazione sui piani Claude Enterprise limitano quali modelli i membri possono eseguire disabilitando i singoli modelli nella console di amministrazione claude.ai. 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.

La restrizione si applica quando un membro accede o utilizza la propria chiave API. Le credenziali con ambito organizzativo, come le chiavi di servizio dell'organizzazione, non sono legate a un utente, quindi la restrizione non si applica a loro.

La Claude Console non ha controllo di restrizione del modello. Le organizzazioni senza un piano Claude Enterprise, incluse quelle i cui membri si autenticano tramite l'API Anthropic, limitano i modelli con availableModels nelle impostazioni gestite, aggiungendo enforceAvailableModels per coprire l'opzione Predefinito. Queste impostazioni vengono applicate da Claude Code stesso, non dal server.

Un modello limitato è nascosto dal selezionatore /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.

Un alias di famiglia di modelli come opus si risolve nel suo modello usuale quando l'organizzazione lo consente. Quando l'organizzazione limita quel modello, Claude Code sostituisce la versione più recente della famiglia che l'organizzazione consente, con lo stesso avviso di sostituzione. /model <alias> viene rifiutato solo quando ogni versione della sua famiglia è limitata; un alias impostato con --model, ANTHROPIC_MODEL, o l'impostazione model viene comunque sostituito all'avvio in quel caso. Prima della versione 2.1.205, un alias di famiglia veniva sostituito o rifiutato in base alla sua versione più recente rilasciata da sola, anche quando una versione precedente era consentita.

Le restrizioni si applicano a livello di organizzazione o per ruolo:

• Disabilitare un modello a livello di organizzazione lo rimuove per ogni membro.
• L'accesso a livello di ruolo concede modelli diversi a diversi ruoli personalizzati, e un membro che detiene diversi ruoli può utilizzare qualsiasi modello che uno dei suoi ruoli concede.
• I modelli Haiku sono sempre disponibili e non possono essere disabilitati, quindi ogni membro mantiene almeno un modello utilizzabile.
• Un cambio di accesso ha effetto su nuove richieste entro circa un minuto; il selezionatore /model lo riflette la prossima volta che una sessione inizia.

Entrambe le restrizioni si applicano insieme: un modello è selezionabile solo quando è consentito da availableModels e non limitato dall'organizzazione. Le restrizioni dell'organizzazione raggiungono le sessioni sull'API Anthropic e sui distribuzioni LLM gateway solo; su qualsiasi altro provider, utilizza availableModels invece.

Modello predefinito dell'organizzazione

Gli amministratori dell'organizzazione nei piani Claude Enterprise possono impostare un modello predefinito per i membri di Claude Code dall'admin console di claude.ai, per l'intera organizzazione o per ruolo personalizzato. Quando ne viene impostato uno, l'opzione Predefinito si risolve in quel modello. Richiede Claude Code v2.1.196 o versione successiva.

La riga Predefinito nel selettore /model mostra il nome del modello predefinito dell'organizzazione con l'etichetta Org default. L'etichetta recita Org default indipendentemente dal fatto che l'amministratore abbia impostato il modello predefinito per l'intera organizzazione o per il vostro ruolo. Un modello predefinito del ruolo copre i membri di quel ruolo personalizzato e ha la precedenza sul modello predefinito a livello di organizzazione; quando diversi vostri ruoli impostano modelli predefiniti diversi, si applica il modello più capace.

Il modello predefinito dell'organizzazione è un punto di partenza, non una restrizione. Queste selezioni hanno la precedenza su di esso:

• il flag --model e la variabile di ambiente ANTHROPIC_MODEL
• un valore model nelle impostazioni gestite o fornito tramite --settings
• un valore model nelle vostre impostazioni utente, progetto o locali, incluso un modello che salvate con /model

Gli amministratori possono anche configurare il modello predefinito dell'organizzazione per ignorare la selezione dell'utente. Con l'override attivato, ha la precedenza sul valore model nelle impostazioni utente, progetto e locali, quindi un modello che salvate con /model si applica per la sessione corrente e il modello predefinito dell'organizzazione ritorna al prossimo avvio. Quando la vostra selezione differisce, /model mostra Your organization's default (<model>) applies on restart. Il flag --model, ANTHROPIC_MODEL, le impostazioni gestite e --settings hanno ancora la precedenza anche con l'override attivato. L'override è disponibile per un set limitato di organizzazioni; chiedete al vostro team di account Anthropic sulla disponibilità.

Per limitare quali modelli i membri possono selezionare, utilizzate restrizioni del modello dell'organizzazione o availableModels invece.

Claude Code legge il modello predefinito dell'organizzazione una sola volta all'avvio, quindi un modello predefinito che l'amministratore cambia durante la sessione ha effetto al prossimo avvio.

Quando il modello predefinito dell'organizzazione non ignora la selezione dell'utente, il primo avvio interattivo dopo che l'amministratore lo cambia cancella la chiave model dalle vostre impostazioni utente una sola volta, in modo che il nuovo modello predefinito si applichi. Non cambia nient'altro nel file, e un modello che salvate con /model dopo quel lancio viene mantenuto.

Il modello predefinito dell'organizzazione passa attraverso questi controlli di restrizione prima di essere adottato:

• availableModels da solo non si applica al modello predefinito dell'organizzazione, quindi un modello predefinito dell'organizzazione al di fuori della lista di autorizzazione si applica comunque. Quando enforceAvailableModels è anche impostato, un modello predefinito dell'organizzazione al di fuori della lista di autorizzazione viene rimappato alla prima voce della lista di autorizzazione, come qualsiasi altro Predefinito
• un modello predefinito dell'organizzazione che restrizioni del modello dell'organizzazione negano per il vostro account viene sostituito dal modello più recente consentito nella sua famiglia, o da una famiglia a costo inferiore quando ogni versione di essa è limitata
• un modello predefinito dell'organizzazione che non è disponibile per il vostro account affatto viene saltato, e l'opzione Predefinito si risolve come farebbe senza un modello predefinito dell'organizzazione

A partire dalla v2.1.199, quando il modello predefinito dell'organizzazione è una famiglia di modelli diversa dal modello predefinito usuale del tipo di account vostro, il selettore /model mantiene una riga separata per quella famiglia usuale, in modo che possiate comunque passare ad essa per una sessione. Dalla v2.1.196 alla v2.1.198 quella riga manca dal selettore.

Il modello predefinito dell'organizzazione raggiunge solo le sessioni autenticate con l'API Anthropic. Per impostare un modello predefinito in qualsiasi altro luogo, incluse le distribuzioni LLM gateway, utilizzate la chiave model nelle impostazioni gestite invece.

Limiti di sforzo dell'organizzazione

La vostra organizzazione può limitare il livello di sforzo in due modi. Su un piano Claude Enterprise, gli amministratori dell'organizzazione impostano limiti di sforzo per ruolo, descritti di seguito. Su qualsiasi piano e qualsiasi provider, inclusi Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, l'impostazione gestita maxEffortLevel limita lo sforzo sul client. Quando entrambi si applicano a un modello, si applica il limite inferiore.

Gli amministratori dell'organizzazione nei piani Claude Enterprise possono impostare un livello di sforzo massimo per modello per ogni ruolo personalizzato, insieme alle restrizioni del modello a livello di organizzazione. I livelli superiori al limite non vengono offerti nel selettore /effort, e denominare un livello superiore con --effort o /effort viene eseguito al limite. Nelle sessioni interattive e nelle esecuzioni in testo semplice --print, un avviso nomina i livelli richiesti e applicati; con output json o stream-json o negli agenti in background, il limite si applica silenziosamente. I limiti sono per modello, quindi il cambio di modelli può modificare quali livelli sono disponibili. Quando diversi vostri ruoli concedono lo stesso modello, si applica il limite meno restrittivo. Richiede Claude Code v2.1.195 o successivo.

I limiti di sforzo vengono forniti insieme alle restrizioni del modello dell'organizzazione e raggiungono le stesse sessioni.

Comportamento speciale del modello

Impostazione del modello `default`

Il comportamento di default dipende dal tipo di account:

• Max, Team Premium, Enterprise e Anthropic API: predefinito su Opus 5
• Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform: predefinito su Opus 5
• Pro e Team Standard: predefinito su Sonnet 5
• Microsoft Foundry: predefinito su Sonnet 4.5

Prima della v2.1.219, default si risolveva in Opus 4.8 su Anthropic API, Max, Team Premium e Enterprise con pagamento a consumo da v2.1.154, e su Claude Platform su AWS, Amazon Bedrock e Google Cloud's Agent Platform da v2.1.207. Prima della v2.1.207, default si risolveva in Opus 4.7 su Claude Platform su AWS e in Sonnet 4.5 su Amazon Bedrock e Google Cloud's Agent Platform.

Quando un amministratore ha impostato un modello predefinito dell'organizzazione, default si risolve in quel modello invece del valore predefinito del tipo di account sopra indicato. Richiede Claude Code v2.1.196 o successiva. default può anche risolversi nel modello impostato con ANTHROPIC_DEFAULT_MODEL, secondo le condizioni elencate nella relativa sezione.

Quando le impostazioni gestite applicano l'elenco consentito per il modello predefinito 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 indicato. Quando entrambi si applicano, il valore predefinito dell'organizzazione sostituisce prima il valore predefinito del tipo di account e l'applicazione si applica quindi ad esso: un valore predefinito dell'organizzazione nell'elenco consentito viene mantenuto, mentre uno al di fuori dell'elenco si risolve nel valore predefinito applicato.

I modelli Fable non sono il valore predefinito del tipo di account su nessun piano o provider. Sceglierne uno con /model lo salva come modello selezionato nelle impostazioni utente, in modo che le sessioni successive inizino su di esso. Per il cambio una tantum che Claude Code apporta a una selezione Fable 5 salvata nella v2.1.257, vedere Lavorare con Fable.

Impostazione del modello `opusplan`

L'alias del modello opusplan fornisce un approccio ibrido automatizzato:

• In modalità piano: utilizza opus per il ragionamento complesso e le decisioni architettoniche
• In modalità esecuzione: passa automaticamente a sonnet per la generazione del codice e l'implementazione

Questo abbina il ragionamento di Opus per la pianificazione con l'efficienza di Sonnet per l'esecuzione.

La fase Opus in modalità piano utilizza la stessa finestra di contesto dell'impostazione del modello opus. Sui livelli di abbonamento in cui Opus viene aggiornato automaticamente a 1M di contesto, opusplan riceve l'aggiornamento anche in modalità piano. Per forzare il contesto 1M per entrambe le fasi quando non sei su un livello di aggiornamento automatico, imposta il modello su opusplan[1m], ad esempio con /model opusplan[1m]. Impostarlo con /model richiede Claude Code v2.1.265 o successiva; nelle versioni precedenti, usa il flag --model o l'impostazione model.

Quando availableModels esclude l'Opus più recente ma consente una versione precedente, ad esempio ["sonnet", "claude-opus-4-6"], opusplan utilizza l'Opus più recente consentito per la pianificazione e rimane su Sonnet solo quando ogni Opus è escluso. Una sessione Haiku che normalmente si aggiornerebbe a Sonnet in modalità piano utilizza allo stesso modo il Sonnet più recente consentito e rimane su Haiku solo quando ogni Sonnet è escluso. Prima della v2.1.205, la modalità piano rimase sul modello della sessione ogni volta che la versione più recente della famiglia di aggiornamento era esclusa, anche quando l'elenco consentito ne consentiva una precedente.

La sostituzione di una versione precedente consentita si applica su Anthropic API e Claude Platform su AWS. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Mantle, i cui deployment utilizzano ID modello specifici del provider, la modalità piano rimane sul modello della sessione ogni volta che il modello di aggiornamento è escluso.

Per un approccio ibrido in cui Claude decide a metà attività quando consultare un secondo modello piuttosto che passare al confine del piano, vedere lo strumento advisor.

Catene di modelli di fallback

Quando il modello primario è sovraccarico, non disponibile o restituisce un altro errore del server non ripetibile, Claude Code può passare a un modello di fallback invece di non riuscire nella richiesta. Gli errori di autenticazione, fatturazione, limite di velocità, dimensione della richiesta e trasporto, e un rifiuto dalla verifica della politica della tua organizzazione, non attivano mai un passaggio; questi seguono il loro normale retry e gestione degli errori.

Configura uno o più modelli di fallback e Claude Code li prova in ordine, mostrando un avviso quando passa. Il passaggio dura solo per il turno corrente, quindi il tuo prossimo messaggio prova prima il modello primario di nuovo. Claude Code limita le catene a tre modelli dopo la rimozione dei duplicati e ignora le voci extra.

Imposta una catena per una sessione con il flag --fallback-model, che accetta un elenco separato da virgole:

claude --fallback-model sonnet,haiku

Per mantenere una catena tra le sessioni, imposta fallbackModel in settings come array:

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

Il flag --fallback-model ha la precedenza sull'impostazione fallbackModel. Ogni voce accetta un nome di modello o un alias, e "default" si espande al modello predefinito.

Claude Code non conferma la catena all'avvio e /status non la visualizza. L'avviso mostrato quando si verifica un passaggio è il primo segno visibile che un fallback è configurato.

Quando una richiesta fallisce, Claude Code prova ogni voce in ordine finché una non l'accetta. Una voce che non può essere raggiunta nemmeno, come un modello ritirato bloccato nelle impostazioni, fallisce alla successiva nello stesso modo. Claude Code rimuove due tipi di voce prima di quel percorso:

• Al di fuori dell'elenco consentito: Claude Code elimina qualsiasi voce non consentita da availableModels quando legge la catena.
• Finestra di contesto più piccola durante la compattazione: la catena copre anche la compattazione, ma Claude Code non farà fallback a un modello con una finestra di contesto più piccola di quella del primario, poiché il riassunto lì taglierebbe prima parte della conversazione. Se ogni fallback è più piccolo, la compattazione mostra l'errore originale e puoi riprovare.

Claude Code applica anche la catena ai subagenti. Quando la richiesta di un subagente fallisce, Claude Code prova i tuoi modelli di fallback configurati in ordine, e il subagente continua sul modello che accetta la richiesta. Il modello della tua sessione rimane invariato. Prima della v2.1.247, un fallimento che la catena copriva terminava il subagente.

Fallback automatico del modello

Questa sezione copre il fallback basato sul contenuto dai modelli Fable e Opus 5. Per il fallback basato sulla disponibilità quando un modello è sovraccarico o non disponibile, vedere Catene di modelli di fallback.

I modelli Fable e Opus 5 vengono eseguiti con classificatori di sicurezza, che il più delle volte contrassegnano il contenuto di sicurezza informatica e biologia. Quando un classificatore contrassegna una richiesta e la categoria contrassegnata ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e mostra un avviso nella trascrizione. Per queste due categorie, il modello di fallback dipende da quale modello ha rifiutato:

• Fable 5.1 e Fable 5: le richieste contrassegnate per biologia vengono rieseguite su Opus 5, e le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8.
• Opus 5: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Opus 5 esegue i propri classificatori di biologia senza modello di fallback.

Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code risolve questi target attraverso il tuo deployment, e se imposti ANTHROPIC_DEFAULT_OPUS_MODEL, le categorie che hanno un fallback vengono rieseguite sul modello bloccato; vedere Abilitare il fallback su Bedrock, Agent Platform e Foundry.

Dopo un fallback, la sessione continua sul modello di fallback. Per tornare al tuo modello originale, esegui /model.

Il fallback basato sulla categoria richiede Claude Code v2.1.219 o successiva. Prima della v2.1.219, ogni richiesta Fable 5 contrassegnata veniva rieseguita sul modello Opus predefinito del tuo provider, e Opus 5 non era una fonte di fallback.

Il modello di fallback viene controllato rispetto a availableModels. Quando è bloccato, non si verifica alcun fallback. Il rifiuto viene mostrato come un errore normale e il modello della sessione rimane invariato.

Verificare cosa ha attivato il fallback

Il fallback può attivarsi alla prima richiesta di una sessione, prima di inviare qualcosa di insolito, perché la prima richiesta contiene il contesto dell'area di lavoro come il contenuto di CLAUDE.md e lo stato di git. Un repository che contiene materiale di sicurezza o biologia può attivare il classificatore solo su quel contesto.

Per verificare se le personalizzazioni sono il trigger, avvia una sessione con claude --safe-mode, che disabilita le personalizzazioni come CLAUDE.md, skills, server MCP e hooks. Lo stato di git e i nomi delle directory non sono personalizzazioni e sono ancora inclusi.

Chiedere prima di passare

Per decidere cosa accade ogni volta che una richiesta viene contrassegnata, piuttosto che passare automaticamente, esegui /config e disattiva Cambia modelli quando un messaggio viene contrassegnato, oppure imposta switchModelsOnFlag su false nel tuo file di impostazioni. Una richiesta contrassegnata mette quindi in pausa la sessione con due opzioni: passare al modello di fallback o modificare il prompt e riprovare sul modello corrente.

Alcuni casi si comportano diversamente:

• Quando la categoria contrassegnata non ha un modello di fallback, come un flag di biologia su Opus 5, Claude Code non mostra il prompt e la richiesta termina con il rifiuto.
• Se entrambi i modelli contrassegnano la stessa richiesta, puoi modificare il prompt e riprovare, o avviare una nuova sessione.
• Su sessioni mobili Claude Code sul web, la modifica e il retry non sono supportati. Cambia modelli o continua la sessione da un browser desktop o dall'app desktop.
• In modalità non interattiva e integrazioni SDK che non possono mostrare il prompt, una richiesta contrassegnata termina il turno con un rifiuto.
• Quando il target di fallback è bloccato da availableModels, Claude Code non mostra il prompt. La richiesta contrassegnata termina con il rifiuto, come il fallback automatico quando il target è bloccato.

Abilitare il fallback su Bedrock, Agent Platform e Foundry

Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare entrambi i modelli coinvolti:

• Claude Code deve riconoscere il modello corrente come fonte di fallback. Fable 5.1 e Fable 5 vengono riconosciuti quando l'ID modello contiene claude-fable-5, corrisponde al valore di ANTHROPIC_DEFAULT_FABLE_MODEL o è mappato con modelOverrides. Opus 5 viene riconosciuto dal suo ID modello del provider o da un mapping modelOverrides.
• Il modello di fallback deve risolversi nel tuo deployment. Se imposti ANTHROPIC_DEFAULT_OPUS_MODEL, le richieste contrassegnate vengono rieseguite su quel modello per ogni categoria che ha un fallback; un flag di biologia su Opus 5 termina comunque con un rifiuto. Se non lo imposti, le richieste contrassegnate per sicurezza informatica vengono rieseguite su una voce Opus 4.8 nell'elenco dei modelli del provider, e le richieste contrassegnate per biologia da un modello Fable su una voce Opus 5.

Se uno dei modelli non può essere identificato, Claude Code non passa automaticamente. La richiesta contrassegnata termina con un messaggio di rifiuto e puoi cambiare modelli con /model e riprovare. Impostare ANTHROPIC_DEFAULT_FABLE_MODEL sul tuo ID modello Fable abilita il riconoscimento di Fable. Impostare ANTHROPIC_DEFAULT_OPUS_MODEL su un ID modello Opus fornisce alle categorie contrassegnate un target di fallback, a meno che il pin non nomini un modello al di fuori della famiglia Opus o il modello che ha rifiutato; quindi Claude Code non passa e il rifiuto rimane.

Ricerca sulla sicurezza e carichi di lavoro biologici

I carichi di lavoro in sicurezza offensiva o biologia, inclusi test di penetrazione, esercizi Capture the Flag (CTF) e basi di codice adiacenti alla biologia, attivano il fallback frequentemente, spesso alla prima richiesta. Per un lavoro biologico sostanziale su Fable 5.1 o Fable 5, Claude Code sposta la sessione a Opus 5 alla prima richiesta contrassegnata, e le successive richieste contrassegnate per biologia terminano in rifiuti lì, perché Opus 5 non ha fallback biologico. Su Opus 5, ricevi quei rifiuti dalla prima richiesta contrassegnata.

Questo è il routing previsto per questi domini, non un flag dell'account. Se la tua organizzazione ha bisogno di capacità di classe Fable per questo lavoro, chiedi al tuo team di account Anthropic informazioni sui programmi di accesso affidabile.

Regola il livello di sforzo

I livelli di sforzo controllano il ragionamento adattivo, che consente al modello di decidere se e quanto pensare ad ogni passo in base alla complessità dell'attività. Lo sforzo inferiore è più veloce e più economico per attività semplici e circoscritte, mentre lo sforzo superiore fornisce un ragionamento più profondo per problemi complessi.

I livelli di sforzo disponibili dipendono dal modello. I modelli non elencati qui non supportano lo sforzo:

Se imposti un livello che il modello attivo non supporta, Claude Code fallback al livello supportato più alto pari o inferiore a quello impostato. Ad esempio, xhigh viene eseguito come high su Opus 4.6. La tua organizzazione o le tue stesse impostazioni possono anche limitare i livelli che un modello offre; vedere Limiti di sforzo dell'organizzazione.

Con l'impostazione ultracode disattivata, Claude Code risolve il livello di sforzo della sessione in questo ordine, prendendo il primo che si applica:

1. Una scelta esplicita: la variabile di ambiente CLAUDE_CODE_EFFORT_LEVEL, l'avvio con --effort, o /effort nella sessione (un /effort non interattivo ha effetto più ristretto)
2. Lo sforzo predefinito del modello, su Fable 5, Opus 4.8 o Opus 4.7: dalla prima volta che esegui uno di questi modelli, Claude Code mantiene lo sforzo predefinito di quel modello tra le sessioni, anche quando le tue impostazioni risolvono un livello diverso. Opus 5 e Fable 5.1 non hanno tale mantenimento. Se un livello che imposti termina il mantenimento dipende da come lo imposti, ad esempio:
   • Termina il mantenimento: confermare un livello in modo interattivo, con Enter nel cursore /effort o nel selettore /model o con un livello digitato dopo /effort, o selezionare un livello dal controllo dello sforzo di un dispositivo connesso Remote Control
   • Lascia il mantenimento in vigore per le sessioni successive: --effort all'avvio, o s nel cursore /effort o nel selettore /model
3. Le tue impostazioni: il livello che hai salvato per il modello o una chiave effortLevel, con la precedenza tra loro e tra i file di impostazioni indicata in modelSettings
4. Lo sforzo predefinito del modello: high su ogni modello che supporta lo sforzo, tranne che Opus 4.7 predefinito a xhigh e, quando la tua organizzazione imposta un livello di sforzo predefinito per il suo modello predefinito dell'organizzazione, quel livello è il predefinito quando esegui quel modello

Quando imposti low, medium, high o xhigh in una sessione interattiva sulla tua macchina, scegli quanto dura selezionando come lo confermi:

• Enter nel cursore /effort o nel selettore /model, o un livello digitato dopo /effort: salva il livello come predefinito e applicalo nelle sessioni successive
• s nel cursore /effort o nel selettore /model: applica il livello solo a questa sessione. Richiede Claude Code v2.1.257 o successiva

Claude Code salva il livello per modello, sotto la chiave modelSettings nelle tue impostazioni utente, quindi ogni modello mantiene il suo livello salvato.

max è il livello di ragionamento più profondo. A meno che non lo imposti tramite la variabile di ambiente CLAUDE_CODE_EFFORT_LEVEL, Claude Code applica max solo alla sessione corrente.

# Usa l'alias opus[1m] o sonnet[1m]
/model opus[1m]
/model sonnet[1m]

# O aggiungi [1m] a un nome di modello completo
/model claude-opus-4-8[1m]

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}