Desde o lançamento do Opus 5.5, vejo pessoas obterem resultados bem diferentes com o modelo. O guia Getting the most out of Opus 5.5 in Claude and Claude Code, de Addy Osmani, ajuda a entender por quê: ele traz recomendações práticas sobre como pedir tarefas, conduzir execuções longas e revisar os resultados.

Se você não conhece Addy Osmani, ele é uma das pessoas que mais admiro no desenvolvimento web. Depois de décadas no time do Chrome, no Google, passou a trabalhar na equipe do Claude Code. Ele também escreveu livros e compartilha conteúdo sobre inteligência artificial. Estou acompanhando com interesse o que sua experiência pode trazer para a ferramenta.

Como o conteúdo é útil para quem usa o Claude Code no dia a dia, traduzi o post para o português. Traduzi também os prompts de exemplo para você poder adaptá-los e colá-los no Claude Code ou no seu CLAUDE.md. Mantive nomes de arquivos, caminhos, comandos e identificadores técnicos. No final, deixo alguns comentários meus.

Tradução do post original de Addy Osmani, publicado em 22 de setembro de 2026 no blog do claude.dev. Todo o crédito do conteúdo é do autor.

---

O Opus 5.5 funciona bem com a forma como você já usa o Claude. Algumas coisas, porém, se comportam de maneira diferente: ele trabalha por mais tempo sozinho, diz com clareza o que fez e pensa antes de cada resposta. Este guia mostra como trabalhar com o Opus 5.5 nos apps do Claude e no Claude Code, incluindo como escrever o prompt, conduzir uma execução longa e conferir os resultados.

Comece por aqui

Três coisas para testar na sua primeira sessão com o Opus 5.5:

• Entregue a tarefa inteira. Diga como é o "pronto" e quando você quer que ele pare para perguntar. Depois, deixe que ele trabalhe.
• Apague as linhas de "pense com cuidado". O Opus 5.5 já pensa antes de cada resposta.
• Quando uma execução longa terminar, leia primeiro o que ele precisa de você.

1. Como pedir

Diga como é o "pronto" e deixe ele trabalhar

O que fazer. Passe a tarefa inteira em uma única mensagem. Defina a linha de chegada, como "os testes passam" ou "todos os endpoints foram migrados". Depois, deixe que ele siga.

Por que isso importa no Opus 5.5. O Opus 5.5 se mantém em trabalhos longos e com várias partes melhor do que o Opus 5. Em comparação com os modelos Opus anteriores, os maiores ganhos estão em trabalho de várias etapas, como levar uma mudança por um repositório grande até que os testes passem. Os primeiros testers deixaram o modelo rodar tarefas longas de código por horas, com pouca supervisão. Com uma linha de chegada clara, ele sabe quando terminou.

Como. No Claude Code, por exemplo:

Migre os endpoints de pagamento do cliente antigo para o novo.
Pronto significa: todos os endpoints usam o novo cliente, o cliente
antigo foi removido e a suíte de testes passa.
Pare e me pergunte apenas se um teste falhar por um motivo que você
não consegue explicar.

Uma única mensagem com a tarefa inteira, a linha de chegada e quando parar.

Pare de pedir para ele "pensar bastante"

O que fazer. Remova "pense com cuidado", "pense passo a passo" e frases parecidas dos seus prompts e das suas instruções salvas.

Por que isso importa no Opus 5.5. O Opus 5.5 sempre pensa antes de responder, e ele mesmo decide o quanto. Você não precisa pedir. Nos testes da equipe em um produto de chat, remover uma linha pedindo para "pensar com cuidado" fez as respostas começarem mais cedo, sem queda perceptível de qualidade.

Como. Apague a linha. Para uma resposta rápida a uma pergunta simples, diga: "Responda diretamente". Para mudar o quanto ele pensa no Claude Code, ajuste o effort.

Complemente uma tarefa em andamento

O que fazer. Se você lembrar de algo no meio da execução, pode digitar uma mensagem de acompanhamento enquanto ele trabalha.

Por que isso importa no Opus 5.5. As execuções agora são mais longas, então recomeçar custa mais caro.

Como. No Claude Code, digite a mensagem e pressione Enter enquanto o Claude trabalha. Por exemplo: "Mantenha também os nomes antigos dos endpoints como aliases".

Em trabalhos de design, diga quais estilos você não quer

O que fazer. Quando pedir uma página, um app ou um artifact, liste os hábitos de design que você quer deixar de fora.

Por que isso importa no Opus 5.5. Sem direção de design, o Opus 5.5 recorre a alguns estilos padrão. Uma instrução genérica como "evite um visual genérico" na maioria das vezes só troca um padrão por outro. Uma lista de padrões específicos funciona muito melhor.

Como. Nomeie os padrões:

Crie um site pessoal com conteúdo de exemplo.
Não use fundo creme ou branco quebrado, palavras em itálico como
destaque nos títulos, rótulos de seção numerados como "01 / 02 / 03",
rótulos em fonte monoespaçada ou botões em formato de pílula.

Depois, veja o que ele escolheu no lugar. Se também não gostar, adicione à lista e peça de novo.

2. Conduzindo uma execução longa no Claude Code

Diga quais paradas você quer

O que fazer. Coloque uma regra curta no seu arquivo CLAUDE.md dizendo quando parar e perguntar, e quando seguir em frente.

Por que isso importa no Opus 5.5. O Opus 5.5 mantém você informado enquanto trabalha. Em uma tarefa longa, às vezes ele para para reportar em vez de continuar: um resumo que cita o próximo passo sem executá-lo, uma oferta para continuar ou uma lista de opções que não bloqueiam o trabalho. Ele segue instruções que nomeiam essas paradas. Nomeie também as paradas que você quer.

Como. Adicione isto ao CLAUDE.md e ajuste para o seu projeto:

Quando uma etapa não precisar da minha participação, continue.
Inclua as notas de progresso na mesma mensagem da próxima ação.
Pare e me pergunte apenas quando não puder continuar sem mim ou antes
de qualquer ação destrutiva: apagar dados, fazer force-push ou alterar
qualquer coisa fora deste repositório.

Se uma execução parar com "Quer que eu continue?", responda "continue". Se isso acontecer com frequência, a regra acima vai ajudar.

Uma regra para seguir em frente significa menos paradas, então mantenha a sua própria checagem antes de qualquer coisa arriscada ou difícil de desfazer. A última linha da regra acima faz isso. Mantenha também os permission prompts ligados para comandos destrutivos.

Para pair programming, talvez você queira o oposto: um plano de uma linha antes de começar e um resumo curto no final. Nesse caso, escreva isso no CLAUDE.md. O Opus 5.5 segue qualquer uma das duas abordagens.

Peça para dividir trabalhos grandes entre subagents

O que fazer. Para uma auditoria, uma migração ou uma revisão em uma codebase grande, peça ao Opus 5.5 para dividir o trabalho entre subagents e conferir cada resultado.

Por que isso importa no Opus 5.5. Os primeiros testers usaram o Opus 5.5 para coordenar subagents em paralelo em auditorias e migrações longas, com pouca supervisão.

Como.

Audite todos os serviços em services/ para encontrar o bug de retry
descrito na issue vinculada. Atribua cada serviço a um subagent.
Quando ele responder, confira as evidências antes de aceitar o resultado.
Termine com uma única tabela: serviço, afetado (sim ou não) e evidências.

Distribua entre subagents, confira as evidências de cada um e finalize com uma única tabela.

Mantenha a lista de tarefas em um arquivo

O que fazer. Em uma execução que vai demorar, peça ao Opus 5.5 para manter a lista de tarefas em um arquivo e atualizá-la conforme avança. Depois, leia o arquivo, e não o histórico do terminal, para saber em que ponto a execução está.

Por que isso importa no Opus 5.5. As execuções agora são mais longas. Uma execução longa enche a context window, e o Claude Code passa a resumir os turnos mais antigos. Uma lista em arquivo sobrevive a isso e mostra de relance o que já foi feito e o que falta.

Como. "Mantenha uma lista de tarefas em TASKS.md. Marque cada item quando terminar e acrescente as novas tarefas que encontrar."

3. Conferindo o resultado

Leia primeiro o que ele precisa de você

O que fazer. Quando uma execução longa terminar, procure primeiro qualquer coisa que o Claude esteja esperando de você, como uma decisão que ficou em aberto ou uma mudança que ele quer que você aprove. Depois, leia o restante do resumo.

Por que isso importa no Opus 5.5. O Opus 5.5 reporta o próprio trabalho com mais clareza do que o Opus 5. As atualizações e o resumo final dizem o que ele fez, o que encontrou e o que precisa de você, em linguagem simples.

Como. Para mudar o formato do resumo, diga isso no CLAUDE.md. Por exemplo: "Encerre cada execução com três seções: Depende de mim, Alterações e Descobertas".

Peça para ele revisar o código

O que fazer. Peça ao Opus 5.5 para revisar um diff ou um pull request antes de uma pessoa revisar.

Por que isso importa no Opus 5.5. Um dos primeiros testers disse que o Opus 5.5 no effort mais baixo encontrou mais bugs do que o Opus 5 em effort alto, e com menos falsos alarmes. Ele também explica suas mudanças em linguagem simples, então as descrições de pull request ficam mais fáceis de revisar.

Como. Use este prompt:

Revise o diff desta branch em relação à main.
Liste apenas problemas que impediriam o merge. Para cada um,
informe o arquivo e a linha, por que está errado e como reproduzir a falha.

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

O que fazer. Em pesquisas e análises, peça para ele dizer o que não conseguiu encontrar ou verificar.

Por que isso importa no Opus 5.5. Um "não consegui encontrar isso" vale a leitura, e pedir por ele torna essa informação fácil de achar.

Como. Adicione "Marque tudo o que você não conseguiu confirmar e diga onde procurou" ao pedido. Isso funciona tanto em um relatório de pesquisa no Claude quanto no Claude Code.

4. Nos apps do Claude

Primeiro, confira se o seletor de modelo mostra Opus 5.5.

Compartilhe o gráfico ou o screenshot em si

O que fazer. Anexe o gráfico, o diagrama, o screenshot ou o slide. Não redigite os números.

Por que isso importa no Opus 5.5. O Opus 5.5 lê gráficos, diagramas e screenshots com mais precisão do que o Opus 5, sem precisar de etapas extras. Ele também é melhor em entender significados que dependem da posição dos elementos na imagem: quais caixas uma seta conecta, o que mudou entre duas versões de um diagrama, ou quando uma reunião começa e termina em um screenshot de calendário.

Como. Anexe a imagem e faça uma pergunta específica: "Quais destes serviços chamam a API de cobrança diretamente?".

Peça para ele revisar um documento longo

O que fazer. Entregue um plano, relatório ou apresentação longa e peça para ele encontrar erros.

Por que isso importa no Opus 5.5. O Opus 5.5 presta mais atenção aos detalhes do que os modelos Opus anteriores. Nos testes da equipe, ele encontrou uma data que caía no dia da semana errado em uma longa thread de planejamento, e um gráfico que não batia com os números de uma apresentação.

Como. Envie o prompt: "Confira esta apresentação e encontre contradições em números, datas e nomes. Cite cada problema e indique onde ele aparece."

Peça o arquivo pronto

O que fazer. Quando quiser uma planilha ou um documento, peça o arquivo, e não um esboço.

Por que isso importa no Opus 5.5. As planilhas e documentos que o Opus 5.5 gera precisam de menos edição do que os do Opus 5 antes de serem compartilhados.

Como. "Crie uma planilha compartilhável: uma linha por fornecedor, com colunas para custo, data de término do contrato e responsável."

Em um projeto, diga quando as respostas estão resolvidas

O que fazer. Se as perguntas de acompanhamento em um chat longo parecerem lentas, adicione uma instrução dizendo que as respostas anteriores estão resolvidas.

Por que isso importa no Opus 5.5. Em um chat longo, o Opus 5.5 às vezes revisita uma resposta anterior enquanto pensa em uma pergunta curta. Isso deixa a resposta mais lenta.

Como. Adicione isto às instruções do projeto:

Quando responder a uma pergunta, considere a resposta concluída.
Concentre-se no que estou perguntando agora e não retome uma resposta
anterior, a menos que eu peça ou aponte um problema nela.

Deixe essa instrução de fora em projetos de análise longa, em que uma etapa posterior pode revelar um erro em uma anterior.

5. Quando uma mensagem é sinalizada

O Opus 5.5 é o primeiro modelo Opus lançado com salvaguardas de bio e cyber no nível do Fable. Nos apps do Claude e no Claude Code, a maioria das mensagens sinalizadas é transferida para um modelo mais antigo, e o seu trabalho continua lá. Encontrar vulnerabilidades de segurança em código-fonte é permitido, e perguntas do dia a dia sobre saúde e educação devem continuar funcionando. Essas salvaguardas podem, às vezes, sinalizar trabalhos legítimos, e a equipe está ajustando-as para reduzir sinalizações incorretas. Se você for transferido, veja o que vai aparecer e o que fazer.

Nos apps do Claude

O que você vê. Um aviso que começa com "Switched to" e o nome de um modelo mais antigo. O Claude responde com esse modelo, e o chat continua nele.

O que fazer.

• Para voltar ao Opus 5.5, escolha-o no seletor de modelo. Se a mensagem anterior ainda estiver no chat, ela pode ser sinalizada de novo. Começar um novo chat evita isso.
• Para ser consultado antes, vá em Settings, depois Capabilities, e desative "Switch models when a message is flagged". Você verá um card de "pausado" com as suas opções.

A checagem cobre tudo na conversa, incluindo arquivos e resultados de busca. Então a sinalização pode vir de um conteúdo anterior, e não só da sua última mensagem.

No Claude Code

O que você vê. Um aviso com o nome do modelo mais antigo. A sessão continua nesse modelo.

O que fazer.

• Rode /model para voltar.
• Pressione Esc duas vezes para editar sua última mensagem e tentar de novo.
• Para ser consultado antes, rode /config e altere "Switch models when a message is flagged".
• Rode /feedback se a sinalização estiver errada.

Não peça para ele mostrar o raciocínio na resposta

O que fazer. Remova dos seus prompts e instruções os pedidos para reproduzir o raciocínio interno na resposta.

Por que isso importa no Opus 5.5. Um pedido para reproduzir o raciocínio interno na resposta pode ser recusado. Essa é uma das categorias de sinalização.

Como. Peça ao Claude o que você realmente precisa. Por exemplo: "Explique em três frases por que escolheu esta abordagem."

6. Velocidade

Ative o fast mode quando estiver esperando cada resposta

O que fazer. No Claude Code, use o fast mode para trabalhos de ida e volta, em que você lê cada resposta antes de enviar a próxima mensagem.

Por que isso importa no Opus 5.5. O fast mode está disponível para o Opus 5.5 desde o lançamento, como research preview. É o mesmo modelo, e o texto chega mais rápido. Ele exige o uso extra ativado e custa mais por token do que o modo padrão.

Como. Digite /fast no Claude.

Seu checklist do Opus 5.5

Revise esta lista antes da sua próxima tarefa longa.

Pedindo

• A tarefa diz como é o "pronto".
• Nenhuma linha pedindo para "pensar bastante" nos prompts ou nas instruções salvas.
• Pedidos de design listam os estilos que devem ficar de fora.
• Gráficos e screenshots são anexados, e não redigitados.

Execuções longas no Claude Code

• O CLAUDE.md diz quando parar e quando seguir, e manda parar antes de qualquer ação destrutiva.
• Os permission prompts continuam ligados para comandos destrutivos.
• Auditorias e migrações grandes são divididas entre subagents.
• A lista de tarefas fica em um arquivo.

Conferindo

• A parte "o que precisa de você" do relatório é lida primeiro.
• Uma revisão automática roda antes da revisão de uma pessoa.
• Respostas de pesquisa marcam o que não pôde ser confirmado.

Sinalizações

• Você sabe como voltar: pelo seletor de modelo ou com /model.
• A opção "Switch models when a message is flagged" está configurada do jeito que você quer.

---

Meus comentários

Duas dicas do guia mudaram meu fluxo logo nos primeiros dias com o Opus 5.5.

A primeira é a linha de chegada. Durante muito tempo eu quebrava tarefas grandes em vários prompts pequenos, porque os modelos se perdiam no meio do caminho. Com o Opus 5.5, faz mais sentido descrever o resultado final e os critérios de parada em uma única mensagem, e deixar o modelo trabalhar.

A segunda é a regra de paradas no CLAUDE.md. Ela conversa diretamente com o que eu já comentei no post sobre subagents no Claude Code e no Antigravity CLI: quanto mais autonomia você dá ao agente, mais importante é deixar explícito o que ele não pode fazer sem perguntar. Autonomia sem limites claros não é produtividade, é risco.

E um lembrete que vale para qualquer modelo: o fato de o Opus 5.5 reportar melhor o próprio trabalho não substitui a sua revisão. Use o resumo dele como ponto de partida, comece pelo que ele precisa de você e continue lendo o diff.

Também estou preparando um vídeo com as cinco dicas que considero mais práticas desse guia, com demonstrações no Claude Code. Você pode acompanhar o canal em youtube.com/@fellyphcintra.

Leia o post original em inglês: Getting the most out of Opus 5.5 in Claude and Claude Code, de Addy Osmani.