Source: https://aiprimetech.io/it/blog/claude-code-default-model-and-model-switch-hooks/ Ago 29, 2026 · 8 min · Guide per sviluppatori # Come cambiare il modello predefinito in Claude Code (e i nuovi hook per il cambio di modello in 2.1.251) A Di [AI Prime Tech](https://aiprimetech.io/it/) · Con l'assistenza dell'AI Cambiare il modello predefinito di Claude Code inizia dal capire se una selezione debba essere mantenuta nelle nuove sessioni o applicarsi solo a quella corrente. Questa guida illustra /model la persistenza, i dettagli di configurazione che rimangono non verificati alla data limite di pubblicazione e gli hook di cambio modello e la diagnostica della cache introdotti in Claude Code 2.1.251. ## Imposta il modello predefinito di Claude Code con /model La distinzione fondamentale è tra salvare una preferenza e cambiare temporaneamente modello. Ad agosto 29, 2026, /model supportava già entrambi i flussi di lavoro. La versione 2.1.153 ha modificato /model in modo che una selezione venga salvata come predefinita per le nuove sessioni. Questo comportamento precede 2.1.251: la versione di agosto ha introdotto gli hook di cambio modello, non la possibilità di ricordare una selezione interattiva del modello. La [registro delle modifiche riferito a una versione specifica](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.251/CHANGELOG.md) è il riferimento storico per questa distinzione. Documenta sia il comportamento di selezione persistente sia l'azione del selettore per un cambio temporaneo. ### Salva una preferenza per le sessioni future Usa il selettore dei modelli: ``` /model ``` Seleziona il modello che vuoi usare come predefinito. Il comportamento di persistenza introdotto in 2.1.153 fa sì che questa selezione venga salvata per le nuove sessioni. Questa è la risposta più chiara, supportata dalle fonti storiche, alla domanda «Come faccio a mantenere il mio modello preferito?». Non richiede di trattare una funzionalità introdotta in una versione precedente come una nuova capacità di 2.1.251. ### Cambia modello solo per la sessione corrente Premi s nel selettore per cambiare modello solo per la sessione corrente. Usa questa azione quando la selezione deve essere temporanea. La distinzione è importante quando si seguono istruzioni meno recenti o si mantengono scorciatoie da tastiera personalizzate. La precedente azione del selettore d è diventata s, e la scorciatoia da tastiera personalizzata associata è passata da modelPicker:setAsDefault a modelPicker:thisSessionOnly. Per un contesto più ampio sulla selezione dei modelli, consulta la [guida ai modelli di Claude Code](/it/claude-code/models/). Il punto specifico di questa versione è semplice: una selezione ordinaria salva un modello predefinito, mentre l'azione limitata alla sessione consente un cambio temporaneo. ## File di configurazione, ANTHROPIC_MODEL e opzioni di avvio che prevalgono sulle impostazioni La configurazione del modello può avvenire anche tramite file delle impostazioni, variabili d'ambiente e flag di avvio. Tuttavia, la ricerca fornita evidenzia un limite storico: la relativa documentazione esatta e l'ordine di precedenza non sono stati verificati in modo indipendente in un'istantanea disponibile entro agosto 29, 2026. La [documentazione sulla configurazione del modello](https://code.claude.com/docs/en/model-config) e [documentazione sulle impostazioni](https://code.claude.com/docs/en/settings) descrivono queste modalità, ma tali pagine contengono aggiornamenti successivi. Non possono comprovare ogni dettaglio del comportamento alla data limite di questo articolo. La tabella seguente distingue le opzioni documentate da ciò che è supportato dalle fonti datate. | Modalità di configurazione | Dettaglio nella ricerca fornita | Stato della verifica storica per questo articolo | Interattiva /model selezione | Salva un modello predefinito per le nuove sessioni | Confermato nel registro delle modifiche precedente alla data limite | Azione del selettore s | Cambia modello solo per la sessione corrente | Confermato nel registro delle modifiche precedente alla data limite | Del file delle impostazioni model chiave | Un'opzione di configurazione persistente | Documentazione esatta precedente alla data limite non verificata | ANTHROPIC_MODEL | Un'opzione di selezione del modello basata sull'ambiente | Documentazione esatta precedente alla data limite non verificata | Di avvio --model flag | Una selezione del modello all'avvio | Ordine di precedenza esatto precedente alla data limite non verificato ### Quale impostazione prevale? La ricerca fornita riporta una documentazione che assegna al flag di avvio una precedenza superiore a ANTHROPIC_MODEL, e alla variabile d'ambiente una precedenza superiore al valore model del file delle impostazioni. Indica inoltre esplicitamente che tale ordine non è verificato per la data limite di pubblicazione. Di conseguenza, questo articolo non presenta tale ordine di precedenza come un fatto accertato ad agosto 29. La modifica alla persistenza di /model ha un riferimento datato nel registro delle modifiche; la gerarchia precisa della configurazione no. ### E un modello predefinito per un singolo progetto? La ricerca identifica nella documentazione file delle impostazioni dell'utente, del progetto e personali del progetto. Non ne accerta l'esatta formulazione storica né il comportamento delle impostazioni del modello tramite un'istantanea precedente alla data limite. Questo consente una risposta più circoscritta rispetto a un tutorial sulla configurazione del progetto: /model la persistenza è confermata, mentre le istruzioni sui file specifici del progetto richiedono una verifica storica. Il [riferimento della CLI](/it/claude-code/cli/) offre un utile complemento per la configurazione da riga di comando, ma non elimina i limiti delle fonti su cui si basa questo articolo. ## Cosa aggiungono gli hook di cambio modello in 2.1.251 Claude Code 2.1.251 è stato rilasciato ad agosto 28, 2026. Le sue [note di rilascio ufficiali](https://github.com/anthropics/claude-code/releases/tag/v2.1.251) introducono due hook con questi nomi esatti: - PreModelSwitch - PostModelSwitch La versione ne descrive le capacità come bloccare, confermare o annotare un cambio di modello. Questi hook estendono il flusso di selezione del modello con controlli sul cambio. Questa è la nuova funzionalità da distinguere dalla persistenza del modello predefinito. Il salvataggio di una preferenza del modello era già disponibile; i nuovi eventi hook aggiungono modi per intervenire in un cambio di modello. ### Un hook può bloccare o richiedere una conferma? Sì, il blocco e la conferma sono capacità esplicitamente citate nell'annuncio della versione. È elencata anche l'annotazione. L'annuncio non fornisce gli schemi completi di input e output, le regole di corrispondenza o i JSON decisionali. Consente quindi di descrivere queste capacità, ma non di pubblicare una configurazione eseguibile basata soltanto sull'annuncio. Lo stesso limite si applica a dettagli come i campi del payload che identificano il vecchio e il nuovo modello o la struttura richiesta per una risposta di conferma. Questi dettagli sono assenti dalle fonti fornite precedenti alla data limite. ### Cosa serve prima di implementarne uno? Un'implementazione funzionante richiede più dei nomi degli eventi: servono il formato di configurazione applicabile e il contratto di risposta supportato. Le note di rilascio non forniscono questi elementi. Usa la [guida agli hook di Claude Code](/it/claude-code/hooks/) per un contesto più ampio sugli hook. Per questa versione, mantieni preciso l'ambito confermato: PreModelSwitch e PostModelSwitch esistono e l'annuncio descrive capacità di blocco, conferma e annotazione. ## Esamina il comportamento della cache dei prompt e i costi di ripresa La versione 2.1.251 aggiunge anche strumenti diagnostici che aiutano a spiegare il comportamento della cache dei prompt. Queste aggiunte mostrano l'attività della cache e il costo stimato di ricostruzione; la versione non annuncia nuovi prezzi dei token né limiti numerici della cache. ### Leggi la nuova riga della cache in /cost Il comando esistente acquisisce una riga sulla cache dei prompt per ciascuna sessione: ``` /cost ``` Questa riga riporta quattro elementi: - Percentuale di riscontri nella cache - Mancati riscontri - Token reinseriti nella cache - Stato caldo o freddo Nel loro insieme, questi elementi forniscono una visione della cache più dettagliata rispetto al solo costo. Distinguono i riscontri nella cache dai mancati riscontri e mostrano quanti token sono stati reinseriti nella cache. Anche gli script della riga di stato acquisiscono un corrispondente oggetto prompt_cache . Questo rende la diagnostica della cache disponibile nell'interfaccia della riga di stato oltre che tramite /cost. L'annuncio non fornisce uno schema completo per tale oggetto. Considera prompt_cache come un nome di oggetto confermato, senza presumere campi aggiuntivi oltre agli elementi diagnostici descritti nella versione. ### Esaminare le informazioni sulla ripresa tramite SessionStart Alla ripresa, SessionStart gli hook ora ricevono informazioni sul tempo trascorso dall'ultima attività della sessione e sul costo stimato per ricostruire la cache del prompt. Questo è distinto dalla visualizzazione di /cost : l'aggiunta relativa alla ripresa fornisce informazioni agli hook, mentre il comando riporta la diagnostica della cache per ciascuna sessione. Entrambe le aggiunte riguardano la visibilità della cache, ma espongono tali informazioni tramite interfacce diverse. Le note di rilascio non indicano i nomi esatti delle chiavi del payload per il tempo trascorso dall'ultima attività della sessione o per il costo stimato di ricostruzione. Un esempio di hook che presupponesse tali nomi andrebbe oltre le evidenze disponibili. ## Sono cambiati anche altri valori predefiniti dei modelli e strumenti diagnostici Diverse modifiche correlate in 2.1.251 sono rilevanti per interpretare il concetto di «modello predefinito». Riguardano i sottoagenti, i valori predefiniti dell'account, le preferenze sul livello di impegno e la visibilità della spesa del gateway. ### Precedenza del modello dei sottoagenti CLAUDE_CODE_SUBAGENT_MODEL ora fornisce un valore predefinito. Il valore model: nella definizione di un agente e un modello selezionato esplicitamente alla creazione di un agente hanno la precedenza su tale variabile. Questa modifica della precedenza è confermata nel changelog associato al tag. Va tenuta distinta dall'ordine storico non verificato tra il flag di avvio, la variabile d'ambiente e il valore nel file delle impostazioni del modello principale. Quando si esamina la selezione del modello di un sottoagente, occorre considerare queste scelte esplicite prima di ritenere determinante la variabile d'ambiente. La [guida ai subagenti](/it/claude-code/subagents/) fornisce un contesto più ampio per la configurazione degli agenti. ### Valori predefiniti dell'account e preferenze sul livello di impegno Gli abbonamenti Enterprise basati sul numero di utenti ora utilizzano Opus 5 come modello predefinito, in linea con gli altri piani premium. Questa modifica a livello di account è distinta da una preferenza del modello salvata tramite /model. Il rilascio modifica anche la persistenza di /effort : ora salva un livello di impegno predefinito separato per ciascun modello. La distinzione pratica è che la selezione del modello e la persistenza del livello di impegno sono impostazioni separate. Il nuovo comportamento relativo al livello di impegno memorizza un valore predefinito per ciascun modello, anziché prevedere un unico valore predefinito condiviso. ### Visibilità della spesa del gateway La /usage aggiunge una barra Limite di spesa per gli sviluppatori che utilizzano un gateway per le app Claude con limiti di spesa: ``` /usage ``` Gli script della riga di stato acquisiscono il campo corrispondente rate_limits.spend_limit . Si tratta di un'aggiunta diagnostica per quel contesto di gateway. Il changelog non annuncia un tetto universale in dollari. La presenza di una visualizzazione del limite di spesa non va quindi interpretata come un limite fisso applicabile a ogni utente di Claude Code. ## Punti chiave - /model salvava già un valore predefinito per le nuove sessioni prima di 2.1.251; questo comportamento risale a 2.1.153. - Premi s nel selettore dei modelli per un cambio valido solo per la sessione corrente. Le associazioni di tasti personalizzate utilizzano modelPicker:thisSessionOnly. - Claude Code 2.1.251 aggiunge PreModelSwitch e PostModelSwitch, con funzionalità di blocco, conferma e annotazione descritte nel rilascio. - /cost, i dati della cache nella riga di stato e le informazioni di SessionStart alla ripresa offrono visibilità sull'attività della cache del prompt e sui costi stimati di ricostruzione. - CLAUDE_CODE_SUBAGENT_MODEL fornisce un valore predefinito che le scelte esplicite del modello dell'agente possono sovrascrivere. L'esatta precedenza storica della configurazione del modello principale resta non verificata nella ricerca fornita. ## FAQ ### /model salva il modello predefinito in Claude Code? Sì. La versione 2.1.153 ha modificato /model in modo che una selezione venga salvata come valore predefinito per le nuove sessioni; questo comportamento era già presente prima di 2.1.251. Premi s nel selettore quando vuoi un cambio valido solo per la sessione corrente. ### Quale ha la precedenza: settings.json, ANTHROPIC_MODEL o --model? La ricerca fornita riporta una documentazione che assegna al flag di avvio una precedenza superiore a ANTHROPIC_MODEL, e a tale variabile una precedenza superiore al valore del modello nel file delle impostazioni. Tuttavia, l'ordine esatto non è stato verificato in modo indipendente in un'istantanea precedente al 29 agosto 2026, quindi questo articolo non lo stabilisce come comportamento specifico alla data limite. ### Un hook di cambio modello di Claude Code può bloccare un cambio? Il rilascio 2.1.251 descrive PreModelSwitch e PostModelSwitch come in grado di supportare il blocco, la conferma e l'annotazione dei cambi di modello. Non fornisce schemi completi né JSON decisionali, quindi il solo annuncio non è sufficiente per implementare un hook eseguibile. ### Dove posso vedere i mancati riscontri nella cache e i costi stimati di ricostruzione? In 2.1.251, /cost riporta, per ciascuna sessione, il rapporto di riscontri nella cache, i mancati riscontri, i token reinseriti nella cache e lo stato caldo o freddo; gli script della riga di stato acquisiscono un oggetto corrispondente prompt_cache . Separatamente, gli hook SessionStart alla ripresa ricevono informazioni sul tempo trascorso dall'ultima attività della sessione e sul costo stimato per ricostruire la cache del prompt, anche se le note di rilascio non specificano i nomi di tali chiavi del payload. [Claude](/it/blog/tag/claude/)[Programmazione](/it/blog/tag/coding/)[Modelli](/it/blog/tag/models/) A [AI Prime Tech](https://aiprimetech.io/it/) AI Prime Tech pubblica questo blog. Gli articoli sono redatti con l'assistenza dell'AI; verifica nella documentazione ufficiale i dettagli specifici della versione, come gli ID dei modelli, i prezzi e i limiti, prima di farvi affidamento. Ottieni accesso all'API Claude a un costo inferiore Un'unica chiave API per Claude Opus 5.5, Sonnet 5, Haiku 4.5 e Fable 5.1, oltre a GPT-6 modelli. Pagamento a consumo, senza abbonamento. [Ottieni la tua chiave API →](/register) AI Prime Tech è un gateway API indipendente di terze parti. Claude™ e Anthropic® sono marchi di Anthropic, PBC. Non si intende suggerire alcuna affiliazione o approvazione.