Directorio / Guías / Claude Code
Git y respaldos con Claude Code
Por qué guardar tu trabajo con git aunque no seas programador: los checkpoints y /rewind con sus límites, commits con mensajes claros, ramas para probar, el .gitignore y un respaldo privado en GitHub.
Claude Code puede editar muchos archivos en pocos minutos. Casi siempre sale bien, y cuando no, necesitas volver atrás con precisión. Git es un registro de versiones de tu carpeta: cada vez que guardas un punto, llamado commit, puedes ver qué cambió y regresar a él. No necesitas ser programador, porque Claude ejecuta los comandos por ti. Tú decides cuándo guardar y revisas qué se guarda.
Lo que ya trae Claude Code: checkpoints
Antes de cada pedido tuyo, Claude Code guarda el estado de los archivos que edita. Con /rewind, o con Esc dos veces cuando la línea de escritura está vacía, ves la lista de tus pedidos y eliges uno. Puedes restaurar el código, la conversación o los dos.
Sirve para deshacer el último intento, pero tiene límites:
- Sigue los cambios que Claude hace con sus herramientas de edición. Un archivo que solo cambió un comando de terminal, por ejemplo uno que movió o borró archivos, no se restaura.
- Los cambios que haces tú fuera de Claude Code, o los de otra sesión abierta al mismo tiempo, normalmente no quedan registrados.
- Lo que edita un subagente en archivos que Claude no había tocado en tu conversación se queda como está.
- Guarda los 100 puntos más recientes de cada sesión, y la limpieza automática los borra, por defecto, unos 30 días después.
La documentación oficial lo dice claro: los checkpoints son para recuperarte rápido dentro de una sesión y no reemplazan el control de versiones.
Empezar con git
- Comprueba que lo tienes. Escribe
git --versionen la terminal. En Windows, si no aparece una versión, instala Git for Windows, que Claude Code también recomienda. La primera vez, configura tu nombre y correo:git config --global user.name "Tu Nombre" git config --global user.email "tu@correo.com" - Pídele a Claude que lo inicie. En la carpeta del proyecto: «Inicializa git aquí, crea un .gitignore adecuado para esta carpeta y haz el primer commit. Antes, muéstrame qué archivos van a entrar».
- Revisa la lista. Si aparece un
.env, una exportación de clientes o una carpeta de datos, detenlo y agrégalos al.gitignore.
El .gitignore: lo que nunca entra
Es un archivo de texto con lo que git debe ignorar. Un punto de partida para un proyecto de negocio:
# Claves y contraseñas
.env
.env.*
!.env.example
# Datos y exportaciones
datos/
*.csv
*.xlsx
# Archivos del sistema
.DS_Store
Thumbs.db
Si un archivo ya estaba en un commit, agregarlo al .gitignore no lo saca del historial. Deja de seguirlo con git rm --cached .env y, si tenía una clave, cámbiala. Considérala filtrada, sobre todo si llegó a GitHub.
Commits con mensajes claros
Guarda un punto cada vez que algo funciona, no al final del día. Pídelo así:
Revisa los cambios desde el último commit y haz un commit con un
mensaje que diga qué cambió y por qué. Si hay cambios de temas
distintos, sepáralos en varios commits.
Un buen mensaje se entiende dentro de seis meses: «Actualiza el horario de atención a lunes a sábado» sirve; «cambios» no. Para ver el historial, pídele los últimos diez commits o escribe git log --oneline. Si haces commits seguido, el plugin commit-commands del marketplace oficial agrega un comando para eso. La guía de plugins de Claude Code explica cómo instalarlo.
Ramas para probar sin miedo
Una rama es una línea paralela de tu proyecto. Pruebas en ella y, si no sirve, la descartas sin tocar la versión buena. Haz commit antes de cambiar de rama. Puedes pedírselo a Claude («crea una rama para probar el diseño nuevo») o escribirlo tú:
git switch -c prueba-diseno # crea la rama y entra en ella
git switch main # vuelve a la rama principal
git merge prueba-diseno # si te gustó, trae los cambios
git branch -D prueba-diseno # si no, bórrala
Según tu instalación, la rama principal puede llamarse main o master. Lo ves con git branch.
Un respaldo privado en GitHub
Git guarda la historia en tu computadora. Si el disco falla, se pierde con ella. Un repositorio privado en GitHub es la copia fuera de tu máquina.
- Instala la CLI de GitHub e inicia sesión con
gh auth login. - Crea el repositorio privado y sube todo desde la carpeta del proyecto:
gh repo create mi-proyecto --private --source=. --push - Al terminar cada sesión, sube los commits nuevos con
git push, o pídele a Claude que suba los cambios.
Privado quiere decir que solo lo ven tú y quienes invites. Aun así es un servicio de terceros: no subas claves ni datos de clientes. Con el proyecto en GitHub también puedes usar las sesiones en la nube o publicar una página.