DEV Community

Cover image for Otimize seus Prompts para Claude Opus 5: Pare de Pedir a Dupla Verificação
Lucas
Lucas

Posted on • Originally published at apidog.com

Otimize seus Prompts para Claude Opus 5: Pare de Pedir a Dupla Verificação

A maioria dos guias de migração informa o que quebra no código. Este mostra o que pode quebrar nos seus prompts.

Experimente o Apidog hoje

O Claude Opus 5 foi lançado em 24 de julho de 2026, e a Anthropic publicou um guia de prompt dedicado. O ponto central: algumas instruções que melhoravam o Opus 4.8 pioram o Opus 5 — com mais custo, mais verbosidade e, em um caso, comportamento potencialmente quebrado em loops de agentes.

O motivo é simples: o Opus 5 já executa por padrão várias ações que antes precisavam ser solicitadas. Se o prompt legado também pede essas ações, você acumula instruções sobre comportamentos nativos do modelo. O resultado não é o dobro da precisão, mas verificações redundantes e mais tokens.

Este guia mostra o que remover, o que restringir e como validar as mudanças em produção. Para alterações de código, consulte o guia de migração do Opus 4.8 para o Opus 5. Para comparar solicitações e respostas reais com configurações diferentes, use o Apidog.

Resumo

O Opus 5 tende a:

  • verificar mais o próprio trabalho;
  • produzir respostas mais longas;
  • delegar mais para subagentes;
  • narrar mais as próprias correções.

Portanto, a migração de prompts é principalmente subtrativa. Remova instruções redundantes e adicione limites explícitos de tamanho, escopo e delegação.

1. Remova instruções globais de verificação

A Anthropic afirma que o Opus 5 verifica o próprio trabalho sem ser solicitado: relê respostas, confere cálculos, repete testes e procura casos de borda.

No Opus 4.8, era comum incluir regras como estas:

Double-check your work before responding.
Verify each step before moving to the next one.
Review your answer for errors, then revise it.
Check your reasoning carefully.
Make sure the output is correct before returning it.
Enter fullscreen mode Exit fullscreen mode

No Opus 5, mantenha essas linhas fora do prompt de sistema. Elas podem induzir passagens extras de verificação que o modelo já faria, aumentando o consumo de tokens em especial em fluxos agentic longos.

Como manter verificações realmente necessárias

Se uma etapa for de alto risco, limite a verificação a ela:

Do not add general verification passes; you already verify by default.
The only exception: after writing the migration SQL, run it against the
schema dump once and report any mismatch. Do not re-verify anything else.
Enter fullscreen mode Exit fullscreen mode

Use este padrão:

  1. Desative verificações genéricas.
  2. Nomeie a única etapa que exige conferência extra.
  3. Defina quantas vezes ela deve ocorrer.
  4. Proíba novas verificações fora desse escopo.

Para otimizar custos além do prompt, combine essa mudança com cache e lote descritos no detalhamento de preços do Opus 5 e no guia para reduzir uma conta da API Claude.

2. Defina limites de saída explicitamente

As respostas e os artefatos escritos do Opus 5 tendem a ser mais longos do que no Opus 4.8.

Reduzir effort não resolve a verbosidade visível. Esse parâmetro controla quanto o modelo pensa, não quanto ele escreve. Ao reduzir de xhigh para medium, você pode diminuir tokens de raciocínio sem reduzir proporcionalmente o tamanho da resposta.

Consulte o guia do parâmetro de esforço do Opus 5 para os efeitos de cada nível.

Limite respostas de chat

Evite instruções vagas como “seja breve”. Prefira números e formato:

Response format: at most 150 words unless I ask for more.
No preamble, no restatement of my question, no summary at the end.
Lead with the answer, then the reasoning if it is needed.
Enter fullscreen mode Exit fullscreen mode

Limite documentos e entregáveis

Defina tamanho, conteúdo obrigatório e conteúdo proibido:

Write the migration doc at 800 words maximum.
Include: the breaking changes, the fix for each, and a rollback step.
Exclude: background on the old system, a glossary, and a conclusion section.
If a section would exceed its share, cut examples before cutting steps.
Enter fullscreen mode Exit fullscreen mode

Limite explicações em mudanças de código

Para tarefas de código, controle comentários e texto adicional:

Return the diff and nothing else.
No explanation of what you changed unless the change is non-obvious,
in which case one sentence above the hunk.
Enter fullscreen mode Exit fullscreen mode

3. Limite a delegação para subagentes

O Opus 5 delega para subagentes mais facilmente do que o Opus 4.8 quando o framework oferece esse recurso.

Isso pode ser útil, mas cada subagente adiciona contexto, chamadas e tokens. Para fluxos sensíveis a custo ou latência, estabeleça uma regra explícita.

Para impedir delegação 

Do not spawn subagents for this task. Handle it in this conversation.
Enter fullscreen mode Exit fullscreen mode

Para permitir delegação controlada 

You may delegate to at most 2 subagents, and only for independent
file-level work that can run in parallel.
Do research, planning, and final synthesis yourself in this thread.
Enter fullscreen mode Exit fullscreen mode

Evite delegar tarefas que o thread principal já consegue resolver com o contexto atual, como ler um único arquivo ou tomar uma decisão local.

Se você usa subagentes de forma intencional, veja o guia para criar subagentes de código Claude.

4. Restrinja o escopo de tarefas cirúrgicas

O Opus 5 pode expandir uma tarefa pequena. Ao pedir uma correção de teste, ele pode refatorar auxiliares, alterar assinaturas e adicionar novos testes. Em tarefas abertas, isso pode ajudar. Em correções pontuais, aumenta o diff e o risco de regressões.

Declare explicitamente o que pode e o que não pode mudar:

Scope: change only the retry-count constant in src/client/http.ts.
Do not refactor surrounding code, do not rename anything, do not add
tests, do not update docs. If you believe another change is required,
stop and tell me instead of making it.
Enter fullscreen mode Exit fullscreen mode

A última frase é importante. Ela dá ao modelo uma forma de apontar uma dependência ou risco sem modificar arquivos fora do escopo.

5. Desative a narração de correções quando a saída for consumida por máquinas

O Opus 5 tende a explicar quando muda de abordagem no meio da resposta. Isso é útil no trabalho interativo, mas pode poluir respostas consumidas por parsers, interfaces ou outros modelos.

Para retornar apenas o resultado final:

Do not narrate corrections or changes of approach.
Return only the final answer. If you revised your thinking, that
revision belongs in your reasoning, not in the response.
Enter fullscreen mode Exit fullscreen mode

Em pipelines estruturados, combine essa instrução com saída estruturada. Não dependa apenas do prompt para preservar o formato.

Modos de falha com pensamento desabilitado

Os itens anteriores são ajustes de qualidade e custo. Esta seção trata de correção.

A Anthropic documenta dois artefatos que podem ocorrer quando o pensamento é desabilitado com:

{
  "thinking": {
    "type": "disabled"
  }
}
Enter fullscreen mode Exit fullscreen mode

Chamadas de ferramenta retornadas como texto

O modelo pode emitir algo que parece uma chamada de ferramenta no texto da resposta, em vez de retornar um bloco estruturado tool_use.

Nesse caso:

  • nenhuma ferramenta é executada;
  • um loop de agente pode não perceber a falha;
  • o texto vazado pode entrar no histórico;
  • interações futuras podem interpretar a falsa chamada como uma ação concluída.

Em um chat isolado, o erro é visível. Em um agente com múltiplos turnos, ele pode se propagar silenciosamente.

Tags XML internas na resposta

Tags como <thinking> podem aparecer na saída visível. Isso é problemático para interfaces, renderização HTML e parsers.

Não adicione instruções como “nunca exiba tags <thinking>”. Nomear essas sequências no prompt pode aumentar a chance de vazamento.

Mitigação recomendada

Em vez de desabilitar o pensamento, mantenha-o habilitado e reduza o esforço:

{
  "model": "claude-opus-5",
  "max_tokens": 4096,
  "output_config": { "effort": "low" },
  "messages": [
    { "role": "user", "content": "..." }
  ]
}
Enter fullscreen mode Exit fullscreen mode

Isso reduz custos sem introduzir os artefatos associados ao pensamento desabilitado.

Também observe:

  • combinar thinking: {type: "disabled"} com esforço xhigh ou max retorna erro 400;
  • com pensamento desabilitado, o limite é esforço high;
  • no Opus 5, o pensamento é ativado por padrão;
  • omitir o campo thinking usa pensamento adaptativo, diferentemente do comportamento esperado no Opus 4.8.

Se desabilitar o pensamento for obrigatório, implemente validação defensiva no loop do agente:

  1. Inspecione cada turno do assistente antes de gravá-lo no histórico.
  2. Detecte padrões que representem chamadas de ferramenta não estruturadas.
  3. Rejeite o turno e registre o erro.
  4. Não permita que a resposta inválida entre na transcrição.

Falhe de forma explícita em vez de aceitar uma chamada fantasma no histórico.

Teste os prompts em vez de adivinhar

Mudanças de prompt não devem ser avaliadas apenas pela leitura. Comprimento de resposta, tokens de raciocínio, cache e chamadas de ferramenta precisam ser medidos em solicitações reais.

Captura de tela de testes de API

Você pode configurar essa comparação no Apidog:

  1. Crie uma solicitação para o endpoint Messages da Anthropic com "model": "claude-opus-5".
  2. Armazene a chave de API em uma variável de ambiente, nunca no corpo da solicitação.
  3. Salve o prompt de sistema antigo do Opus 4.8 e a versão simplificada para Opus 5 como duas solicitações separadas.
  4. Execute ambas com a mesma entrada.
  5. Compare o bloco usage de cada resposta.
  6. Execute variações com níveis diferentes de effort.
  7. Inspecione a resposta de streaming para confirmar que chamadas de ferramenta chegam como blocos estruturados tool_use, não como texto.

Ao comparar usage:

  • tokens de saída mostram se o limite de concisão funcionou;
  • tokens de entrada ajudam a identificar crescimento desnecessário do prompt;
  • campos de cache mostram se alterações quebraram um prefixo cacheável;
  • respostas de streaming ajudam a detectar chamadas de ferramenta serializadas incorretamente.

O último teste detecta chamadas de ferramenta em texto puro antes da produção. Baixe o Apidog para executar comparações lado a lado e consulte o tutorial da API Opus 5 para a solicitação completa.

O limite honesto

O Opus 5 não é o topo da pilha Claude. O Fable 5 mantém a designação de “mais capaz amplamente lançado”, e o Opus 5 ainda está atrás do Mythos 5 em exploração de segurança cibernética e pesquisa de biologia autônoma.

A Anthropic menciona ambos no próprio post de lançamento. A posição precisa é capacidade de classe de fronteira pela metade do preço de fronteira, com um limite claramente definido acima dele.

Os benchmarks de lançamento — Frontier-Bench, ARC-AGI 3, OSWorld 2.0 e CursorBench — são números publicados pela própria Anthropic e não haviam sido reproduzidos independentemente até 25 de julho de 2026. Trate-os como relatórios do fornecedor e execute avaliações com seus prompts e cargas de trabalho reais.

Prompt de sistema base para tarefas sensíveis a custo

Use este ponto de partida para migrar um agente do Opus 4.8:

Do not add verification passes; you verify by default.
Responses: 150 words maximum, no preamble, no closing summary.
Do not spawn subagents. Handle this in one thread.
Stay strictly within the task I state. If another change seems
required, stop and tell me rather than making it.
Do not narrate corrections or changes of approach.
Enter fullscreen mode Exit fullscreen mode

São seis linhas, quase todas restrições. Nenhuma pede que o modelo se esforce mais.

No Opus 4.8, os prompts frequentemente buscavam elevar o comportamento do modelo. No Opus 5, o objetivo é definir limites operacionais claros.

Faça uma varredura de effort com suas próprias avaliações, pois os níveis foram recalibrados. Para detalhes adicionais, consulte:

FAQ

Devo excluir “verifique seu trabalho” dos prompts?

Sim. O guia da Anthropic informa que o Opus 5 verifica o trabalho sem solicitação. Remova regras globais de verificação e use exceções estritamente limitadas para etapas de alto risco.

Por que o Opus 5 continua prolixo com effort baixo?

Porque effort controla o pensamento, não o tamanho da resposta visível. Defina limites de palavras, formato e conteúdo diretamente no prompt.

Como impedir a criação de subagentes?

Use uma instrução direta:

Do not spawn subagents for this task. Handle it in this conversation.
Enter fullscreen mode Exit fullscreen mode

Se precisar permitir delegação, imponha um limite numérico e restrinja-a a tarefas independentes que possam rodar em paralelo.

Por que tags <thinking> aparecem na saída?

Esse artefato pode ocorrer quando o pensamento está desabilitado. Não escreva um prompt citando as tags. Mantenha o pensamento habilitado e reduza effort para controlar custos.

O que fazer se uma chamada de ferramenta vier como texto simples?

Considere o turno inválido: nenhuma ferramenta foi executada. Valide a resposta antes de adicioná-la ao histórico do agente, rejeite formatos de chamada não estruturados e prefira manter o pensamento habilitado.

Top comments (0)