Modos de planeamento
Shift+Tab duas vezes muda o Claude Code para o modo de planeamento só de leitura. O modelo analisa o projeto e propõe uma estratégia, e nenhum ficheiro é alterado até que o aprove.
Pare de configurar. Comece a construir.
Templates SaaS com orquestração de IA.
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+Tabduas 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.
Pare de configurar. Comece a construir.
Templates SaaS com orquestração de IA.
Billing Change (June 15)
Anthropic planned to split subscription usage on June 15, then paused it on the day. What actually changed, what the split would have done, and the model-ID retirements that did land.
Estratégias de Auto-Planejamento
O Auto Plan Mode usa --append-system-prompt para forçar o Claude Code a entrar em um loop plan-first. Operações de arquivo pausam para aprovação antes de qualquer coisa ser tocada.