BookinglyTech News
Software

Backup de tu infraestructura Claude con repositorio privado

Una práctica esencial: almacenar tu carpeta ~/.claude en git para proteger tus skills, reglas y configuraciones.

2 min de lecturaDev.to0 vistas

Una regla de oro en ingeniería de software es siempre respaldar lo que haces. Cuando trabajas con Claude, la carpeta ~/.claude almacena skills, hooks, CLAUDE.md y otros artefactos que evolucionan con el tiempo. Si algo falla, perderías tu historial de cambios y las modificaciones que Claude aplica a CLAUDE.md.

La solución propuesta es crear un repositorio privado y hacer commit de la carpeta ~/.claude. De esa forma obtienes:

  • Respaldo de todo lo que has escrito y editado.
  • Historial de versiones de tus skills y de CLAUDE.md.
  • Visibilidad de los cambios que Claude introduce en los archivos.

Para evitar que se suban credenciales y datos sensibles, añade un .gitignore que excluya los archivos que contienen tokens o transcripciones de sesión. Un ejemplo funcional se muestra a continuación:

# Back up only what you author in ~/.claude. Everything else stays out by default:
# credentials, session transcripts, caches, installed plugins.
# Keep your own files in another folder here? Add a !/<folder>/ line for it.
/*
!/.gitignore
!/README.md
!/CLAUDE.md
!/rules/
!/skills/
!/commands/
!/agents/
!/hooks/
!/output-styles/
!/keybindings.json
!/statusline*
# Hook registration, permissions and the status line live here.
# Uncomment only after every token in its env block moved to a real environment variable.
# !/settings.json
# Auto-memory: keep only memory/ from each project, never the session transcripts
!/projects/
!/projects/*/*
!/projects/*/memory/
# Synced by the Claude apps, not authored here
/skills/synced/
# Safety net inside allowed folders
.env*
*.pem
*.key
node_modules/
__pycache__/

El punto clave es que, aunque la carpeta ~/.claude contenga archivos generados por la app, el backup debe limitarse a lo que tú autoras. Con la configuración anterior, Git solo rastrea los archivos que has creado y excluye los que contienen información sensible.

Para implementar esto en tu flujo de trabajo:

  1. Crea un repositorio en tu host de Git preferido (GitHub, GitLab, Bitbucket).
  2. Clona el repositorio en un directorio, por ejemplo ~/claude-backup.
  3. Copia la carpeta ~/.claude dentro del repositorio.
  4. Añade el .gitignore proporcionado.
  5. Realiza commits regulares y push a la rama principal.

Con esta estrategia, cualquier actualización que hagas en tus skills o en la configuración de Claude quedará versionada, y tendrás un punto de restauración inmediato en caso de corrupción de datos o eliminación accidental.

Esta práctica no solo protege tu trabajo, sino que también facilita la colaboración con otros desarrolladores, ya que el historial de cambios queda visible y rastreable. Además, al mantener la carpeta de configuración bajo control de versiones, puedes detectar cuando Claude modifica CLAUDE.md sin que tú lo solicites, lo que ayuda a depurar comportamientos inesperados.

En resumen, el backup con Git es una solución sencilla, robusta y alineada con las mejores prácticas de ingeniería de software. Si aún no lo has implementado, vale la pena dar el paso.

Mi blog ofrece más ejemplos de flujos de trabajo con Claude.