Was macht ClaudePortable?
Sichert und stellt Claude Desktop, Cowork-Projekte sowie den Claude Code-Zustand als einzelne ZIP-Datei für lokale Speicherung oder Cloud-Synchronisation wieder her.
Funktionsweise
Dieses Tool durchsucht die Standard-Speicherorte Ihres Betriebssystems nach den Konfigurations- und Cache-Dateien von Claude Desktop, Cowork und Claude Code. Es packt alle relevanten Ordner in eine einzige ZIP-Datei, die Sie lokal ablegen oder mit einem Cloud-Dienst Ihrer Wahl synchronisieren können.
Unterstützte Plattformen
- Claude Desktop: Chat-Verläufe, Einstellungen und angehängte Dateien
- Cowork: Aktuelle Projekte und Sitzungszustände
- Claude Code: CLI-Kontext, Konfiguration und Caching-Daten
Voraussetzungen
- Node.js 18+ oder Python 3.8+
- Zugriff auf die Dateisystem-Pfade der genannten Tools (Standardinstallation vorausgesetzt)
- Ein Cloud-Dienst (optional), wenn Sie die ZIP-Datei synchronisieren möchten
Installation
# Klonen des Repositories
git clone https://github.com/Carliemajuscular804/ClaudePortable.git
cd ClaudePortable
# Abhängigkeiten installieren (Node.js)
npm install
Verwendung
Backup erstellen
# Standard-Backup in das aktuelle Verzeichnis
node cli.js backup
# Backup in ein bestimmtes Verzeichnis
node cli.js backup --output /pfad/zu/backup
# Mit Zeitstempel (Standard: `claude-portable-YYYYMMDD-HHmmss.zip`)
node cli.js backup --timestamp
Backup wiederherstellen
# Wiederherstellen aus einer bestimmten ZIP-Datei
node cli.js restore /pfad/zu/backup.zip
# Vor Wiederherstellung ein automatisches Backup erstellen
node cli.js restore /pfad/zu/backup.zip --pre-backup
In der Cloud synchronisieren
# Backup in Dropbox-Ordner (Beispiel)
node cli.js backup --output ~/Dropbox/ClaudeBackups
# Von Google Drive wiederherstellen
node cli.js restore ~/GoogleDrive/ClaudeBackups/claude-portable-20231201-120000.zip
Konfiguration
Optionale Umgebungsvariablen:
| Variable | Beschreibung | Standard |
|---|---|---|
CLAUDE_PORTABLE_DIR | Benutzerdefinierter Backup-Ordner | ./backups |
CLAUDE_DESKTOP_PATH | Manueller Pfad zu Claude Desktop | Automatisch erkannt |
CLAUDE_CODE_PATH | Manueller Pfad zu Claude Code | Automatisch erkannt |
COWORK_PATH | Manueller Pfad zu Cowork-Projekten | Automatisch erkannt |
Wiederherstellungs-Reihenfolge
- Sicherheitsprüfung: Vor jeder Wiederherstellung wird geprüft, ob die Zielpfade existieren
- Automatisches Backup: Bei Bedarf (
--pre-backup) wird der aktuelle Zustand gesichert - Wiederherstellung: Die Inhalte der ZIP-Datei werden an die ursprünglichen Pfade zurückgeschrieben
- Überschreiben: Bestehende Dateien werden überschrieben (mit Ausnahme von Konfigurationsdateien, die gemergt werden)
Fehlerbehandlung
- Falls ein Pfad nicht existiert, wird eine Warnung ausgegeben und der Vorgang fortgesetzt
- Bei fehlenden Berechtigungen wird das Skript mit einem Fehler beendet (
Fehler 13) - Die ZIP-Datei wird nur geschrieben, wenn alle Quellordner erfolgreich gelesen wurden
Lizenz
MIT-Lizenz – siehe LICENSE-Datei für Details.