Effort

O parâmetro "effort" (esforço) permite controlar quantos tokens o Claude gasta ao responder a requisições. Você pode equilibrar entre a completude da resposta e a eficiência de tokens com um único modelo. O parâmetro effort está disponível em todos os modelos compatíveis, sem necessidade de cabeçalho beta.



Como o effort funciona

Por padrão, o Claude usa effort alto, gastando quantos tokens forem necessários para obter resultados excelentes. Você pode aumentar o nível de effort para max para obter a capacidade máxima absoluta, ou reduzi-lo para ser mais conservador com o uso de tokens, otimizando para velocidade e custo enquanto aceita alguma redução na capacidade.

O parâmetro effort afeta todos os tokens na resposta, incluindo:

• Respostas de texto e explicações
• Chamadas de ferramentas e argumentos de funções
• Thinking (quando ativo)

Essa abordagem tem duas vantagens principais:

1. Não requer que o thinking esteja habilitado.
2. Pode afetar todo o gasto de tokens, incluindo chamadas de ferramentas. Por exemplo, um effort mais baixo significaria que o Claude faz menos chamadas de ferramentas. Isso oferece um grau muito maior de controle sobre a eficiência.



Níveis de effort

xhigh é um nível mais recente; alguns modelos que suportam max não suportam xhigh.



Níveis de effort recomendados para o Claude Sonnet 5

O Claude Sonnet 5 usa effort high por padrão na API do Claude e no Claude Code.

• Effort high (padrão): Adequado para raciocínio complexo, codificação e tarefas agênticas em que a qualidade importa mais do que velocidade ou custo.
• Effort xhigh: Para as tarefas mais difíceis de codificação e agênticas. Consulte Prompting para o Claude Sonnet 5.
• Effort medium: Redução de custo em relação ao padrão. Comparável ao Claude Sonnet 4.6 com effort high.
• Effort low: Para cargas de trabalho de alto volume ou sensíveis à latência. Adequado para chat e casos de uso que não envolvem codificação, em que um retorno mais rápido é priorizado.
• Effort max: Para tarefas que exigem a capacidade máxima absoluta sem restrições no gasto de tokens.



Níveis de effort recomendados para o Claude Sonnet 4.6

O Sonnet 4.6 usa effort high por padrão. Defina o effort explicitamente ao usar o Sonnet 4.6 para evitar latência inesperada:

• Effort medium (padrão recomendado): Melhor equilíbrio entre velocidade, custo e desempenho para a maioria das aplicações. Adequado para codificação agêntica, fluxos de trabalho com uso intensivo de ferramentas e geração de código.
• Effort low: Para cargas de trabalho de alto volume ou sensíveis à latência. Adequado para chat e casos de uso que não envolvem codificação, em que um retorno mais rápido é priorizado.
• Effort high: Para raciocínio complexo e tarefas em que a qualidade importa mais do que velocidade ou custo.
• Effort max: Para tarefas que exigem a capacidade máxima absoluta sem restrições no gasto de tokens.



Níveis de effort recomendados para o Claude Opus 4.7

Comece com xhigh para casos de uso de codificação e agênticos, e use high como mínimo para a maioria das cargas de trabalho sensíveis à inteligência. Reduza para medium em cargas de trabalho sensíveis a custo, ou aumente para max apenas quando suas avaliações mostrarem margem mensurável de melhoria em xhigh.

O padrão da API é high. Para usar xhigh, defina effort explicitamente; o valor que você passa substitui o padrão.

O Claude Opus 4.7 também respeita os níveis de effort de forma mais estrita do que o Claude Opus 4.6, especialmente em low e medium. Em níveis de effort mais baixos, o modelo limita seu trabalho ao que foi solicitado em vez de fazer mais do que o pedido. Se você observar raciocínio superficial em problemas complexos com o Claude Opus 4.7, aumente o effort em vez de tentar contornar isso via prompt. Se precisar manter o effort baixo por questões de latência, adicione orientação direcionada como "Esta tarefa envolve raciocínio em várias etapas. Pense cuidadosamente antes de responder."

Ao executar o Claude Opus 4.7 com effort xhigh ou max, defina um max_tokens grande para que o modelo tenha espaço para pensar e agir entre subagentes e chamadas de ferramentas. Começar com 64k tokens e ajustar a partir daí é um padrão razoável.



Níveis de effort recomendados para o Claude Opus 4.8

A orientação para o Claude Opus 4.7 também se aplica ao Claude Opus 4.8. Comece com xhigh para casos de uso de codificação e agênticos, use high para a maioria das outras cargas de trabalho sensíveis à inteligência, e reduza para medium ou low apenas quando tiver medido que o nível mais baixo mantém a qualidade nas suas avaliações.

O padrão da API é high. Defina effort explicitamente para usar um nível diferente; o valor que você passa substitui o padrão.

Ao executar o Claude Opus 4.8 com effort xhigh ou max, defina um max_tokens grande para que o modelo tenha espaço para pensar e agir entre subagentes e chamadas de ferramentas. Começar com 64k tokens e ajustar a partir daí é um padrão razoável.



Níveis de effort recomendados para o Claude Opus 5

O Claude Opus 5 suporta todos os cinco níveis de effort. Comece com high, o padrão, e ajuste com base nas suas avaliações: aumente para xhigh em trabalho exigente de codificação e agêntico, ou para max quando uma tarefa justificar gasto irrestrito de tokens, e use low e medium livremente como seu controle principal de custo de tokens e tempo de resposta sempre que suas avaliações mostrarem que a qualidade se mantém. Se você trouxe configurações de effort de um modelo anterior, execute uma nova varredura de effort nas suas avaliações em vez de reutilizá-las.

O effort controla o volume de thinking, não o comprimento visível da resposta: no Claude Opus 5, alterar o effort não encurta as respostas de forma confiável, então use o prompt para controlar o comprimento.

O padrão da API é high. Defina effort explicitamente para usar um nível diferente; o valor que você passa substitui o padrão.

No Claude Opus 5, o thinking não pode ser desabilitado com effort xhigh ou max: requisições que definem thinking: {"type": "disabled"} nesses níveis retornam um erro 400. Consulte Effort com thinking.

Ao executar o Claude Opus 5 com effort xhigh ou max, defina um max_tokens grande para que o modelo tenha espaço para pensar e agir entre subagentes e chamadas de ferramentas. Começar com 64k tokens e ajustar a partir daí é um padrão razoável.



Níveis de effort recomendados para o Claude Fable 5

O effort é o controle principal para equilibrar inteligência, latência e custo no Claude Fable 5. Comece com high, o padrão, para a maioria das tarefas, use xhigh para as cargas de trabalho mais sensíveis à capacidade, e reduza para medium ou low em trabalho rotineiro. Configurações de effort mais baixas no Claude Fable 5 ainda têm bom desempenho e frequentemente superam o desempenho de xhigh em modelos anteriores. Em high e xhigh, defina um max_tokens grande: ele é um limite rígido na saída total, thinking mais texto de resposta. Consulte Controle de custos.

Reduza o effort se uma tarefa for concluída mas demorar mais do que o necessário, ou se você quiser um estilo de trabalho mais rápido e interativo. As mesmas recomendações se aplicam ao Claude Mythos 5. Para orientação mais completa, consulte Prompting para o Claude Fable 5.



Uso básico

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-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)



Quando ajustar o parâmetro effort

• Use effort max quando precisar da capacidade máxima absoluta sem restrições: o raciocínio mais completo e a análise mais profunda. Disponível nos modelos Claude 4.6 e posteriores e no Claude Mythos Preview.
• Use effort xhigh para codificação avançada e trabalho agêntico complexo que exige exploração estendida, como chamadas repetidas de ferramentas e busca detalhada. Disponível no Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7 e Claude Sonnet 5.
• Use effort high (o padrão) para raciocínio complexo, análise com nuances, problemas difíceis de codificação ou qualquer tarefa em que a qualidade importa mais do que velocidade ou custo.
• Use effort medium como uma opção equilibrada quando quiser desempenho sólido sem o gasto total de tokens do effort high.
• Use effort low quando estiver otimizando para velocidade (porque o Claude responde com menos tokens) ou custo. Por exemplo, tarefas simples de classificação, consultas rápidas ou casos de uso de alto volume em que melhorias marginais de qualidade não justificam latência ou gasto adicional.



Effort com uso de ferramentas

Ao usar ferramentas, o parâmetro effort afeta tanto as explicações em torno das chamadas de ferramentas quanto as próprias chamadas de ferramentas. Níveis de effort mais baixos tendem a:

• Combinar várias operações em menos chamadas de ferramentas
• Fazer menos chamadas de ferramentas
• Prosseguir diretamente para a ação sem preâmbulo
• Usar mensagens de confirmação concisas após a conclusão

Níveis de effort mais altos podem:

• Fazer mais chamadas de ferramentas
• Explicar o plano antes de agir
• Fornecer resumos detalhados das alterações
• Incluir comentários de código mais abrangentes



Effort com thinking

O parâmetro thinking controla se Claude pensa em blocos de pensamento antes de responder; o parâmetro effort controla quanto trabalho Claude dedica à resposta como um todo, o que no modo adaptativo inclui com que frequência e com que profundidade ele pensa. Não passe adaptive como um valor de effort: adaptive é um modo de pensamento, não um nível de esforço.

Em níveis de effort mais altos, o Claude pensa na maioria das requisições e com maior extensão; em níveis mais baixos, ele pode pular o thinking completamente para problemas mais simples. Consulte Thinking e effort para orientação completa sobre como os dois controles funcionam juntos.

No Claude Opus 4.5, o único modelo exclusivamente de pensamento estendido que suporta effort, ele funciona junto com budget_tokens: defina o nível de effort para sua tarefa e, em seguida, defina o orçamento de tokens de thinking com base na profundidade de raciocínio que a tarefa precisa.

Para disponibilidade de thinking por modelo, consulte a tabela de configuração por modelo. O effort funciona com ou sem thinking; consulte Como o effort funciona.



Alterando o effort no meio da conversa

output_config.effort é uma configuração no nível da requisição: cada requisição carrega seu próprio valor, então, para executar uma parte posterior de uma conversa em um nível de effort diferente, defina o novo valor na próxima requisição. O nível de effort se aplica à requisição inteira. Como o effort molda o prompt renderizado, alterá-lo entre requisições não preserva prefixos em cache de turnos anteriores; se você depende de cache de prompt ao longo de uma sessão longa, escolha um nível de effort no início e mantenha-o constante.



Melhores práticas

1. Defina o effort explicitamente: O padrão da API é high, mas o ponto de partida certo depende do seu modelo e da sua carga de trabalho.
2. Use low para tarefas sensíveis à velocidade ou simples: Quando a latência importa ou as tarefas são diretas, o effort low pode reduzir significativamente os tempos de resposta e os custos.
3. Teste seu caso de uso: O impacto dos níveis de effort varia por tipo de tarefa. Avalie o desempenho nos seus casos de uso específicos antes de implantar.
4. Considere effort dinâmico: Ajuste o effort com base na complexidade da tarefa. Consultas simples podem justificar effort low, enquanto codificação agêntica e raciocínio complexo se beneficiam de effort high. Consulte o próximo item antes de variá-lo dentro de uma mesma conversa.
5. Mantenha o effort constante em conversas com cache: Alterar o valor de effort entre requisições invalida o cache de prompt, então varie o effort entre cargas de trabalho em vez de dentro de uma conversa que depende de acertos de cache. Consulte Thinking e cache de prompt.



Próximos passos