Configurazione del modello
Scopri la configurazione del modello Claude Code, inclusi gli alias del modello come opusplan
Modelli disponibili
Per l’impostazione model
in Claude Code, puoi configurare:
- Un alias del modello
- Un nome completo del modello
- Per Bedrock, un ARN
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 modello | Comportamento |
---|---|
default | Impostazione del modello consigliata, a seconda del tipo di account |
sonnet | Utilizza l’ultimo modello Sonnet (attualmente Sonnet 4) per le attività di codifica quotidiane |
opus | Utilizza il modello Opus più capace (attualmente Opus 4.1) per il ragionamento complesso |
haiku | Utilizza il modello Haiku veloce ed efficiente per compiti semplici |
sonnet[1m] | Utilizza Sonnet con una finestra di contesto di 1 milione di token per sessioni lunghe |
opusplan | Modalità 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à:
- Durante la sessione - Usa
/model <alias|nome>
per cambiare modello a metà sessione - All’avvio - Avvia con
claude --model <alias|nome>
- Variabile d’ambiente - Imposta
ANTHROPIC_MODEL=<alias|nome>
- Impostazioni - Configura permanentemente nel tuo file delle impostazioni usando il campo
model
.
Esempio di utilizzo:
Esempio di file delle impostazioni:
Comportamento speciale del modello
Impostazione del modello default
Il comportamento di default
dipende dal tipo di account.
Per alcuni 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 il ragionamento complesso e le decisioni architetturali - In modalità esecuzione - Passa automaticamente a
sonnet
per la generazione del 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.
Nota: I modelli con contesto esteso hanno prezzi diversi.
Controllare il tuo modello attuale
Puoi vedere quale modello stai attualmente utilizzando in diversi modi:
- Nella linea di stato (se configurata)
- In
/status
, che mostra anche le informazioni del tuo account.
Variabili d’ambiente
Puoi utilizzare le seguenti variabili d’ambiente, che devono essere nomi completi del modello, per controllare i nomi del modello a cui gli alias si mappano.
Variabile env | Descrizione |
---|---|
ANTHROPIC_DEFAULT_OPUS_MODEL | Il modello da utilizzare per opus , o per opusplan quando la Modalità Piano è attiva. |
ANTHROPIC_DEFAULT_SONNET_MODEL | Il modello da utilizzare per sonnet , o per opusplan quando la Modalità Piano non è attiva. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Il modello da utilizzare per haiku , o funzionalità in background |
CLAUDE_CODE_SUBAGENT_MODEL | Il modello da utilizzare per i subagenti |
Nota: ANTHROPIC_SMALL_FAST_MODEL
è deprecato in favore di ANTHROPIC_DEFAULT_HAIKU_MODEL
.