SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

Limite strumenti Claude: cosa significa e come continuare

L’errore indica che Claude ha esaurito le chiamate agli strumenti del turno, non la quota del piano. Scopri come continuare senza perdere il lavoro già svolto.

Cosa significa il limite di utilizzo degli strumenti per questo turno

Un limite di utilizzo degli strumenti per questo turno indica che Claude ha interrotto la risposta a metà perché aveva esaurito il numero di chiamate agli strumenti consentite per quella risposta, non perché il tuo account avesse esaurito la quota di utilizzo. Tutto ciò che aveva trovato prima dell'interruzione è ancora disponibile nella conversazione. Invia un altro messaggio chiedendo di continuare: verrà avviato un nuovo turno con un nuovo limite.

Nell'Agent SDK, un turno è un passaggio completo attraverso il ciclo dell'agente. Claude produce un output contenente chiamate agli strumenti, il client esegue tali strumenti e i risultati vengono restituiti a Claude per la decisione successiva. Il ciclo si ripete senza restituire il controllo all'utente. Il ciclo termina quando Claude produce una risposta che non contiene chiamate agli strumenti. Il limite di turni dell'SDK conta ogni passaggio, inclusa la risposta finale senza chiamate agli strumenti.

Il limite di utilizzo del piano è un controllo separato

Il limite del piano conteggia quanto hai utilizzato durante una finestra temporale. La pagina del centro assistenza di Anthropic sui messaggi di errore, consultata il 9 novembre 2026, indica Approaching session limit quando ti stai avvicinando al limite e 5-hour limit reached - resets [time] quando lo superi. Il limite settimanale presenta messaggi analoghi, che indicano il giorno e l’ora del ripristino. In entrambi i casi, il messaggio specifica un momento preciso. Se non disponi di crediti di utilizzo, attendere fino a quell’ora risolve il problema e ciò che digiti nel frattempo non produce alcun effetto. Se hai attivato i crediti di utilizzo per un piano a pagamento, la pagina indica che il lavoro continua utilizzando i crediti e il messaggio diventa 5-hour limit resets [time] - continuing with usage credits. La prosecuzione termina quando raggiungi il limite di spesa mensile oppure quando il saldo dei crediti si esaurisce con il ricaricamento automatico disattivato. Gli account Ultra verificati non hanno un limite di sessione di cinque ore, ma i limiti settimanali restano applicabili.

Il messaggio relativo all’utilizzo degli strumenti si comporta in modo opposto. Viene visualizzato durante un’attività e un singolo messaggio successivo consente di continuare immediatamente il lavoro. Le chiamate agli strumenti già eseguite continuano a essere conteggiate nell’utilizzo del piano. Continuare non ripristina la quota e i crediti di utilizzo possono consentire di proseguire anche dopo il raggiungimento di un limite del piano. Per il caso della quota, cosa fare quando Claude indica che il limite è stato raggiunto elenca le opzioni disponibili, mentre come vengono conteggiati i limiti di utilizzo di Claude spiega le finestre temporali sottostanti.

Perché esiste un budget di strumenti per ogni turno

Ogni chiamata a uno strumento consuma contesto. La chiamata viene eseguita, lo strumento elabora la richiesta e l’intero risultato viene reinserito nella conversazione. La lettura di un file di grandi dimensioni o l’esecuzione di un comando con un output molto esteso può consumare migliaia di token in un singolo passaggio, e il testo resta nel contesto per il resto della sessione. La documentazione del ciclo degli agenti di Anthropic espone chiaramente la conseguenza: il contesto si accumula tra i turni, quindi una sessione con molte chiamate agli strumenti contiene molto più testo di una sessione breve.

Il budget per turno interrompe un ciclo che non sta più facendo progressi. Un agente che esegue una ricerca, legge i risultati, cerca di nuovo e continua a non trovare nulla proseguirà fino a quando qualcosa non lo interrompe. Il budget svolge questa funzione. Ti restituisce il controllo in un punto in cui puoi riorientare il lavoro, con un costo molto inferiore rispetto a lasciare che il ciclo prosegua fino a esaurire la finestra di contesto.

Dove è visibile questo limite nell'API

La documentazione pubblica di Anthropic sugli errori non indica alcun numero di chiamate agli strumenti per turno per l'app di chat Claude. Di conseguenza, qualsiasi cifra precisa che trovi è una stima di qualcuno. Una modalità di limitazione analoga è documentata per l'API (interfaccia di programmazione delle applicazioni), ed è nella documentazione dell'API che il comportamento effettivo è visibile.

Il campo stop_reason nella risposta dell'API Messages indica il motivo per cui la generazione si è interrotta. I valori documentati sono end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal e model_context_window_exceeded. Due di questi descrivono la situazione trattata in questa guida.

pause_turn viene restituito quando il ciclo di campionamento lato server raggiunge il limite di iterazioni durante l'esecuzione di strumenti server, come la ricerca sul Web. Al 25 ottobre 2026, la pagina sui motivi dell'arresto e sul comportamento di fallback indica come valore predefinito 10 iterazioni per richiesta. La correzione documentata consiste nel reinviare la risposta senza modificarla come messaggio dell'assistant, in modo che Claude riprenda dal punto in cui si era fermato. Non devi aggiungere un nuovo messaggio dell'utente per chiedere di continuare: l'esempio documentato invia soltanto il messaggio originale dell'utente seguito dal contenuto sospeso dell'assistant.

max_tokens indica che la risposta ha raggiunto il limite di token di output impostato nella richiesta. Se la troncatura avviene all'interno di un blocco di utilizzo degli strumenti incompleto, la chiamata allo strumento non può essere eseguita. La soluzione documentata consiste nel riprovare con un valore max_tokens più alto.

Consulta i valori correnti nella pagina sui motivi dell'arresto e sul comportamento di fallback, invece di affidarti a quelli riportati qui. I valori predefiniti indicati in quella pagina cambiano e un numero non aggiornato è peggiore dell'assenza di un numero.

Perché una chat esaurisce le chiamate agli strumenti

  • Una domanda senza un punto di arresto naturale. "Trova tutto ciò che è stato scritto su X" non fornisce al modello alcuna indicazione per capire quando la ricerca è terminata.
  • Letture ripetute dello stesso materiale, perché la risposta non si trova nel punto in cui il modello si aspettava di trovarla.
  • Risultati di grandi dimensioni restituiti dagli strumenti. Una pagina web lunga o un file voluminoso occupano lo spazio necessario al resto del turno.
  • Più attività indipendenti nello stesso messaggio. Ogni attività richiede le proprie chiamate agli strumenti, che vengono tutte sottratte allo stesso budget.
  • Connettori e server MCP (model context protocol) che non stai utilizzando per questa attività. Dopo il caricamento, ciascuno occupa spazio nella conversazione e offre al modello più modi per consumare il budget del turno.

Come completare la risposta

Rispondi con "continua" oppure, meglio ancora, con una breve istruzione che indichi ciò che manca. In questo modo si apre un nuovo turno con un nuovo budget. La conversazione precedente rimane nel contesto, quindi Claude riprende il lavoro senza ripetere le chiamate agli strumenti già effettuate.

Se si blocca due volte nello stesso punto, l'attività è troppo ampia per un solo turno e devi suddividerla. Invece di chiedere un audit completo di un repository, chiedi prima l'elenco dei file e poi occupati di un file per messaggio. Quattro turni brevi possono completare un'attività che un unico turno lungo non riesce a terminare.

Riduci l'ambito di ciò che il modello deve cercare. Fornisci il percorso esatto del file o la stringa di errore esatta e incolla il log se lo hai già. Incollare un log costa un messaggio. Chiedere al modello di trovare quel log richiede diverse chiamate agli strumenti e potrebbe portarlo a individuare quello sbagliato.

Disattiva i connettori che non ti servono in quel momento. Il centro assistenza di Anthropic indica che ogni connettore occupa spazio nella conversazione. Con l'impostazione predefinita Auto, Claude decide quali connettori caricare; Always available li carica tutti all'inizio, e ogni connettore caricato consuma contesto e amplia l'insieme delle azioni che il modello può scegliere. Se mantieni un insieme ampio di connettori, l'impostazione On demand li carica solo dopo che Claude ha cercato quello appropriato. Lo stesso principio vale per una lunga sessione di programmazione, in cui mantenere ridotto il contesto di una sessione Claude Code fa la differenza tra un agente che completa il lavoro e uno che si interrompe a metà.

Imposta tu il limite di turni quando esegui un agent

Se controlli Claude dal tuo codice, il limite di turni del ciclo è un'impostazione che gestisci tu. Il Claude Agent SDK (software development kit) espone max_turns in Python e maxTurns in TypeScript. Questi parametri contano i turni con chiamate agli strumenti e la risposta finale contenente solo testo. Il valore predefinito documentato non impone alcun limite.

Quando viene raggiunto questo limite, l'SDK restituisce un risultato in cui subtype è error_max_turns. Una chiamata query() singola genera quindi un errore che contiene il testo Reached maximum number of turns. La pagina del ciclo dell'Agent SDK documenta anche un'uscita con codice diverso da zero del processo Claude Code sottostante per questo errore della chiamata singola. Il risultato contiene comunque num_turns e session_id. Puoi quindi riprendere la stessa sessione con un limite più alto, invece di riavviare l'attività.

Dalla CLI (command line interface), lo stesso controllo è disponibile come flag e si applica solo alla modalità print:

claude -p --max-turns 3 "summarise the failing tests"

Il riferimento dei flag indica che, per impostazione predefinita, non esiste alcun limite. Con --input-format stream-json, un messaggio ancora in coda quando il limite termina un turno resta in coda e avvia un nuovo turno con il relativo limite. Esiste anche una variante dello stesso meccanismo basata sui costi: max_budget_usd in Python e maxBudgetUsd in TypeScript arrestano il ciclo al raggiungimento di una soglia di spesa, invece di contare i turni. La spesa dei subagent contribuisce a questo totale. Il budget viene verificato dopo la ricezione delle risposte del modello. Di conseguenza, la spesa può superare il limite a causa della risposta che lo raggiunge e dei subagent in background che terminano prima di arrestarsi. Se esegui agent su un server il cui costo è calcolato mensilmente, vale la pena configurare prima della prima esecuzione lunga il controllo dei costi di un agente AI su un VPS.

Una pausa in attesa di approvazione è un caso diverso. Se l'agent si arresta senza generare spesa, consulta permission_mode invece del conteggio dei turni. In questo caso, uno strumento sta aspettando una risposta umana che non arriva. La modalità automatica e le impostazioni delle autorizzazioni di Claude Code spiega quali modalità richiedono conferma e quali procedono senza richiederla.

Come verificare personalmente il comportamento attuale

Il comportamento può cambiare senza preavviso, quindi considera ogni numero riportato in questa guida come soggetto a variazioni e non come un valore fisso. Esistono due fonti che mostrano la situazione attuale.

  • La documentazione API sui motivi di arresto, che indica il valore predefinito di iterazioni dello strumento server e il modo per proseguire oltre tale limite.
  • La pagina del centro assistenza di Anthropic sui messaggi di errore, che riporta la formulazione relativa ai limiti di utilizzo. Verificata il 9 novembre 2026, la pagina documenta i messaggi relativi all'utilizzo su cinque ore e settimanale, comprese le versioni visualizzate quando intervengono i crediti di utilizzo, e non menziona alcun limite degli strumenti per singolo turno. Per questo motivo, qui non viene indicato alcun valore ufficiale per l'app di chat.

Misura invece le tue esecuzioni. In Claude Code, /context visualizza l'utilizzo attuale del contesto sotto forma di griglia colorata e indica gli strumenti che ne consumano la quota maggiore, mentre /compact riassume la conversazione fino a quel momento per liberare spazio. Nell'Agent SDK, ogni risultato contiene num_turns, quindi puoi vedere quanti turni richiede realmente un'attività tipica prima di impostare un limite. Un valore ricavato dal tuo carico di lavoro è più utile di quello riportato in un post su un forum.

FAQ

Il limite di utilizzo degli strumenti è uguale al mio limite di utilizzo di Claude?

No. Il limite di utilizzo tiene conto di quanto hai consumato in un intervallo di tempo e indica quando viene ripristinato; in questo caso basta aspettare. Il messaggio relativo all'utilizzo degli strumenti interrompe una risposta a metà perché quella risposta ha esaurito le chiamate agli strumenti disponibili. L'invio di un altro messaggio avvia subito un nuovo turno con un nuovo budget. L'utilizzo degli strumenti viene comunque conteggiato ai fini del consumo previsto dal tuo piano. come viene conteggiato il limite di utilizzo di Claude descrive in dettaglio il caso della quota.

Come posso fare in modo che Claude completi un'attività che ha interrotto a metà?

Invia un altro messaggio. «Continue» funziona, ma è più efficace indicare cosa manca ancora, perché così eviti che il modello ricostruisca il contesto che già possiede. Se si interrompe di nuovo nello stesso punto, suddividi l'attività in parti più piccole e invia una parte per messaggio. Specificare i percorsi esatti dei file o incollare direttamente il contenuto evita la ricerca che aveva consumato il budget iniziale.

Che cosa significa «límite de uso de herramientas» o «limite de uso de ferramentas»?

Sono le formulazioni rispettivamente in spagnolo e in portoghese dello stesso messaggio, che di solito compare come «límite de uso de herramientas en este turno» o «limite de uso de ferramentas neste turno». Il significato è identico in tutte le lingue: Claude ha esaurito le chiamate agli strumenti consentite in una singola risposta e la quota del piano non è coinvolta. Anche la soluzione è la stessa. Rispondi chiedendo di continuare oppure suddividi la richiesta in passaggi più piccoli. Il limite di fatturazione è indicato in un messaggio separato, che specifica l'ora del ripristino.

L'upgrade del piano aumenta il limite di utilizzo degli strumenti per un turno?

Il livello del piano e il budget degli strumenti per singolo turno sono due controlli distinti. L'upgrade aumenta la quantità di utilizzo disponibile nell'intervallo di tempo, cioè il limite che indica quando viene ripristinato. Il numero di chiamate agli strumenti che una singola risposta può effettuare dipende dal ciclo che esegue il modello, e Anthropic non pubblica questo valore per l'app di chat. Suddividere l'attività in turni più piccoli è ciò che aiuta concretamente, indipendentemente dal piano.

Perché il mio agent si interrompe dopo solo poche chiamate agli strumenti?

Verifica se hai impostato un limite. Claude Agent SDK accetta max_turns in Python e maxTurns in TypeScript; l'interfaccia della riga di comando accetta --max-turns in modalità print. Quando viene raggiunto uno di questi limiti, l'SDK restituisce un risultato con un subtype pari a error_max_turns; una chiamata query() singola genera quindi un errore contenente il testo Reached maximum number of turns. Per impostazione predefinita, entrambi non hanno limiti. Se non è stato impostato alcun limite e l'esecuzione si interrompe comunque, controlla stop_reason nel risultato: max_tokens indica che è stato raggiunto il limite massimo dell'output, mentre pause_turn indica che il ciclo degli strumenti sul server ha raggiunto il proprio limite di iterazioni e richiede l'invio della risposta per poter continuare.

Questo articolo ti è stato utile?