So verschieben oder benennen Sie Claude-Code-Projektordner, ohne Sitzungsverlauf zu verlieren

Das Problem: mv unterbricht die Claude Code-Sitzungshistorie

Claude Code speichert Ihre Sitzungshistorie in ~/.claude/projects/ unter Verwendung des exakten absoluten Pfads Ihres Projekts als Identifikator. Beispielsweise erhält ein Projekt unter /Users/alex/my-project einen Sitzungsordner unter: ~/.claude/projects/-Users-alex-my-project/.

Wenn Sie mv verwenden, um einen Projektordner zu verschieben oder umzubenennen, stimmt der Pfad nicht mehr überein und alle Ihre Sitzungen werden für Claude Code unsichtbar. Die Daten werden nicht gelöscht, sondern bleiben verwaist.

Die Lösung: clamp Tool

clamp ist ein von der Community entwickeltes Tool, das das Umbenennen, Verschieben oder beides von Ordnern handhabt und dabei die Claude Code-Sitzungshistorie bewahrt.

Installation über Homebrew:

brew install wsagency/tap/clamp

Schritte zur Verwendung von clamp

Folgen Sie diesen Schritten in der angegebenen Reihenfolge:

1. Zuerst einen Probelauf durchführen (Änderungen vorab prüfen):
   clamp --dry-run /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Überprüfen Sie die Ausgabe auf erkannte Sitzungsdateien und bestätigte neue Pfade.
2. Die tatsächliche Migration durchführen:
   clamp /Users/alex/old-project-name /Users/alex/documents/new-project-name
   Geben Sie y zur Bestätigung ein.
3. Überprüfen, ob alles korrekt übernommen wurde:
   clamp --list clamp --verify
4. Ihre Sitzung fortsetzen:
   cd /Users/alex/documents/new-project-name
claude --continue

Falls Sie bereits mv verwendet haben

Wenn Sie den Ordner bereits mit mv verschoben haben und der Sitzungszugriff unterbrochen wurde, verwenden Sie den Befehl --fix:

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

Dieses Tool adressiert einen spezifischen Schmerzpunkt für Entwickler, die ihre Projektstrukturen neu organisieren, während sie Zugriff auf ihre Claude Code-Konversationshistorie behalten.