​
Modelli disponibili

Per l’impostazione model in Claude Code, puoi configurare:

​
Alias del modello

Gli alias del modello forniscono un modo conveniente per selezionare le impostazioni del modello senza ricordare i numeri di versione esatti:
Alias del modelloComportamento
defaultImpostazione del modello consigliata, a seconda del tipo di account
sonnetUtilizza l’ultimo modello Sonnet (attualmente Sonnet 4.5) per le attività di codifica quotidiane
opusUtilizza il modello Opus (attualmente Opus 4.1) per attività di ragionamento complesso specializzate
haikuUtilizza il modello Haiku veloce ed efficiente per attività semplici
sonnet[1m]Utilizza Sonnet con una finestra di contesto di 1 milione di token per sessioni lunghe
opusplanModalità speciale che utilizza opus durante la modalità piano, poi passa a sonnet per l’esecuzione

​
Impostare il tuo modello

Puoi configurare il tuo modello in diversi modi, elencati in ordine di priorità:
  1. Durante la sessione - Usa /model <alias|nome> per cambiare modello a metà sessione
  2. All’avvio - Avvia con claude --model <alias|nome>
  3. Variabile d’ambiente - Imposta ANTHROPIC_MODEL=<alias|nome>
  4. Impostazioni - Configura permanentemente nel tuo file delle impostazioni usando il campo model.
Esempio di utilizzo: 
# Inizia con Opus
claude --model opus

# Passa a Sonnet durante la sessione
/model sonnet
Esempio di file delle impostazioni: 
{
    "permissions": {
        ...
    },
    "model": "opus"
}

​
Comportamento speciale del modello

​
Impostazione del modello default

Il comportamento di default dipende dal tipo di account. Per certi utenti Max, Claude Code tornerà automaticamente a Sonnet se raggiungi una soglia di utilizzo con Opus.

​
Impostazione del modello opusplan

L’alias del modello opusplan fornisce un approccio ibrido automatizzato:
  • In modalità piano - Utilizza opus per ragionamento complesso e decisioni architetturali
  • In modalità esecuzione - Passa automaticamente a sonnet per la generazione di codice e l’implementazione
Questo ti dà il meglio di entrambi i mondi: il ragionamento superiore di Opus per la pianificazione, e l’efficienza di Sonnet per l’esecuzione.

​
Contesto esteso con [1m]

Per gli utenti Console/API, il suffisso [1m] può essere aggiunto ai nomi completi del modello per abilitare una finestra di contesto di 1 milione di token. 
# Esempio di utilizzo di un nome completo del modello con il suffisso [1m]
/model anthropic.claude-sonnet-4-5-20250929-v1:0[1m]
Nota: I modelli con contesto esteso hanno prezzi diversi.

​
Controllare il tuo modello attuale

Puoi vedere quale modello stai attualmente utilizzando in diversi modi:
  1. Nella linea di stato (se configurata)
  2. In /status, che mostra anche le informazioni del tuo account.

​
Variabili d’ambiente

Puoi utilizzare le seguenti variabili d’ambiente, che devono essere nomi di modello completi, per controllare i nomi dei modelli a cui gli alias si mappano.
Variabile envDescrizione
ANTHROPIC_DEFAULT_OPUS_MODELIl modello da utilizzare per opus, o per opusplan quando la Modalità Piano è attiva.
ANTHROPIC_DEFAULT_SONNET_MODELIl modello da utilizzare per sonnet, o per opusplan quando la Modalità Piano non è attiva.
ANTHROPIC_DEFAULT_HAIKU_MODELIl modello da utilizzare per haiku, o funzionalità in background
CLAUDE_CODE_SUBAGENT_MODELIl modello da utilizzare per i subagenti
Nota: ANTHROPIC_SMALL_FAST_MODEL è deprecato in favore di ANTHROPIC_DEFAULT_HAIKU_MODEL.

​
Configurazione della cache dei prompt

Claude Code utilizza automaticamente la cache dei prompt per ottimizzare le prestazioni e ridurre i costi. Puoi disabilitare la cache dei prompt globalmente o per livelli di modello specifici:
Variabile envDescrizione
DISABLE_PROMPT_CACHINGImposta a 1 per disabilitare la cache dei prompt per tutti i modelli (ha precedenza sulle impostazioni per modello)
DISABLE_PROMPT_CACHING_HAIKUImposta a 1 per disabilitare la cache dei prompt solo per i modelli Haiku
DISABLE_PROMPT_CACHING_SONNETImposta a 1 per disabilitare la cache dei prompt solo per i modelli Sonnet
DISABLE_PROMPT_CACHING_OPUSImposta a 1 per disabilitare la cache dei prompt solo per i modelli Opus
Queste variabili d’ambiente ti danno un controllo granulare sul comportamento della cache dei prompt. L’impostazione globale DISABLE_PROMPT_CACHING ha precedenza sulle impostazioni specifiche del modello, permettendoti di disabilitare rapidamente tutta la cache quando necessario. Le impostazioni per modello sono utili per il controllo selettivo, come quando si esegue il debug di modelli specifici o si lavora con fornitori cloud che potrebbero avere implementazioni di cache diverse.