Claude Code é um agente de linha de comando que funciona no seu terminal, lê seu repositório, edita arquivos, executa comandos e solicita confirmação antes de realizar ações potencialmente destrutivas. Ele foi projetado para ajudar em todas as etapas do ciclo de vida do desenvolvimento de software—desde explorar uma base de código desconhecida até enviar e manter código em produção.
A tabela abaixo resume onde Claude Code se encaixa no ciclo de vida do desenvolvimento. O restante deste artigo apresenta as dez tarefas que os desenvolvedores mais frequentemente o usam, com um exemplo de prompt e resultado esperado para cada uma.
1. Descobrir | 2. Projetar | 3. Construir | 4. Implantar | 5. Suporte e escala |
Explorar base de código e histórico | Planejar projeto | Implementar código | Automatizar CI/CD | Depurar erros |
Pesquisar documentação | Desenvolver especificações técnicas | Escrever e executar testes | Configurar ambientes | Refatoração em larga escala |
Integração e aprendizado | Definir arquitetura | Criar commits e PRs | Gerenciar implantações | Monitorar uso e desempenho |
Como usar este guia
Cada caso de uso abaixo inclui quando usá-lo, um exemplo de prompt e o resultado esperado. Nenhuma configuração é necessária para nenhum deles, exceto §9 (integração de rastreador de problemas), que requer uma configuração de conector MCP única.
Os casos de uso são ordenados aproximadamente pela ordem em que a maioria dos desenvolvedores os encontra. Selecione o que corresponde à sua tarefa atual.
Casos de uso
1. Corrigir um teste com falha
Quando usar: Um teste está falhando e a causa não é imediatamente óbvia. Use isto para que Claude Code localize a causa raiz e proponha uma correção sem que você precise identificar o arquivo de origem primeiro.
Exemplo de prompt:
> the tests in tests/auth.test.ts are failing, can you figure out why and fix them
Resultado esperado: Claude Code lê o arquivo de teste, rastreia o caminho do código através dos módulos em teste, identifica a incompatibilidade e propõe uma edição. Após você aprovar a alteração, ele executa novamente o conjunto de testes para confirmar a correção.
2. Entender código desconhecido
Quando usar: Você precisa entender como um módulo, função ou subsistema funciona antes de fazer alterações—por exemplo, ao herdar código ou revisar uma área desconhecida.
Exemplo de prompt:
> walk me through how the payment retry logic works
Resultado esperado: Claude Code localiza os arquivos relevantes, lê a implementação e explica o fluxo de controle em linguagem simples: pontos de entrada, ramificações de decisão, casos extremos e como o código se conecta ao resto do sistema. Faça perguntas de acompanhamento (por exemplo, "onde X é definido") para aprofundar.
3. Encontrar onde algo acontece
Quando usar: Você sabe que um comportamento existe na base de código, mas não consegue localizá-lo por nome de arquivo ou pesquisa de texto simples.
Exemplo de prompt:
> where do we validate email addresses in this codebase? I want to add a new rule
Resultado esperado: Claude Code pesquisa o repositório, abre arquivos candidatos e retorna caminhos de arquivo e números de linha com contexto suficiente para identificar a correspondência correta. Se existirem múltiplos locais, ele indica qual é a fonte da verdade.
4. Triagem de um erro ou rastreamento de pilha
Quando usar: Você tem um erro de tempo de execução, rastreamento de pilha ou saída de log e precisa mapeá-lo de volta para o código responsável.
Exemplo de prompt:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> getting this in production:<br />
TypeError: Cannot read properties of undefined (reading 'sessionId')<br />
at validateSession (src/auth/session.ts:47)<br /> at middleware
(src/auth/middleware.ts:12)<br /> what's going on?</td> </tr> </tbody>
</table>
Resultado esperado: Claude Code lê os arquivos referenciados no rastreamento, explica o que é indefinido e por quê, e propõe uma correção. Para erros sem um rastreamento de pilha limpo, cole qualquer saída de log disponível e Claude Code reconstruirá a falha a partir do contexto.
5. Refatorar com um plano
Quando usar: Uma alteração abrange múltiplos arquivos e você deseja revisar o escopo completo antes de qualquer edição ser feita.
Pré-requisito: Pressione Shift+Tab até o indicador de modo mostrar "plan."
Exemplo de prompt:
> refactor the auth module to use the new session store instead of SessionCache
Resultado esperado: Claude Code analisa o código e produz um plano numerado listando cada arquivo que será modificado e a alteração em cada um. Você pode aprovar o plano como está ou alterá-lo (por exemplo, "não toque na rota de logout"). Nenhum arquivo é editado até você aprovar.
Referência: Permissões
6. Escrever testes para código existente
Quando usar: Um arquivo de código-fonte não tem cobertura, ou você precisa de testes de casos extremos adicionais que correspondam às convenções de teste existentes do seu projeto.
Exemplo de prompt:
> add tests for @src/billing/invoice.ts — cover the edge cases around partial refunds. match the style of the existing tests in tests/billing/
Resultado esperado: Claude Code lê o arquivo de código-fonte e o diretório de testes de referência, gera um novo arquivo de teste no estilo existente e o executa para confirmar que os testes passam. Se houver lacunas óbvias de cobertura, ele as sinaliza e pergunta se deve abordá-las.
7. Revisar um pull request
Quando usar: Você precisa revisar ou resumir um PR, particularmente em uma área da base de código que você não conhece bem.
Pré-requisito: GitHub CLI autenticado (execute gh auth login uma vez).
Exemplo de prompt:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /pr-comments
https://github.com/acme/api/pull/4471<br /> > is the error handling
solid?</td> </tr> </tbody> </table>
Resultado esperado: Claude Code busca o diff, comentários de revisão e status de CI, depois lê os arquivos alterados em seu contexto completo do repositório. Ele pode produzir uma revisão focada, rascunhar comentários de revisão, verificar uma preocupação específica ou resumir o PR.
8. Integrar-se a um novo repositório
Quando usar: Você está trabalhando em um repositório pela primeira vez e precisa de uma visão geral estruturada de sua arquitetura, comandos de compilação e convenções.
Exemplo de prompt:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /init<br /> > give me a tour of this
codebase — where's the entry point, how is it structured, what should I
read first</td> </tr> </tbody> </table>
Resultado esperado: /init verifica o projeto e escreve um arquivo CLAUDE.md resumindo comandos de compilação, arquitetura e convenções. O prompt de tour de acompanhamento produz um passo a passo guiado da estrutura do projeto. O contexto do projeto permanece carregado pelo resto da sessão.
Referência: Memória e CLAUDE.md
9. Trabalhar em uma issue do início ao fim
Quando usar: Você quer ler um ticket, implementar a correção e validá-la em uma única conversa sem trocar de ferramentas.
Pré-requisito: Rastreador de issues conectado via MCP (configuração .mcp.json única).
Exemplo de prompt:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> what's the top-priority issue assigned
to me?<br /> > go ahead and fix it</td> </tr> </tbody> </table>
Resultado esperado: Claude Code consulta o rastreador de issues, lê o ticket, localiza o código relevante, propõe uma correção e executa os testes. A sessão termina com um diff revisável e o contexto necessário para fechar o ticket.
Referência: MCP
10. Transformar uma tarefa recorrente em um comando de barra
Quando usar: Você repete o mesmo prompt de várias etapas regularmente (verificações pré-commit, resumos de standup, descrições de PR, notas de lançamento) e quer torná-lo reutilizável para toda a equipe.
Exemplo de prompt:
> make me a /ship command that runs the tests, runs the linter, looks at git diff, and drafts a conventional-commit message — then shows me the message without committing
Resultado esperado: Claude Code escreve um arquivo markdown em .claude/commands/. O comando /ship está disponível imediatamente, sem necessidade de reinicialização, e é compartilhado com qualquer pessoa que clone o repositório.
Referência: Comandos de barra
Apêndice: Referência rápida
# | Caso de uso | Exemplo de prompt |
1 | Corrigir um teste com falha |
|
2 | Entender código desconhecido |
|
3 | Encontrar onde algo acontece |
|
4 | Triagem de um erro | Cole o rastreamento de pilha e depois pergunte: |
5 | Refatorar com um plano | Shift+Tab → modo de plano → descreva a refatoração |
6 | Escrever testes |
|
7 | Revisar um PR |
|
8 | Integrar-se a um repositório |
|
9 | Trabalhar em uma issue do início ao fim |
|
10 | Criar um comando de barra |
|
Apêndice: Diretório de recursos
Recurso | Link |
Guia de início rápido | |
Fluxos de trabalho comuns | |
Permissões | |
Memória e | |
Conectores MCP | |
Comandos de barra |
Para detalhes sobre /init, referências @, modos de permissão, skills, MCP e hooks, consulte code.claude.com/docs. Claude Code é atualizado frequentemente—verifique detalhes específicos da versão em code.claude.com/docs antes de distribuir internamente.