Skip to main content
Esta página coleta receitas curtas para desenvolvimento cotidiano. Para orientação de nível superior sobre prompting e gerenciamento de contexto, consulte Melhores práticas. Esta página aborda:

​
Receitas de prompt

Estes são padrões de prompt para tarefas cotidianas como explorar código desconhecido, depuração, refatoração, escrita de testes e criação de PRs. Cada um funciona em qualquer superfície do Claude Code; adapte a redação ao seu projeto.

​
Entender novas bases de código

Para configurar Claude Code em um monorepo ou base de código grande, consulte Monorepos e repositórios grandes.

​
Obter uma visão geral rápida da base de código

Suponha que você acabou de ingressar em um novo projeto e precisa entender sua estrutura rapidamente.
1

Navegue até o diretório raiz do projeto

2

Inicie Claude Code

3

Peça uma visão geral de alto nível

4

Aprofunde-se em componentes específicos

Dicas:
  • Comece com perguntas amplas e depois estreite para áreas específicas
  • Pergunte sobre convenções de codificação e padrões usados no projeto
  • Solicite um glossário de termos específicos do projeto

​
Encontrar código relevante

Suponha que você precise localizar código relacionado a um recurso ou funcionalidade específica.
1

Peça ao Claude para encontrar arquivos relevantes

2

Obtenha contexto sobre como os componentes interagem

3

Entenda o fluxo de execução

Dicas:
  • Seja específico sobre o que você está procurando
  • Use linguagem de domínio do projeto
  • Instale um plugin de inteligência de código para sua linguagem para dar ao Claude navegação precisa de “ir para definição” e “encontrar referências”

​
Corrigir bugs com eficiência

Suponha que você tenha encontrado uma mensagem de erro e precise encontrar e corrigir sua origem.
1

Compartilhe o erro com Claude

2

Peça recomendações de correção

3

Aplique a correção

Dicas:
  • Diga ao Claude o comando para reproduzir o problema e obtenha um rastreamento de pilha
  • Mencione quaisquer etapas para reproduzir o erro
  • Deixe Claude saber se o erro é intermitente ou consistente

​
Refatorar código

Suponha que você precise atualizar código antigo para usar padrões e práticas modernas.
1

Identifique código legado para refatoração

2

Obtenha recomendações de refatoração

3

Aplique as alterações com segurança

4

Verifique a refatoração

Dicas:
  • Peça ao Claude para explicar os benefícios da abordagem moderna
  • Solicite que as alterações mantenham compatibilidade com versões anteriores quando necessário
  • Faça refatoração em pequenos incrementos testáveis

​
Trabalhar com testes

Suponha que você precise adicionar testes para código não coberto.
1

Identifique código não testado

2

Gere scaffolding de teste

3

Adicione casos de teste significativos

4

Execute e verifique os testes

Claude pode gerar testes que seguem os padrões e convenções existentes do seu projeto. Ao solicitar testes, seja específico sobre qual comportamento você quer verificar. Claude examina seus arquivos de teste existentes para corresponder ao estilo, frameworks e padrões de asserção já em uso. Para cobertura abrangente, peça ao Claude para identificar casos extremos que você pode ter perdido. Claude pode analisar seus caminhos de código e sugerir testes para condições de erro, valores de limite e entradas inesperadas que são fáceis de negligenciar.

​
Criar pull requests

Você pode criar pull requests pedindo ao Claude diretamente (“create a pr for my changes”), ou guiar Claude através disso passo a passo:
1

Resuma suas alterações

2

Gere uma pull request

3

Revise e refine

Quando você cria uma PR usando gh pr create, a sessão é automaticamente vinculada a essa PR. Para retornar a ela mais tarde, execute claude --from-pr 123, substituindo 123 pelo número da PR, ou cole a URL da PR no seletor /resume.
Revise a PR gerada por Claude antes de enviar e peça ao Claude para destacar riscos ou considerações potenciais.

​
Lidar com documentação

Suponha que você precise adicionar ou atualizar documentação para seu código.
1

Identifique código não documentado

2

Gere documentação

3

Revise e melhore

4

Verifique a documentação

Dicas:
  • Especifique o estilo de documentação que você deseja (JSDoc, docstrings, etc.)
  • Peça por exemplos na documentação
  • Solicite documentação para APIs públicas, interfaces e lógica complexa

​
Trabalhar em notas e pastas não-código

Claude Code funciona em qualquer diretório. Execute-o dentro de um cofre de notas, uma pasta de documentação ou qualquer coleção de arquivos markdown para pesquisar, editar e reorganizar conteúdo da mesma forma que você faria com código. O diretório .claude/ e CLAUDE.md ficam ao lado dos diretórios de configuração de outras ferramentas sem conflito. Claude lê arquivos novamente em cada chamada de ferramenta, então vê edições que você faz em outro aplicativo na próxima vez que lê esse arquivo.

​
Trabalhar com imagens

Suponha que você precise trabalhar com imagens em sua base de código e queira ajuda do Claude para analisar o conteúdo da imagem.
1

Adicione uma imagem à conversa

Você pode usar qualquer um destes métodos:
  1. Arraste e solte uma imagem na janela do Claude Code
  2. Copie uma imagem e cole-a no CLI com Ctrl+V. No macOS, Cmd+V também funciona no iTerm2.
  3. Forneça um caminho de imagem ao Claude. Por exemplo, “Analyze this image: /path/to/your/image.png”
2

Peça ao Claude para analisar a imagem

3

Use imagens para contexto

4

Obtenha sugestões de código do conteúdo visual

Dicas:
  • Use imagens quando descrições de texto seriam pouco claras ou complicadas
  • Inclua capturas de tela de erros, designs de UI ou diagramas para melhor contexto
  • Você pode trabalhar com múltiplas imagens em uma conversa
  • A análise de imagem funciona com diagramas, capturas de tela, mockups e muito mais
  • Quando Claude referencia imagens (por exemplo, [Image #1]), Cmd+Click (Mac) ou Ctrl+Click (Windows/Linux) o link para abrir a imagem em seu visualizador padrão

​
Referenciar arquivos e diretórios

Use @ para incluir rapidamente arquivos ou diretórios sem esperar que Claude os leia.
1

Referencie um único arquivo

Isso inclui o conteúdo completo do arquivo na conversa.
2

Referencie um diretório

Isso fornece uma listagem de diretório com informações de arquivo.
3

Referencie recursos MCP

Isso busca dados de servidores MCP conectados usando o formato @server:resource. Consulte recursos MCP para detalhes.
Dicas:
  • Os caminhos de arquivo podem ser relativos ou absolutos
  • Referências de arquivo @ adicionam CLAUDE.md no diretório do arquivo e diretórios pai ao contexto
  • Referências de diretório mostram listagens de arquivo, não conteúdos
  • Você pode referenciar múltiplos arquivos em uma única mensagem (por exemplo, “@file1.js and @file2.js”)

​
Executar Claude em um cronograma

Suponha que você queira que Claude lide com uma tarefa automaticamente em uma base recorrente, como revisar PRs abertas todas as manhãs, auditar dependências semanalmente ou verificar falhas de CI durante a noite. Escolha uma opção de agendamento com base em onde você quer que a tarefa seja executada:
Ao escrever prompts para tarefas agendadas, seja explícito sobre o que o sucesso parece e o que fazer com os resultados. A tarefa é executada autonomamente, então não pode fazer perguntas de esclarecimento. Por exemplo: “Review open PRs labeled needs-review, leave inline comments on any issues, and post a summary in the #eng-reviews Slack channel.”

​
Pergunte ao Claude sobre suas capacidades

Claude tem acesso integrado à sua documentação e pode responder perguntas sobre seus próprios recursos e limitações.

​
Perguntas de exemplo

Claude fornece respostas baseadas em documentação para essas perguntas. Para demonstrações práticas, execute /powerup para lições interativas com demos animadas, ou consulte as seções de fluxo de trabalho específicas acima.
Dicas:
  • Claude sempre tem acesso à documentação mais recente do Claude Code, independentemente da versão que você está usando
  • Faça perguntas específicas para obter respostas detalhadas
  • Claude pode explicar recursos complexos como integração MCP, configurações empresariais e fluxos de trabalho avançados

​
Retomar conversas anteriores

Quando uma tarefa abrange múltiplas sessões, retome de onde parou em vez de re-explicar o contexto. Claude Code salva cada conversa localmente.
Isso retoma a sessão mais recente no diretório atual; se não houver uma ainda, ele imprime No conversation found to continue e sai. Use claude --resume para escolher de uma lista, ou /resume de dentro de uma sessão em execução. Consulte Gerenciar sessões para nomeação, ramificação e referência completa do seletor.

​
Executar sessões paralelas com worktrees

Trabalhe em um recurso em um terminal enquanto Claude corrige um bug em outro, sem que as edições colidam. Cada worktree é um checkout separado em seu próprio branch.
Execute o mesmo comando com um nome diferente em um segundo terminal para iniciar uma sessão paralela isolada. Consulte Worktrees para limpeza, .worktreeinclude e suporte a VCS não-git. Para monitorar sessões paralelas de uma tela em vez de terminais separados, consulte agentes em segundo plano.

​
Planejar antes de editar

Para alterações que você quer revisar antes de tocarem o disco, mude para plan mode. Claude lê arquivos e propõe um plano, mas não faz edições até que você aprove.
Você também pode pressionar Shift+Tab durante uma sessão para alternar para plan mode. Consulte Plan mode para o fluxo de aprovação e edição do plano em seu editor de texto.

​
Delegar pesquisa para subagents

Explorar uma base de código grande preenche seu contexto com leituras de arquivo. Delegue a exploração para que apenas os achados retornem.
O subagent lê arquivos em sua própria janela de contexto e relata um resumo. Consulte Subagents para definir agentes personalizados com suas próprias ferramentas e prompts.

​
Canalizar Claude em scripts

Execute Claude de forma não interativa para CI, hooks de pré-commit ou processamento em lote. Stdin e stdout funcionam como qualquer ferramenta Unix.
Consulte Modo não interativo para formatos de saída, flags de permissão e padrões de fan-out.

​
Próximos passos

Melhores práticas

Padrões para aproveitar ao máximo Claude Code

Gerenciar sessões

Retomar, nomear e ramificar conversas

Worktrees

Executar sessões paralelas isoladas

Estender Claude Code

Adicionar skills, hooks, MCP, subagents e plugins