---
title: Esforço por mensagem
url: https://platform.claude.com/docs/pt-BR/build-with-claude/effort-per-message
description: Use uma mensagem do sistema para alterar o nível de effort no meio de uma conversa e manter o cache de prompt.
featureMetadata:
  status: beta
  betaHeader: mid-conversation-output-config-2026-07-01
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-haiku-5-5
  supportedPlatforms:
    Claude API: beta
    Amazon Bedrock: beta
    Amazon Bedrock (bedrock-runtime):
      availability: beta
      note: Envie o valor beta no array `anthropic_beta` do corpo da requisição.
    Claude Platform on AWS: beta
    Claude Models on Google Cloud (Anthropic managed): beta
    Claude Models on Google Cloud (Google managed): beta
    Microsoft Foundry: beta
---

Uma alteração de “effort” (esforço) por mensagem define um novo nível de effort para os turnos posteriores de uma conversa sem alterar o valor de nível superior da solicitação, de modo que o prefixo em cache ainda corresponde.

## Alterar o nível de esforço

Para alterar o nível no meio de uma conversa:

1. Adicione uma mensagem `role: "system"` a `messages`, com `content` vazio e o novo nível de [effort](https://platform.claude.com/docs/pt-BR/build-with-claude/effort) em `output_config.effort`.
2. Envie o [cabeçalho beta](https://platform.claude.com/docs/pt-BR/api/beta-headers) `mid-conversation-output-config-2026-07-01`.
3. Deixe o valor de nível superior inalterado.

O exemplo a seguir mantém o valor de nível superior em `high` e reduz para `low` em um acompanhamento rotineiro:

<CodeGroup>
  ```bash cURL
  # Mensagem do sistema só de esforço: o novo nível vale a partir do próximo turno do usuário.
  curl https://api.anthropic.com/v1/messages \
    -H "x-api-key: $ANTHROPIC_API_KEY" \
    -H "anthropic-version: 2026-10-21" \
    -H "anthropic-beta: mid-conversation-output-config-2026-07-01" \
    -H "content-type: application/json" \
    -d '{
      "model": "claude-fable-5-1",
      "max_tokens": 4096,
      "output_config": {"effort": "high"},
      "messages": [
        {"role": "user", "content": "Plan a migration from SQLite to PostgreSQL in three short steps."},
        {"role": "assistant", "content": "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts."},
        {"role": "system", "content": [], "output_config": {"effort": "low"}},
        {"role": "user", "content": "Summarize the plan in one sentence."}
      ]
    }'
  ```

  ```bash CLI
  ant beta:messages create \
    --beta mid-conversation-output-config-2026-07-01 <<'YAML'
  model: claude-fable-5-1
  max_tokens: 4096
  output_config:
    effort: high
  messages:
    - role: user
      content: Plan a migration from SQLite to PostgreSQL in three short steps.
    - role: assistant
      content: "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts."
    # Mensagem do sistema só de esforço: o novo nível vale a partir do próximo turno do usuário.
    - role: system
      content: []
      output_config:
        effort: low
    - role: user
      content: Summarize the plan in one sentence.
  YAML
  ```

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

  response = client.beta.messages.create(
      model="claude-fable-5-1",
      max_tokens=4096,
      output_config={"effort": "high"},
      messages=[
          {
              "role": "user",
              "content": "Plan a migration from SQLite to PostgreSQL in three short steps.",
          },
          {
              "role": "assistant",
              "content": "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts.",
          },
          # Mensagem do sistema só de esforço: o novo nível vale a partir do próximo turno do usuário.
          {"role": "system", "content": [], "output_config": {"effort": "low"}},
          {"role": "user", "content": "Summarize the plan in one sentence."},
      ],
      betas=["mid-conversation-output-config-2026-07-01"],
  )

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

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

  const response = await client.beta.messages.create({
    model: "claude-fable-5-1",
    max_tokens: 4096,
    output_config: { effort: "high" },
    messages: [
      {
        role: "user",
        content: "Plan a migration from SQLite to PostgreSQL in three short steps."
      },
      {
        role: "assistant",
        content:
          "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts."
      },
      // Mensagem do sistema só de esforço: o novo nível vale a partir do próximo turno do usuário.
      { role: "system", content: [], output_config: { effort: "low" } },
      { role: "user", content: "Summarize the plan in one sentence." }
    ],
    betas: ["mid-conversation-output-config-2026-07-01"]
  });

  for (const block of response.content) {
    if (block.type === "text") {
      console.log(block.text);
    }
  }
  ```

  ```csharp C#
  using Anthropic.Models.Beta;
  using Anthropic.Models.Beta.Messages;
  using Model = Anthropic.Models.Messages.Model;

  AnthropicClient client = new();

  var response = await client.Beta.Messages.Create(new MessageCreateParams
  {
      Model = Model.ClaudeFable5_1,
      MaxTokens = 4096,
      OutputConfig = new() { Effort = Effort.High },
      Messages =
      [
          new BetaUserMessageParam { Content = "Plan a migration from SQLite to PostgreSQL in three short steps." },
          new BetaAssistantMessageParam { Content = "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts." },
          // Mensagem do sistema apenas de esforço: o novo nível entra em vigor a partir do próximo turno do usuário.
          new BetaSystemMessageParam
          {
              Content = new([]),
              OutputConfig = new() { Effort = BetaSystemMessageOutputConfigEffort.Low },
          },
          new BetaUserMessageParam { Content = "Summarize the plan in one sentence." },
      ],
      Betas = [AnthropicBeta.MidConversationOutputConfig2026_07_01],
  });

  foreach (var block in response.Content)
  {
      if (block.TryPickText(out var textBlock))
      {
          Console.WriteLine(textBlock.Text);
      }
  }
  ```

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

  response, err := client.Beta.Messages.New(context.Background(), anthropic.BetaMessageNewParams{
  	Model:     anthropic.ModelClaudeFable5_1,
  	MaxTokens: 4096,
  	OutputConfig: anthropic.BetaOutputConfigParam{
  		Effort: anthropic.BetaOutputConfigEffortHigh,
  	},
  	Messages: []anthropic.BetaMessageParam{
  		anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Plan a migration from SQLite to PostgreSQL in three short steps.")),
  		{OfAssistant: &anthropic.BetaAssistantMessageParam{
  			Content: []anthropic.BetaContentBlockParamUnion{anthropic.NewBetaTextBlock("1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts.")},
  		}},
  		// Mensagem do sistema apenas de esforço: o novo nível vale a partir do próximo turno do usuário.
  		anthropic.NewBetaSystemMessage(anthropic.BetaSystemMessageOutputConfigParam{
  			Effort: anthropic.BetaSystemMessageOutputConfigEffortLow,
  		}),
  		anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Summarize the plan in one sentence.")),
  	},
  	Betas: []anthropic.AnthropicBeta{anthropic.AnthropicBetaMidConversationOutputConfig2026_07_01},
  })
  if err != nil {
  	log.Fatal(err)
  }

  for _, block := range response.Content {
  	if textBlock, ok := block.AsAny().(anthropic.BetaTextBlock); ok {
  		fmt.Println(textBlock.Text)
  	}
  }
  ```

  ```java Java
  import com.anthropic.models.beta.AnthropicBeta;
  import com.anthropic.models.beta.messages.BetaMessage;
  import com.anthropic.models.beta.messages.BetaOutputConfig;
  import com.anthropic.models.beta.messages.BetaSystemMessageOutputConfig;
  import com.anthropic.models.beta.messages.BetaSystemMessageParam;
  import com.anthropic.models.beta.messages.MessageCreateParams;
  import com.anthropic.models.messages.Model;

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

      MessageCreateParams params = MessageCreateParams.builder()
          .model(Model.CLAUDE_FABLE_5_1)
          .maxTokens(4096L)
          .addBeta(AnthropicBeta.MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01)
          .outputConfig(BetaOutputConfig.builder()
              .effort(BetaOutputConfig.Effort.HIGH)
              .build())
          .addUserMessage("Plan a migration from SQLite to PostgreSQL in three short steps.")
          .addAssistantMessage("1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts.")
          // Mensagem do sistema só de esforço: o novo nível vale a partir do próximo turno do usuário.
          .addMessage(BetaSystemMessageParam.builder()
              .contentOfBlocks(List.of())
              .outputConfig(BetaSystemMessageOutputConfig.builder()
                  .effort(BetaSystemMessageOutputConfig.Effort.LOW)
                  .build())
              .build())
          .addUserMessage("Summarize the plan in one sentence.")
          .build();

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

  ```php PHP
  use Anthropic\Beta\AnthropicBeta;
  use Anthropic\Beta\Messages\BetaMessageParam;
  use Anthropic\Beta\Messages\BetaOutputConfig;
  use Anthropic\Beta\Messages\BetaSystemMessageOutputConfig;
  use Anthropic\Beta\Messages\BetaTextBlock;
  use Anthropic\Client;
  use Anthropic\Messages\Model;

  $client = new Client();

  $response = $client->beta->messages->create(
      model: Model::CLAUDE_FABLE_5_1,
      maxTokens: 4096,
      outputConfig: BetaOutputConfig::with(effort: 'high'),
      messages: [
          BetaMessageParam::with(role: 'user', content: 'Plan a migration from SQLite to PostgreSQL in three short steps.'),
          BetaMessageParam::with(role: 'assistant', content: '1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts.'),
          // Mensagem do sistema só de esforço: o novo nível vale a partir do próximo turno do usuário.
          BetaMessageParam::with(
              role: 'system',
              content: [],
              outputConfig: BetaSystemMessageOutputConfig::with(effort: 'low'),
          ),
          BetaMessageParam::with(role: 'user', content: 'Summarize the plan in one sentence.'),
      ],
      betas: [AnthropicBeta::MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01],
  );

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

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

  response = client.beta.messages.create(
    model: Anthropic::Model::CLAUDE_FABLE_5_1,
    max_tokens: 4096,
    output_config: {effort: :high},
    messages: [
      {role: "user", content: "Plan a migration from SQLite to PostgreSQL in three short steps."},
      {role: "assistant", content: "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts."},
      # Mensagem do sistema só de esforço: o novo nível vale a partir do próximo turno do usuário.
      {role: "system", content: [], output_config: {effort: :low}},
      {role: "user", content: "Summarize the plan in one sentence."}
    ],
    betas: [Anthropic::AnthropicBeta::MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01]
  )

  response.content.each do |block|
    case block
    when Anthropic::Beta::BetaTextBlock
      puts block.text
    end
  end
  ```
</CodeGroup>

A posição da mensagem decide quando o novo nível começa:

* Diretamente após um turno `user` com nova entrada: a resposta de Claude a esse turno usa o novo nível.
* Em qualquer outra posição, como entre um turno `assistant` e o próximo turno `user`, como no exemplo anterior: o novo nível começa no próximo turno `user` com nova entrada.

Um turno `user` que contém apenas blocos `tool_result` não conta como nova entrada.

O novo nível permanece em vigor até que uma mensagem posterior o altere.

Coloque a mensagem depois de tudo o que você já enviou e mantenha-a no lugar nas solicitações posteriores. Não a insira antes de turnos que você já enviou, e não a mova nem a remova depois. Em modelos com [preserved thinking](https://platform.claude.com/docs/pt-BR/build-with-claude/preserved-thinking) (pensamento preservado), qualquer uma dessas alterações invalida os blocos de pensamento nos turnos `assistant` após a mensagem. [O que a API faz com um bloco inválido](https://platform.claude.com/docs/pt-BR/build-with-claude/preserved-thinking#mismatch-behavior) explica o que acontece em seguida.

Se ela estiver ao lado de uma mensagem `system` que tenha conteúdo, ambas as mensagens devem seguir as [regras de posicionamento para mensagens do sistema no meio da conversa](https://platform.claude.com/docs/pt-BR/build-with-claude/mid-conversation-system-messages#limitations).

Com a API InvokeModel do Amazon Bedrock, envie o valor beta no array `anthropic_beta` do corpo da solicitação em vez do cabeçalho. Para os modelos que oferecem suporte a effort por mensagem lá, consulte [Mensagens do sistema no meio da conversa no Bedrock](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-on-amazon-bedrock-legacy#mid-conversation-system-messages-on-bedrock).

## Erros

* Sem o cabeçalho beta, um `output_config` por mensagem retorna um erro 400: `messages.N.output_config: Extra inputs are not permitted`, onde `N` é o índice da mensagem `system` em `messages`.
* Com o cabeçalho beta, modelos sem effort por mensagem, como o Claude Fable 5, retornam um erro 400: `output_config.effort requires a model that supports per-turn effort; this model does not`. No Amazon Bedrock, esses modelos e o Claude Opus 5 retornam `Extra inputs are not permitted` em vez disso.
* No Claude Sonnet 5.5 com `thinking: {"type": "between_tools"}`, e no Claude Haiku 5.5 com `thinking: {"type": "disabled"}`, você não pode alterar o nível de effort no meio da conversa. Nesses casos, um `output_config.effort` por mensagem com um novo nível retorna um erro 400. Para variar o effort a cada turno, use o pensamento adaptativo.

## Esforço por mensagem ou de nível superior

Prefira o effort por mensagem a [alterar o valor de nível superior](https://platform.claude.com/docs/pt-BR/build-with-claude/effort#top-level-effort-on-the-next-request) entre solicitações. Uma alteração por mensagem deixa tudo o que vem antes dela inalterado, de modo que o prefixo em cache ainda corresponde. Uma alteração de nível superior reinicia o cache. No Claude Fable 5.1, uma alteração de nível superior também direciona o modelo de forma menos confiável. As respostas anteriores do modelo foram escritas no nível anterior, e o modelo tende a permanecer consistente com elas.

## Disponibilidade

Esforço por mensagem está em beta em modelos selecionados.

### Suporte da API

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

* Disponibilidade: Disponível

| Status           | Plataformas de nuvem                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Modelos                                                                                                                                                                                                                                                                                                                                                |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Beta             | Claude API, [Amazon Bedrock](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-amazon-bedrock), [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry) | [Claude Fable 5.1](https://platform.claude.com/docs/pt-BR/models/fable-5-1/overview), [Claude Opus 5.5](https://platform.claude.com/docs/pt-BR/models/opus-5-5/overview)                                                                                                                                                                               |
| Beta<sup>1</sup> | [Amazon Bedrock (bedrock-runtime)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-on-amazon-bedrock-legacy)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | [Claude Fable 5.2](https://platform.claude.com/docs/pt-BR/models/fable-5-2/overview), [Claude Mythos 5.2](https://platform.claude.com/docs/pt-BR/models/mythos-5-2/overview), [Claude Fable 5.1](https://platform.claude.com/docs/pt-BR/models/fable-5-1/overview), [Claude Opus 5.5](https://platform.claude.com/docs/pt-BR/models/opus-5-5/overview) |
| Beta             | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry)                                                                                                      | [Claude Fable 5.2](https://platform.claude.com/docs/pt-BR/models/fable-5-2/overview), [Claude Opus 5](https://platform.claude.com/docs/pt-BR/models/opus-5/overview), [Claude Sonnet 5.5](https://platform.claude.com/docs/pt-BR/models/sonnet-5-5/overview), [Claude Haiku 5.5](https://platform.claude.com/docs/pt-BR/models/haiku-5-5/overview)     |
| Beta             | Claude API, [Amazon Bedrock](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-amazon-bedrock), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry)                                                                                                                                                                                                                                                     | [Claude Mythos 5.1](https://platform.claude.com/docs/pt-BR/models/mythos-5-1/overview)                                                                                                                                                                                                                                                                 |
| Beta             | Claude API, [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry)                                                                                                                                                                                           | [Claude Mythos 5.2](https://platform.claude.com/docs/pt-BR/models/mythos-5-2/overview)                                                                                                                                                                                                                                                                 |

1. Envie o valor beta no array `anthropic_beta` do corpo da requisição.

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

* Disponibilidade: Não disponível
* Uso: Em vez disso, defina o esforço de uma sessão substituindo as configurações de modelo do agente.

### Cabeçalhos beta obrigatórios

[Visão geral dos cabeçalhos beta](https://platform.claude.com/docs/pt-BR/api/beta-headers)

Os cabeçalhos beta permitem que você acesse recursos experimentais e novas capacidades de modelos antes que eles se tornem parte da API padrão.

* `mid-conversation-output-config-2026-07-01`