---
title: Effort
url: https://platform.claude.com/docs/it/build-with-claude/effort
description: Controlla quanti token Claude utilizza quando risponde con il parametro effort, bilanciando tra completezza della risposta ed efficienza dei token.
featureMetadata:
  status: stable
  zdr:
    eligibility: eligible
    note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements).
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
  supportedPlatforms:
    Claude API: stable
    Amazon Bedrock: stable
    Amazon Bedrock (bedrock-runtime): stable
    Claude Platform on AWS: stable
    Claude Models on Google Cloud (Anthropic managed): stable
    Claude Models on Google Cloud (Google managed): stable
    Microsoft Foundry: stable
---

**Supporto API**: L’utilizzo varia in base al prodotto.

* **Messages API**: Imposta `output_config.effort` nella richiesta. Senza un valore, si applica il livello predefinito del modello.
* **Managed Agents**: Imposta `effort` nell’oggetto modello dell’agente o nell’override del modello di una sessione. Senza un valore, Managed Agents inserisce il valore predefinito del modello.

Il parametro effort ti permette di controllare quanti token Claude spende quando risponde alle richieste. Puoi bilanciare tra completezza della risposta ed efficienza dei token con un singolo modello.

<Tip>
  Per scoprire come l’effort interagisce con il ragionamento e quale controllo utilizzare, consulta [Ragionamento ed effort](https://platform.claude.com/docs/it/build-with-claude/thinking#thinking-and-effort). Dove il ragionamento adattivo è disponibile, l’effort è il modo consigliato per controllare la profondità del ragionamento.
</Tip>

## Imposta il livello di effort

Imposta `output_config.effort` nella richiesta. L’esempio seguente esegue una richiesta con effort `medium`.

<CodeGroup>
  ```bash cURL
  curl https://api.anthropic.com/v1/messages \
    -H "x-api-key: $ANTHROPIC_API_KEY" \
    -H "anthropic-version: 2026-10-21" \
    -H "content-type: application/json" \
    -d '{
      "model": "claude-opus-5-5",
      "max_tokens": 4096,
      "messages": [{
        "role": "user",
        "content": "Analyze the trade-offs between microservices and monolithic architectures"
      }],
      "output_config": {
        "effort": "medium"
      }
    }'
  ```

  ```bash CLI
  ant messages create \
    --model claude-opus-5-5 \
    --max-tokens 4096 \
    --output-config '{effort: medium}' \
    --message '{role: user, content: "Analyze the trade-offs between microservices and monolithic architectures"}'
  ```

  ```python Python
  client = anthropic.Anthropic()

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

  for block in response.content:
      if block.type == "text":
          print(block.text)
  ```

  ```typescript TypeScript
  const client = new Anthropic();

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

  const textBlock = response.content.find((block) => block.type === "text");
  console.log(textBlock?.text);
  ```

  ```csharp C#
  AnthropicClient client = new();

  var parameters = new MessageCreateParams
  {
      Model = Model.ClaudeOpus5_5,
      MaxTokens = 4096,
      Messages = [
          new UserMessageParam
          {
              Content = "Analyze the trade-offs between microservices and monolithic architectures"
          }
      ],
      OutputConfig = new OutputConfig
      {
          Effort = Effort.Medium
      }
  };

  var message = await client.Messages.Create(parameters);
  foreach (var block in message.Content)
  {
      if (block.TryPickText(out var textBlock))
      {
          Console.WriteLine(textBlock.Text);
      }
  }
  ```

  ```go Go
  client := anthropic.NewClient()

  response, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{
  	Model:     anthropic.ModelClaudeOpus5_5,
  	MaxTokens: 4096,
  	Messages: []anthropic.MessageParam{
  		anthropic.NewUserMessage(anthropic.NewTextBlock("Analyze the trade-offs between microservices and monolithic architectures")),
  	},
  	OutputConfig: anthropic.OutputConfigParam{
  		Effort: anthropic.OutputConfigEffortMedium,
  	},
  })
  if err != nil {
  	log.Fatal(err)
  }
  for _, block := range response.Content {
  	if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok {
  		fmt.Println(textBlock.Text)
  	}
  }
  ```

  ```java Java
  import com.anthropic.models.messages.OutputConfig;

  void main() {
      AnthropicClient client = AnthropicOkHttpClient.fromEnv();

      MessageCreateParams params = MessageCreateParams.builder()
          .model(Model.CLAUDE_OPUS_5_5)
          .maxTokens(4096L)
          .addUserMessage("Analyze the trade-offs between microservices and monolithic architectures")
          .outputConfig(OutputConfig.builder()
              .effort(OutputConfig.Effort.MEDIUM)
              .build())
          .build();

      Message response = client.messages().create(params);
      response.content().stream()
          .flatMap(block -> block.text().stream())
          .forEach(textBlock -> IO.println(textBlock.text()));
  }
  ```

  ```php PHP
  use Anthropic\Client;
  use Anthropic\Messages\Model;
  use Anthropic\Messages\TextBlock;

  $client = new Client();

  $message = $client->messages->create(
      maxTokens: 4096,
      messages: [
          ['role' => 'user', 'content' => 'Analyze the trade-offs between microservices and monolithic architectures']
      ],
      model: Model::CLAUDE_OPUS_5_5,
      outputConfig: ['effort' => 'medium'],
  );

  foreach ($message->content as $block) {
      if ($block instanceof TextBlock) {
          echo $block->text, PHP_EOL;
      }
  }
  ```

  ```ruby Ruby
  client = Anthropic::Client.new

  message = client.messages.create(
    model: Anthropic::Model::CLAUDE_OPUS_5_5,
    max_tokens: 4096,
    messages: [
      { role: "user", content: "Analyze the trade-offs between microservices and monolithic architectures" }
    ],
    output_config: {
      effort: "medium"
    }
  )

  message.content.each do |block|
    case block
    when Anthropic::Models::TextBlock
      puts block.text
    end
  end
  ```
</CodeGroup>

## Come funziona l’effort

La maggior parte dei modelli Claude usa per impostazione predefinita un effort alto, spendendo tutti i token necessari per ottenere risultati eccellenti; Claude Opus 5.5 e Claude Haiku 5.5 usano per impostazione predefinita medium. Puoi aumentare il livello di effort a `max` per ottenere la massima capacità in assoluto, oppure abbassarlo per essere più parsimonioso nell’uso dei token, ottimizzando velocità e costi a fronte di una certa riduzione delle capacità.

<Tip>
  Impostare `effort` sul valore predefinito del modello (`"medium"` su Claude Opus 5.5 e Claude Haiku 5.5, `"high"` sugli altri modelli) produce esattamente lo stesso comportamento dell’omissione completa del parametro `effort`.
</Tip>

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

* Risposte testuali e spiegazioni
* Chiamate agli strumenti e argomenti delle funzioni
* Ragionamento (quando attivo)

Poiché l’effort si applica a ogni token di output, funziona con o senza ragionamento. Un effort più basso significa anche chiamate agli strumenti meno numerose e più concise.

### Livelli di effort

| Livello | Descrizione | Caso d’uso tipico |
| ----- | ----- | ----- |
| `max` | Capacità massima in assoluto, senza vincoli sulla spesa di token. Disponibile su Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5, Claude Mythos Preview, 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 e Claude Haiku 5.5. | Attività che richiedono il ragionamento più profondo possibile e l’analisi più approfondita |
| `xhigh` | Capacità estesa per lavori di lungo periodo. Disponibile su Claude Fable 5.2, Claude Mythos 5.2, 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 Sonnet 5.5, Claude Sonnet 5 e Claude Haiku 5.5. | Attività agentiche e di programmazione di lunga durata (oltre 30 minuti) con budget di token nell’ordine dei milioni |
| `high` | Spende tutti i token necessari all’attività per ottenere risultati eccellenti. Il valore predefinito su ogni modello che supporta l’effort, eccetto Claude Opus 5.5 e Claude Haiku 5.5. | Ragionamento complesso, problemi di programmazione difficili, attività agentiche |
| `medium` | Approccio bilanciato con un moderato risparmio di token. Il valore predefinito su Claude Opus 5.5 e Claude Haiku 5.5. | Attività agentiche che richiedono un equilibrio tra velocità, costi e prestazioni |
| `low` | Il più efficiente. Risparmio significativo di token con una certa riduzione delle capacità. | Attività più semplici che richiedono la massima velocità e i costi più bassi, come i subagenti |

Non tutti i modelli che supportano `max` supportano `xhigh`.

<Note>
  L’effort è un segnale comportamentale, non un budget di token rigido. A livelli di effort più bassi, Claude ragiona comunque su problemi sufficientemente difficili, ma ragiona meno di quanto farebbe a livelli di effort più alti per lo stesso problema.
</Note>

Le raccomandazioni per modello che seguono prevalgono su questa tabella laddove differiscono.

## Livelli di effort consigliati

**[Claude Fable 5.2](https://platform.claude.com/docs/it/models/fable-5-2/overview) & [Claude Mythos 5.2](https://platform.claude.com/docs/it/models/mythos-5-2/overview)** — *For demanding reasoning and long-horizon agentic work*

Claude Fable 5.2 supporta tutti e cinque i livelli di effort. Il valore predefinito dell’API è `high`. Il ragionamento adattivo è sempre attivo, quindi l’effort è il tuo controllo principale per la profondità del ragionamento, la latenza e il costo.

Inizia con `high`. La maggior parte del guadagno in capacità è già presente a `high`, e al di sopra, i guadagni sono disomogenei e dipendono dall’attività. Passa a `xhigh` per il tuo lavoro di programmazione e agentico di lunga durata più difficile, dove hai misurato un guadagno. Scendi a `medium` o `low` dove le tue valutazioni mostrano che la qualità si mantiene. Riserva `max` per misurare il limite massimo del modello e per le rare attività in cui tempo e token non contano. A `max` il modello ottimizza le capacità senza riguardo per il costo dei token. È più lento e costa di più rispetto a `xhigh`, spesso per un guadagno solo modesto.

Esegui un’analisi comparativa dei livelli di effort sulle tue valutazioni anziché riportare le impostazioni da Claude Fable 5.1. A `high` e livelli superiori, imposta un valore elevato di `max_tokens`. È un limite rigido sull’output totale (ragionamento più testo della risposta). L’effort modifica appena la lunghezza delle risposte del modello, quindi usa il prompt per modificare la lunghezza e il tono delle risposte.

Le stesse raccomandazioni si applicano a Claude Mythos 5.2.

Sulle [piattaforme supportate](https://platform.claude.com/docs/it/build-with-claude/effort-per-message#feature-availability), Claude Fable 5.2 e Claude Mythos 5.2 supportano anche la [modifica dell’effort a metà conversazione](https://platform.claude.com/docs/it/build-with-claude/effort-per-message) con un `output_config` per singolo messaggio, che preserva la cache dei prompt.

See also: [Prompting per Claude Fable 5.2](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#calibrate-effort)

**[Claude Opus 5.5](https://platform.claude.com/docs/it/models/opus-5-5/overview)** — *For long-running agentic coding and knowledge work*

Claude Opus 5.5 supporta tutti e cinque i livelli di effort, e `medium` è il valore predefinito. Claude Opus 5 e i modelli Opus precedenti usano `high` come predefinito, quindi una richiesta che omette `effort` viene eseguita un livello più in basso su Claude Opus 5.5.

Il ragionamento adattivo è sempre attivo e non può essere disattivato, quindi l’effort è il controllo principale per quanto il modello ragiona e quanto costa una richiesta. Le richieste che impostano `thinking: {"type": "disabled"}` restituiscono un errore 400 a qualsiasi livello di effort.

Esegui un’analisi comparativa dei livelli di effort sulle tue valutazioni anziché riportare le impostazioni da un modello precedente. A `xhigh` o `max`, imposta un valore elevato di `max_tokens`. È un limite rigido sull’output totale (ragionamento più testo della risposta).

Claude Opus 5.5 supporta anche la [modifica dell’effort a metà conversazione](https://platform.claude.com/docs/it/build-with-claude/effort-per-message) con un `output_config` per singolo messaggio, che preserva la cache dei prompt.

See also: [Prompting per Claude Opus 5.5](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-opus-5-5)

**[Claude Sonnet 5.5](https://platform.claude.com/docs/it/models/sonnet-5-5/overview)** — *The best combination of speed and intelligence*

Claude Sonnet 5.5 supporta tutti e cinque i livelli di effort, e `high` è il valore predefinito sulla Claude API. I suoi livelli sono calibrati in modo diverso, quindi un livello non produce la stessa quantità di ragionamento che su Claude Sonnet 5. Esegui una nuova analisi comparativa dei livelli di effort sulle tue valutazioni anziché riportare l’impostazione usata su Claude Sonnet 5.

Inizia con `high` a meno che il tuo carico di lavoro non sia agentico o sensibile alla latenza. Per la programmazione agentica e l’uso degli strumenti in più passaggi, inizia con `medium` per attività ben specificate e passa a `high` per quelle più difficili o più lunghe. Per la chat e altri lavori sensibili alla latenza, inizia con `medium` o `low`. Usa `xhigh` o `max` solo dove le tue valutazioni mostrano un guadagno di qualità.

Imposta `max_tokens` lasciando spazio per il ragionamento e la risposta. Il ragionamento viene conteggiato in `max_tokens` anche quando il contenuto del ragionamento non viene restituito. Per la programmazione agentica, imposta `max_tokens` a 128.000, il massimo del modello, e usa lo streaming per la risposta (consulta [Messaggi in streaming](https://platform.claude.com/docs/it/build-with-claude/streaming)).

Per far rispondere il modello senza ragionare prima, invia `thinking: {"type": "between_tools"}`, non `"disabled"`. Funziona con effort `low`, `medium` e `high`. A `xhigh` o `max` restituisce un errore 400, quindi usa il ragionamento adattivo, il valore predefinito, a quei livelli. Consulta [Esecuzione senza ragionamento iniziale](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5#running-without-up-front-thinking).

Sulle [piattaforme supportate](https://platform.claude.com/docs/it/build-with-claude/effort-per-message#feature-availability), Claude Sonnet 5.5 supporta anche la [modifica dell’effort a metà conversazione](https://platform.claude.com/docs/it/build-with-claude/effort-per-message) con un `output_config` per singolo messaggio, che preserva la cache dei prompt. Con `between_tools`, l’effort non può cambiare a metà conversazione: un `output_config.effort` per singolo messaggio a un livello diverso restituisce un errore 400. Per variare l’effort a ogni turno, usa il ragionamento adattivo.

See also: [Prompting per Claude Sonnet 5.5](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5#calibrate-effort)

**[Claude Haiku 5.5](https://platform.claude.com/docs/it/models/haiku-5-5/overview)** — *For high-volume, latency-sensitive tasks such as classification, extraction, and routing*

Claude Haiku 5.5 supporta tutti e cinque i livelli di effort, e `medium` è il valore predefinito. L’effort è il controllo principale per quanto il modello ragiona e, di conseguenza, per qualità, latenza e costo. **Inizia con `medium`** per la maggior parte del lavoro, inclusa la programmazione agentica. Usa `low`, il livello più economico e veloce, per la chat, brevi attività con strumenti e richieste semplici ad alto volume. Nei prompt di agenti lunghi, a `low` è più probabile che il modello salti una ricerca, si fermi in anticipo o salti un controllo. Usa `high` per il lavoro di conoscenza, attività di agenti più lunghe e il rispetto rigoroso delle istruzioni. Usa `xhigh` o `max` solo dove le tue valutazioni mostrano un guadagno di qualità, e confrontali con Claude Sonnet 5.5 in termini di prestazioni, costo e velocità. Il ragionamento è attivo per impostazione predefinita e viene conteggiato in `max_tokens`, quindi lascia spazio per esso.

Per ottenere meno ragionamento, abbassa il livello di effort. Puoi anche inviare `thinking: {"type": "disabled"}` con effort `high` o inferiore. A `xhigh` o `max`, restituisce un errore 400, quindi usa il ragionamento adattivo in quei casi: ometti il campo `thinking` o invia `thinking: {"type": "adaptive"}`.

Sulle [piattaforme supportate](https://platform.claude.com/docs/it/build-with-claude/effort-per-message#feature-availability), Claude Haiku 5.5 ti consente anche di [modificare l’effort a metà conversazione](https://platform.claude.com/docs/it/build-with-claude/effort-per-message) con un `output_config` per singolo messaggio, che preserva la cache dei prompt. Con `thinking: {"type": "disabled"}`, l’effort non può cambiare a metà conversazione: un `output_config.effort` per singolo messaggio a un livello diverso restituisce un errore 400. Per variare l’effort a ogni turno, usa il ragionamento adattivo.

See also: [Prompting per Claude Haiku 5.5](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#use-effort-to-control-thinking)

**[Claude Fable 5.1](https://platform.claude.com/docs/it/models/fable-5-1/overview) & [Claude Mythos 5.1](https://platform.claude.com/docs/it/models/mythos-5-1/overview)**

Claude Fable 5.1 supporta tutti e cinque i livelli di “effort” (impegno). **Inizia con `high`, il valore predefinito.** Passa a `xhigh` o `max` per il lavoro agentico e di programmazione più sensibile alle capacità, e scendi a `medium` o `low` per il lavoro di routine o sensibile alla latenza una volta che le tue valutazioni mostrano che la qualità si mantiene. A `high` e livelli superiori, imposta un valore elevato di `max_tokens`. È un limite rigido sull’output totale (ragionamento più testo della risposta).

Claude Fable 5.1 supporta anche la [modifica dell’effort a metà conversazione](https://platform.claude.com/docs/it/build-with-claude/effort-per-message) con un `output_config` per singolo messaggio, che preserva la cache dei prompt.

See also: [Prompting per Claude Fable 5.1](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-fable-5-1#consider-all-effort-levels)

**[Claude Fable 5](https://platform.claude.com/docs/it/models/fable-5/overview) & [Claude Mythos 5](https://platform.claude.com/docs/it/models/mythos-5/overview)**

L’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 il lavoro 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 valore elevato di `max_tokens`. È un limite rigido sull’output totale (ragionamento più testo della risposta). Consulta [Controllo dei costi](https://platform.claude.com/docs/it/build-with-claude/thinking-steering-and-cost#cost-control).

Riduci l’effort se un’attività viene completata ma richiede più tempo del necessario, o se desideri uno stile di lavoro più rapido e interattivo.

See also: [Prompting per Claude Fable 5](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-fable-5)

**[Claude Opus 5](https://platform.claude.com/docs/it/models/opus-5/overview)**

Claude Opus 5 supporta tutti e cinque i livelli di effort. **Inizia con `high`, il valore predefinito**, e regola in base alle tue valutazioni: passa a `xhigh` per il lavoro di programmazione e agentico impegnativo, o a `max` quando un’attività giustifica una spesa di token senza vincoli. 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 comparativa dei livelli di effort sulle tue valutazioni anziché riutilizzarle.

L’effort controlla la quantità di ragionamento, non la lunghezza visibile della risposta: su Claude Opus 5, modificare l’effort non accorcia in modo affidabile le risposte, quindi [specifica la lunghezza nel prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-opus-5#response-length-and-verbosity).

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 ragionamento non può essere disattivato con effort `xhigh` o `max`: le richieste che impostano `thinking: {"type": "disabled"}` a quei livelli restituiscono un errore 400. Consulta [Effort con il ragionamento](https://platform.claude.com/docs/it/build-with-claude/effort#effort-with-thinking).

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

Sulle [piattaforme supportate](https://platform.claude.com/docs/it/build-with-claude/effort-per-message#feature-availability), Claude Opus 5 supporta anche la [modifica dell’effort a metà conversazione](https://platform.claude.com/docs/it/build-with-claude/effort-per-message) con un `output_config` per singolo messaggio, che preserva la cache dei prompt.

See also: [Prompting per Claude Opus 5](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-opus-5)

**[Claude Opus 4.8](https://platform.claude.com/docs/it/models/opus-4-8/overview)**

Le indicazioni per Claude Opus 4.7 si applicano anche a Claude Opus 4.8. **Inizia con `xhigh` per i casi d’uso di programmazione 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 misurato che il livello inferiore mantiene la qualità sulle 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 valore elevato di `max_tokens` in modo che il modello abbia spazio per ragionare e agire attraverso subagenti e chiamate agli strumenti. Iniziare con 64k token e regolare a partire da lì è un valore predefinito ragionevole.

See also: [Prompting per Claude Opus 4.8](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-opus-4-8)

**[Claude Opus 4.7](https://platform.claude.com/docs/it/models/opus-4-7/overview)**

**Inizia con `xhigh` per i casi d’uso di programmazione e agentici**, e usa `high` come minimo per la maggior parte dei carichi di lavoro sensibili all’intelligenza. Scendi a `medium` per i carichi di lavoro sensibili ai costi, o sali a `max` solo quando le tue valutazioni mostrano un margine di miglioramento misurabile rispetto a `xhigh`.

Il valore predefinito dell’API è `high`. Per usare `xhigh`, imposta `effort` esplicitamente. Il valore che passi sovrascrive quello predefinito.

* **Effort basso:** Efficiente, ma più adatto ad attività brevi e circoscritte. Abbina `low` a checklist esplicite se la tua attività ha più sezioni.
* **Effort medio:** L’impostazione per il flusso di lavoro medio in cui desideri buoni risultati riducendo i costi.
* **Effort alto:** Casi d’uso avanzati che richiedono comunque un equilibrio tra intelligenza e consumo di token. Questo è spesso il miglior equilibrio tra qualità ed efficienza dei token.
* **Effort xhigh:** Il punto di partenza consigliato per il lavoro di programmazione e agentico, e per attività esplorative come chiamate ripetute agli strumenti, ricerche web dettagliate e ricerche in basi di conoscenza. Prevedi un utilizzo di token significativamente più elevato rispetto a `high`.
* **Effort massimo:** Riservalo ai problemi di frontiera. Sulla maggior parte dei carichi di lavoro `max` aggiunge un costo significativo per guadagni di qualità relativamente piccoli, e su alcune attività con output strutturato o meno sensibili all’intelligenza può portare a un eccesso di ragionamento.

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 quanto richiesto anziché fare più del necessario. Se osservi un ragionamento superficiale su problemi complessi con Claude Opus 4.7, aumenta l’effort anziché aggirare il problema tramite il prompt. Se devi mantenere l’effort basso per motivi di latenza, aggiungi indicazioni mirate come “This task involves multistep reasoning. Think carefully before responding.”

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

See also: [Best practice per il prompting](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/claude-prompting-best-practices)

**[Claude Sonnet 5](https://platform.claude.com/docs/it/models/sonnet-5/overview)**

Claude Sonnet 5 usa come predefinito l’effort `high` sulla Claude API e su Claude Code.

* **Effort alto (predefinito):** Adatto a ragionamenti complessi, programmazione e attività agentiche in cui la qualità conta più della velocità o del costo.
* **Effort xhigh:** Per le attività di programmazione e agentiche più difficili.
* **Effort medio:** Un passo indietro rispetto al predefinito per risparmiare sui costi. Paragonabile a Claude Sonnet 4.6 con effort alto.
* **Effort basso:** Per carichi di lavoro ad alto volume o sensibili alla latenza. Adatto alla chat e a casi d’uso non legati alla programmazione in cui si privilegiano tempi di risposta più rapidi.
* **Effort massimo:** Per attività che richiedono le capacità in assoluto più elevate senza vincoli sulla spesa di token.

See also: [Prompting per Claude Sonnet 5](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-sonnet-5#calibrating-effort-and-thinking-depth)

**[Claude Sonnet 4.6](https://platform.claude.com/docs/it/models/sonnet-4-6/overview)**

Claude Sonnet 4.6 usa come predefinito l’effort `high`. Imposta esplicitamente l’effort per evitare latenze impreviste:

* **Effort medio (consigliato):** Il miglior equilibrio tra velocità, costo e prestazioni per la maggior parte delle applicazioni. Adatto alla programmazione agentica, ai flussi di lavoro con uso intensivo di strumenti e alla generazione di codice.
* **Effort basso:** Per carichi di lavoro ad alto volume o sensibili alla latenza. Adatto alla chat e a casi d’uso non legati alla programmazione in cui si privilegiano tempi di risposta più rapidi.
* **Effort alto:** Per ragionamenti complessi e attività in cui la qualità conta più della velocità o del costo.
* **Effort massimo:** Per attività che richiedono le capacità in assoluto più elevate senza vincoli sulla spesa di token.

See also: [Best practice per il prompting](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/claude-prompting-best-practices)

## Effort con l’uso degli strumenti

Quando si usano gli strumenti, il parametro effort influisce sia sulle spiegazioni attorno alle chiamate agli strumenti sia sulle chiamate stesse. I 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

I 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 il ragionamento

Il parametro `thinking` controlla se Claude riflette in [blocchi di ragionamento](https://platform.claude.com/docs/it/build-with-claude/thinking) prima di rispondere; il parametro `effort` controlla quanto lavoro Claude dedica all’intera risposta, il che in modalità adattiva include quanto spesso e quanto profondamente riflette. Non passare `adaptive` come valore di `effort`: `adaptive` è una modalità di ragionamento, non un livello di effort.

A livelli di effort più alti, Claude ragiona più prontamente e più a lungo. In un ciclo di uso degli strumenti, le richieste successive che elaborano solo i risultati degli strumenti possono comunque saltare il ragionamento a qualsiasi livello. A livelli più bassi, Claude può saltare del tutto il ragionamento per i problemi più semplici. Consulta [Ragionamento ed effort](https://platform.claude.com/docs/it/build-with-claude/thinking#thinking-and-effort) per indicazioni complete su come i due controlli funzionano insieme.

Su Claude Opus 4.5, l’unico modello con solo ragionamento esteso che supporta l’effort, questo funziona insieme a [`budget_tokens`](https://platform.claude.com/docs/it/build-with-claude/extended-thinking): imposta il livello di effort per la tua attività, poi imposta il budget di token per il ragionamento in base alla profondità di ragionamento di cui l’attività ha bisogno.

Per la disponibilità del ragionamento per modello, consulta la [tabella di configurazione per modello](https://platform.claude.com/docs/it/build-with-claude/thinking-troubleshooting#supported-models). L’effort funziona con o senza ragionamento. Consulta [Come funziona l’effort](https://platform.claude.com/docs/it/build-with-claude/effort#how-effort-works).

## Modificare l’effort a metà conversazione

Puoi eseguire i turni successivi di una conversazione a un livello di effort diverso in due modi. Una modifica dell’effort per messaggio mantiene la cache dei prompt. Un nuovo valore di primo livello nella richiesta successiva può invalidare in tutto o in parte la cache dei prompt.

### Effort per messaggio

L’[effort per messaggio](https://platform.claude.com/docs/it/build-with-claude/effort-per-message) imposta un nuovo livello con un messaggio `system` in `messages`.

### Effort di primo livello nella richiesta successiva

L’`output_config.effort` di primo livello si applica all’intera richiesta. Per eseguire una parte successiva di una conversazione a un livello diverso, imposta il nuovo valore nella richiesta successiva. Poiché l’effort di primo livello modella il prompt renderizzato, modificarlo tra una richiesta e l’altra può invalidare i prefissi in cache dei turni precedenti. Se fai affidamento sulla [cache dei prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-caching) in una sessione lunga e il tuo modello non supporta l’effort per messaggio, scegli un livello di effort all’inizio e mantienilo costante.

## Best practice

1. **Imposta l’effort esplicitamente:** L’API usa per impostazione predefinita `high` (`medium` su Claude Opus 5.5 e Claude Haiku 5.5), ma il punto di partenza giusto dipende dal tuo modello e dal tuo carico di lavoro.
2. **Usa low per attività sensibili alla velocità o semplici:** Quando la latenza è importante o le attività sono semplici, un effort basso 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 del deployment.
4. **Considera un effort dinamico:** Regola l’effort in base alla complessità dell’attività. Le query semplici possono giustificare un effort basso, mentre la programmazione agentica e il ragionamento complesso traggono vantaggio da un effort alto. Consulta il punto successivo prima di variarlo all’interno di una conversazione.
5. **Mantieni costante l’effort di primo livello nelle conversazioni con cache:** Modificare il valore di effort di primo livello tra una richiesta e l’altra può invalidare in tutto o in parte la [cache dei prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-caching), quindi varialo tra carichi di lavoro diversi piuttosto che all’interno di una conversazione che fa affidamento sugli hit della cache. Sui modelli che la supportano, usa invece una modifica dell’[effort per messaggio](https://platform.claude.com/docs/it/build-with-claude/effort-per-message), che preserva la cache. Consulta [Ragionamento e cache dei prompt](https://platform.claude.com/docs/it/build-with-claude/thinking#thinking-and-prompt-caching).

## Passaggi successivi

<CardGroup>
  <Card title="Budget delle attività" icon="gauge" href="https://platform.claude.com/docs/it/build-with-claude/task-budgets">
    Fornisci a Claude un budget di token indicativo per l’intero ciclo agentico, per aiutare il modello ad autoregolarsi nelle attività agentiche lunghe.
  </Card>

  <Card title="Orientare il ragionamento" icon="compass" href="https://platform.claude.com/docs/it/build-with-claude/thinking-steering-and-cost">
    Comprendi il ragionamento adattivo, in cui Claude determina quando e quanto ragionare, e orientalo con l’effort e il prompting.
  </Card>

  <Card title="Ragionamento" icon="brain" href="https://platform.claude.com/docs/it/build-with-claude/thinking">
    Comprendi come funziona il ragionamento, quando Claude ragiona per impostazione predefinita e come il ragionamento interagisce con l’effort.
  </Card>
</CardGroup>

## Disponibilità

La funzionalità Effort è disponibile su alcuni modelli e idonea per conservazione zero dei dati e preparazione HIPAA.

### Supporto API

#### [Messages API](https://platform.claude.com/docs/it/build-with-claude/working-with-messages)

* Disponibilità: Sempre attivo
* Utilizzo: Imposta `output_config.effort` nella richiesta. Senza un valore, si applica il livello predefinito del modello.

| Stato | Piattaforme cloud | Modelli |
| ----- | ----- | ----- |
| Disponibile | Tutte le piattaforme supportate | [Claude Fable 5.2](https://platform.claude.com/docs/it/models/fable-5-2/overview), [Claude Mythos 5.2](https://platform.claude.com/docs/it/models/mythos-5-2/overview), [Claude Fable 5.1](https://platform.claude.com/docs/it/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/it/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/it/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/it/models/mythos-5/overview), Claude Mythos Preview, [Claude Opus 5.5](https://platform.claude.com/docs/it/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/it/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/it/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/it/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/it/models/haiku-5-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/it/models/opus-4-8/overview), [Claude Opus 4.7](https://platform.claude.com/docs/it/models/opus-4-7/overview), [Claude Opus 4.6](https://platform.claude.com/docs/it/models/opus-4-6/overview), [Claude Sonnet 4.6](https://platform.claude.com/docs/it/models/sonnet-4-6/overview), [Claude Opus 4.5](https://platform.claude.com/docs/it/models/opus-4-5/overview) |

#### [Managed Agents](https://platform.claude.com/docs/it/managed-agents/overview)

* Disponibilità: Sempre attivo
* Utilizzo: Imposta `effort` nell’oggetto modello dell’agente o nell’override del modello di una sessione. Senza un valore, Managed Agents inserisce il valore predefinito del modello.

| Stato | Piattaforme cloud | Modelli |
| ----- | ----- | ----- |
| Disponibile | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws) | [Claude Fable 5.2](https://platform.claude.com/docs/it/models/fable-5-2/overview), [Claude Mythos 5.2](https://platform.claude.com/docs/it/models/mythos-5-2/overview), [Claude Fable 5.1](https://platform.claude.com/docs/it/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/it/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/it/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/it/models/mythos-5/overview), Claude Mythos Preview, [Claude Opus 5.5](https://platform.claude.com/docs/it/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/it/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/it/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/it/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/it/models/haiku-5-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/it/models/opus-4-8/overview), [Claude Opus 4.7](https://platform.claude.com/docs/it/models/opus-4-7/overview), [Claude Opus 4.6](https://platform.claude.com/docs/it/models/opus-4-6/overview), [Claude Sonnet 4.6](https://platform.claude.com/docs/it/models/sonnet-4-6/overview), [Claude Opus 4.5](https://platform.claude.com/docs/it/models/opus-4-5/overview) |
| Disponibile | [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [Claude Fable 5.2](https://platform.claude.com/docs/it/models/fable-5-2/overview), [Claude Mythos 5.2](https://platform.claude.com/docs/it/models/mythos-5-2/overview), [Claude Fable 5.1](https://platform.claude.com/docs/it/models/fable-5-1/overview), [Claude Mythos 5.1](https://platform.claude.com/docs/it/models/mythos-5-1/overview), [Claude Fable 5](https://platform.claude.com/docs/it/models/fable-5/overview), [Claude Mythos 5](https://platform.claude.com/docs/it/models/mythos-5/overview), [Claude Opus 5.5](https://platform.claude.com/docs/it/models/opus-5-5/overview), [Claude Opus 5](https://platform.claude.com/docs/it/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/it/models/sonnet-5-5/overview), [Claude Sonnet 5](https://platform.claude.com/docs/it/models/sonnet-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/it/models/haiku-5-5/overview), [Claude Opus 4.8](https://platform.claude.com/docs/it/models/opus-4-8/overview), [Claude Opus 4.7](https://platform.claude.com/docs/it/models/opus-4-7/overview), [Claude Opus 4.6](https://platform.claude.com/docs/it/models/opus-4-6/overview), [Claude Sonnet 4.6](https://platform.claude.com/docs/it/models/sonnet-4-6/overview), [Claude Opus 4.5](https://platform.claude.com/docs/it/models/opus-4-5/overview) |

### Gestione dei dati

[Panoramica sulla gestione dei dati](https://platform.claude.com/docs/it/manage-claude/api-and-data-retention#feature-eligibility)

| Elemento | Conservazione zero dei dati | HIPAA |
| ----- | ----- | ----- |
| Stato | Idoneo (esclude [Modelli coperti](https://platform.claude.com/docs/it/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Idoneo |

Endpoint applicabili:

* `/v1/messages` con `effort`
