Cómo hacer cambios en varios archivos con Claude Code
3 min de lectura
Cuando un cambio toca más de un archivo, probablemente pegas cada archivo en un chat por separado, aplicas la sugerencia de Claude a uno, pegas el siguiente y esperas ser consistente en todos.
Consejo
Claude Code mantiene el panorama completo de todos los archivos a la vez, así que describes el resultado que quieres una sola vez, no una vez por archivo.
Describir el cambio, no los archivos
En lugar de pegar el contenido de los archivos, dile a Claude Code qué patrón buscar y en qué debe convertirse. Busca en tu proyecto real, hace las ediciones y puede ejecutar tu suite de pruebas para verificar su propio trabajo, todo en una sola tarea.
- 1
Describe el patrón, no una ubicación
Di qué debe cambiar (“cada llamada a la función auxiliar antigua”) en lugar de listar tú mismo las rutas de los archivos. Claude Code las encuentra más rápido y de forma más completa que tú a mano.
- 2
Di qué NO debe cambiar
Si una función de nombre parecido en otro lugar debe dejarse en paz, dilo explícitamente. Ese es el detalle que evita una edición demasiado amplia.
- 3
Pídele que verifique, no solo que edite
Pide después una ejecución de pruebas o una revisión específica, para no confirmar manualmente cada archivo afectado.
- 4
Revisa el diff antes de hacer el commit
Trata la salida de Claude Code como tratarías el pull request de un colega: lee lo que realmente cambió antes de aceptarlo.
Encuentra cada lugar de este repositorio que llama a la función auxiliar antigua formatCurrency, reemplázala por la nueva utilidad formatMoney (mismos argumentos, distinto nombre) y ejecuta la suite de pruebas para confirmar que nada se rompió. Deja intacta formatCurrencyRange, es una función distinta a pesar del nombre parecido.
”
Dentro de Claude Tutorial
Describir resultados, no pasos, es una habilidad transferible
Decirle a Claude qué debe ser cierto cuando termine, en lugar de guiarlo tú por cada paso, es el mismo hábito de fondo que la app enseña en muchos tipos de trabajo, no solo en código.
Tu directorio de trabajo de git está limpio antes de empezar, para que el cambio sea fácil de revisar o revertir por sí solo
Has nombrado todo lo que se parece pero debe dejarse en paz
Tienes una forma real de verificar el resultado, pruebas, un build, una revisión manual, y no solo una lectura visual del diff
Sigue leyendo
- Conectar Claude a tus propios datos y herramientas con MCP para darle a Claude acceso a sistemas más allá de tu propio código.
- Elegir entre Claude Code, un Proyecto o un chat simple para una tarea técnica para cuando un cambio en varios archivos es la señal de recurrir a Claude Code desde el principio.
- ¿Qué son los Artefactos de Claude? Una introducción práctica para prototipar el resultado de un cambio antes de aplicarlo en una base de código real.