Git con Claude Code: revisa diffs y commits sin leer cada línea
Claude Code opera sobre tu repositorio de Git: revisa diffs, prepara cambios y genera mensajes de commit. Pero cuando un agente modifica veinte archivos en una sesión, leer cada línea para verificar no escala. La técnica que sí escala es cambiar el nivel de revisión: verificar la forma del diff (¿los archivos correctos, el tamaño correcto?) y usar un diagrama Mermaid para entender la arquitectura resultante. Esos dos chequeos capturan la mayoría de los problemas sin leer el código completo.
El cambio de método: con agentes capaces, leer cada línea de un diff de 20 archivos significa o revisar mal o no revisar. Mejor revisar la forma y la arquitectura, que detectan las desviaciones estructurales más rápido que la lectura línea por línea.
Verificación 1: la forma del diff
El primer chequeo es el conjunto de archivos modificados y la cantidad aproximada de cambios en cada uno. La intuición es simple:
- Pediste un cambio pequeño en pagos, el diff debería mostrar uno o dos archivos de pagos con pocos cambios.
- Pediste cambiar un texto de la landing, el diff debería mostrar ese archivo con una o dos líneas.
Si ves 200 líneas cambiadas en 12 archivos para una corrección de texto, eso es una señal de problema. No necesitas leer qué cambió para saber que algo salió mal. La vista de árbol del panel de cambios (en VS Code u otros) basta para el primer chequeo: ¿están los archivos correctos? ¿Hay alguno que no debería estar?
Verificación 2: el diagrama Mermaid
El segundo chequeo es pedirle al agente un diagrama Mermaid que muestre cómo funciona el sistema o el feature después de los cambios. A diferencia de leer código, el diagrama muestra relaciones entre componentes, no implementación: ves de un vistazo si el flujo resultante es el que esperabas, sin entender cada función.
El flujo: el agente implementa, le pides el Mermaid de la arquitectura resultante, y lo contrastas con lo que esperabas.
En la práctica
- Para commits: pídele que resuma los cambios y proponga un mensaje convencional. Puedes encapsularlo en un slash command
/end-sessionconmodel: haikupara que sea rápido y consistente. - Para revisar: primero la forma del diff, después el Mermaid. Solo lees líneas concretas donde el chequeo de forma o arquitectura levantó una bandera.
- Seguridad: nunca dejes que incluya archivos de credenciales o
.enven un commit; restringe las herramientas del comando conallowed-tools.
Preguntas frecuentes
¿Cómo reviso los cambios que hace Claude Code en Git?
En lugar de leer cada línea, verifica dos cosas: la forma del diff (que los archivos modificados sean los correctos y el tamaño del cambio sea el esperado) y un diagrama Mermaid de la arquitectura resultante. Esos dos chequeos capturan la mayoría de los problemas rápido.
¿Cómo sé si un cambio de Claude Code salió mal sin leer el código?
Mira la forma del diff: si pediste algo pequeño y el diff toca muchos archivos con muchas líneas, hay una señal de problema. La vista de árbol del panel de cambios te dice de un vistazo si los archivos correctos están y si hay alguno que no debería.
¿Puede Claude Code generar mensajes de commit?
Sí. Le pides que resuma los cambios y proponga un mensaje (por ejemplo en formato Conventional Commits). Puedes encapsular ese flujo en un slash command para que sea consistente, fijando un modelo rápido como Haiku.
¿Cómo verifico la arquitectura de un cambio grande con Claude Code?
Pídele un diagrama Mermaid que muestre cómo queda el sistema después de los cambios. El diagrama muestra las relaciones entre componentes, no la implementación, así que ves si el flujo resultante es el que esperabas sin leer cada función.
Recursos relacionados
- Slash commands personalizados: para encapsular el flujo de commit.
- Comandos de calidad y cómo depurar.
- Guía completa para dominar Claude Code.
Tu siguiente paso
Los comandos del día a día están en la Cheat Sheet de Claude Code: una hoja imprimible, en español.
Descargar la Cheat Sheet gratis
Es el resumen de Ship with Claude Code, la guía de Takren (14 módulos, 190 capítulos, actualizaciones gratuitas).