Como usar o Opus 5.5: guia de prompts e Claude Code

Diga o que significa terminar

Entregue a tarefa inteira em uma única mensagem e deixe claro qual é a linha de chegada. Por exemplo, "os testes passam" ou "todos os endpoints foram migrados" funcionam como critérios objetivos.

Isso importa porque os maiores ganhos do Opus 5.5 estão em trabalhos de várias etapas. Um caso típico envolve levar uma mudança por um repositório grande até que a suíte de testes fique verde.

Os primeiros testadores deixaram o modelo rodar tarefas de código por horas, com pouca supervisão. Com uma linha de chegada clara, ele sabe quando parar.

No Claude Code, um pedido nesse formato fica assim:

Migrate the payment endpoints from the old client to the new one.
Done means: every endpoint uses the new client, the old client is deleted, and the test suite passes.
Stop and ask me only if a test fails for a reason you can't explain.

Repare que a mensagem traz três coisas: a tarefa, a definição de pronto e a única situação em que você quer ser chamado. Assim, você consegue usar o Opus 5.5 sem ser interrompido a cada passo.

Remova os pedidos para pensar mais

Frases como "think carefully" ou "pense passo a passo" perderam a função. O Opus 5.5 sempre raciocina antes de responder e escolhe sozinho a profundidade desse raciocínio.

Nos testes da Anthropic em um produto de chat, remover uma linha desse tipo fez as respostas começarem mais cedo. Mesmo assim, ninguém notou queda clara de qualidade.

Para usar o Opus 5.5 com respostas mais ágeis, portanto, apague essas linhas dos seus prompts e também das instruções salvas, como o CLAUDE.md. Quando quiser uma resposta rápida para algo simples, diga apenas "Answer directly".

Caso precise ajustar quanto o modelo pensa no Claude Code, mude o nível de effort. Esse é o controle correto, e não um pedido escrito dentro do prompt.

Complemente uma tarefa em andamento

As execuções agora duram mais, então reiniciar uma tarefa custa caro. Se você lembrar de algo no meio do caminho, envie o complemento enquanto o modelo trabalha.

Para usar o Opus 5.5 assim no Claude Code, basta digitar a mensagem e apertar Enter durante a execução. Uma frase como "Also keep the old endpoint names as aliases" já ajusta a rota sem perder o que foi feito.

Liste os estilos que você não quer no design

Sem direção de design, o Opus 5.5 recorre a alguns estilos padrão. Um pedido genérico como "evite um visual genérico" apenas troca um padrão por outro.

Por outro lado, uma lista de padrões específicos funciona muito melhor. Veja um exemplo de pedido para um site pessoal:

Build a personal website with placeholder content.
Don't use a cream or off-white background, italic accent words in headings, numbered "01 / 02 / 03" section labels, monospace labels, or pill-shaped buttons.

Em seguida, observe o que o modelo escolheu no lugar. Se ainda não gostar, acrescente o novo padrão à lista e peça de novo.

Defina as paradas no CLAUDE.md

O Opus 5.5 mantém você informado enquanto trabalha. Às vezes, porém, ele para só para relatar, sem seguir para o próximo passo.

Essas paradas aparecem como um resumo que cita a próxima etapa sem executá-la, uma oferta para continuar ou uma lista de opções que nem bloqueiam o trabalho. A boa notícia é que o modelo respeita instruções que nomeiam essas paradas.

Por isso, antes de usar o Opus 5.5 em tarefas longas, coloque uma regra curta no seu CLAUDE.md:

When a step doesn't need my input, keep going. Put status notes in the same message as your next action.
Stop and ask only when you can't continue without me, or before anything destructive: deleting data, force-pushing, or changing anything outside this repository.

Se uma execução parar com "Want me to continue?", responda apenas "continue". Caso isso aconteça com frequência, a regra acima resolve.

Vale um cuidado importante aqui. Uma regra para seguir em frente significa menos paradas, então mantenha o seu próprio controle antes de qualquer ação arriscada ou difícil de desfazer.

A última linha da regra já cobre esse ponto. Além disso, mantenha os pedidos de permissão ativos para comandos destrutivos.

Em sessões de pair programming, talvez você queira o contrário: um plano de uma linha antes de começar e um resumo curto no fim. Nesse caso, escreva isso no CLAUDE.md, porque o Opus 5.5 segue qualquer um dos dois estilos.

Por que usar o Opus 5.5 com subagentes

Em auditorias, migrações ou revisões que cobrem uma base de código grande, peça ao modelo para dividir o trabalho entre subagentes. Os primeiros testadores colocaram o Opus 5.5 para coordenar subagentes em paralelo, com pouca supervisão.

O segredo é pedir também que ele confira a evidência de cada subagente antes de aceitar o resultado. Veja um exemplo:

Audit every service in services/ for the retry bug in the linked issue.
Give each service to its own subagent. When a subagent reports back, check its evidence before you accept it.
Finish with one table: service, affected yes or no, and the evidence.

Assim, você recebe uma única tabela consolidada, e não dezenas de relatórios soltos. Na prática, essa é uma das formas mais eficientes de usar o Opus 5.5 em tarefas de grande escala.

Mantenha a lista de tarefas em um arquivo

Uma execução longa enche a janela de contexto, e o Claude Code então resume os turnos mais antigos. Uma lista salva em arquivo sobrevive a esse resumo.

Além disso, o arquivo mostra num relance o que já terminou e o que falta. Basta um pedido simples:

Keep a checklist in TASKS.md. Tick each item when it's done, and add anything new you find.

Depois, acompanhe o progresso lendo o arquivo, e não o histórico do terminal. Essa ideia combina bem com a abordagem de spec driven development, em que o plano também vive em arquivos versionados.

Leia primeiro o que ele precisa de você

Quando você termina de usar o Opus 5.5 em uma execução longa, procure primeiro o que o Claude espera de você. Pode ser uma decisão em aberto ou uma mudança que ele quer que você aprove.

Só depois leia o restante do resumo. O Opus 5.5 relata o trabalho com mais clareza que o Opus 5 e separa o que fez, o que encontrou e o que precisa de você.

Caso queira um formato fixo, defina isso no CLAUDE.md. Por exemplo:

End every run with three headings: Blocked on me, Changed, Found.

Quando usar o Opus 5.5 para revisar código

Vale usar o Opus 5.5 para revisar um diff ou um pull request antes de uma pessoa fazer isso. Um dos primeiros testadores relatou que o modelo, no menor nível de effort, encontrou mais bugs que o Opus 5 em effort alto.

Além disso, ele gerou menos falsos alarmes. Como também explica as mudanças em linguagem simples, as descrições de pull request ficam mais fáceis de revisar.

Um bom prompt de revisão foca apenas no que bloqueia o merge:

Review the diff on this branch against main.
List only problems you'd block the merge for. For each one, give the file and line, why it's wrong, and how to show it fails.

Com isso, a revisão humana parte de uma lista curta de problemas reais. Dessa forma, o revisor gasta tempo onde o risco de fato existe.

Peça para marcar o que ele não conseguiu confirmar

Em pesquisas e análises, peça que o modelo aponte o que não encontrou ou não conseguiu verificar. Uma frase como "não encontrei isso" vale a leitura, e pedir explicitamente torna essa informação fácil de achar.

Acrescente ao pedido a instrução "Mark anything you couldn't confirm, and say where you looked". Ela funciona tanto em um relatório de pesquisa do Claude quanto no Claude Code.

Envie imagens e documentos longos

Anexe o gráfico, o diagrama, a captura de tela ou o slide, em vez de digitar os números de novo. O Opus 5.5 lê esse tipo de material com mais precisão que o Opus 5 e não precisa de etapas extras.

Ele também entende melhor o significado que depende da posição dos elementos. Isso inclui quais caixas uma seta conecta, o que mudou entre duas versões de um diagrama ou quando uma reunião começa numa captura do calendário.

Então, anexe a imagem e faça uma pergunta específica, como "Which of these services call the billing API directly?". Quanto mais objetiva a pergunta, melhor a resposta.

Documentos longos seguem a mesma lógica quando você decide usar o Opus 5.5 como revisor. O modelo presta mais atenção a detalhes que os Opus anteriores, por isso vale entregar um plano, relatório ou apresentação e pedir que ele encontre erros.

Nos testes da Anthropic, ele pegou uma data que caía no dia da semana errado em uma longa conversa de planejamento. Também encontrou um gráfico que não batia com os números de uma apresentação.

Um pedido útil para isso é "Check this deck for anything that contradicts itself: numbers, dates and names. Quote each problem and say where it is."

Peça arquivos prontos e marque respostas resolvidas

Ao usar o Opus 5.5 para gerar uma planilha ou um documento, peça o arquivo final, e não um esboço. Segundo a Anthropic, o que o Opus 5.5 produz precisa de menos edição antes de você compartilhar.

Por exemplo, "Make this a spreadsheet I can share: one row per vendor, with columns for cost, contract end date and owner" já descreve linhas, colunas e o objetivo de compartilhamento.

Em conversas longas, porém, o modelo às vezes revisita uma resposta anterior enquanto pensa num complemento curto. Isso deixa a resposta mais lenta.

Para evitar esse efeito em um projeto, acrescente uma instrução às instruções do projeto:

Once you have answered something, treat that answer as done. Focus on what I'm asking now, and don't go back over an earlier answer unless I ask about it or point out a problem with it.

No entanto, deixe essa instrução de fora em projetos de análise longa. Nesses casos, uma etapa posterior pode revelar um erro numa etapa anterior, e você quer que o modelo volte a ela.

Nos apps do Claude e no Claude Code

Nos apps, aparece um aviso que começa com "Switched to" seguido do nome de um modelo mais antigo. A conversa continua nesse modelo até você mudar.

Para voltar a usar o Opus 5.5, escolha o modelo no seletor. Se a mensagem anterior ainda estiver na conversa, ela pode disparar o filtro de novo, então começar uma nova conversa evita o problema.

Caso prefira decidir antes da troca, vá em Settings, depois Capabilities, e desligue a opção "Switch models when a message is flagged". Assim, você verá um cartão de pausa com as opções disponíveis.

Lembre também que a verificação cobre toda a conversa, incluindo arquivos e resultados de busca. Ou seja, o alerta pode vir de um conteúdo anterior, e não só da sua última mensagem.

No Claude Code, o aviso também mostra o modelo mais antigo, e a sessão continua nele. Os comandos principais para lidar com isso estão abaixo:

• Rode /model para voltar ao Opus 5.5.
• Aperte Esc duas vezes para editar sua última mensagem e tentar de novo.
• Use /config para mudar a opção "Switch models when a message is flagged".
• Envie /feedback quando o alerta estiver errado.

Não peça o raciocínio interno na resposta

Remova dos seus prompts e instruções qualquer pedido para reproduzir o raciocínio interno do modelo na resposta. Esse tipo de pedido pode ser recusado, porque faz parte das categorias que disparam o alerta.

Em vez disso, ao usar o Opus 5.5, peça exatamente o que você precisa. Por exemplo, "Explain why you chose this approach in three sentences" entrega a justificativa sem esbarrar no filtro.