Comment déplacer ou renommer les dossiers de projet Claude Code sans perdre l'historique des sessions

Le Problème : mv Rend l'Historique des Sessions Claude Code Inaccessible

Claude Code stocke votre historique de sessions dans ~/.claude/projects/ en utilisant le chemin absolu exact de votre projet comme identifiant. Par exemple, un projet situé à /Users/alex/my-project obtient un dossier de session à : ~/.claude/projects/-Users-alex-my-project/.

Lorsque vous utilisez mv pour déplacer ou renommer un dossier de projet, le chemin ne correspond plus et toutes vos sessions deviennent invisibles pour Claude Code. Les données ne sont pas supprimées mais deviennent orphelines.

La Solution : L'outil clamp

clamp est un outil créé par la communauté qui gère le renommage, le déplacement, ou les deux, tout en préservant l'historique des sessions Claude Code.

Installez-le via Homebrew :

brew install wsagency/tap/clamp

Étapes pour Utiliser clamp

Suivez ces étapes dans l'ordre :

1. Exécutez d'abord un test à blanc (prévisualisez les changements) :
   clamp --dry-run /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Vérifiez la sortie pour les fichiers de session détectés et les nouveaux chemins confirmés.
2. Exécutez la migration réelle :
   clamp /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Tapez y pour confirmer.
3. Vérifiez que tout s'est bien passé :
   clamp --list clamp --verify
4. Reprenez votre session :
   cd /Users/alex/documents/new-project-name
claude --continue

Si Vous Avez Déjà Utilisé mv

Si vous avez déjà déplacé le dossier avec mv et que l'accès aux sessions est rompu, utilisez la commande --fix :

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

Cet outil répond à un point de friction spécifique pour les développeurs qui réorganisent la structure de leurs projets tout en conservant l'accès à leur historique de conversations Claude Code.