--- title: Finestre di contesto url: https://platform.claude.com/docs/it/build-with-claude/context-windows description: Comprendi come funziona la finestra di contesto, come il ragionamento esteso e l'uso degli strumenti vengono conteggiati al suo interno e come gestire il contesto man mano che le conversazioni crescono. --- Man mano che le conversazioni crescono, finirai per avvicinarti ai limiti della finestra di contesto. Per conversazioni di lunga durata e flussi di lavoro agentici, la [compattazione lato server](https://platform.claude.com/docs/it/build-with-claude/compaction) è la strategia principale per la gestione del contesto. ## Come funziona la finestra di contesto La "context window" (finestra di contesto) si riferisce a tutto il testo che un modello linguistico può consultare quando genera una risposta, inclusa la risposta stessa. Questo è diverso dal grande corpus di dati su cui il modello linguistico è stato addestrato, e rappresenta invece una "memoria di lavoro" per il modello. Una finestra di contesto più ampia consente al modello di gestire prompt più complessi e lunghi, ma più contesto non è automaticamente meglio. Man mano che il numero di token cresce, l'accuratezza e il richiamo si degradano, un fenomeno noto come *context rot* (deterioramento del contesto). Questo rende la cura di ciò che si trova nel contesto importante tanto quanto lo spazio disponibile. Per saperne di più sul perché i contesti lunghi si degradano e su come progettare soluzioni per aggirare il problema, consulta [Effective context engineering](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents). Il seguente diagramma illustra il comportamento standard della finestra di contesto per le richieste API1: ![Diagramma dei turni che si accumulano nella context window (finestra di contesto) finché la conversazione non si avvicina al limite di token](https://platform.claude.com/docs/it/images/context-window.svg) *1 Le interfacce di chat come [claude.ai](https://claude.ai/) possono anche gestire la finestra di contesto su base progressiva "first in, first out" (il primo a entrare è il primo a uscire).* * **Accumulo progressivo dei token:** Man mano che la conversazione avanza attraverso i turni, ogni messaggio dell'utente e ogni risposta dell'assistente si accumulano all'interno della finestra di contesto, e i turni precedenti vengono conservati completamente. * **Capacità della finestra di contesto:** La finestra di contesto ([fino a 1M di token, a seconda del modello](https://platform.claude.com/docs/it/build-with-claude/context-windows#context-window-sizes-by-model)) contiene la cronologia della conversazione più il nuovo output generato da Claude. * **Flusso input-output:** Ogni turno è composto da: * **Fase di input:** Contiene tutta la cronologia precedente della conversazione più il messaggio corrente dell'utente * **Fase di output:** Genera una risposta testuale che diventa parte dell'input per il turno successivo Tutto ciò che è presente nella richiesta viene conteggiato nella finestra di contesto: il "system prompt" (prompt di sistema), ogni messaggio in `messages` (inclusi risultati degli strumenti, immagini e documenti) e le definizioni dei tuoi strumenti. Anche l'output che Claude genera per il turno, incluso il suo ragionamento esteso, viene conteggiato. Ogni risposta riporta ciò che la richiesta ha consumato nel suo campo `usage`. Se usi la [cache dei prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-caching), il conteggio dell'input è suddiviso tra `input_tokens`, `cache_read_input_tokens` e `cache_creation_input_tokens`, e tutti e tre vengono conteggiati nella finestra. Per stimare una richiesta prima di inviarla, usa l'[API di conteggio dei token](https://platform.claude.com/docs/it/build-with-claude/token-counting). ## Dimensioni della finestra di contesto per modello Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Haiku 5.5 e [Claude Mythos Preview](https://anthropic.com/glasswing) hanno una finestra di contesto da 1M di token. Una singola richiesta a uno qualsiasi di essi può generare fino a 128k token di output (`max_tokens`). Gli altri modelli Claude, incluso Claude Sonnet 4.5 (deprecato), hanno una finestra di contesto da 200k token. Per ogni modello con una finestra di contesto da 1M di token, 1M è il valore predefinito: non hai bisogno di un header beta, e le richieste a contesto lungo vengono fatturate ai [prezzi standard](https://platform.claude.com/docs/it/about-claude/pricing#long-context-pricing), tranne su Claude Haiku 5.5, dove i prompt oltre i 100.000 token costano di più. Una singola richiesta può includere fino a 600 immagini o pagine PDF (100 per i modelli con una finestra di contesto da 200k token). Se invii molte immagini o documenti di grandi dimensioni, potresti raggiungere i [limiti di dimensione della richiesta](https://platform.claude.com/docs/it/api/overview#request-size-limits) prima del limite di token. Consulta la tabella di [confronto dei modelli](https://platform.claude.com/docs/it/models/overview#latest-models-comparison) per un elenco delle dimensioni della finestra di contesto per modello. ## La finestra di contesto con il thinking Con il [thinking](https://platform.claude.com/docs/it/build-with-claude/thinking) (ragionamento), tutti i token di input e output, inclusi i token di thinking, vengono conteggiati nel limite della finestra di contesto, con alcune sfumature nelle situazioni multi-turno. I token di thinking sono un sottoinsieme del tuo parametro `max_tokens`, vengono fatturati come token di output e vengono conteggiati nei limiti di velocità. Con l'[adaptive thinking](https://platform.claude.com/docs/it/build-with-claude/thinking) (ragionamento adattivo), Claude determina dinamicamente la propria allocazione di thinking, quindi l'uso dei token di thinking varia da richiesta a richiesta. Il fatto che i blocchi di ragionamento dei turni precedenti dell'assistente rimangano nella finestra di contesto dipende dal modello. Su Claude Opus 4.5 e sui modelli Opus successivi, Claude Sonnet 4.6 e sui modelli Sonnet successivi, Claude Haiku 5.5, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5 e Claude Mythos Preview, l'API conserva per impostazione predefinita i blocchi di ragionamento precedenti, che vengono conteggiati nella finestra di contesto come qualsiasi altro token di input. Sui modelli Opus e Sonnet precedenti e su tutti i modelli Haiku fino a Claude Haiku 4.5, l'API rimuove automaticamente i blocchi di ragionamento precedenti dalla cronologia della conversazione quando li reinvii, preservando così la capacità di token per il contenuto della conversazione. Per i valori predefiniti per modello, consulta [preservazione dei blocchi di ragionamento per modello](https://platform.claude.com/docs/it/build-with-claude/thinking#thinking-block-preservation-by-model). Per modificare il comportamento predefinito in una delle due direzioni, usa la [rimozione dei blocchi di ragionamento](https://platform.claude.com/docs/it/build-with-claude/context-editing#thinking-block-clearing). Il seguente diagramma mostra come vengono gestiti i token quando il thinking è abilitato su un modello che rimuove i blocchi di thinking precedenti: ![Diagramma del thinking (ragionamento) su un modello che rimuove i blocchi di ragionamento precedenti: il blocco di ragionamento di ogni turno viene generato nell'output e non viene riportato nell'input dei turni successivi](https://platform.claude.com/docs/it/images/context-window-thinking.svg) * **Rimozione dei blocchi di thinking:** Sui modelli che rimuovono i blocchi di thinking precedenti, i blocchi di thinking (mostrati in grigio scuro) vengono generati durante la fase di output di ogni turno ma non vengono riportati come token di input per i turni successivi. Non devi rimuovere tu stesso i blocchi di thinking: se li ripassi, la Claude API li rimuove automaticamente. * **Fatturazione:** I token di thinking vengono fatturati come token di output una sola volta, quando vengono generati. Sui modelli che mantengono i blocchi di thinking precedenti, i blocchi mantenuti fanno poi parte dell'input delle richieste successive e vengono fatturati come token di input, come il resto della cronologia della conversazione. Puoi leggere di più sulla finestra di contesto e sul thinking nella guida [Thinking](https://platform.claude.com/docs/it/build-with-claude/thinking). ## La finestra di contesto con thinking e uso degli strumenti Il seguente diagramma illustra come vengono gestiti i token quando combini il thinking con il "tool use" (uso degli strumenti) su un modello che rimuove i blocchi di thinking precedenti: ![Diagramma del thinking (ragionamento) con tool use (uso degli strumenti): il ragionamento viene mantenuto con il relativo risultato dello strumento, poi scartato al turno utente successivo sui modelli che rimuovono i blocchi di ragionamento precedenti](https://platform.claude.com/docs/it/images/context-window-thinking-tools.svg) * **Componenti di input:** Configurazione degli strumenti e messaggio dell'utente * **Componenti di output:** Thinking + risposta testuale + richiesta di uso degli strumenti * **Calcolo dei token:** Tutti i componenti di input e output vengono conteggiati nella finestra di contesto, e tutti i componenti di output vengono fatturati come token di output. * **Componenti di input:** Ogni blocco del primo turno e il `tool_result`. Devi restituire il blocco di thinking con i risultati degli strumenti corrispondenti. Questo è l'unico caso in cui devi restituire i blocchi di thinking. * **Componenti di output:** Dopo che i risultati degli strumenti sono stati ripassati a Claude, Claude risponde solo con testo (nessun thinking aggiuntivo fino al prossimo messaggio `user`, a meno che non sia abilitato l'[interleaved thinking](https://platform.claude.com/docs/it/build-with-claude/thinking#interleaved-thinking)). * **Calcolo dei token:** Tutti i componenti di input e output vengono conteggiati nella finestra di contesto, e tutti i componenti di output vengono fatturati come token di output. * **Componenti di input:** Tutti gli input e l'output del turno precedente vengono riportati. Il blocco di thinking del ciclo di uso degli strumenti completato non deve più rimanere nel contesto: sui modelli che rimuovono i blocchi di thinking precedenti, l'API lo scarta automaticamente quando lo ripassi, e sui modelli che mantengono i blocchi di thinking precedenti, rimane a meno che tu non lo cancelli con la [cancellazione dei blocchi di thinking](https://platform.claude.com/docs/it/build-with-claude/context-editing#thinking-block-clearing). Questo è anche il punto in cui aggiungi il turno `user` successivo. * **Componenti di output:** Poiché c'è un nuovo turno `user` al di fuori del ciclo di uso degli strumenti, Claude genera un nuovo blocco di thinking e continua da lì. * **Calcolo dei token:** Sui modelli che rimuovono i blocchi di thinking precedenti, i token di thinking precedenti non vengono più conteggiati nella finestra di contesto. Tutti gli altri blocchi precedenti vengono ancora conteggiati nella finestra di contesto, così come il blocco di thinking nel turno `assistant` corrente. * **Considerazioni per l'uso degli strumenti con il thinking:** * Quando invii i risultati degli strumenti, devi includere l'intero blocco di thinking non modificato che accompagna quella richiesta di strumento, inclusa la sua firma. * L'API usa firme crittografiche per verificare l'autenticità dei blocchi di thinking. Se modifichi un blocco di thinking, l'API restituisce un errore. La maggior parte dei modelli Claude attuali supporta il [ragionamento interlacciato](https://platform.claude.com/docs/it/build-with-claude/thinking#interleaved-thinking), che consente a Claude di ragionare tra una chiamata di strumento e l'altra, anche dopo aver ricevuto i risultati degli strumenti. È automatico sui modelli con ragionamento adattivo; Claude Opus 4.5, Claude Sonnet 4.5 (deprecato) e i modelli Claude 4 precedenti richiedono l'header beta `interleaved-thinking-2025-05-14`, e Claude Haiku 4.5 non lo supporta. Per maggiori informazioni sull'uso degli strumenti con il thinking, consulta [Thinking con uso degli strumenti](https://platform.claude.com/docs/it/build-with-claude/thinking#thinking-with-tool-use). Per ridurre il contesto consumato dalle definizioni degli strumenti stesse, consulta [Gestire il contesto degli strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/manage-tool-context), oppure rinvia le definizioni degli strumenti con lo [strumento di ricerca strumenti](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-search-tool). ## Consapevolezza del contesto Claude Sonnet 5, Claude Sonnet 4.6, Claude Sonnet 4.5 (deprecato) e Claude Haiku 4.5 dispongono della **"context awareness" (consapevolezza del contesto):** questi modelli tengono traccia della finestra di contesto rimanente (il loro "budget di token") durante tutta la conversazione. Questo consente al modello di gestire le attività di lunga durata in base allo spazio rimanente, anziché dover indovinare quanti token restano. La consapevolezza del contesto è automatica: non c'è nulla da abilitare e non devi mai inviare tu stesso i tag mostrati in questa sezione. È l'API a inserirli. ### Come funziona Nel prompt di sistema di ogni richiesta, l'API fornisce a Claude la sua finestra di contesto totale: ```xml 200000 ``` Il budget corrisponde alla finestra di contesto disponibile per la tua richiesta: 1M di token per Claude Sonnet 5 e Claude Sonnet 4.6, e 200k token per Claude Sonnet 4.5 (deprecato) e Claude Haiku 4.5. Gli esempi in questa sezione mostrano un modello con una finestra di contesto da 200k token. Dopo ogni chiamata a uno strumento, l'API fornisce a Claude un aggiornamento sulla capacità rimanente: ```xml Token usage: 35000/200000; 165000 remaining ``` I token delle immagini sono inclusi in questi budget. Claude Opus 4.7 e i modelli Opus successivi, Claude Sonnet 5.5, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5 e Claude Haiku 5.5 non ricevono questi tag inseriti. Su questi modelli, puoi fornire al modello un budget esplicito con i ["task budget" (budget delle attività)](https://platform.claude.com/docs/it/build-with-claude/task-budgets), che sono in beta. Per gli agenti che si estendono su più sessioni, progetta i tuoi artefatti di stato in modo che il recupero del contesto sia rapido quando inizia una nuova sessione. Il [pattern multisessione dello strumento di memoria](https://platform.claude.com/docs/it/agents-and-tools/tool-use/memory-tool#multisession-software-development-pattern) illustra un approccio concreto. Consulta anche [Effective harnesses for long-running agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents). Per indicazioni di prompting sull'uso della consapevolezza del contesto, consulta [Best practice di prompting](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/claude-prompting-best-practices#context-awareness-and-multiwindow-workflows). ## Gestire il contesto con la compattazione Se le tue conversazioni si avvicinano regolarmente ai limiti della finestra di contesto, usa la [compattazione lato server](https://platform.claude.com/docs/it/build-with-claude/compaction). La compattazione riassume automaticamente sul server le parti precedenti della conversazione, così la conversazione può continuare oltre il limite della finestra di contesto. È disponibile in beta per i modelli Claude 4.6 e successivi e per [Claude Mythos Preview](https://anthropic.com/glasswing). Per esigenze più specializzate, la [modifica del contesto](https://platform.claude.com/docs/it/build-with-claude/context-editing) offre strategie aggiuntive: * **Cancellazione dei risultati degli strumenti:** Cancella i vecchi risultati degli strumenti nei flussi di lavoro agentici * **Cancellazione dei blocchi di ragionamento:** Gestisci i blocchi di ragionamento dei turni precedenti I prefissi di prompt in cache occupano comunque la finestra di contesto: la [cache dei prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-caching) cambia quanto paghi per quei token, non se vengono conteggiati. ## Comportamento in caso di superamento della finestra di contesto Se il solo input supera già la finestra di contesto del modello, l'API restituisce un errore 400 `invalid_request_error` ("prompt is too long") su ogni modello. Sui modelli Claude 4.5 e successivi, se i token di input più `max_tokens` superano la dimensione della finestra di contesto, l'API accetta la richiesta. Se la generazione raggiunge poi il limite della finestra di contesto, si interrompe con `stop_reason: "model_context_window_exceeded"`. Sui modelli precedenti, l'API restituisce invece un [errore di validazione](https://platform.claude.com/docs/it/api/errors). Per aderire al comportamento `model_context_window_exceeded` su quei modelli, usa l'header beta `model-context-window-exceeded-2025-08-26`. Consulta [Motivi di arresto e fallback](https://platform.claude.com/docs/it/build-with-claude/handling-stop-reasons) per i dettagli. Per rimanere entro i limiti della finestra di contesto, usa l'[API di conteggio dei token](https://platform.claude.com/docs/it/build-with-claude/token-counting) per stimare l'uso dei token prima di inviare messaggi a Claude. ## Prossimi passi Compattazione del contesto lato server per gestire conversazioni lunghe che si avvicinano ai limiti della finestra di contesto. Gestisci automaticamente il contesto della conversazione man mano che cresce con la modifica del contesto. Consulta la tabella di confronto dei modelli per un elenco delle dimensioni della finestra di contesto e dei prezzi dei token di input/output per modello. Fornisci a Claude un ragionamento potenziato per attività complesse e controlla come viene restituito il contenuto del thinking.