Esforço

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

• Respostas de texto e explicações
• Chamadas de ferramentas e argumentos de função
• Pensamento estendido (quando ativado)

Esta abordagem tem duas grandes vantagens:

1. Não requer que o pensamento seja ativado para usá-lo.
2. Pode afetar todo o gasto de tokens, incluindo chamadas de ferramentas. Por exemplo, esforço mais baixo significaria que Claude faz menos chamadas de ferramentas. Isso oferece um grau muito maior de controle sobre a eficiência.

Níveis de esforço

Uso básico

Quando devo ajustar o parâmetro effort?

• Use max effort quando você precisar da capacidade absoluta mais alta sem restrições—o raciocínio mais minucioso e análise mais profunda. Disponível apenas no Opus 4.6; solicitações usando max em outros modelos retornarão um erro.
• Use high effort (o padrão) quando você precisar do melhor trabalho de Claude—raciocínio complexo, análise nuançada, problemas de codificação difíceis, ou qualquer tarefa onde a qualidade é a prioridade máxima.
• Use medium effort como uma opção equilibrada quando você quer desempenho sólido sem o gasto total de tokens do esforço alto.
• Use low effort quando você está otimizando para velocidade (porque Claude responde com menos tokens) ou custo—por exemplo, tarefas simples de classificação, buscas rápidas, ou casos de uso de alto volume onde melhorias marginais de qualidade não justificam latência adicional ou gasto.

Esforço 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 esforço mais baixos tendem a:

• Combinar múltiplas operações em menos chamadas de ferramentas
• Fazer menos chamadas de ferramentas
• Proceder diretamente à ação sem preâmbulo
• Usar mensagens de confirmação tersas após a conclusão

Níveis de esforço mais altos podem:

• Fazer mais chamadas de ferramentas
• Explicar o plano antes de tomar ação
• Fornecer resumos detalhados de mudanças
• Incluir comentários de código mais abrangentes

Esforço com pensamento estendido

O parâmetro effort funciona junto com o pensamento estendido. Seu comportamento depende do modelo:

• Claude Opus 4.6 usa adaptive thinking (thinking: {type: "adaptive"}), onde effort é o controle recomendado para a profundidade do pensamento. Embora budget_tokens ainda seja aceito no Opus 4.6, está deprecado e será removido em um lançamento futuro. Em esforço high e max, Claude quase sempre pensa profundamente. Em níveis mais baixos, pode pular o pensamento para problemas mais simples.
• Claude Opus 4.5 usa pensamento manual (thinking: {type: "enabled", budget_tokens: N}), onde effort funciona junto com o orçamento de tokens de pensamento. Defina o nível de esforço para sua tarefa, depois defina o orçamento de tokens de pensamento com base na complexidade da tarefa.

O parâmetro effort pode ser usado com ou sem pensamento estendido ativado. Quando usado sem pensamento, ainda controla o gasto total de tokens para respostas de texto e chamadas de ferramentas.

Melhores práticas

1. Comece com high: Use níveis de esforço mais baixos para equilibrar desempenho com eficiência de tokens.
2. Use low para tarefas sensíveis à velocidade ou simples: Quando a latência importa ou as tarefas são diretas, esforço baixo pode reduzir significativamente os tempos de resposta e custos.
3. Teste seu caso de uso: O impacto dos níveis de esforço varia por tipo de tarefa. Avalie o desempenho em seus casos de uso específicos antes de implantar.
4. Considere esforço dinâmico: Ajuste o esforço com base na complexidade da tarefa. Consultas simples podem justificar esforço baixo enquanto codificação de agentes e raciocínio complexo se beneficiam de esforço alto.