O que é o opusplan do Claude Code? Opus para planejar, Sonnet para implementar: como configurar e cuidados

Você quer deixar só o planejamento com um modelo mais inteligente e passar a escrita do código propriamente dita para um modelo mais rápido e mais barato. O Claude Code tem uma configuração que faz exatamente isso de forma automática: opusplan.

Resposta direta: opusplan é uma indicação de modelo que roda no Opus enquanto você está no modo de planejamento e no Sonnet no resto do tempo. Para usar, digite /model opusplan ou escreva no model do settings.json. Mas ele não aparece na lista do /model, então quem não conhece o nome não o encontra. Além disso, como o modelo troca toda vez que você entra ou sai do modo de planejamento, é preciso lembrar que a cada troca a conversa inteira é relida sem cache.

Neste artigo, com base na documentação oficial, no histórico de mudanças do Claude Code (CHANGELOG) e nas issues do GitHub em 15 de setembro de 2026, organizo como configurar, como funciona na prática, por que ele não aparece na lista, os cuidados com preço e cache e as diferenças em relação a mecanismos parecidos (a ferramenta advisor e os subagentes).

1. O que é o opusplan: Opus só durante o modo de planejamento

opusplan é um alias (apelido) de modelo que você pode indicar no /model, assim como sonnet e opus. A documentação oficial o descreve como um modo especial que usa opus no modo de planejamento e troca para sonnet na execução.

O que decide a troca é apenas se você está ou não no modo de planejamento. O modo de planejamento é o estado em que o Claude lê arquivos e investiga com comandos para escrever um plano, sem editar o código-fonte até que você o aprove (o panorama dos modos de permissão está em Modos de permissão do Claude Code: guia completo dos 5 modos).

Fonte: documentação oficial do Claude Code, "Model configuration" (em 15 de setembro de 2026). O destino muda conforme o provedor: no Amazon Bedrock e na Agent Platform do Google Cloud, por exemplo, sonnet é o Sonnet 4.5

Existe mais um mecanismo parecido. Uma sessão que roda no Haiku sobe automaticamente para o Sonnet, só enquanto está no modo de planejamento (introduzido na v2.0.17, junto com o Haiku 4.5; no lançamento, a subida automática não acontecia no Amazon Bedrock nem no Google Vertex AI). Esse funciona sem nenhuma configuração.

2. Como configurar

A forma de indicar é a mesma de qualquer outro modelo. Listo os métodos na ordem de prioridade descrita na documentação oficial, do mais alto para o mais baixo.

Digitar /model opusplan não só troca a sessão atual: o valor é gravado no model das configurações do usuário e passa a ser também o padrão das novas sessões. Se quiser experimentar só desta vez, inicie com claude --model opusplan.

{
  "model": "opusplan"
}

Há outras três indicações que vale conhecer.

• Fixar a versão dos modelos usados: o Opus que o opusplan usa no modo de planejamento é definido por ANTHROPIC_DEFAULT_OPUS_MODEL, e o Sonnet usado no resto do tempo, por ANTHROPIC_DEFAULT_SONNET_MODEL. No Amazon Bedrock e em provedores semelhantes, escreva ali os IDs de modelo do seu provedor
• Usar com contexto de 1M tokens: nos planos em que o Opus passa automaticamente para 1M, como Max, Team e Enterprise, o lado Opus do opusplan também fica com 1M. Nos demais, para ter 1M nos dois lados, indique opusplan[1m]. Indicar com /model opusplan[1m] só funciona a partir da v2.1.265; antes disso, use --model ou o arquivo de configurações
• Não funciona na variável de ambiente do modelo padrão: colocar opusplan em ANTHROPIC_DEFAULT_MODEL, que define o padrão das novas sessões, é ignorado. Para torná-lo o padrão, digite /model opusplan ou escreva no model do settings.json

Fonte: documentação oficial do Claude Code, "Model configuration" (Setting your model, Environment variables, Extended context, opusplan model setting), idem, "Settings reference" (model)

3. Como funciona na prática

Só indicar o opusplan não basta: ele continua rodando no Sonnet. Ele só vira Opus quando você mesmo entra no modo de planejamento.

1. Entre no modo de planejamento: no terminal, alterne com Shift+Tab ou coloque /plan no início do pedido. Para já começar nele, use claude --permission-mode plan. No app desktop, escolha-o na seleção do modo de permissão (o seletor de modo)
2. O Opus escreve o plano: ele lê arquivos e investiga com comandos, e monta o plano sem editar nada. Com Ctrl+G, você também pode abrir o plano no seu editor e alterá-lo diretamente
3. Aprove o plano: escolha entre seguir no modo automático ("Yes, and use auto mode"), aprovar as edições uma a uma ("Yes, manually approve edits") ou continuar planejando ("No, keep planning"); quando o modo automático não está disponível, a primeira opção passa a ser aprovar as edições automaticamente ("Yes, auto-accept edits"). Ao aprovar, você sai do modo de planejamento, e a partir daí quem implementa é o Sonnet
4. Se quiser planejar de novo: volte ao modo de planejamento com Shift+Tab ou coloque /plan no início do próximo pedido. Enquanto estiver lá, ele volta a ser o Opus

Se você definir a configuração showClearContextOnPlanAccept como true, uma opção para limpar o contexto e aprovar ("Yes, clear context and …") é acrescentada no topo das escolhas de aprovação. É a opção de descartar coisas como o conteúdo dos arquivos lidos durante o planejamento e começar a implementação levando só o plano (o padrão é false). Como explico na seção 5, no opusplan isso também faz diferença no custo.

Fonte: documentação oficial do Claude Code, "Choose a permission mode" (Analyze before you edit with plan mode, Review and approve a plan), idem, "Settings reference" (showClearContextOnPlanAccept), idem, "Desktop" (seleção do modo de permissão)

Não pergunte ao próprio modelo em qual modelo ele está rodando. Numa discussão no GitHub em setembro de 2025, um funcionário da Anthropic escreveu que, em vez de perguntar ao modelo o que ele é, deve-se conferir o que a aplicação exibe. As formas de conferir estão reunidas na P3 do FAQ.

4. Por que ele não aparece na lista do /model

O opusplan não é um recurso novo. Ele não aparece na lista porque, em certo momento, foi retirado da interface. Seguindo o histórico de mudanças e as issues do GitHub, a sequência é esta.

Fonte: Claude Code CHANGELOG, issue #8358 do GitHub, #26556, #27237 (todos conferidos em 15 de setembro de 2026)

🟡 A Anthropic não voltou a explicar por que ele não aparece na lista hoje. A explicação de setembro de 2025 comparava o Sonnet 4.5 e o Opus 4.1 da época. Não se sabe se o mesmo julgamento continua valendo para a dupla Opus 5 e Sonnet 5. Por outro lado, a documentação oficial ainda tem uma seção sobre o opusplan, e o histórico de mudanças traz correções feitas já em 2026, então ele continua utilizável como configuração.

Também há relatos, como a issue #27237, de que a versão escolhida não foi a esperada. Mas o ID de modelo que aparece nesse relato está no formato do Google Cloud, e a documentação oficial atual também aponta sonnet para o Sonnet 4.5 no Google Cloud, então pode ter sido o funcionamento previsto (leitura minha). Se isso preocupa você, fixe as versões com as duas variáveis de ambiente acima e confira qual modelo realmente rodou.

5. Preços e cache: cada troca obriga a reler tudo

Boa parte de quem usa o opusplan quer reduzir o uso ou o custo. Passando a implementação para o Sonnet, o preço por token cai.

Fonte: Claude Platform Docs, "Pricing" (por milhão de tokens, em 15 de setembro de 2026)

Mas há um custo fácil de passar despercebido. O cache de prompt é separado para cada modelo, e a documentação oficial diz que, no opusplan, entrar e sair do modo de planejamento é uma troca de modelo e, a cada vez, o cache é criado do zero. Ou seja, a primeira resposta do Sonnet logo depois de sair do modo de planejamento e a primeira resposta do Opus logo depois de voltar a ele leem toda a conversa até ali sem cache.

Para ter uma ideia do tamanho, calculei o caso de uma troca feita quando a conversa já chegou a 100 mil tokens. Na assinatura, dentro do plano, o cache da conversa principal dura 1 hora, então contei a escrita pelo preço do cache de 1 hora. Vale notar que, com chave de API ou por meio de um provedor de nuvem, também dá para dar à conversa principal um cache de 1 hora definindo promptCacheTtl como 1h (v2.1.242 ou posterior) e que, ao contrário, mesmo na assinatura o cache cai para 5 minutos enquanto você paga com usage credits além do plano.

Fonte: minha própria estimativa com base nos preços oficiais (100 mil tokens × preço). 🟡 Não foi divulgado que os limites da assinatura diminuem na mesma proporção desses valores. A validade do cache vem da documentação oficial do Claude Code, "How Claude Code uses prompt caching"

Se você continuasse lendo os mesmos 100 mil tokens no Opus, cada leitura de cache custaria cerca de $0,05. Se você entra e sai do modo de planejamento várias vezes enquanto a parte de implementação ainda é curta, as escritas causadas pelas trocas podem sair mais caras. Há três formas de conter o custo.

• Planeje cedo na conversa: trocando enquanto o contexto ainda é pequeno, a quantidade reescrita também fica pequena
• Limpe o contexto ao aprovar: ative o showClearContextOnPlanAccept e escolha limpar o contexto e aprovar; como o Sonnet começa levando só o plano, ele relê menos
• Não fique indo e voltando entre planejamento e implementação: cada volta ao modo de planejamento provoca uma releitura também do lado do Opus

Vale falar também dos limites da assinatura. O limite da sessão e o limite semanal são comuns a todos os modelos e, à parte, existem limites por família de modelos, como o "limite do Opus" e o "limite do Sonnet". Como o opusplan também usa o Opus no modo de planejamento, se você tiver atingido o limite do Opus, não poderá usar o Opus no modo de planejamento. A página de preços indica o Opus como disponível até no plano Pro, mas, segundo a documentação oficial, usar o Opus com contexto de 1M no Pro exige créditos de uso adicionais (usage credits).

Fonte: documentação oficial do Claude Code, "How Claude Code uses prompt caching" (Switching models, Changing permission mode, Which TTL each request gets), idem, "Error reference" (limites comuns a todos os modelos e limites por família de modelos), idem, "Model configuration" (Extended context), página de preços do Claude (modelos por plano)

6. Diferenças em relação ao advisor e aos subagentes

O opusplan não é a única forma de combinar um modelo forte com um rápido. A documentação oficial compara as opções pelo momento em que o modelo mais forte roda.

Fonte: documentação oficial do Claude Code, "Escalate hard decisions with the advisor tool" (Compare with related features)

A ferramenta advisor mantém a sessão principal num modelo rápido enquanto o Claude consulta um modelo mais forte no meio do trabalho. Diferente do opusplan, ligá-la ou desligá-la não quebra o cache da sessão principal. Porém, a cada consulta o advisor lê a conversa inteira, e essa leitura não fica em cache. Em 15 de setembro de 2026, é um recurso experimental e só está disponível na Anthropic API (não funciona no Amazon Bedrock e em provedores semelhantes).

Os subagentes rodam em outro modelo só o trabalho delegado. A configuração e as medições estão em Como rodar os subagentes do Claude Code em outro modelo.

Fonte: documentação oficial do Claude Code, "Escalate hard decisions with the advisor tool" (Cost, Impact on prompt caching, Requirements)

7. Quando vale a pena e quando não vale

A partir do funcionamento visto até aqui, organizo o que pesar na decisão (não é uma recomendação oficial, e sim a minha leitura derivada do mecanismo).

Na dúvida, o caminho seguro é fazer o mesmo tipo de tarefa uma vez com o opusplan e outra com o seu modelo habitual, e comparar os números do /usage e o resultado. Como ver o uso por sessão em detalhe está explicado em Claude Code: como ver o uso por sessão.

FAQ

P1. Abri o /model e não encontro o opusplan.
Ele não aparece na lista, por design (em 15 de setembro de 2026). Indique-o digitando o nome: /model opusplan. Digitado assim, ele também fica salvo como padrão das novas sessões. Para usar só desta vez, inicie com claude --model opusplan.

P2. Coloquei o opusplan, mas ele continua no Sonnet o tempo todo.
É o esperado. No opusplan, o Opus só entra durante o modo de planejamento, e ele não entra no modo de planejamento sozinho. Alterne com Shift+Tab ou coloque /plan no início do pedido.

P3. Há como conferir em qual modelo ele está rodando agora?
Em vez de perguntar ao modelo, confira o que o app exibe. O /status mostra o modelo atual e, além disso, a linha de status passa o modelo atual para o seu script, então dá para configurá-la para mostrar o nome do modelo. Depois que terminar, o message.model de cada resposta nos logs de conversa (os JSONL em ~/.claude/projects) registra o modelo que realmente respondeu.

P4. Funciona no Amazon Bedrock ou no Google Cloud?
Funciona. Coloque os IDs de modelo do seu provedor em ANTHROPIC_DEFAULT_OPUS_MODEL e ANTHROPIC_DEFAULT_SONNET_MODEL para indicar as versões que o opusplan usa. Se as configurações gerenciadas da sua organização (availableModels) excluem o Opus mais recente, na Anthropic API e no Claude Platform on AWS o planejamento é feito com o Opus mais recente entre os permitidos e, se todos os Opus estiverem excluídos, ele continua no Sonnet mesmo no modo de planejamento. No Bedrock, no Google Cloud, no Microsoft Foundry e em provedores semelhantes, se o modelo estiver excluído, o planejamento continua no modelo original mesmo no modo de planejamento (os dois comportamentos valem a partir da v2.1.205).

P5. O que é opusplan[1m]?
É a indicação para usar contexto de 1 milhão de tokens tanto no Opus do modo de planejamento quanto no Sonnet da execução. Nos planos em que o Opus passa automaticamente para 1M, como Max, Team e Enterprise, o lado Opus fica com 1M mesmo sem ela. Além disso, na Anthropic API o Sonnet 5 sempre usa 1M, mesmo sem indicação. O /model aceita essa forma a partir da v2.1.265.

Fontes

• Claude Code Docs — Model configuration (o que é o opusplan, destino dos aliases, formas de indicar o modelo e sua prioridade, variáveis de ambiente, contexto de 1M, availableModels e a subida de modelo no modo de planejamento)
• Claude Code Docs — Choose a permission mode (como entrar no modo de planejamento, aprovação do plano)
• Claude Code Docs — Settings reference (model, showClearContextOnPlanAccept)
• Claude Code Docs — How Claude Code uses prompt caching (troca de modelo e cache, a troca do modo de planejamento no opusplan, validade do cache)
• Claude Code Docs — Escalate hard decisions with the advisor tool (comparação com recursos relacionados, custo, efeito no cache)
• Claude Code Docs — Error reference (limites de uso)
• Claude Code Docs — Desktop (seleção de modelo e de modo de permissão)
• Claude Code CHANGELOG (v1.0.77, v1.0.88, v2.0.17, v2.1.172, v2.1.265)
• issue #8358 do GitHub, #26556, #27237 (como ele saiu da tela de seleção, a explicação do funcionário da Anthropic, o pedido para aparecer na lista, o relato sobre a versão escolhida)
• Claude Platform Docs — Pricing, página de preços do Claude (preços por modelo, modelos por plano)

Artigos relacionados

• Como rodar os subagentes do Claude Code em outro modelo — dividir os modelos por tarefa
• Modos de permissão do Claude Code: guia completo dos 5 modos — os modos de permissão, incluindo o modo de planejamento
• Claude Code: como ver o uso por sessão — como comparar o uso
• Claude Code: o que está consumindo o seu contexto? — por que a quantidade relida fica grande
• Dicas para Economizar Tokens no Claude Code e o Que Acontece ao Atingir o Limite — onde mais dá para cortar