Cómo Mover o Renombrar Carpetas de Proyectos de Código Claude Sin Perder el Historial de Sesión

El problema: mv interrumpe el historial de sesiones de Claude Code

Claude Code almacena tu historial de sesiones en ~/.claude/projects/ utilizando la ruta absoluta exacta de tu proyecto como identificador. Por ejemplo, un proyecto en /Users/alex/my-project obtiene una carpeta de sesión en: ~/.claude/projects/-Users-alex-my-project/.

Cuando usas mv para mover o renombrar una carpeta de proyecto, la ruta ya no coincide y todas tus sesiones se vuelven invisibles para Claude Code. Los datos no se eliminan, pero quedan huérfanos.

La solución: herramienta clamp

clamp es una herramienta creada por la comunidad que maneja el cambio de nombre, la reubicación o ambos de carpetas mientras preserva el historial de sesiones de Claude Code.

Instala mediante Homebrew:

brew install wsagency/tap/clamp

Pasos para usar clamp

Sigue estos pasos en orden:

1. Primero haz una prueba en seco (vista previa de los cambios):
   clamp --dry-run /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Verifica la salida para ver los archivos de sesión detectados y las nuevas rutas confirmadas.
2. Ejecuta la migración real:
   clamp /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Escribe y para confirmar.
3. Verifica que todo se haya realizado correctamente:
   clamp --list clamp --verify
4. Reanuda tu sesión:
   cd /Users/alex/documents/new-project-name
claude --continue

Si ya usaste mv

Si ya moviste la carpeta con mv e interrumpiste el acceso a las sesiones, usa el comando --fix:

clamp --fix --from /Users/alex/old-project-name --to /Users/alex/documents/new-project-name

Esta herramienta aborda un punto de dolor específico para desarrolladores que reorganizan sus estructuras de proyecto mientras mantienen el acceso a su historial de conversaciones de Claude Code.