Effort

Il parametro effort ti consente di controllare quanto Claude è disposto a spendere token quando risponde alle richieste. Questo ti dà la possibilità di bilanciare tra la completezza della risposta e l'efficienza dei token, il tutto con un singolo modello. Il parametro effort è generalmente disponibile su tutti i modelli supportati senza richiedere un header beta.

Come funziona effort

Per impostazione predefinita, Claude utilizza high effort, spendendo quanti token necessari per risultati eccellenti. Puoi aumentare il livello di effort a max per la massima capacità assoluta, oppure abbassarlo per essere più conservatore con l'utilizzo dei token, ottimizzando per velocità e costo accettando una riduzione nella capacità.

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

• Risposte di testo e spiegazioni
• Chiamate di strumenti e argomenti di funzioni
• Pensiero esteso (quando abilitato)

Questo approccio ha due vantaggi principali:

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

Livelli di effort

Livelli di effort consigliati per Sonnet 4.6

Sonnet 4.6 ha come impostazione predefinita high effort. Imposta esplicitamente effort quando usi Sonnet 4.6 per evitare latenza inaspettata:

• Medium effort (predefinito consigliato): Miglior equilibrio di velocità, costo e prestazioni per la maggior parte delle applicazioni. Adatto per codifica agentic, flussi di lavoro ricchi di strumenti e generazione di codice.
• Low effort: Per carichi di lavoro ad alto volume o sensibili alla latenza. Adatto per chat e casi d'uso non di codifica dove è prioritario un turnaround più veloce.
• High effort: Per attività che richiedono l'intelligenza massima da Sonnet 4.6.
• Max effort: Per attività che richiedono la capacità assoluta più elevata senza vincoli sulla spesa di token.

Livelli di effort consigliati per Claude Opus 4.7

Inizia con xhigh per casi d'uso di codifica e agentic, 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 i tuoi eval mostrano spazio di manovra misurabile a xhigh.

L'impostazione predefinita dell'API è high. Per usare xhigh, imposta effort esplicitamente; il valore che passi sostituisce l'impostazione predefinita.

Claude Opus 4.7 rispetta anche i livelli di effort più rigorosamente rispetto a Claude Opus 4.6, specialmente a low e medium. A livelli di effort inferiori, il modello circoscrive il suo lavoro a ciò che è stato chiesto piuttosto che andare oltre. Se osservi ragionamento superficiale su problemi complessi con Claude Opus 4.7, aumenta effort piuttosto che cercare di aggirarlo con il prompt. Se devi mantenere effort basso per la latenza, aggiungi una guida mirata come "Questo compito comporta ragionamento multi-step. Pensa attentamente prima di rispondere."

Quando esegui Claude Opus 4.7 a xhigh o max effort, imposta un grande max_tokens in modo che il modello abbia spazio per pensare e agire tra subagent e chiamate di strumenti. Iniziare con 64k token e sintonizzarsi da lì è un'impostazione predefinita ragionevole.

Utilizzo di base

Quando regolare il parametro effort

• Usa max effort quando hai bisogno della capacità assoluta più elevata senza vincoli: il ragionamento più completo e l'analisi più profonda. Disponibile su Claude Mythos Preview, Claude Opus 4.7, Claude Opus 4.6, e Claude Sonnet 4.6.
• Usa xhigh effort per lavoro di codifica avanzato e agentic complesso che richiede esplorazione estesa, come chiamate di strumenti ripetute e ricerca dettagliata. Disponibile su Claude Opus 4.7.
• Usa high effort (l'impostazione predefinita) quando hai bisogno del miglior lavoro di Claude: ragionamento complesso, analisi sfumata, problemi di codifica difficili, o qualsiasi attività dove la qualità è la priorità principale.
• Usa medium effort come opzione equilibrata quando vuoi prestazioni solide senza la piena spesa di token di high effort.
• Usa low effort quando stai ottimizzando per velocità (perché Claude risponde con meno token) o costo. Ad esempio, semplici compiti di classificazione, ricerche rapide, o casi d'uso ad alto volume dove miglioramenti marginali di qualità non giustificano latenza aggiuntiva o spesa.

Effort con l'uso di strumenti

Quando usi strumenti, il parametro effort influisce sia sulle spiegazioni intorno alle chiamate di strumenti che sulle chiamate di strumenti stesse. I livelli di effort inferiori tendono a:

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

I livelli di effort superiori possono:

• Effettuare più chiamate di strumenti
• Spiegare il piano prima di intraprendere un'azione
• Fornire riepiloghi dettagliati dei cambiamenti
• Includere commenti di codice più completi

Effort con il pensiero esteso

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

• Claude Mythos Preview utilizza adaptive thinking per impostazione predefinita (nessuna configurazione thinking richiesta). thinking: {type: "disabled"} è rifiutato. Effort controlla la profondità del pensiero allo stesso modo di Opus 4.7 e Opus 4.6.
• Claude Opus 4.7 utilizza adaptive thinking (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 adaptive thinking con effort. A high, xhigh, e max effort, Claude quasi sempre pensa profondamente. A livelli inferiori, potrebbe saltare il pensiero per problemi più semplici.
• Claude Opus 4.6 utilizza adaptive thinking (thinking: {type: "adaptive"}), dove effort è il controllo consigliato per la profondità del pensiero. Mentre budget_tokens è ancora accettato su Opus 4.6, è deprecato e sarà rimosso in una futura versione. A high e effort, Claude quasi sempre pensa profondamente. A livelli inferiori, potrebbe saltare il pensiero per problemi più semplici.

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

Best practice

1. Imposta effort esplicitamente: L'API ha come impostazione predefinita high, ma il punto di partenza giusto dipende dal tuo modello e dal carico di lavoro.
2. Usa low per attività sensibili alla velocità o semplici: Quando la latenza è importante o i compiti sono semplici, low effort 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 di distribuire.
4. Considera effort dinamico: Regola effort in base alla complessità del compito. Le query semplici potrebbero giustificare low effort mentre la codifica agentic e il ragionamento complesso beneficiano di high effort.