Modo de planejamento do Claude Code: como usar e quando economiza tempo e tokens

O que o modo de planejamento do Claude Code faz

O modo de planejamento separa a proposta de uma mudança de sua implementação. O Claude investiga a tarefa, propõe uma abordagem e aguarda aprovação para que você possa revisar e ajustar o plano antes de prosseguir.

O Perguntas frequentes para usuários do Claude Code, datadas de 7 de agosto de 2026, descrevem plan como um planejamento somente de leitura que aguarda aprovação. Isso o torna útil quando você quer verificar a compreensão do Claude sobre uma tarefa antes de permitir a implementação.

Somente leitura não significa ausência de ferramentas. Claude pode ler arquivos e usar ferramentas somente de leitura durante o planejamento. O histórico de versões disponível até agosto de 14, 2026 inclui uma correção para chamadas de ferramentas somente de leitura em sessões iniciadas no Modo de Planejamento. Portanto, seria enganoso dizer que o planejamento impede todos os comandos ou toda inspeção do repositório.

Modo de Planejamento e outros modos de permissão

O planejamento determina se Claude está propondo o trabalho ou executando-o. O modo de permissão usado na implementação determina quais ações exigem aprovação.

Na data de publicação, o nome exibido para o antigo default modo de permissão é Manual. A versão 2.1.200 introduziu essa mudança de nome na interface e passou a aceitar manual junto com default nas configurações e opções de linha de comando correspondentes.

Como entrar e sair do Modo de Planejamento

Há três formas úteis de entrar: alternar entre os modos de permissão durante uma sessão, usar /plan, ou iniciar Claude Code com a opção do Modo de Planejamento.

Use Shift+Tab durante uma sessão

Pressione Shift+Tab para alternar entre os modos de permissão até selecionar o Modo de Planejamento. Partindo do estado inicial comum descrito no guia de abril de 15 da Anthropic, o primeiro toque entra em acceptEdits e o segundo entra no Modo de Planejamento.

Trate “pressionar duas vezes” como uma descrição desse estado inicial, e não como uma regra universal. Sua sessão já pode estar em outro modo, portanto confira o modo selecionado ao alternar.

Para sair do Modo de Planejamento, use Shift+Tab para alternar para o modo de permissão desejado para a implementação. Revise o plano primeiro e depois prossiga com o trabalho acordado nesse modo.

Entre diretamente com /plan

Dentro de uma sessão, use:

/plan

Você também pode incluir a tarefa imediatamente:

/plan fix the auth bug

O argumento de descrição foi adicionado na v2.1.72 em março de 10, 2026. Ele entra no Modo de Planejamento e inicia o planejamento dessa tarefa, permitindo expressar tanto o modo quanto a tarefa em um único comando.

Inicie uma nova sessão no Modo de Planejamento

Para começar com o planejamento selecionado, execute:

claude --permission-mode plan

Isso é útil quando você já sabe que a tarefa precisa de investigação e revisão antes da implementação. Para informações relacionadas ao uso da linha de comando, consulte o referência da CLI do Claude Code.

Essas formas de entrada levam ao mesmo fluxo de planejamento. Escolha o atalho para uma conversa em andamento, /plan quando quiser um comando explícito, e a opção de inicialização quando o planejamento deve ser o modo inicial da sessão.

Crie um plano pronto para implementação

Um plano útil do Claude Code deve facilitar a avaliação da alteração proposta. Forneça a Claude contexto suficiente para identificar o código relevante e critérios de aceitação suficientes para entender o que significa uma implementação bem-sucedida.

O guia de contexto e prompts melhores recomenda fornecer referências aos arquivos relevantes e revisar o plano na conversa antes de trocar de modo e implementar uma etapa.

Forneça caminhos conhecidos e critérios de aceitação

Referencie arquivos com @path/to/file quando você já souber onde está o código relevante. O guia afirma que fornecer essas referências é mais rápido e usa menos tokens do que fazer Claude localizar os arquivos.

Combine esses caminhos com uma definição concreta de sucesso. Para um bug de autenticação, por exemplo, você pode descrever o comportamento que apresenta falha, identificar os arquivos relevantes e indicar o comportamento esperado após a correção. Essa é uma sugestão de como formular uma tarefa, não uma afirmação sobre um repositório específico.

Informações úteis para incluir:

• O comportamento que precisa mudar.
• Arquivos relevantes que você já conhece.
• Restrições ao escopo da alteração.
• Critérios de aceitação para o trabalho concluído.

O objetivo é reduzir a incerteza antes da implementação. Uma descrição detalhada do resultado desejado é mais útil do que pedir um plano sem explicar o que a alteração deve alcançar.

Revise o plano antes de aprová-lo

Verifique se a abordagem proposta atende ao comportamento solicitado e permanece dentro do escopo pretendido. Para trabalhos que envolvem vários arquivos, revise como as etapas se articulam antes de permitir que as alterações prossigam.

Se o plano refletir um mal-entendido, corrija-o na conversa. As orientações da Anthropic apoiam explicitamente a revisão e o ajuste do plano antes de trocar de modo e implementar uma etapa.

A aprovação marca a transição da revisão da abordagem para a implementação. O modo de permissão selecionado para a implementação continua sendo relevante: aprovar um plano não torna Manual, acceptEdits e auto equivalentes.

Quando o planejamento economiza tempo e tokens

O modo de planejamento do Claude Code é mais útil quando resolver incertezas logo no início pode evitar trabalho desnecessário de implementação. Alterações que envolvem vários arquivos são boas candidatas, pois uma suposição incorreta pode afetar várias partes da alteração proposta.

Os mecanismos de economia respaldados pelas evidências são específicos: identificar mal-entendidos antes que se tornem um diff extenso, reduzir rodadas de revisão ao definir o sucesso antecipadamente e evitar buscas desnecessárias por arquivos ao fornecer caminhos conhecidos.

Use o planejamento quando o escopo precisar de revisão

Considere o Modo de Planejamento quando uma tarefa envolver vários arquivos ou quando você precisar confirmar a abordagem antes de começar as edições. Revisar o plano oferece a oportunidade de restringir o escopo, corrigir suposições ou alterar a ordem do trabalho.

Para uma alteração pequena e claramente especificada, considere se uma rodada separada de planejamento resolveria alguma incerteza relevante. Se o arquivo afetado e o comportamento exigido já estiverem claros, uma conversa extensa de planejamento pode trazer menos benefícios.

Essa é uma avaliação do fluxo de trabalho, não um benchmark. O resumo da pesquisa não estabelece um limiar medido a partir do qual o planejamento se torna mais rápido.

Mantenha precisa a afirmação sobre tokens

O planejamento acrescenta uma rodada de trabalho antes da implementação. Seu benefício potencial vem de evitar trabalho que, de outra forma, seria repetido ou descartado.

Essa distinção importa ao avaliar o uso de tokens. Fornecer um caminho de arquivo conhecido tem respaldo documentado como forma de economizar tokens em buscas. A revisão do plano também pode ajudar a reduzir mal-entendidos e rodadas de revisão, mas as evidências disponíveis não quantificam a economia líquida do Modo de Planejamento.

Não há um benchmark oficial estabelecido anterior à data de corte que sustente uma redução percentual fixa de tempo ou tokens. Também não há um preço ou uma franquia de uso específicos do Modo de Planejamento estabelecidos nas evidências fornecidas.

Use o planejamento para melhorar a qualidade da próxima etapa de implementação e avalie a economia em termos de buscas e revisões evitadas. Para uma discussão mais ampla desse objetivo, consulte como reduzir o uso de tokens do Claude.

Modo de Planejamento, opusplan, e limpeza de contexto

O modo de permissão e a seleção de modelo são escolhas separadas. Entrar no Modo de Planejamento seleciona o comportamento de planejamento; uma configuração de planejamento com Opus determina qual modelo realiza esse trabalho.

O que opusplan significa

A versão 1.0.77 introduziu Modo de Planejamento com Opus em /model, usando Opus para planejamento e Sonnet nos demais casos. O registro de alterações na data de corte de agosto de 14, 2026 também documenta o opusplan alias.

Não trate opusplan como sinônimo do plan modo de permissão. Um diz respeito à seleção de modelo entre o planejamento e outros trabalhos; o outro diz respeito ao planejamento somente de leitura e à aprovação.

As versões exatas dos modelos e qualquer economia resultante dependem da configuração. As evidências fornecidas não estabelecem um percentual fixo de economia para essa combinação. O guia de modelos do Claude Code oferece um ponto de partida para explorar a seleção de modelo separadamente das configurações de permissão.

Você deve limpar o contexto antes da implementação?

A limpeza de contexto é opcional. A versão 2.1.81, lançada em março de 20, 2026, ocultou por padrão a opção “limpar contexto” na aprovação do plano.

Para restaurar essa opção, use a configuração:

{
  "showClearContextOnPlanAccept": true
}

O Notas de versão da v2.1.81 documentam essa alteração. Restaurar a opção a disponibiliza na aprovação do plano; as evidências não estabelecem que limpar o contexto sempre economiza tokens ou melhora a implementação.

Defina o planejamento como padrão

Se você costuma querer revisar uma abordagem antes da implementação, pode configurar o Modo de Planejamento como padrão:

{
  "permissions": {
    "defaultMode": "plan"
  }
}

A discussão no repositório de julho de 28, 2025 situa essa configuração em ~/.claude/settings.json.

Há uma ressalva sobre a fonte: o exemplo datado é um comentário da comunidade no repositório oficial da Anthropic. A documentação oficial atual sobre modos de permissão corrobora a configuração, mas a data de sua revisão histórica é incerta.

Use a opção de inicialização quando quiser planejar uma sessão específica. Considere a configuração padrão quando revisar um plano primeiro fizer parte do seu fluxo de trabalho habitual. Em ambos os casos, você pode revisar e ajustar a abordagem proposta e depois trocar de modo para a implementação.

Principais conclusões

• O modo de planejamento permite planejar em modo somente leitura, com uma etapa de aprovação. Ele pode inspecionar arquivos e usar ferramentas de somente leitura enquanto prepara a abordagem.
• Entre usando Shift+Tab, /plan, ou claude --permission-mode plan; a quantidade de vezes que você precisa pressionar o atalho depende do modo inicial.
• Forneça caminhos de arquivos conhecidos e critérios de aceitação para reduzir buscas e rodadas de revisão.
• O planejamento é especialmente útil para revisar alterações em vários arquivos, mas não há uma porcentagem fixa estabelecida de economia de tempo ou tokens.
• opusplan diz respeito à seleção do modelo, enquanto a limpeza do contexto é uma configuração opcional da aprovação do plano.

Perguntas frequentes

Como entro e saio do modo de planejamento com Shift+Tab?

Pressione Shift+Tab para alternar entre os modos de permissão até selecionar o modo de planejamento. Para sair dele, alterne para o modo desejado para a implementação; a quantidade de vezes que você precisa pressionar o atalho depende do modo atual da sessão.

O modo de planejamento pode ler arquivos ou executar comandos de shell?

O modo de planejamento pode ler arquivos e usar ferramentas de somente leitura enquanto prepara um plano. É incorreto dizer que ele bloqueia todos os comandos, mas seu comportamento documentado é planejar em modo somente leitura e aguardar aprovação antes da implementação.

Como inicio todas as sessões no modo de planejamento?

Defina permissions.defaultMode para "plan" em ~/.claude/settings.json, conforme mostrado na discussão datada do repositório. Para uma única sessão, inicie o Claude Code com claude --permission-mode plan.

O modo de planejamento economiza tokens?

Fornecer caminhos de arquivos conhecidos economiza tokens de busca, e definir critérios de aceitação pode reduzir as rodadas de revisão. O planejamento em si acrescenta trabalho, portanto a economia líquida depende do que ele ajuda a evitar; as evidências fornecidas não estabelecem uma porcentagem fixa nem um parâmetro oficial de economia líquida.