Como fazer mudanças em vários arquivos com o Claude Code
3 min de leitura
Quando uma mudança toca mais de um arquivo, você provavelmente cola cada arquivo num chat separadamente, aplica a sugestão do Claude a um, cola o próximo e torce para estar sendo consistente em todos.
Dica
O Claude Code mantém o quadro inteiro entre os arquivos de uma só vez, então você descreve o resultado que quer uma única vez, e não uma vez por arquivo.
Descrevendo a mudança, não os arquivos
Em vez de colar o conteúdo dos arquivos, diga ao Claude Code qual padrão encontrar e no que ele deve se transformar. Ele busca no seu projeto real, faz as edições e pode rodar sua suíte de testes para conferir o próprio trabalho, tudo numa só tarefa.
- 1
Descreva o padrão, não um local
Diga o que deve mudar (“toda chamada ao helper antigo”) em vez de listar você mesmo os caminhos dos arquivos. O Claude Code os encontra mais rápido e de forma mais completa do que você à mão.
- 2
Diga o que NÃO deve mudar
Se uma função de nome parecido em outro lugar deve ser deixada em paz, diga isso explicitamente. Esse é o detalhe que evita uma edição ampla demais.
- 3
Peça que ele verifique, não só edite
Peça depois uma execução de testes ou uma checagem específica, para você não confirmar manualmente cada arquivo afetado.
- 4
Revise o diff antes de fazer o commit
Trate a saída do Claude Code do mesmo modo que trataria o pull request de um colega: leia o que realmente mudou antes de aceitar.
Encontre todo lugar neste repositório que chama o antigo helper formatCurrency, troque-o pelo novo utilitário formatMoney (mesmos argumentos, nome diferente) e rode a suíte de testes para confirmar que nada quebrou. Deixe formatCurrencyRange intocado, é uma função diferente apesar do nome parecido.
”Dentro do Claude Tutorial
Descrever resultados, não passos, é uma habilidade transferível
Dizer ao Claude o que deve ser verdade quando ele terminar, em vez de guiá-lo por cada passo você mesmo, é o mesmo hábito de fundo que o app ensina em muitos tipos de trabalho, não só em código.
Seu diretório de trabalho do git está limpo antes de começar, para a mudança ser fácil de revisar ou reverter isoladamente
Você nomeou tudo o que parece semelhante mas deve ser deixado em paz
Você tem uma forma real de verificar o resultado, testes, um build, uma checagem manual, e não só uma leitura visual do diff
Continue lendo
- Conectando o Claude aos seus dados e ferramentas com MCP para dar ao Claude acesso a sistemas além do seu próprio código.
- Escolhendo entre o Claude Code, um Projeto ou um chat simples para uma tarefa técnica para quando uma mudança em vários arquivos é o sinal de recorrer ao Claude Code logo de início.
- O que são os Artefatos do Claude? Uma introdução prática para prototipar o resultado de uma mudança antes de aplicá-la numa base de código real.
