Effort

Il parametro "effort" (sforzo) ti consente di controllare quanti token Claude impiega quando risponde alle richieste. Puoi bilanciare tra completezza della risposta ed efficienza dei token con un singolo modello. Il parametro effort è disponibile su tutti i modelli supportati senza necessità di header beta.



Come funziona effort

Per impostazione predefinita, Claude utilizza effort alto, impiegando tutti i token necessari per ottenere risultati eccellenti. Puoi aumentare il livello di effort a max per ottenere la massima capacità assoluta, oppure abbassarlo per essere più conservativo nell'uso dei token, ottimizzando velocità e costi accettando una certa riduzione delle capacità.

Il parametro effort influisce su tutti i token nella risposta, inclusi:

• Risposte testuali e spiegazioni
• Chiamate agli strumenti e argomenti delle funzioni
• Thinking (quando attivo)

Questo approccio presenta due vantaggi principali:

1. Non richiede che il thinking sia abilitato.
2. Può influire su tutta la spesa di token, incluse le chiamate agli strumenti. Ad esempio, un effort più basso significa che Claude effettua meno chiamate agli strumenti. Questo offre un grado di controllo molto maggiore sull'efficienza.



Livelli di effort

xhigh è un livello più recente; alcuni modelli che supportano max non supportano xhigh.



Livelli di effort consigliati per Claude Sonnet 5

Claude Sonnet 5 utilizza per impostazione predefinita effort high sulla Claude API e su Claude Code.

• Effort high (predefinito): Adatto per ragionamento complesso, coding e attività agentiche in cui la qualità conta più della velocità o del costo.
• Effort xhigh: Per le attività di coding e agentiche più difficili. Consulta Prompting di Claude Sonnet 5.
• Effort medium: Riduzione dei costi rispetto al valore predefinito. Paragonabile a Claude Sonnet 4.6 con effort high.
• Effort low: Per carichi di lavoro ad alto volume o sensibili alla latenza. Adatto per chat e casi d'uso non di coding in cui si dà priorità a tempi di risposta più rapidi.
• Effort max: Per attività che richiedono la massima capacità assoluta senza vincoli sulla spesa di token.



Livelli di effort consigliati per Claude Sonnet 4.6

Sonnet 4.6 utilizza per impostazione predefinita effort high. Imposta esplicitamente effort quando usi Sonnet 4.6 per evitare latenze impreviste:

• Effort medium (predefinito consigliato): Miglior equilibrio tra velocità, costo e prestazioni per la maggior parte delle applicazioni. Adatto per coding agentico, flussi di lavoro con uso intensivo di strumenti e generazione di codice.
• Effort low: Per carichi di lavoro ad alto volume o sensibili alla latenza. Adatto per chat e casi d'uso non di coding in cui si dà priorità a tempi di risposta più rapidi.
• Effort high: Per ragionamento complesso e attività in cui la qualità conta più della velocità o del costo.
• Effort max: Per attività che richiedono la massima capacità assoluta senza vincoli sulla spesa di token.



Livelli di effort consigliati per Claude Opus 4.7

Inizia con xhigh per casi d'uso di coding e agentici, e usa high come minimo per la maggior parte dei carichi di lavoro sensibili all'intelligenza. Scendi a medium per carichi di lavoro sensibili ai costi, oppure sali a max solo quando le tue valutazioni mostrano un margine misurabile a xhigh.

Il valore predefinito dell'API è high. Per usare xhigh, imposta effort esplicitamente; il valore che passi sovrascrive quello predefinito.

Claude Opus 4.7 rispetta inoltre i livelli di effort in modo più rigoroso rispetto a Claude Opus 4.6, specialmente a low e medium. A livelli di effort più bassi, il modello limita il proprio lavoro a ciò che è stato richiesto anziché fare più del necessario. Se osservi un ragionamento superficiale su problemi complessi con Claude Opus 4.7, aumenta effort anziché aggirare il problema tramite prompting. Se devi mantenere effort basso per motivi di latenza, aggiungi indicazioni mirate come "Questa attività richiede un ragionamento in più passaggi. Rifletti attentamente prima di rispondere."

Quando esegui Claude Opus 4.7 con effort xhigh o max, imposta un max_tokens elevato in modo che il modello abbia spazio per ragionare e agire attraverso subagent e chiamate agli strumenti. Iniziare da 64k token e regolare da lì è un valore predefinito ragionevole.



Livelli di effort consigliati per Claude Opus 4.8

Le indicazioni per Claude Opus 4.7 si applicano anche a Claude Opus 4.8. Inizia con xhigh per casi d'uso di coding e agentici, usa high per la maggior parte degli altri carichi di lavoro sensibili all'intelligenza, e scendi a medium o low solo quando hai verificato che il livello inferiore mantiene la qualità nelle tue valutazioni.

Il valore predefinito dell'API è high. Imposta effort esplicitamente per usare un livello diverso; il valore che passi sovrascrive quello predefinito.

Quando esegui Claude Opus 4.8 con effort xhigh o max, imposta un max_tokens elevato in modo che il modello abbia spazio per ragionare e agire attraverso subagent e chiamate agli strumenti. Iniziare da 64k token e regolare da lì è un valore predefinito ragionevole.



Livelli di effort consigliati per Claude Opus 5

Claude Opus 5 supporta tutti e cinque i livelli di effort. Inizia con high, il valore predefinito, e regola in base alle tue valutazioni: sali a xhigh per lavori di coding e agentici impegnativi, oppure a max quando un'attività giustifica una spesa di token senza vincoli, e usa liberamente low e medium come controllo principale per il costo dei token e il tempo di risposta ovunque le tue valutazioni mostrino che la qualità si mantiene. Se hai riportato le impostazioni di effort da un modello precedente, esegui una nuova analisi di effort sulle tue valutazioni anziché riutilizzarle.

Effort controlla il volume del thinking, non la lunghezza visibile della risposta: su Claude Opus 5, modificare effort non accorcia in modo affidabile le risposte, quindi usa il prompting per la lunghezza.

Il valore predefinito dell'API è high. Imposta effort esplicitamente per usare un livello diverso; il valore che passi sovrascrive quello predefinito.

Su Claude Opus 5, il thinking non può essere disabilitato con effort xhigh o max: le richieste che impostano thinking: {"type": "disabled"} a quei livelli restituiscono un errore 400. Consulta Effort con thinking.

Quando esegui Claude Opus 5 con effort xhigh o max, imposta un max_tokens elevato in modo che il modello abbia spazio per ragionare e agire attraverso subagent e chiamate agli strumenti. Iniziare da 64k token e regolare da lì è un valore predefinito ragionevole.



Livelli di effort consigliati per Claude Fable 5

Effort è il controllo principale per bilanciare intelligenza, latenza e costo su Claude Fable 5. Inizia con high, il valore predefinito, per la maggior parte delle attività, usa xhigh per i carichi di lavoro più sensibili alle capacità, e scendi a medium o low per lavori di routine. Le impostazioni di effort più basse su Claude Fable 5 offrono comunque buone prestazioni e spesso superano le prestazioni di xhigh sui modelli precedenti. A high e xhigh, imposta un max_tokens elevato: è un limite rigido sull'output totale, thinking più testo di risposta. Consulta Controllo dei costi.

Riduci effort se un'attività viene completata ma richiede più tempo del necessario, o se desideri uno stile di lavoro più veloce e interattivo. Le stesse raccomandazioni si applicano a Claude Mythos 5. Per indicazioni più complete, consulta Prompting di Claude Fable 5.



Utilizzo di base



Quando regolare il parametro effort

• Usa effort max quando hai bisogno della massima capacità assoluta senza vincoli: il ragionamento più approfondito e l'analisi più profonda. Disponibile sui modelli Claude 4.6 e successivi e su Claude Mythos Preview.
• Usa effort xhigh per coding avanzato e lavori agentici complessi che richiedono esplorazione estesa, come chiamate ripetute agli strumenti e ricerca dettagliata. Disponibile su Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7 e Claude Sonnet 5.
• Usa effort high (il valore predefinito) per ragionamento complesso, analisi sfumate, problemi di coding difficili o qualsiasi attività in cui la qualità conta più della velocità o del costo.
• Usa effort medium come opzione bilanciata quando desideri prestazioni solide senza la piena spesa di token di effort high.
• Usa effort low quando stai ottimizzando per la velocità (perché Claude risponde con meno token) o per il costo. Ad esempio, attività di classificazione semplici, ricerche rapide o casi d'uso ad alto volume in cui miglioramenti marginali della qualità non giustificano latenza o spesa aggiuntive.



Effort con l'uso degli strumenti

Quando si utilizzano strumenti, il parametro effort influisce sia sulle spiegazioni relative alle chiamate agli strumenti sia sulle chiamate stesse. Livelli di effort più bassi tendono a:

• Combinare più operazioni in meno chiamate agli strumenti
• Effettuare meno chiamate agli strumenti
• Procedere direttamente all'azione senza preamboli
• Usare messaggi di conferma concisi dopo il completamento

Livelli di effort più alti possono:

• Effettuare più chiamate agli strumenti
• Spiegare il piano prima di agire
• Fornire riepiloghi dettagliati delle modifiche
• Includere commenti al codice più completi



Effort con thinking

Il parametro thinking controlla se Claude pensa in blocchi di pensiero prima di rispondere; il parametro effort controlla quanto lavoro Claude dedica all'intera risposta, il che in modalità adattiva include quanto spesso e quanto in profondità pensa. Non passare adaptive come valore di effort: adaptive è una modalità di pensiero, non un livello di effort.

A livelli di effort più alti, Claude ragiona sulla maggior parte delle richieste e più a lungo; a livelli più bassi, può saltare completamente il thinking per problemi più semplici. Consulta Thinking ed effort per indicazioni complete su come i due controlli funzionano insieme.

Su Claude Opus 4.5, l'unico modello con solo pensiero esteso che supporta effort, funziona insieme a budget_tokens: imposta il livello di effort per la tua attività, quindi imposta il budget di token per il thinking in base alla profondità di ragionamento necessaria.

Per la disponibilità del thinking per modello, consulta la tabella di configurazione per modello. Effort funziona con o senza thinking; consulta Come funziona effort.



Modificare effort a metà conversazione

output_config.effort è un'impostazione a livello di richiesta: ogni richiesta porta il proprio valore, quindi per eseguire una parte successiva di una conversazione a un livello di effort diverso, imposta il nuovo valore nella richiesta successiva. Il livello di effort si applica all'intera richiesta. Poiché effort modella il prompt renderizzato, modificarlo tra le richieste non preserva i prefissi memorizzati nella cache dai turni precedenti; se fai affidamento sulla cache dei prompt durante una sessione lunga, scegli un livello di effort all'inizio e mantienilo costante.



Best practice

1. Imposta effort esplicitamente: L'API utilizza high come valore predefinito, ma il punto di partenza corretto dipende dal tuo modello e dal carico di lavoro.
2. Usa low per attività sensibili alla velocità o semplici: Quando la latenza è importante o le attività sono semplici, effort low può ridurre significativamente i tempi di risposta e i costi.
3. Testa il tuo caso d'uso: L'impatto dei livelli di effort varia in base al tipo di attività. Valuta le prestazioni sui tuoi casi d'uso specifici prima della distribuzione.
4. Considera effort dinamico: Regola effort in base alla complessità dell'attività. Query semplici possono giustificare effort low mentre coding agentico e ragionamento complesso beneficiano di effort high. Consulta il punto successivo prima di variarlo all'interno di una conversazione.
5. Mantieni effort costante all'interno di conversazioni memorizzate nella cache: Modificare il valore di effort tra le richieste invalida la cache dei prompt, quindi varia effort tra carichi di lavoro diversi anziché all'interno di una conversazione che si basa sui cache hit. Consulta .



Passaggi successivi