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.

1. Navegue até o diretório raiz do projeto

cd /path/to/project 

Substitua /path/to/project pelo caminho para seu projeto.

2. Inicie Claude Code

claude 

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

give me an overview of this codebase

4. Aprofunde-se em componentes específicos

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

[!TIP]

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

find the files that handle user authentication

2. Obtenha contexto sobre como os componentes interagem

how do these authentication files work together?

3. Entenda o fluxo de execução

trace the login process from front-end to database

[!TIP]

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

I'm seeing an error when I run npm test

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

suggest a few ways to fix the @ts-ignore in user.ts

3. Aplique a correção

update user.ts to add the null check you suggested

[!TIP]

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.

Para portar uma base de código inteira para uma nova linguagem, consulte como a Anthropic executa migrações de código em larga escala com Claude Code no blog.

1. Identifique código legado para refatoração

find deprecated API usage in our codebase

2. Obtenha recomendações de refatoração

suggest how to refactor utils.js to use modern JavaScript features

3. Aplique as alterações com segurança

refactor utils.js to use ES2024 features while maintaining the same behavior

4. Verifique a refatoração

run tests for the refactored code

[!TIP]

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

find functions in NotificationsService.swift that are not covered by tests

2. Gere scaffolding de teste

add tests for the notification service

3. Adicione casos de teste significativos

add test cases for edge conditions in the notification service

4. 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 melhorar a cobertura, 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 frequentemente são negligenciados.

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

summarize the changes I've made to the authentication module

2. Gere uma pull request

create a pr

3. Revise e refine

enhance the PR description with more context about the security improvements

Para encontrar a sessão mais tarde, execute claude --from-pr 1234 com seu próprio número de PR, que abre o seletor de sessão filtrado para sessões vinculadas a essa PR, ou cole a URL da PR no seletor /resume. Claude Code vincula a sessão à PR quando Claude a cria com gh pr create ou glab mr create, e quando Claude trabalha em uma PR existente.

[!TIP]

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

find functions without proper JSDoc comments in the auth module

2. Gere documentação

add JSDoc comments to the undocumented functions in auth.js

3. Revise e melhore

improve the generated documentation with more context and examples

4. Verifique a documentação

check if the documentation follows our project standards

[!TIP]

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, ou com Alt+V no Windows e WSL
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

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

3. 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?

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

Generate CSS to match this design mockup

What HTML structure would recreate this component?

[!TIP]

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

Explain the logic in @src/utils/auth.js

Isso inclui o conteúdo do arquivo na conversa quando ele cabe no limite de tokens da ferramenta Read, 25.000 tokens por padrão. Um arquivo de texto maior que 256KB não é incluído.

2. Referencie um diretório

What's the structure of @src/components?

3. 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.

[!TIP]

Dicas:

• Os caminhos de arquivo podem ser relativos ou absolutos
• Digite @ para abrir um menu de sugestão de caminho, depois pressione Enter ou Tab para aceitar o caminho destacado e Enter novamente para enviar a mensagem
• 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")

Para impedir que referências @ incluam conteúdos de arquivos e listagens de diretórios, defina CLAUDE_CODE_DISABLE_FILE_MENTIONS como 1 no seu shell ou no bloco env das configurações de usuário ou das configurações gerenciadas. Claude então recebe os caminhos que você referenciou com uma nota para lê-los usando suas ferramentas de arquivo. A variável requer Claude Code v2.1.299 ou posterior, e Claude Code a ignora nas configurações de projeto e locais.

Seus hooks PreToolUse não são executados quando Claude Code inclui um arquivo que você referencia com @, porque ele não faz nenhuma chamada de ferramenta. Se você depende desses hooks para controlar o que Claude lê, bloqueie caminhos específicos ou impeça que referências @ incluam arquivos:

• Bloquear caminhos específicos: adicione uma regra de negação Read para eles. Claude Code não inclui um arquivo que corresponda à regra.
• Impedir que referências @ incluam arquivos: defina CLAUDE_CODE_DISABLE_FILE_MENTIONS=1, o que impede que referências @ a arquivos e diretórios em suas mensagens incluam conteúdo, mesmo para caminhos que seus hooks não verificam. Seus hooks correspondentes então são executados antes que Claude abra um caminho referenciado com uma ferramenta como Read.

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:

[!TIP]

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 pode responder perguntas sobre seus próprios recursos e limitações. Ele busca as respostas na documentação atual do Claude Code, então elas não se limitam à versão que você está executando.

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?

[!NOTE]

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.

[!TIP]

Dicas:

• 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.

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 git worktree é um checkout separado em seu próprio branch, criado a partir de um commit existente, portanto o repositório precisa ter pelo menos um commit primeiro.

claude --worktree feature-auth

Execute o mesmo comando com um nome diferente em um segundo terminal para iniciar uma sessão paralela isolada. Em um repositório sem commits, o comando falha com Failed to resolve base branch "HEAD": git rev-parse failed. 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. A barra de status mostra ⏸ plan mode on enquanto plan mode está ativo.

claude --permission-mode plan

Você também pode pressionar Shift+Tab durante uma sessão até a barra de status mostrar ⏸ plan mode on. 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.

Próximos passos

[card] Melhores práticas

Padrões para aproveitar ao máximo Claude Code

[card] Gerenciar sessões

Retomar, nomear e ramificar conversas

[card] Worktrees

Executar sessões paralelas isoladas

[card] Estender Claude Code

Adicionar skills, hooks, MCP, subagents e plugins