Effort

Il parametro effort ti consente di controllare quanto Claude è propenso a spendere token quando risponde alle richieste. Puoi bilanciare la completezza della risposta e l'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 high, spendendo tutti i token necessari per ottenere risultati eccellenti. Puoi aumentare il livello di effort a max per la massima capacità assoluta, oppure abbassarlo per essere più conservativo nell'utilizzo 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
• Pensiero esteso (quando abilitato)

Questo approccio presenta due vantaggi principali:

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



Livelli di effort



Livelli di effort consigliati per Claude Sonnet 5

Claude Sonnet 5 utilizza per impostazione predefinita effort high.

• 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 Sonnet 4.6

Sonnet 4.6 utilizza per impostazione predefinita effort high. Imposta esplicitamente effort quando usi Sonnet 4.6 per evitare latenza imprevista:

• Effort medium (predefinito consigliato): Il 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 inferiori, il modello limita il proprio lavoro a ciò che è stato richiesto anziché andare oltre. Se osservi un ragionamento superficiale su problemi complessi con Claude Opus 4.7, aumenta effort anziché aggirare il problema tramite prompt. Se devi mantenere effort basso per la latenza, aggiungi indicazioni mirate come "Questa attività richiede ragionamento in più passaggi. Pensa 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 pensare e agire attraverso subagenti 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 pensare e agire attraverso subagenti 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 inferiori 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, pensiero 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

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

print(response.content[0].text)



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 su Claude Fable 5, Claude Mythos 5, Claude Opus 4.8, Claude Mythos Preview, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 e Claude Sonnet 4.6.
• 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 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, semplici attività di classificazione, 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 inferiori tendono a:

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

Livelli di effort più alti possono:

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



Effort con il pensiero esteso

Il parametro effort funziona insieme al pensiero esteso. Il suo comportamento dipende dal modello:

• Claude Fable 5 e Claude Mythos 5 utilizzano il pensiero adattivo, che è sempre attivo (nessuna configurazione thinking richiesta). thinking: {type: "disabled"} viene rifiutato. Effort controlla la profondità del pensiero allo stesso modo di Opus 4.8 e Opus 4.7.
• Claude Opus 4.8 utilizza il pensiero adattivo (thinking: {type: "adaptive"}), dove effort è il controllo consigliato per la profondità del pensiero. Il pensiero esteso manuale (thinking: {type: "enabled", budget_tokens: N}) non è supportato e restituisce un errore 400. Il modello decide quando e quanto pensare in base a ciascuna richiesta, quindi attiva il pensiero solo quando necessario. Con effort high, xhigh e max, Claude pensa quasi sempre in profondità. A livelli inferiori, potrebbe saltare il pensiero per problemi più semplici. Imposta thinking: {type: "adaptive"} per abilitare il pensiero; senza di esso, le richieste vengono eseguite senza pensiero.
• Claude Mythos Preview utilizza il pensiero adattivo per impostazione predefinita (nessuna configurazione thinking richiesta). thinking: {type: "disabled"} viene rifiutato. Effort controlla la profondità del pensiero allo stesso modo di Opus 4.7 e Opus 4.6.
• Claude Opus 4.7 utilizza il pensiero adattivo (thinking: {type: "adaptive"}), dove effort è il controllo consigliato per la profondità del pensiero. Il pensiero esteso manuale (thinking: {type: "enabled", budget_tokens: N}) non è più supportato su Opus 4.7; usa invece il pensiero adattivo con effort. Con effort high, xhigh e max, Claude pensa quasi sempre in profondità. A livelli inferiori, potrebbe saltare il pensiero per problemi più semplici.
• Claude Opus 4.6 utilizza il pensiero adattivo (thinking: {type: "adaptive"}), dove effort è il controllo consigliato per la profondità del pensiero. Sebbene budget_tokens sia ancora accettato su Opus 4.6, è deprecato e verrà rimosso in una futura release. Con effort high e max, Claude pensa quasi sempre in profondità. A livelli inferiori, potrebbe saltare il pensiero per problemi più semplici.
• Claude Sonnet 5 utilizza il pensiero adattivo, che è attivo per impostazione predefinita (nessuna configurazione thinking richiesta), ed effort è il controllo consigliato per la profondità del pensiero. Il pensiero esteso manuale (thinking: {type: "enabled", budget_tokens: N}) non è supportato e restituisce un errore 400. Passa thinking: {type: "disabled"} per disattivare il pensiero. Con effort high (predefinito), xhigh e max, Claude pensa quasi sempre in profondità. A livelli inferiori, potrebbe saltare il pensiero per problemi più semplici.
• Claude Sonnet 4.6 utilizza il pensiero adattivo (dove effort controlla la profondità del pensiero). Il pensiero manuale con modalità interleaved (thinking: {type: "enabled", budget_tokens: N}) è ancora funzionante ma deprecato.
• Claude Opus 4.5 utilizza il pensiero manuale (thinking: {type: "enabled", budget_tokens: N}), dove effort funziona insieme al budget di token per il pensiero. Imposta il livello di effort per la tua attività, quindi imposta il budget di token per il pensiero in base alla complessità dell'attività.

Il parametro effort può essere utilizzato con o senza il pensiero esteso abilitato. Quando utilizzato senza pensiero, controlla comunque la spesa complessiva di token per le risposte testuali e le chiamate agli strumenti.



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 il coding agentico e il ragionamento complesso beneficiano di effort high.



Passaggi successivi