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.

Guía paso a paso4 min de lecturaPor Rafael Schwart

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

  1. Comprueba que lo tienes. Escribe git --version en 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"
  2. 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».
  3. 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.

  1. Instala la CLI de GitHub e inicia sesión con gh auth login.
  2. Crea el repositorio privado y sube todo desde la carpeta del proyecto:
    gh repo create mi-proyecto --private --source=. --push
  3. 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.

Primero el proceso: fija una regla simple y cúmplela siempre. Por ejemplo, commit cada vez que algo funciona y push al cerrar la sesión. Un respaldo que depende de que te acuerdes no es un respaldo.

Sigue leyendo

Más guías.

Cada una se lee en menos de cinco minutos.

Todas las guías
Guía paso a paso · 4 min

Claude Code desde cero

Qué es Claude Code, cómo instalarlo en Windows o Mac, tu primer pedido, cómo aprobar lo que hace y los comandos que vas a usar cada día.

Guía paso a paso · 4 min

CLAUDE.md: el manual de tu proyecto

Qué es el archivo CLAUDE.md, dónde va, cómo crearlo con /init y qué escribir para que Claude no te pregunte lo mismo en cada sesión.

  Arqentia

¿Prefieres que lo armemos contigo?

Treinta minutos para ver tu operación: cómo entra el dinero, dónde se pierde tiempo y qué conviene automatizar primero. Gratis para negocios y sin compromiso.

Agendar consulta