Claude para programar: o que dá para fazer além de perguntar código?

Pedir "me dá esse código" é o uso mais raso que existe do Claude

E é onde a maior parte da galera para

Só que o modelo não é um autocomplete com chat em volta, ele consegue ocupar praticamente todas as etapas chatas do teu dia: revisar diff antes do merge, entender uma base legada que ninguém documentou, escrever teste, deixar convenção escrita e automatizar aquela tarefa que tu repete toda santa semana

Neste post eu passo caso por caso, sempre com o que dá pra esperar de resultado, e onde ainda vai precisar de você na cadeira 🙂

Revisar diff e caçar vulnerabilidade antes do merge

Esse é o caso que mais surpreende quem só usa chat

O Claude Code tem um comando de revisão de segurança sob demanda, rodado dentro do projeto, direto no terminal:

/security-review

Ele varre a base atrás de vulnerabilidade e explica o que encontrou

A cobertura inclui injeção de SQL, XSS, falhas de autenticação, tratamento inseguro de dados e vulnerabilidades de dependências

E se eu quiser isso no pull request, sem ninguém lembrar de rodar? Aí tu usa a GitHub Action oficial da Anthropic, o repositório anthropics/claude-code-security-review

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

O pulo do gato dela: a análise é diff-aware, ou seja, olha só os arquivos alterados no PR, publica os achados como comentários no próprio PR e ainda aplica filtragem de falsos positivos

O que esperar de resultado: achado comentado na linha certa, no lugar onde a discussão já acontece, e não um relatório gigante em PDF que ninguém abre

O que NÃO esperar: carimbo de "seguro". É input pra revisão humana, principalmente se aquilo vai pra produção

Entender uma base legada e deixar o entendimento escrito

Entrar num projeto legado perguntando arquivo por arquivo é desperdício puro

Tu gasta a sessão inteira reconstruindo contexto, fecha o terminal e o conhecimento evapora

O caminho melhor é o comando /init: ele analisa a base e cria uma versão inicial do CLAUDE.md, com comandos de build, instruções de teste e convenções do projeto

Que arquivo é esse? É onde o Claude Code guarda as instruções persistentes do projeto

E o detalhe que muda tudo: ele é compartilhado com o time por controle de versão

Ou seja, o entendimento vira ativo do repositório, versionado igual código, e não conversa perdida no teu histórico

Tem ainda um complemento: a auto memory acumula aprendizados automaticamente, e o comando /memory deixa navegar essa pasta de memória automática

O conteúdo é markdown puro, então dá pra ler, editar ou apagar na mão quando ele aprendeu alguma bobagem

O que esperar: um mapa inicial pra você corrigir, não a verdade final sobre o sistema

O primeiro CLAUDE.md gerado quase sempre tem chute sobre convenção interna. Lê e ajusta antes de commitar, senão tu versiona o erro pro time inteiro

Escrever teste e documentar sem virar tarefa de fim de sprint

Teste e documentação são exatamente o trabalho que mais sofre com preguiça humana

Ninguém sente prazer em escrever o quinto caso de borda de uma função de validação

E é justamente aí que o modelo rende, porque não existe custo mental pra ele repetir

Funciona MUITO melhor quando o contexto do projeto já está no CLAUDE.md: com os comandos de build e as instruções de teste escritos ali, ele não precisa adivinhar como o teu projeto roda a suíte

A mesma lógica vale pra documentação

Documentar convenção dentro do próprio CLAUDE.md faz aquela instrução valer pra todo mundo do time nas próximas sessões, e não só na tua janela de chat de hoje

Se o resultado tá vindo genérico, o problema costuma estar no pedido, e vale revisar suas técnicas de prompt no Claude Code antes de culpar o modelo

O que esperar: rascunho que você revisa

O ganho real não é qualidade sobre-humana, é volume sem custo mental

Automatizar a tarefa repetitiva que você faz toda semana

Esse é o caso mais subestimado de todos

Se tu faz a mesma coisa toda semana, tu não precisa pedir de novo toda semana, tu precisa transformar aquilo em configuração do projeto

São quatro caminhos, do mais simples ao mais estruturado

1. Comando customizado

O caminho de entrada

O próprio security-review.md do repositório anthropics/claude-code-security-review pode ser copiado pra pasta .claude/commands/ do teu projeto e editado do teu jeito

É o atalho pra ter um comando com as regras da tua casa, não as genéricas

2. Hooks

Hooks disparam ação automática em eventos de ferramenta, configurados no settings.json

Os eventos incluem PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest e PermissionDenied

A estrutura tem o evento, um matcher (do tipo "Edit|Write", pra pegar edição e escrita de arquivo) e um handler do tipo command

Pra conferir o que está ativo, o comando /hooks lista os hooks configurados agrupados por evento

E se algo começar a atrapalhar, "disableAllHooks": true desliga todos de uma vez, sem você sair apagando configuração

3. Subagentes customizados

Subagente é instrução especializada que vira um arquivo

O Claude Code observa duas pastas: ~/.claude/agents/, pessoal, que vale em todos os teus projetos, e .claude/agents/, do projeto, pra versionar com o time

O arquivo usa frontmatter YAML e o corpo em markdown vira o system prompt dele:

---
name: revisor-de-migration
description: Revisa migrations antes do merge
---

Você revisa migrations de banco procurando operação destrutiva
e mudança de coluna sem plano de rollback

O frontmatter aceita também os campos tools e model

Coisa massa: editar o arquivo é detectado em segundos, sem reiniciar nada. Tu ajusta o prompt e já testa

4. Skills

Skill é o degrau mais estruturado: um diretório com um arquivo SKILL.md, cujo frontmatter YAML tem campos como name, description, disable-model-invocation e allowed-tools

O Claude Code lê tanto ~/.claude/skills/ quanto o .claude/skills/ do projeto

Dá pra instalar pelos plugins do marketplace anthropics/skills ou na mão, colocando a pasta em ~/.claude/skills

Tome cuidado com esta pegadinha: mudanças são detectadas na sessão, MAS criar um diretório de skills que não existia quando a sessão começou exige reiniciar

É o clássico "criei a skill e ele ignorou". Não é bug, é sessão velha

Colocar o Claude dentro do script e do CI

Aqui é o pulo do interativo pro automático

A flag -p (ou --print) roda o Claude Code com o prompt sem sessão interativa, o que permite usar ele dentro de script e de pipeline de CI

O exemplo oficial da documentação:

claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"

Repara no --allowedTools: tu escolhe explicitamente o que ele pode usar, e isso é o teu guardrail no automático, onde não vai ter ninguém aprovando permissão na mão

E o detalhe que faz virar script de verdade: ele sai com código 0 em sucesso e código diferente de zero em falha

Então o teu script ramifica pelo exit status, igual qualquer outra ferramenta de linha de comando

Pra pipeline tem ainda a flag --bare, um modo enxuto que reduz o tempo de inicialização pulando a descoberta automática de hooks, skills, plugins, servidores MCP, auto memory e CLAUDE.md

A ideia dela é justamente essa: no CI tu quer rodada previsível, que não dependa da configuração da tua máquina nem da minha

O que esperar: comportamento igual em qualquer runner

Onde o Claude rende de verdade e onde ainda exige você

Cruzando os casos, dá pra ver um padrão bem claro

Resumo honesto: ele rende em trabalho de contexto amplo e repetitivo

E ainda exige você em decisão de arquitetura, onde a escolha carrega tradeoff que só quem conhece o negócio consegue pesar. Nesses casos vale planejar antes de executar em vez de deixar ele sair mexendo

Um aviso de transparência: nada disso aqui foi medido em teste próprio do blog

O veredito é sobre a NATUREZA de cada uso, não sobre benchmark. Não vou te vender percentual de bug encontrado nem hora economizada, porque esses números por aí costumam ser chute com cara de dado

Em qual plano isso está disponível

Dúvida prática que sempre aparece antes de instalar qualquer coisa

Hoje são cinco planos: Free, Pro, Max, Team e Enterprise

E aqui vai a boa notícia pra quem acha que Claude Code é coisa de plano caro: ele está incluído já no Pro, junto do conjunto completo de capacidades do Claude, incluindo Claude Cowork e Claude Design

O Pro pode ser mensal ou anual

O Max entra quando o uso aperta: ele oferece 5x ou 20x o uso do Pro por sessão de 5 horas, além de limites de saída maiores, e está disponível apenas como assinatura mensal

Sobre limite, o funcionamento é o seguinte: todo plano tem limite que reinicia em janela móvel de sessão de 5 horas, e os planos pagos somam limites semanais em cima disso

Não vou citar valor em dólar nem conversão em real aqui, porque preço muda e eu não checo número por achismo. Confere direto na página de planos da Anthropic

Por onde começar hoje

Se tu leu até aqui e bateu aquela vontade de configurar tudo de uma vez, segura o freio

O caminho que funciona é progressivo:

1. Abra o projeto que você mais mexe e rode /init pra gerar o CLAUDE.md. O erro comum deste passo é commitar o arquivo sem ler: ele chuta convenção, e chute versionado vira lei pro time inteiro

2. Antes do próximo merge, rode /security-review dentro do projeto. O erro comum aqui é tratar o resultado como veredito final em vez de lista pra revisar

3. Só depois disso suba um degrau: quando você identificar A tarefa que repete toda semana, transforme ela em comando customizado, hook, subagente ou Skill. O erro comum é começar por aqui, automatizando algo que você ainda nem entendeu direito no manual

4. Se a rotina for de pipeline, aí sim vá pro -p com --allowedTools, e considere --bare no CI

Usar Claude para programar de verdade é menos sobre saber o prompt perfeito e mais sobre deixar o contexto e a rotina configurados uma vez só

Agora me conta nos comentários: qual é a repetição da tua semana que tu mais quer automatizar? Tenho quase certeza que dá pra virar um comando 😀

até o próximo post!