{"slug": "parametro-de-esforco-do-claude-opus-5-trocando-custo-por-capacidade", "title": "Parâmetro de Esforço do Claude Opus 5: Trocando Custo por Capacidade", "summary": "Anthropic's Claude Opus 5, released July 24, 2026, introduces an 'effort' parameter that lets developers trade cost for reasoning capability. The parameter has five levels—low, medium, high (default), xhigh, and max—controlling internal reasoning tokens before response generation. Anthropic recommends starting with xhigh for code and agentic loops, reserving max for single-shot hard problems where failure cost exceeds token cost.", "body_md": "Todo artigo principal sobre o [lançamento do Claude Opus 5](https://www.anthropic.com/news/claude-opus-5) em 24 de julho de 2026 destacou a mesma funcionalidade: uma forma de alternar entre custo e capacidade. Mas poucos explicaram o que ela controla, quais níveis existem, como afeta a requisição ou o impacto na conta.\n\nEssa funcionalidade é o parâmetro `effort`\n\n. No Opus 5, ele tem cinco níveis e o padrão é `high`\n\n. A Anthropic recalibrou esses níveis para o modelo, então configurações ajustadas no Opus 4.8 não devem ser reutilizadas sem avaliação. Além disso, uma combinação específica de parâmetros gera erro `400`\n\ndurante migrações.\n\n💡 Para comparar os cinco níveis contra um endpoint real, envie a mesma requisição com valores diferentes de\n\n`effort`\n\ne registre custo, latência e qualidade da resposta.\n\n`effort`\n\nrealmente faz\nO `effort`\n\nfica dentro de `output_config`\n\nem uma requisição para a API de Mensagens:\n\n```\n{\n  \"model\": \"claude-opus-5\",\n  \"max_tokens\": 8192,\n  \"output_config\": {\n    \"effort\": \"high\"\n  },\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Refatorar este módulo e explicar os trade-offs.\"\n    }\n  ]\n}\n```\n\nEle controla quanto raciocínio interno o modelo executa antes de responder.\n\nNo Opus 5, o pensamento adaptativo está ativado por padrão. O valor de `effort`\n\ndefine o orçamento usado nesse raciocínio:\n\n`effort`\n\nmais alto: mais tokens de raciocínio, maior custo e maior latência.`effort`\n\nmais baixo: menos tokens de raciocínio, menor custo e menor latência.Nas interfaces de consumidor, a mesma opção pode aparecer como um seletor entre custo e capacidade. Na API, o controle efetivo é o campo `output_config.effort`\n\n.\n\nConsulte o formato completo da requisição no [guia da API do Opus 5](https://apidog.com/pt/blog/claude-opus-5-api?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) e a documentação da Anthropic na [visão geral de modelos](https://platform.claude.com/docs/en/about-claude/models/overview).\n\n`effort`\n\nnão controla verbosidade\n`effort`\n\nnão é um controle de tamanho da resposta.\n\nSegundo o [guia de prompting da Anthropic para o Opus 5](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5), reduzir o `effort`\n\ndiminui o raciocínio interno, não o comprimento do texto visível.\n\nSe você precisa de respostas curtas, inclua essa restrição no prompt:\n\n```\nResponda em no máximo 5 bullets. Não inclua introdução, justificativas longas ou exemplos adicionais.\n```\n\nNão espere que usar `low`\n\nreduza automaticamente a saída textual.\n\n`effort`\n\n| Nível | O que faz | Aplicação típica |\n|---|---|---|\n`low` |\nRaciocínio mínimo antes de responder | Classificação de alto volume, extração, roteamento e resumos curtos |\n`medium` |\nRaciocínio moderado | Perguntas e respostas sobre contexto recuperado, edições de arquivo único e transformações estruturadas |\n`high` |\nPadrão. Raciocínio substancial |\nTrabalho de propósito geral quando você ainda não mediu resultados |\n`xhigh` |\nRaciocínio estendido | Codificação e loops agênticos; ponto de partida recomendado pela Anthropic |\n`max` |\nOrçamento máximo de raciocínio | Problemas difíceis de uma única tentativa, quando errar custa mais que os tokens |\n\nDois detalhes são especialmente importantes:\n\n**O padrão é high.**\n\n`output_config`\n\n, a requisição usa `high`\n\n. Isso afeta previsões de custo: uma requisição sem configuração explícita no Opus 5 realiza trabalho de raciocínio e cobra por ele.**Para código e agentes, comece em xhigh, não em max.**\n\n`xhigh`\n\ncomo ponto de partida para essas cargas. Use `max`\n\napenas quando suas avaliações mostrarem ganho mensurável que justifique o custo adicional.A mudança do comportamento padrão é uma das alterações relevantes na [migração do Opus 4.8 para o Opus 5](https://apidog.com/pt/blog/claude-opus-5-migration-opus-4-8?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation).\n\nO rótulo de cada nível não representa necessariamente o mesmo orçamento entre modelos.\n\nNo Opus 5, `medium`\n\nnão corresponde à mesma quantidade de raciocínio que `medium`\n\nno Opus 4.8. A recomendação da Anthropic é executar uma nova varredura de `effort`\n\nem vez de migrar a configuração anterior diretamente.\n\nNa prática, isso pode abrir espaço para redução de custo:\n\n`low`\n\ne `medium`\n\nfrequentemente apresentavam queda perceptível de qualidade em tarefas complexas.`low`\n\ne `medium`\n\nopções viáveis para tarefas de produção que não precisam de raciocínio extenso.O Opus 5 custa US$ 5 por milhão de tokens de entrada e US$ 25 por milhão de tokens de saída, os mesmos valores do Opus 4.8. Tokens de raciocínio entram na cobrança de saída.\n\nPor isso, usar `high`\n\nem um pipeline de classificação onde `low`\n\njá atende aos critérios pode aumentar significativamente o gasto sem melhorar a precisão.\n\nVeja a tabela completa de preços no [detalhamento de preços do Opus 5](https://apidog.com/pt/blog/claude-opus-5-pricing?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation), incluindo desconto de 50% para lote e o mínimo de cache de 512 tokens.\n\nPara otimizações adicionais, consulte [como cortar sua conta da API Claude](https://apidog.com/pt/blog/cut-claude-api-bill?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation).\n\n`xhigh`\n\ne `max`\n\ninteragem com `max_tokens`\n\n`max_tokens`\n\nlimita os tokens de raciocínio **e** os tokens da resposta visível.\n\nEm outras palavras, ele é um teto para toda a saída gerada pela requisição:\n\n```\ntokens de raciocínio + tokens de resposta <= max_tokens\n```\n\nAo aumentar o `effort`\n\n, o modelo pode gastar mais do orçamento em raciocínio antes de começar a gerar a resposta. Se `max_tokens`\n\nestiver dimensionado para um modelo sem esse comportamento, a resposta pode ser truncada.\n\nExemplo recomendado para `xhigh`\n\n:\n\n```\n{\n  \"model\": \"claude-opus-5\",\n  \"max_tokens\": 64000,\n  \"output_config\": {\n    \"effort\": \"xhigh\"\n  },\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Corrigir o teste de integração com falha e explicar a causa raiz.\"\n    }\n  ]\n}\n```\n\nA orientação da Anthropic é começar com `max_tokens: 64000`\n\nao usar `xhigh`\n\nou `max`\n\n.\n\nUm valor alto de `max_tokens`\n\né um teto, não uma compra antecipada. Você é cobrado pelos tokens realmente produzidos. Portanto, definir `64000`\n\nnão significa pagar por `64000`\n\n; significa evitar que o modelo interrompa o raciocínio ou a resposta cedo demais.\n\n`thinking`\n\ndesativado com `xhigh`\n\nou `max`\n\nHá uma combinação inválida que deve ser verificada durante a migração.\n\nDesabilitar o pensamento e solicitar um `effort`\n\nalto são instruções contraditórias. Esta requisição falha:\n\n```\n{\n  \"model\": \"claude-opus-5\",\n  \"max_tokens\": 8192,\n  \"thinking\": {\n    \"type\": \"disabled\"\n  },\n  \"output_config\": {\n    \"effort\": \"xhigh\"\n  }\n}\n```\n\nO Opus 5 retorna `400`\n\nquando `thinking: { \"type\": \"disabled\" }`\n\né usado com `effort: \"xhigh\"`\n\nou `effort: \"max\"`\n\n.\n\nAs combinações válidas são:\n\n`low`\n\n, `medium`\n\nou `high`\n\n.Um caminho comum para esse erro é:\n\n`thinking: { \"type\": \"disabled\" }`\n\nde uma configuração do Opus 4.8.`effort`\n\npara `xhigh`\n\n, seguindo a recomendação para codificação.`400`\n\nporque os dois ajustes são incompatíveis.A recomendação da Anthropic é não desabilitar o pensamento no Opus 5. Com ele desativado, dois problemas podem aparecer:\n\nEm loops agênticos, esse texto vazado pode contaminar interações posteriores. Para controlar custo, prefira reduzir `effort`\n\nem vez de desabilitar o pensamento.\n\nVeja mais detalhes no [guia de prompt do Opus 5](https://apidog.com/pt/blog/prompting-claude-opus-5?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation).\n\n`effort`\n\nnas suas avaliações\nA forma prática de escolher um nível é avaliar sua carga de trabalho real.\n\nSepare de 30 a 50 prompts dos logs de produção. Evite exemplos exclusivamente sintéticos.\n\nInclua casos difíceis, falhas conhecidas e tarefas com impacto real. Diferenças entre níveis de `effort`\n\ntendem a desaparecer em tarefas simples.\n\nDefina métricas objetivas antes de ler as saídas. Por exemplo:\n\nEvite critérios vagos como “parece melhor”.\n\nCom 40 prompts e 5 níveis, você terá 200 chamadas:\n\n```\n40 prompts × 5 níveis = 200 execuções\n```\n\nComo essa avaliação não é sensível à latência, você pode usar a API Batch para reduzir o custo.\n\nPara cada execução, capture pelo menos:\n\n`usage.output_tokens`\n\n;O campo `usage`\n\né importante porque mostra o consumo real de tokens de saída, incluindo os tokens de raciocínio.\n\nUm registro simples pode ter este formato:\n\n```\n{\n  \"prompt_id\": \"integration-test-17\",\n  \"effort\": \"medium\",\n  \"passed\": true,\n  \"output_tokens\": 1842,\n  \"latency_ms\": 3280\n}\n```\n\nCompare a taxa de aprovação com custo e latência. Escolha o nível mais barato que atinge seus requisitos e valide a decisão em um conjunto separado, que não foi usado para ajustar a configuração.\n\nA razão para executar essa varredura é justamente a recalibração entre Opus 4.8 e Opus 5. Não assuma que os rótulos terão o mesmo comportamento no próximo modelo.\n\nA parte mecânica da varredura consiste em enviar o mesmo corpo de requisição cinco vezes, alterando apenas `output_config.effort`\n\n.\n\nUma configuração prática no [Apidog](https://apidog.com/?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation):\n\n`output_config.effort`\n\nem cada cópia.`usage.output_tokens`\n\n, latência e resultado funcional.`cache_read_input_tokens`\n\nquando estiver validando o cache.`low`\n\ne `xhigh`\n\n.`stop_reason`\n\nexista e não seja `max_tokens`\n\n.A última verificação evita que uma resposta truncada pareça uma resposta curta válida.\n\nExemplo de condição que sua coleção deve verificar:\n\n```\nstop_reason existe AND stop_reason != \"max_tokens\"\n```\n\nSe a requisição terminar com `stop_reason: \"max_tokens\"`\n\n, aumente `max_tokens`\n\nantes de concluir que aquele nível de `effort`\n\nteve desempenho ruim.\n\nVocê pode [baixar o Apidog](https://apidog.com/download?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) para montar essa coleção. Não é obrigatório: o mesmo processo pode ser automatizado com scripts, mas uma coleção facilita comparar as cinco variações.\n\n`effort`\n\npode tornar o Opus 5 mais eficiente para rodar bem, mas não altera a posição do modelo na linha Claude.\n\nOs números de lançamento divulgados pela Anthropic para o Opus 5 incluem:\n\nEsses números foram publicados pela Anthropic e não haviam sido reproduzidos independentemente até 25 de julho de 2026. Trate-os como afirmações do fornecedor, não como medições neutras.\n\nConsulte o [detalhamento de benchmarks do Opus 5](https://apidog.com/pt/blog/claude-opus-5-benchmarks?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) para as ressalvas de cada benchmark.\n\nAcima do Opus 5, o [Fable 5](https://apidog.com/pt/blog/what-is-claude-fable-5?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) continua sendo o modelo mais capaz amplamente lançado da Anthropic, a US$ 10 por milhão de tokens de entrada e US$ 50 por milhão de tokens de saída.\n\nO Opus 5 também fica atrás do [Mythos 5](https://apidog.com/pt/blog/mythos-class-model-explained?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) em exploração de segurança cibernética e pesquisa biológica autônoma, conforme declarado pela Anthropic.\n\nUsar `effort: \"max\"`\n\nnão elimina essas diferenças de capacidade. O ganho prático está em encontrar o menor nível que atende às exigências da sua carga de trabalho.\n\nPara comparar custo e capacidade entre os modelos, veja [Opus 5 vs Fable 5](https://apidog.com/pt/blog/claude-opus-5-vs-fable-5?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation).\n\n`effort`\n\npadrão no Claude Opus 5?\n`high`\n\n.\n\nUma requisição sem `output_config`\n\nusa `effort: \"high\"`\n\ncom pensamento adaptativo ativado.\n\n`effort`\n\n?\n`low`\n\n, `medium`\n\n, `high`\n\n, `xhigh`\n\ne `max`\n\n.\n\nA Anthropic recomenda começar em `xhigh`\n\npara codificação e trabalho agêntico e, então, avaliar níveis menores com sua própria suíte de testes.\n\n`effort: \"xhigh\"`\n\n?\nProvavelmente porque você também enviou:\n\n```\n{\n  \"thinking\": {\n    \"type\": \"disabled\"\n  }\n}\n```\n\nCom pensamento desativado, o `effort`\n\nfica limitado a `high`\n\n. Remova a desativação do pensamento ou reduza o nível para `high`\n\n, `medium`\n\nou `low`\n\n.\n\n`effort`\n\ndo Opus 4.8 no Opus 5?\nNão.\n\nOs níveis foram recalibrados, então o mesmo rótulo representa uma quantidade diferente de raciocínio. Execute uma nova varredura de avaliação antes de definir a configuração de produção.\n\nConsulte o [guia de migração](https://apidog.com/pt/blog/claude-opus-5-migration-opus-4-8?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) para a lista completa de mudanças.\n\n`effort`\n\ndeixa as respostas mais curtas?\nNão.\n\n`effort`\n\ncontrola o raciocínio interno, não o tamanho visível da resposta. Se você precisa de uma resposta curta, solicite explicitamente concisão no prompt.\n\n`max_tokens`\n\ndevo usar com `xhigh`\n\nou `max`\n\n?\nComece com `64000`\n\n.\n\n`max_tokens`\n\nlimita o raciocínio e a resposta juntos. Um teto baixo pode truncar a saída. Você só paga pelos tokens realmente produzidos, então um teto alto não gera custo por si só.\n\nPara especificações, disponibilidade e preços, comece por [o que é o Claude Opus 5](https://apidog.com/pt/blog/what-is-claude-opus-5?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation).", "url": "https://wpnews.pro/news/parametro-de-esforco-do-claude-opus-5-trocando-custo-por-capacidade", "canonical_source": "https://dev.to/lucas_ferreira/parametro-de-esforco-do-claude-opus-5-trocando-custo-por-capacidade-411l", "published_at": "2026-07-25 03:20:28+00:00", "updated_at": "2026-07-25 03:28:47.123487+00:00", "lang": "en", "topics": ["large-language-models", "ai-products", "developer-tools", "ai-infrastructure"], "entities": ["Anthropic", "Claude Opus 5", "Claude Opus 4.8"], "alternates": {"html": "https://wpnews.pro/news/parametro-de-esforco-do-claude-opus-5-trocando-custo-por-capacidade", "markdown": "https://wpnews.pro/news/parametro-de-esforco-do-claude-opus-5-trocando-custo-por-capacidade.md", "text": "https://wpnews.pro/news/parametro-de-esforco-do-claude-opus-5-trocando-custo-por-capacidade.txt", "jsonld": "https://wpnews.pro/news/parametro-de-esforco-do-claude-opus-5-trocando-custo-por-capacidade.jsonld"}}