Tutorial da Série Claude Code 4: Quais são os cenários de uso do Claude Code?

Cenários Típicos de Uso

Divido os cenários de uso em quatro categorias, organizadas por frequência, da mais alta para a mais baixa.

Primeira Categoria: Entender o Código

Este é provavelmente o uso mais frequente. Ao assumir um projeto de outra pessoa, revisar um módulo antigo ou abrir um repositório sem documentação, pergunte diretamente.

Como fazer:

claude "O que este projeto faz? Onde está a entrada?" — Ele lerá package.json, a estrutura de diretórios, arquivos chave e fornecerá um resumo.
Abra uma função e peça para ele explicar a lógica, descrever o fluxo (em texto).
Peça para ele rastrear o caminho completo de uma requisição da API, do frontend ao banco de dados.

Aqui, o trabalho que ele faz é essencialmente o "trabalho sujo de leitura de código". Você não precisa passar horas com grep e montar o quebra-cabeça mentalmente. Ele organiza o caminho, e você toma as decisões.

O substituto para este cenário é: procurar manualmente no código, fazer anotações, desenhar gráficos de chamada.

Segunda Categoria: Escrever e Modificar Código

Esta é a categoria mais discutida, mas não é a mais usada. Os cenários de escrita de código geralmente são assim:

Gerar nova funcionalidade: "Adicione uma interface para alterar o e-mail no módulo user, valide o formato do e-mail e escreva testes unitários."
Refatoração entre arquivos: "Substitua todas as chamadas moment() por dayjs() nestes três arquivos, sem alterar outra lógica."
Migração e atualização: "Converta este componente Vue 2 para a sintaxe da Composition API do Vue 3."

O código que ele gera pode não estar correto de primeira, mas ele pode fazer todas as alterações entre arquivos de uma vez, e você pode ver o diff arquivo por arquivo, aceitando ou rejeitando individualmente.

O substituto para este cenário é: escrever código repetitivo manualmente, pesquisar e substituir referências entre arquivos manualmente.

Terceira Categoria: Depuração e Correção

Quando um bug aparece, o fluxo de trabalho típico é: olhar o erro, localizar o arquivo, adivinhar a causa, tentar uma correção, se não funcionar, voltar e ver de novo. O Claude Code pode receber diretamente toda a stack trace do erro e, combinando com o código do projeto, localizar a causa.

Uso típico:

Cole a saída de um teste que falhou, ele lerá o código relevante, dará uma sugestão de correção, corrigirá e executará o teste novamente para ver se passa.
Ao encontrar um erro no CI, cole o log, peça para ele corrigir e, em seguida, execute git diff para confirmar as alterações.

Aqui, ele atua mais como um "primeiro investigador". Você gasta tempo pensando no problema, mas ele busca arquivos, compara diferenças e executa comandos de verificação.

O substituto para este cenário é: executar testes repetidamente, ler logs de erro, comparar diferenças de código manualmente.

Quarta Categoria: Automação Diversa

Esta categoria é a menos chamativa, mas somada, economiza mais tempo.

Exemplos:

Escrever mensagens de commit Git: claude "Escreva uma mensagem de commit no formato Conventional Commits baseada no git diff atual"
Gerar descrição de PR: Peça para ele comparar as diferenças entre o branch atual e o main, gerar um resumo das alterações e instruções de teste.
Escrever notas de versão: Peça ao Claude Code para ler o histórico de commits da última semana e gerar um CHANGELOG.
Resolver problemas de ambiente: "Ao instalar esta dependência, ocorreu um erro. Ajude-me a analisar a saída do terminal e encontrar a causa."

O ponto em comum dessas tarefas é: não são complexas, mas são tediosas. Fazer manualmente exige alternar janelas e digitar muito. Com ele, termina em segundos.

O substituto para este cenário é: editar texto manualmente, escrever documentação padronizada, pesquisar problemas de configuração de ambiente.

Um "Mapa"

Colocando esses quatro cenários no fluxo de trabalho diário, fica mais ou menos assim:

Pegar um projeto desconhecido
    │
    ▼
[Entender o código] ─── Descobrir a estrutura, entrada, lógica chave
    │
    ▼
Começar a escrever nova função ou modificar módulo
    │
    ▼
[Escrever código/Modificar código] ─── Gerar implementação, refatoração entre arquivos
    │
    ▼
Executar testes, aparece bug
    │
    ▼
[Depuração e correção] ─── Analisar erro, localizar, corrigir, executar novamente
    │
    ▼
Preparar commit
    │
    ▼
[Automação diversa] ─── Escrever commit, descrição de PR, notas de versão
    │
    ▼
Commit, concluído

Você não precisa usar todas as quatro áreas. Alguns times usam apenas para entender código, outros apenas para escrever testes e abrir PRs. Comece pelo cenário que mais te incomoda.

Dois Critérios Úteis

Se você não tem certeza se deve delegar algo ao Claude Code, pergunte-se:

1. Esta tarefa é mais "mecânica" do que "criativa"?

Alterar cem referências, formatar saída, gerar código boilerplate — essas tarefas consomem tempo quando feitas manualmente, mas você já tem a ideia. São adequadas para delegar.

2. O "custo de verificação" desta tarefa é alto?

Se uma modificação exige várias navegações, execução de testes e leitura de logs para confirmar, o loop manual de tentativa e erro é lento. O Claude Code pode completar o ciclo "alterar-executar-verificar-alterar novamente" sozinho, facilitando sua vida.