Configurazione del modello

​

Modelli disponibili

• Un alias del modello
• Un nome del modello
  • API Anthropic: un nome del modello completo
  • Amazon Bedrock: un ARN del profilo di inferenza
  • Microsoft Foundry: un nome di distribuzione
  • Agent Platform di Google Cloud: un nome di versione

​

Alias dei modelli

​

Lavorare con Fable

• Fable 5.1: eseguire /model fable, o avviare con claude --model fable. Nelle sessioni di gateway delle app Claude, dove l’alias si risolve in Fable 5, eseguire invece /model claude-fable-5-1.
• 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.

• Descrivere il risultato, non i passaggi: fornitegli il risultato che desiderate e lasciate che pianifichi il percorso. Per mantenerlo orientato verso quel risultato, impostare un obiettivo.
• Fornitegli problemi ambigui: le indagini sulla causa principale, il debug dei disservizi e le decisioni architettoniche sono dove l’investigazione e la verifica aggiuntive 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: fornitegli il lavoro che normalmente dividereste in pezzi. Sostiene lunghe sessioni senza perdere il filo.

​

Fable e crediti di utilizzo

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

• Con Remote Control connesso o in una sessione di un compagno, 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.

​

Impostazione del vostro modello

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>

• Enter: passa il modello e salva come vostro valore predefinito
• s: passa il modello solo per questa sessione e lascia il vostro valore predefinito invariato. Per utilizzare un tasto diverso, riassegnare modelPicker:thisSessionOnly

• Quando il vostro amministratore non ha impostato un modello predefinito dell’organizzazione, l’opzione Predefinito può risolversi al modello registrato, e quando lo fa, la riga Predefinito del selettore mostra il nome di quel modello.
• Se le restrizioni del modello escludono il modello registrato o non è disponibile per il vostro account, e il vostro amministratore non ha impostato un modello predefinito dell’organizzazione, l’opzione Predefinito si risolve come se nulla fosse stato registrato.
• Se scegliete Predefinito o opusplan in /model, la scelta registrata non cambia.

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

claude --model opus

/model sonnet

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

​

Impostare un modello predefinito per le nuove sessioni

• 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

• L’avete impostata a default, inherit, opusplan, o haiku
• enforceAvailableModels è attivo
• Le restrizioni del modello della vostra organizzazione escludono il modello
• Il modello non è disponibile per il vostro account

​

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

• 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 corrente 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 modello predefinito dell’organizzazione che il vostro amministratore ha impostato per ignorare le scelte dell’utente si applica di nuovo ad ogni avvio. 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 poteva salvare la vostra scelta. /model scrive model a ~/.claude/settings.json. Se non potete scrivere su 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 avvio legge il valore vecchio. Impostare model nello strumento che genera il file, o rendere il file scrivibile. Consultare Una modifica che avete fatto in Claude Code viene persa nelle nuove sessioni.
• 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

• 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

• /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

• 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

• Le sessioni cloud su Claude Code sul web, incluse quelle che avvii dall’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. Quando l’elenco availableModels nelle tue impostazioni gestite dal server è non vuoto, il server rifiuta la richiesta di un utente di avviare una sessione cloud su un modello che l’elenco esclude.
• 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; non applica l’allowlist.

​

Comportamento del modello predefinito

​

Applicare l’allowlist per il modello Predefinito

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

​

Controllare il modello su cui gli utenti vengono eseguiti

• 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
• deniedModels e availableModelsMatch: blocca versioni specifiche che una voce availableModels altrimenti consentirebbe
• 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

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

​

Comportamento di merge

​

ID modello Mantle

​

Bloccare modelli o versioni specifici

• deniedModels: elenca i modelli da bloccare. Un modello elencato viene bloccato anche quando availableModels lo consente, e la chiave funziona anche senza alcun allowlist. Un rilascio che nessuna voce blocca rimane consentito
• availableModelsMatch: impostalo su "exact" in modo che ogni ID modello in availableModels consenta solo la versione che nomina. Una versione più recente di un ID modello elencato rimane quindi bloccata fino a quando non la aggiungi all’elenco

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

1. La versione più recente consentita della stessa famiglia
2. Il modello più recente consentito di ogni famiglia di costo inferiore a turno: Sonnet, poi Haiku
3. La prima voce availableModels che nomina un modello consentito

​

Restrizioni del modello dell’organizzazione

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

​

Modello predefinito dell’organizzazione

• 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

• Con la corrispondenza del prefisso predefinito, 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 pure
• 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
• per un modello predefinito dell’organizzazione che deniedModels o un elenco "exact" blocca, vedere Bloccare modelli o versioni specifiche
• 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

​

Limiti di sforzo dell’organizzazione

​

Comportamento speciale del modello

​

Impostazione del modello default

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

​

Impostazione del modello opusplan

• In Plan Mode: 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

​

Catene di modelli di fallback

claude --fallback-model sonnet,haiku

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

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

​

Fallback automatico del modello

• Fable 5.1, Fable 5 e Opus 5.5: le richieste contrassegnate per biologia vengono rieseguite su Opus 5, e le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8.
• Sonnet 5.5: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Sonnet 5. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Sonnet 5.5 non ha un modello di fallback biologico.
• 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.

​

Verificare cosa ha attivato il fallback

​

Chiedere prima di passare

• Quando la categoria contrassegnata non ha un modello di fallback, come un flag di biologia su Opus 5 o Sonnet 5.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

• 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.5, Sonnet 5.5 e Opus 5 vengono riconosciuti dal loro ID modello del provider o da un mapping modelOverrides.
• Un target Opus deve risolversi nel tuo deployment, indipendentemente da quale modello ha rifiutato: imposta ANTHROPIC_DEFAULT_OPUS_MODEL, o mantieni una voce Opus 4.8 nell’elenco dei modelli del provider. Senza uno, il fallback rimane disattivato per ogni modello sorgente, incluso Sonnet 5.5, e le richieste contrassegnate terminano con un rifiuto.
• Il modello di fallback della categoria contrassegnata deve risolversi nel tuo deployment. Da un modello Fable, Opus 5.5 o Opus 5, 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 sulla voce Opus 4.8, e le richieste contrassegnate per biologia da un modello Fable o Opus 5.5 su una voce Opus 5. Da Sonnet 5.5, le richieste contrassegnate per sicurezza informatica vengono rieseguite sul modello che imposti in ANTHROPIC_DEFAULT_SONNET_MODEL, o su una voce Sonnet 5 nell’elenco dei modelli del provider se non lo imposti.

• Modelli Fable: imposta ANTHROPIC_DEFAULT_FABLE_MODEL sul tuo ID modello Fable in modo che Claude Code lo riconosca come fonte di fallback.
• Ogni modello sorgente: imposta ANTHROPIC_DEFAULT_OPUS_MODEL su un ID modello Opus per attivare il fallback e fornire alle categorie contrassegnate un target. Un pin che nomina un modello al di fuori della famiglia Opus, o il modello che ha rifiutato, lascia il rifiuto in piedi.
• Sonnet 5.5: oltre al pin Opus, imposta ANTHROPIC_DEFAULT_SONNET_MODEL o mantieni una voce Sonnet 5 nell’elenco dei modelli del provider per fornire il modello su cui la richiesta viene rieseguita. Un pin Sonnet che nomina un modello al di fuori della famiglia Sonnet, o Sonnet 5.5 stesso, lascia il rifiuto in piedi.

​

Ricerca sulla sicurezza e carichi di lavoro biologici

​

Regola il livello di sforzo

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. 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
3. Lo sforzo predefinito del modello: high su ogni modello che supporta lo sforzo, tranne che Opus 5.5 e Sonnet 5.5 predefinito a medium, 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

• 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

• /effort: esegui /effort ultracode per attivarlo per la sessione corrente o /effort ultracode off per disattivarlo. Nel cursore /effort, premi Tab per capovolgere l’opzione Ultracode, quindi Enter per applicarla
• Flag --effort: avvia con claude --effort ultracode, che avvia la sessione a sforzo xhigh con ultracode attivato
• Impostazione ultracode: imposta "ultracode": true in un file di impostazioni, con --settings, o in una richiesta di controllo Agent SDK. Una richiesta applyFlagSettings() accetta anche effortLevel: "ultracode", che lo attiva e imposta il livello di sforzo a xhigh

• I flussi di lavoro sono disattivati
• Il modello non supporta lo sforzo xhigh

​

Scegli un livello di sforzo

​

Usa ultrathink per il ragionamento profondo una tantum

​

Imposta il livello di sforzo

• /effort: esegui /effort senza argomenti per aprire un cursore interattivo, /effort seguito da un nome di livello per impostarlo direttamente, o /effort auto per cancellare il tuo livello salvato per il modello attivo. Puoi eseguirlo mentre Claude sta lavorando, e una volta confermato l’avviso della cache, se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla richiesta successiva nel turno
• In /model: usa i tasti freccia sinistra/destra per regolare il cursore dello sforzo quando selezioni un modello
• Flag --effort: passa un nome di livello per impostarlo per una singola sessione quando avvii Claude Code
• Variabile di ambiente: imposta CLAUDE_CODE_EFFORT_LEVEL su un nome di livello o auto
• Impostazioni: imposta un livello per modello in modelSettings, o imposta effortLevel su low, medium, high o xhigh come predefinito per i modelli senza uno. max non è accettato in nessuna delle due chiavi, e ultracode ha la sua propria chiave ultracode
• Da un dispositivo connesso: in una sessione Remote Control, scegli un livello dal controllo dello sforzo sul tuo telefono o nel tuo browser. Il livello si applica solo alla sessione corrente. Richiede Claude Code v2.1.234 o successiva
• Frontmatter di skill e subagente: imposta effort in un file markdown skill o subagente per sostituire il livello di sforzo quando quella skill o subagente viene eseguito

​

Ragionamento adattivo e budget di pensiero fissi

​

Extended thinking

​

Extended context

• Con la compattazione automatica attivata, le sessioni si compattano al confine 200K attraverso la compattazione automatica. Impostare la finestra di compattazione automatica sopra 200K non solleva il mantenimento, perché Claude Code limita quella finestra alla finestra di contesto del modello.
• Con la compattazione automatica disattivata, le sessioni si fermano al confine 200K con l’errore di limite di contesto invece di compattarsi.

# 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]

​

Finestra di contesto di Sonnet 5.5 e Sonnet 5

• Gateway LLM: quando ANTHROPIC_BASE_URL punta a un gateway, Claude Code non può verificare il supporto 1M. Per usare la finestra completa, seleziona Sonnet 5.5 (1M context) nel selettore di modelli, che mappa a sonnet[1m], o esegui /model claude-sonnet-5[1m] per Sonnet 5.
• CLAUDE_CODE_DISABLE_1M_CONTEXT=1: mantiene le sessioni su ogni modello con una finestra 1M nativa a una finestra 200K; vedere Extended context per come il mantenimento viene applicato. Utile per i deployment che devono limitare il contesto.

​

Finestra di contesto e auto-compattazione

​

Impostare la finestra auto-compact

• Per questa sessione e quelle successive: eseguire /autocompact con un valore, come /autocompact 500k. Claude Code lo salva nelle impostazioni utente come autoCompactWindow e lo applica alla sessione corrente; se un ambito di impostazioni con priorità più alta, come le impostazioni gestite, imposta la chiave, il comando salva il valore ma la sessione mantiene la finestra di tale ambito, e il comando lo comunica. Eseguire /autocompact auto per tornare alla finestra ottimizzata per il modello.
• Per un singolo avvio: passare --autocompact all’avvio di Claude Code. Il flag sostituisce l’impostazione salvata per tale avvio senza modificarla, e claude --autocompact auto esegue la sessione alla finestra ottimizzata anche se l’impostazione salvata ha un valore. A differenza di /autocompact, il flag non è prevenuto da un ambito di impostazioni con priorità più alta, come le impostazioni gestite.
• In script e ambienti cloud: impostare CLAUDE_CODE_AUTO_COMPACT_WINDOW. Mentre è impostato, ha precedenza sul comando, sul flag e sull’impostazione, e /autocompact segnala l’override invece di modificare la finestra.

• Un conteggio di token semplice, come 200000
• Un suffisso k o M, come 500k o 1M
• Un numero semplice da 100 a 1000, che significa migliaia, quindi 200 imposta 200.000

​

Soglie auto-compact predefinite

• Le sessioni cloud si compattano mentre la conversazione si avvicina al limite del modello
• Sonnet 4.6 e Opus 4.6 senza contesto esteso si compattano al limite di 200K, così come Opus 4.8 e versioni successive quando vengono eseguiti con una finestra di contesto di 200K, come su Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry
• Quando si imposta CLAUDE_CODE_DISABLE_1M_CONTEXT=1, i modelli con una finestra nativa di 1M, come Sonnet 5 e i modelli Fable, si compattano al limite di 200K
• I modelli in esecuzione con una finestra nativa di 1M, come Sonnet 5, i modelli Fable e Opus 4.7 e versioni successive su Anthropic API, si compattano prima che la finestra si riempia, a circa 967K token per impostazione predefinita. Su Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry, Pin models for third-party deployments indica quali modelli vengono eseguiti con quella finestra; per le configurazioni che assegnano a Sonnet 5.5 e Sonnet 5 200K, vedere Sonnet 5.5 and Sonnet 5 context window
• Le sessioni su un ID modello che Claude Code non riconosce, come un alias LLM gateway, si compattano alla finestra di contesto che Claude Code assume per l’ID; vedere Correct the window for a gateway or custom model ID

​

Correggere la finestra per un gateway o un ID modello personalizzato

• Se Claude Code non può risolvere un provider o un’ortografia personalizzata a un modello che riconosce e l’ID non contiene [1m], la variabile si applica direttamente e la compattazione proattiva continua alla finestra dichiarata.
• Se Claude Code non può risolvere un provider o un’ortografia personalizzata a un modello che riconosce e l’ID contiene [1m], in qualsiasi maiuscola/minuscola, Claude Code assume una finestra di 1M per esso e la variabile non si applica da sola. Per correggere la finestra mantenendo la compattazione proattiva, impostare anche CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Con quella variabile impostata, Claude Code dimensiona l’ID come la stessa ortografia senza [1m], quindi CLAUDE_CODE_MAX_CONTEXT_TOKENS si applica quando si applicherebbe a tale ortografia senza tag. Con una finestra dichiarata superiore a 200K, Claude Code mostra quindi un avviso di avvio che il limite di 200K non è applicato. L’avviso è previsto in questa configurazione.
• Se l’ID si risolve a un modello che Claude Code riconosce, o l’ID è un nome claude- semplice senza suffisso per Claude Code da rimuovere, in qualsiasi maiuscola/minuscola, la variabile ha effetto solo quando si imposta anche DISABLE_COMPACT, che disabilita tutta la compattazione. Ad esempio, un ID che contiene un nome di modello Claude che Claude Code conosce, come anthropic/claude-opus-4-8, us.anthropic.claude-…-v1:0, o il datato claude-sonnet-4-5@20250929, si risolve a quel modello. Questo include gli ID che contengono anche [1m]: Claude Code risolve claude-opus-4-8[1m] a Opus 4.8 anche con CLAUDE_CODE_DISABLE_1M_CONTEXT impostato.

​

Verifica del modello corrente

• Nella riga di stato, se ne hai una configurata
• In /status, che visualizza anche le informazioni del tuo account

​

Aggiungere un’opzione di modello personalizzato

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

• Se omettete il nome, la voce mostra il nome del modello quando Claude Code riconosce l’ID, e l’ID del modello altrimenti.
• Se omettete la descrizione, Claude Code utilizza Custom model (<model-id>).

​

Variabili di ambiente

​

Fissare i modelli per distribuzioni di terze parti

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

• Claude Code rimuove il suffisso prima di inviare l’ID del modello al provider.
• Aggiungere [1m] solo quando il modello sottostante supporta il contesto 1M.
• Il suffisso viene letto per variabile, non per modello. Su Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft 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. Sonnet 5 viene sempre eseguito con la finestra 1M su questi provider e non ha mai bisogno del suffisso.

​

Personalizzare la visualizzazione e le capacità del modello fissato

• Riconosciuto: l’ID esatto di un modello che Claude Code conosce, come il suo ID API Anthropic o la forma del provider o del gateway, con o senza il suffisso [1m]. Fissare us.anthropic.claude-sonnet-4-5-20250929-v1:0 e la riga legge Sonnet 4.5.
• Non riconosciuto: qualsiasi altro ID, come un ARN di profilo di inferenza dell’applicazione o una versione del modello che Claude Code non conosce, a meno che una voce modelOverrides non mappi un modello a quella stringa esatta. Su Microsoft Foundry, i nomi di distribuzione sono definiti dall’utente, quindi Claude Code non riconosce mai un ID fissato lì, mappato o meno, e la riga mostra il nome di distribuzione per impostazione predefinita.

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'

​

Eseguire l’override degli ID di modello per versione

{
  "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"
  }
}

​

Configurazione della prompt caching

​

Cronologia delle versioni