Modos de planeamento

Problema: O Claude Code entrega código rapidamente. Às vezes, demasiado rápido. Pediste uma «solução rápida» e recebeste doze ficheiros modificados, com uma alteração que causa incompatibilidade incorporada em dois deles.

Solução rápida: Carrega duas vezes em Shift+Tab para entrar no modo de planeamento agora mesmo. O Claude vai analisar o projeto e não vai mexer num único ficheiro até que dês o teu aval.

O modo de planeamento altera a forma como uma edição complexa é efetivamente aplicada. Em vez de cruzares os dedos para que o Claude acerte à primeira, vês a estratégia antes de qualquer código ser executado.

Antes de o Modo de Planeamento existir, a solução alternativa era uma mensagem do tipo:

"Não codes nada ainda, apenas analisa o problema e sugere abordagens"

Isso funcionava, às vezes. As respostas do Claude variavam muito em forma e profundidade. Uma execução dava uma única linha. A seguinte dava um pequeno romance.

Com o Modo de Planeamento, o resultado é estruturado e previsível em todas as ocasiões. Obténs:

Opções numeradas com as suas vantagens e desvantagens explicadas
Uma leitura da complexidade de cada abordagem
As alterações necessárias no ficheiro, listadas logo à partida
Um formato consistente que é rápido de analisar

Ativação e Controlo

Shift+Tab coloca-te duas vezes no modo de planeamento. A interface confirma isso. O Claude ainda consegue ler tudo no repositório, mas não pode modificar nada.

Shift+Tab O «once more» leva-te de volta para fora. O Claude pede então uma confirmação explícita antes de executar qualquer coisa.

Dica profissional: o modo de planeamento é rápido. Sem execução de ferramentas, sem gravações de ficheiros. As respostas chegam rapidamente e gastam menos tokens.

O que o Claude pode fazer no modo de planeamento

Acesso apenas de leitura:

Análise do conteúdo dos ficheiros com as ferramentas Read e LS
Pesquisa na base de código com Glob e Grep
Pesquisa na Web com WebSearch e WebFetch
Organização de tarefas com TodoRead/TodoWrite
Visualização de cadernos Jupyter com o NotebookRead
Compreensão completa do projeto através de uma análise cuidadosa

Ações restritas :

Não é possível editar ficheiros (Edit/MultiEdit bloqueados)
Não é possível criar ficheiros (Write bloqueado)
Sem execução de comandos (Bash bloqueado)
Não é possível modificar cadernos (NotebookEdit bloqueado)
Não é possível fazer alterações através das ferramentas dMCP

O Claude assume o papel de estratega neste modo, não de construtor prático.

Projetos complexos de refatoração

Usa o modo de planeamento quando:

Uma refatoração afetar vários ficheiros
Uma mudança arquitetónica altera o design do sistema
O melhor caminho de implementação não estiver claro
O código legado precisa de um tratamento cuidadoso

Exemplo de pedido :

«Preciso de migrar esta aplicação Express de CommonJS para módulos ES. Qual é a abordagem mais segura?»

O Claude analisa a base de código, mapeia as dependências, propõe caminhos de migração e avalia a complexidade, tudo isto sem escrever uma única linha.

Estratégia de implementação de funcionalidades

Usa o modo de planeamento para:

Novos recursos a serem implementados num sistema existente
Alterações no esquema da base de dados
API Alterações em endpoints que afetam vários consumidores

Padrão de resposta de exemplo :

Revisão da arquitetura

Diz ao Claude: «Analisa a estrutura atual do meu projeto e sugere melhorias»

Vais obter uma análise da organização dos ficheiros, dos padrões de dependência e dos gargalos arquitetónicos, além de alterações específicas a fazer.

Otimização de desempenho

Pedido: «Analisa as minhas consultas à base de dados e sugere estratégias de otimização»

O Claude analisa as tuas consultas, identifica problemas N+1, sugere ajustes de indexação e compara várias abordagens de otimização.

Avaliação de segurança

Pede: «Audita o meu sistema de autenticação para detetar vulnerabilidades de segurança»

O Claude analisa o fluxo de autenticação, identifica possíveis problemas e sugere correções. Nada é alterado.

Começa sessões complexas com planeamento: Antes de dizeres ao Claude para «refatorar todo o sistema de utilizadores», entra primeiro no modo de planeamento. Conhece o âmbito antes de te comprometeres.

Usa para revisões de código: O modo de planeamento é ótimo para ler código existente e propor melhorias. É ideal para trabalhar com dívida técnica.

Pesquise tecnologias desconhecidas: Vais integrar uma nova biblioteca ou framework? O modo de planeamento ajuda-te a ver a superfície de integração antes de escreveres qualquer coisa.

Valida antes de executar: mesmo em alterações menores, o modo de planeamento mostra-te exatamente o que o Claude pretende alterar. Sem surpresas.

O modo de planeamento funciona bem com o resto do Claude Code:

Gestão do contexto: O planeamento obriga a uma análise antecipada, o que preserva o contexto ao longo da sessão
Domínio do CLAUDE.md: Usa o planeamento para esboçar alterações no CLAUDE.md antes de as implementares
Estratégias de planeamento automático: Combina com o planeamento automático para uma análise completa do projeto. O Code Kit do ClaudeFast baseia-se nisto com um pipeline «/team-plan» que encaminha automaticamente as tarefas através de 5 níveis de complexidade, desde a execução direta para correções triviais até à orquestração multiagente completa para trabalho de arquitetura
Thread principal do terminal: O planeamento reforça a abordagem de desenvolvimento «terminal-first»

Familiariza-te com o modo de planeamento em trabalho real:

Entra no modo de planeamento com o Shift+Tab duas vezes na tua próxima solicitação de funcionalidade
Analisa a análise e observa a resposta estruturada e detalhada
Aprova ou itera para refinar o plano antes de qualquer coisa ser executada
Executa com confiança, saindo do modo de planeamento com pleno conhecimento do que vai acontecer a seguir

Pronto para combinar o planeamento com ferramentas mais sistemáticas? Lê a seguir as Estratégias de Planeamento Automático.

O modo de planeamento é a base do desenvolvimento PRD-first. Vê como os melhores programadores o combinam com outras quatro técnicas no nosso guia de melhores práticas do Claude Code.