Claude Code na Prática: Automatize Tarefas de Programação
Fonte: Unsplash
O Claude Code é um agente de programação que roda no seu terminal: ele lê arquivos, edita código, executa comandos e propõe diffs, tudo dentro do repositório que você já usa. Diferente de um chat encaixado no editor, ele trabalha com o projeto inteiro e com a linha de comando — o que muda o tipo de tarefa que delegamos. Este guia descreve o fluxo real de uso, do primeiro commit de configuração até automação em pipeline, sem prometer que a ferramenta substitui o revisor.
1. Instalação e o arquivo que muda tudo: CLAUDE.md
npm install -g @anthropic-ai/claude-code
cd meu-projeto
claude
Na primeira execução, o comando /init gera um CLAUDE.md na raiz do projeto a partir da leitura do código. Vale editar: registre comandos de teste, de build e de lint, convenções de pasta e o que nunca deve mudar. Exemplo de conteúdo que economiza tempo de todo mundo:
# CLAUDE.md
- Testes: npm test (vitest, cobre src/)
- Lint: npm run lint
- Nunca alterar src/legacy/
- Sempre rodar lint antes de finalizar
Além do arquivo do projeto, existe memória de usuário no diretório pessoal do seu editor de configuração — use-a para preferências individuais (tom dos commits, formato de diff). O conteúdo do CLAUDE.md é recarregado a cada sessão, então manter curto e específico rende mais do que um documento longo.
2. Planejar antes de tocar: o modo de aprovação
O erro clássico de quem usa agente é pedir "conserte isso" e aceitar o diff sem ler. O fluxo mais seguro separa as etapas: primeiro peça um plano (o agente explora o código e descreve a abordagem), você aprova, depois ele executa. No terminal isso se faz com o modo de permissão/plan (alternável durante a sessão, via atalho de interface), e o efeito prático é o mesmo: o agente para antes de editar e você valida o caminho. Para perguntas de leitura — "onde esse cálculo é usado?" — ele responde sem escrever nada, e é aí que ele mais brilha em codebase alheia.
3. Tarefas de manutenção: testes, refatoração e explicação
Fluxos que funcionam bem porque têm critério objetivo de sucesso:
- Escrever testes — "adicione testes para src/cart/checkout.ts cobrindo cupom expirado"; o critério é a cobertura e o
npm testpassando - Refatoração pequena — "extraia a validação de CPF para um módulo próprio e mantenha a API pública"; diff pequeno, revisão rápida
- Explicar código legado — "documente o fluxo de pagamento em docs/pagamentos.md"; a saída é documento, não mudança de comportamento
- Traduzir erros — cole o stack trace e peça o ponto provável no código
Repare no padrão: cada pedido nomeia arquivo, comportamento esperado e critério de pronto. Pedido vago ("melhore o código") gera diff amplo e difícil de revisar.
4. Commits, revisão e pull request
Depois de um diff aprovado, o agente também faz a parte chata do git: analisa o estágio, escreve mensagem no padrão do time e gera descrição de PR. Comandos úteis:
# dentro da sessão
/review # pede revisão do diff atual
/compact # resume o contexto da conversa para continuar leve
/clear # começa sessão nova sem contexto antigo
Para times que usam revisão por PR, um fluxo comum é: agente escreve, humano revisa o diff no git, agente responde aos comentários e ajusta. O que não funciona é revisão de agente por agente sem humano no loop — o erro sutil passa.
5. Automação headless: agente no pipeline
Uma das funcionalidades que mais diferencia o Claude Code é o modo não interativo: você passa a tarefa como argumento e recebe a resposta em JSON, o que permite plugar em script, cron ou etapa de CI:
claude -p "resuma as mudanças do PR e sugira itens de review" \
--output-format json
No modo script, restrinja as ferramentas permitidas (leitura de arquivos, comando específico de teste) e evite flags que removem confirmação — em pipeline, o agente deve poder ler e reportar, não aplicar mudança em produção sem revisão. Casos de uso reais: gerar notas de release a partir do histórico, checar se a mensagem de commit segue o padrão, sintetizar falhas de CI.
6. Hooks: regras que valem mais que prompt
Instrução em linguagem natural é sugestão; hook é garantia. No arquivo de configuração do projeto você registra gatilhos por evento — por exemplo, executar lint automático depois de cada edição de arquivo, ou bloquear comandos perigosos antes de rodar. A ideia é a mesma do git hooks, aplicada às ações do agente: para o time inteiro, a configuração versionada força o mesmo comportamento em toda sessão. Combine isso com subagentes (arquivos de configuração que definem agentes especializados, como "revisor de segurança" ou "especialista em testes") quando o fluxo repetir.
Na prática, comece pequeno: instale, gere o CLAUDE.md, use o agente para explicar o código por uma semana e só então delegue mudanças — sempre com modo de aprovação ligado e diff lido antes do commit. Quem pula essa curva de leitura acaba refazendo trabalho, não economizando.