Fluxos de trabalho comuns
Guias passo a passo para explorar bases de código, corrigir bugs, refatorar, testar e outras tarefas cotidianas com Claude Code.
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 para explorar código, corrigir bugs, refatorar, testar, PRs e documentação
- Retomar conversas anteriores para que uma tarefa possa abranger múltiplas sessões
- Executar sessões paralelas com worktrees para que edições simultâneas não colidam
- Planejar antes de editar para revisar alterações antes de tocarem o disco
- Delegar pesquisa para subagents para manter seu contexto principal limpo
- Canalizar Claude em scripts para CI e processamento em lote
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.
Navegue até o diretório raiz do projeto
cd /path/to/project
Inicie Claude Code
claude
Peça uma visão geral de alto nível
give me an overview of this codebase
Aprofunde-se em componentes específicos
explain the main architecture patterns used here
what are the key data models?
how is authentication handled?
Encontrar código relevante
Suponha que você precise localizar código relacionado a um recurso ou funcionalidade específica.
Peça ao Claude para encontrar arquivos relevantes
find the files that handle user authentication
Obtenha contexto sobre como os componentes interagem
how do these authentication files work together?
Entenda o fluxo de execução
trace the login process from front-end to database
Corrigir bugs com eficiência
Suponha que você tenha encontrado uma mensagem de erro e precise encontrar e corrigir sua origem.
Compartilhe o erro com Claude
I'm seeing an error when I run npm test
Peça recomendações de correção
suggest a few ways to fix the @ts-ignore in user.ts
Aplique a correção
update user.ts to add the null check you suggested
Refatorar código
Suponha que você precise atualizar código antigo para usar padrões e práticas modernas.
Identifique código legado para refatoração
find deprecated API usage in our codebase
Obtenha recomendações de refatoração
suggest how to refactor utils.js to use modern JavaScript features
Aplique as alterações com segurança
refactor utils.js to use ES2024 features while maintaining the same behavior
Verifique a refatoração
run tests for the refactored code
Trabalhar com testes
Suponha que você precise adicionar testes para código não coberto.
Identifique código não testado
find functions in NotificationsService.swift that are not covered by tests
Gere scaffolding de teste
add tests for the notification service
Adicione casos de teste significativos
add test cases for edge conditions in the notification service
Execute e verifique os testes
run the new tests and fix any failures
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:
Resuma suas alterações
summarize the changes I've made to the authentication module
Gere uma pull request
create a pr
Revise e refine
enhance the PR description with more context about the security improvements
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 <number> ou cole a URL da PR no seletor /resume.
Lidar com documentação
Suponha que você precise adicionar ou atualizar documentação para seu código.
Identifique código não documentado
find functions without proper JSDoc comments in the auth module
Gere documentação
add JSDoc comments to the undocumented functions in auth.js
Revise e melhore
improve the generated documentation with more context and examples
Verifique a documentação
check if the documentation follows our project standards
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.
Adicione uma imagem à conversa
Você pode usar qualquer um destes métodos:
- Arraste e solte uma imagem na janela do Claude Code
- Copie uma imagem e cole-a no CLI com ctrl+v (Não use cmd+v)
- Forneça um caminho de imagem ao Claude. Por exemplo, "Analyze this image: /path/to/your/image.png"
Peça ao Claude para analisar a imagem
What does this image show?
Describe the UI elements in this screenshot
Are there any problematic elements in this diagram?
Use imagens para contexto
Here's a screenshot of the error. What's causing it?
This is our current database schema. How should we modify it for the new feature?
Obtenha sugestões de código do conteúdo visual
Generate CSS to match this design mockup
What HTML structure would recreate this component?
Referenciar arquivos e diretórios
Use @ para incluir rapidamente arquivos ou diretórios sem esperar que Claude os leia.
Referencie um único arquivo
Explain the logic in @src/utils/auth.js
Isso inclui o conteúdo completo do arquivo na conversa.
Referencie um diretório
What's the structure of @src/components?
Isso fornece uma listagem de diretório com informações de arquivo.
Referencie recursos MCP
Show me the data from @github:repos/owner/repo/issues
Isso busca dados de servidores MCP conectados usando o formato @server:resource. Consulte recursos MCP para detalhes.
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:
| Opção | Onde é executado | Melhor para |
|---|---|---|
| Rotinas | Infraestrutura gerenciada pela Anthropic | Tarefas que devem ser executadas mesmo quando seu computador está desligado. Também podem ser acionadas por chamadas de API ou eventos do GitHub além de um cronograma. Configure em claude.ai/code/routines. |
| Tarefas agendadas no desktop | Sua máquina, via aplicativo desktop | Tarefas que precisam de acesso direto a arquivos locais, ferramentas ou alterações não confirmadas. |
| GitHub Actions | Seu pipeline de CI | Tarefas vinculadas a eventos de repositório como PRs abertos, ou cronogramas cron que devem viver junto com sua configuração de fluxo de trabalho. |
/loop |
A sessão CLI atual | Polling rápido enquanto uma sessão está aberta. As tarefas são canceladas quando você inicia uma nova conversa; --resume e --continue restauram as não expiradas. |
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
can Claude Code create pull requests?
how does Claude Code handle permissions?
what skills are available?
how do I use MCP with Claude Code?
how do I configure Claude Code for Amazon Bedrock?
what are the limitations of Claude Code?
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.
claude --continue
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.
claude --worktree feature-auth
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.
claude --permission-mode plan
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.
use a subagent to investigate how our auth system handles token refresh
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.
git log --oneline -20 | claude -p "summarize these recent commits"
Consulte Modo não interativo para formatos de saída, flags de permissão e padrões de fan-out.