Qué es un commit y por qué te salva cuando trabajas con IA
Claude Code puede cambiar veinte archivos en un minuto. Si algo sale mal, su botón de deshacer no recupera todo: lo dice su propia documentación. Lo que sí te deja volver a cualquier punto es un commit, una foto de tu proyecto con nombre y fecha. Aquí va qué es, cuándo hacerlo y cómo volver atrás sin romper nada.
- 01Qué esUna foto de tu proyecto que puedes recuperar
- 02Qué esPor qué el deshacer de Claude Code no basta
- 03Paso a pasoTu primer commit en 4 pasos
- 04DecidirCuándo hacer un commit
- 05Paso a pasoCómo volver atrás sin romper nada
- 06Prompts2 prompts para que Claude lo haga por ti
- 07CuidadoLo honesto
Qué es un commit: una foto de tu proyecto que puedes recuperar
En git, un commit (en español, una confirmación) es una instantánea de tus archivos guardada en el historial del proyecto. El libro oficial de git lo describe como confirmar instantáneas de tus cambios «cada vez que el proyecto alcance un estado que quieras conservar». (Pro Git · Guardando cambios)
Cada commit lleva un mensaje que escribes tú (o Claude), una fecha y un código único. Juntos forman el historial: la lista de todas las versiones por las que pasó tu proyecto.
El ciclo tiene tres pasos, siempre los mismos:
- Editas tus archivos (tú o la IA). Git los ve como «modificados».
- Preparas los que quieres guardar, con
git add. Es elegir qué entra en la foto. - Confirmas con
git commit: la foto queda guardada con su mensaje.
Piensa en guardar partida en un videojuego. Cada commit es un punto de guardado con nombre. Si el siguiente nivel sale mal, vuelves al último punto en vez de empezar de cero.
Por qué el deshacer de Claude Code no basta
Claude Code guarda automáticamente un punto de control antes de cada mensaje que le mandas. Con /rewind (o pulsando dos veces Esc) puedes volver atrás el código, la conversación o ambos. Es muy útil, pero su propia documentación marca cuatro límites: (Checkpointing · Claude Code Docs)
| Qué cambió | ¿Lo recupera /rewind? | ¿Lo recupera un commit? |
|---|---|---|
| Archivos que Claude editó con su herramienta de edición | Sí | Sí |
| Archivos que cambió con un comando de terminal (borrar, mover, copiar) | No | Sí |
| Lo que editó un subagente, en la mayoría de los casos | No: la documentación dice «usa git» | Sí |
| Cambios que hiciste tú a mano o desde otra sesión | Normalmente no | Sí |
| Versiones de hace semanas | Los guarda unos 30 días por defecto | Para siempre |
La misma página lo resume así: los puntos de control son para recuperarse rápido dentro de una sesión, y no reemplazan al control de versiones. Para el historial permanente, git.
Cómo hacer tu primer commit en 4 pasos
Si trabajas con Claude Code, puedes pedírselo en lenguaje normal (ver los prompts de abajo). Pero conviene saber qué pasa por debajo. Estos son los comandos, en una terminal dentro de tu carpeta de proyecto:
- Mira qué cambió. Git te lista los archivos nuevos y modificados.
git status - Prepara lo que quieres guardar. Nombra los archivos uno por uno: así no se cuela nada que no querías.
git add nombre-del-archivo.md - Confirma con un mensaje que diga qué cambió y por qué.
git commit -m "Precios de marzo actualizados en la ficha de servicios" - Comprueba que quedó en el historial. Cada línea es un commit, del más nuevo al más viejo.
git log --oneline
Si tu carpeta todavía no usa git, el primer paso es git init, que la convierte en un repositorio. Solo se hace una vez. (git-commit · Pro Git)
Cuándo hacer un commit (y cuándo no)
No hay una regla oficial de frecuencia. Estas son las que usamos en IActn con Claude Code a diario:
- Antes de pedirle a la IA un cambio grande. Si sale mal, vuelves a este punto en segundos.
- Después de cada cambio que funciona. Una idea por commit: «precios actualizados», no «cambios varios».
- Con un mensaje que tu yo de dentro de un mes entienda. Qué cambió y por qué, en una línea.
- Nunca con contraseñas ni claves dentro. Lo que entra en un commit se queda en el historial aunque luego lo borres del archivo.
Nuestro ejemplo real: cada guía de este Arsenal se guarda en su propio commit, con un mensaje que dice qué cambió. Y antes de guardar, un control automático revisa que no se cuele ninguna clave ni dato personal. Eso es un hook de git, y tiene su propia guía: hooks.
Cómo volver atrás sin romper nada
La forma más segura de deshacer un commit es git revert: en vez de borrar historia, crea un commit nuevo que deshace los cambios del que eliges. Así el error y su arreglo quedan registrados, y no pierdes nada. (git-revert)
- Busca el commit que quieres deshacer con
git log --oneline. Cada uno empieza con un código corto, comoa1b2c3d. - Deshazlo con un commit nuevo:
git revert a1b2c3d
Hay otros comandos que sí descartan cambios sin dejar rastro. Si la IA te propone uno que no entiendes, pídele antes que te explique qué se pierde. Guardar primero y borrar después siempre es la opción segura.
2 prompts para que Claude Code lo haga por ti
Son nuestros, no de Anthropic. Funcionan en Claude Code dentro de una carpeta con git.
Guarda lo que acabas de hacer
Cuándo usarlo: al terminar un cambio que funciona, antes de pedir el siguiente.
Explícame qué cambió
Cuándo usarlo: cuando algo dejó de funcionar y no sabes desde cuándo.
Lo honesto
- Un commit no es una copia de seguridad. Vive en tu computadora: si se rompe el disco, se va con ella. Para tener copia fuera hay que subirlo a un servicio como GitHub. Eso es otro paso (push) y otra guía.
- Si solo usas el chat de Claude en la web, no aplica. Git sirve para carpetas de archivos. En el chat, tus versiones son las conversaciones y los archivos que descargas.
- La frecuencia que recomendamos es nuestra, no oficial. Git no dice cada cuánto hacer un commit. Lo de «antes de cada cambio grande de la IA» sale de nuestra forma de trabajar.
- Lo que entra en el historial cuesta sacarlo. Si guardaste una clave por error, cámbiala: borrarla del archivo no la borra de los commits anteriores.
- Los 30 días de /rewind son el valor por defecto de Claude Code a la fecha de esta guía. Se puede cambiar en su configuración, y puede cambiar en versiones nuevas.
Antes de pedirle a una IA un cambio grande, haz un commit. Es un punto de guardado que no depende de que la IA se acuerde de nada, y que su propio deshacer no reemplaza. Lo siguiente de la serie: CLAUDE.md, las reglas que Claude Code lee siempre.
¿Y ahora qué?
Tres formas de seguir, según lo que prefieras.
El mensaje para tu grupo
¿Le sirve a alguien de tu equipo o de tu grupo? Cópialo tal cual o ábrelo directo en WhatsApp.
Te paso esta guía: Qué es un commit. Un punto de guardado que la IA no puede borrar. https://iactn.com/arsenal/que-es-un-commit/Fuentes, leídas el 30-09-2026
- Fundamentos de Git · Guardando cambios en el Repositorio · libro oficial Pro Git, en español. Qué es confirmar, el ciclo editar → preparar → confirmar,
git addygit status. - git-commit y git-log · documentación oficial de git.
- git-revert · documentación oficial de git. Deshacer un commit registrando uno nuevo.
- Checkpointing · Claude Code Docs.
/rewind, lo que no rastrea (terminal, subagentes, cambios externos), la retención de unos 30 días y «no reemplaza al control de versiones».