Claude Code para engenheiros: de chat a colega de time
A maioria dos engenheiros usa o Claude como uma busca mais esperta. Aqui está o caminho curto pra usá-lo como um colega de time que de fato entrega trabalho na sua máquina.
- #claude-code
- #terminal
- #engineering
Eu lidero engenharia numa startup americana, e a maior diferença que eu vejo entre quem tira valor do Claude e quem não tira é essa: a maioria dos engenheiros ainda fica digitando pergunta numa caixa de chat e colando a resposta de volta no editor. É a forma mais lenta possível de usar a ferramenta.
O Claude Code fecha o ciclo. Ele lê os seus arquivos, roda os seus comandos e edita o código no lugar — na sua máquina, no seu repositório. O salto de "Google mais esperto" pra "colega que faz o trabalho" depende, no fundo, de dois hábitos.
Hábito 1: escrever um CLAUDE.md
Coloque um CLAUDE.md numa pasta e o Claude pega ele sozinho toda vez que você começa a trabalhar ali — sem ficar colando contexto no prompt a cada vez. É a diferença entre integrar um estranho toda manhã e trabalhar com alguém que já conhece a sua stack, as suas convenções e as três coisas em que você nunca quer que mexam.
Mantenha curto e específico. O meu geralmente tem quatro seções:
- Stack — linguagens,
framework, gerenciador de pacotes, como rodar os testes. - Convenções — nomenclatura, tratamento de erro, os padrões que você realmente usa.
- Limites — o que não mexer sem perguntar (
migrations, autenticação, cobrança). - Comandos — os comandos exatos de
build,linte testes.
Hábito 2: dê as ferramentas e deixe ele iterar
Com o contexto redondo, pare de microgerenciar. Deixe o Claude ler, planejar, editar e rodar os testes sozinho, e depois reagir ao resultado. Um fluxo típico é mais ou menos assim:
# aponte pro objetivo, não pra cada tecla
claude "add a guides-index.json build step, run the tests, fix until green"
O trabalho que antes eram vinte instruçõezinhas vira um resultado claro mais a liberdade de iterar. A própria orientação da Anthropic sobre engenharia de contexto diz a mesma coisa: dê ao modelo o contexto certo e um ciclo de feedback curto, e a qualidade vai se acumulando.
O que fazer essa semana
Escolha o seu repositório mais ativo. Escreva um CLAUDE.md de uma página. Depois entregue ao Claude uma tarefa de verdade, de ponta a ponta — não uma pergunta, uma tarefa — e observe onde ele trava. Esses pontos onde ele trava são exatamente o que deve entrar no seu CLAUDE.md pra próxima vez. É esse o jogo inteiro: cada sessão deixa a próxima mais afiada.
Fontes
Continue lendo
Mais guias parecidos com este.
Um plugin do Claude Code não te dá poder nenhum. Ele te dá o resto do time.
Tudo que um plugin faz, uma pasta .claude/ solta já fazia. O que o empacotamento compra é distribuição — e o preço é o nome dos seus comandos. Aqui vão o manifesto, os comandos de instalação e a regra pra saber quando a troca compensa.
Os 4 lugares onde dá pra rodar o Claude Code (e o que cada um deixa cair)
Uma sessão na nuvem clona o seu repositório numa VM nova da Anthropic — então as suas `skills`, os seus agentes e todo servidor MCP adicionado com `claude mcp add` não estão lá. Escolher a superfície é escolha de capacidade, não de interface. Aqui vai a regra de decisão por tipo de tarefa.
Sua revisão semanal precisa de uma coluna "apagar"
Adicionar a sua 30ª skill pode deixar as outras 29 mais difíceis de achar: a listagem de skills recebe ~1% do `context window`, e o Claude Code corta a descrição das skills que você usa menos. Aqui está o ritual de sexta, a tabela que roteia cada lição e a passada de poda que todo mundo pula.