Speicherbedarf von Claude Code auf dem Mac: Sitzungen, Logs und was bleiben sollte

Sitzungen, Debug-Logs und Datei-Schnappschüsse erfüllen unterschiedliche Aufgaben. Miss deshalb jedes davon, bevor du entscheidest, was weg soll. Ein großer Ordner kann trotzdem frühere Unterhaltungen oder Wiederherstellungsdaten enthalten, die du noch brauchst.

Das Wichtigste in Kürze

  • Kurz gesagt. Sitzungen, Debug-Logs und Datei-Schnappschüsse erfüllen unterschiedliche Aufgaben. Miss deshalb jedes davon, bevor du etwas entfernst.
  • Worauf du achten solltest. Löschst du ein Transkript, ist die Unterhaltung weg. Ein großer Ordner kann trotzdem Verläufe oder Wiederherstellungsdaten enthalten, die du noch brauchst.
  • Mit Mint. Mint zeigt im Tab „Disk“, wie viel Platz Claude belegt. Eine gemessene Größe ist keine Empfehlung zum Bereinigen.

Was in ~/.claude liegt

Jede Sitzung ist eine Datei unter ~/.claude/projects/<encoded-path>/<uuid>.jsonl und kann eingebettete Bilder enthalten. Zu manchen Sitzungen gehört außerdem ein gleichnamiger Begleitordner, in dem Ergebnisse von Tools und Transkripte von Subagenten liegen können. Behandle diesen Ordner und seine Sitzungsdatei als Paar.

Logs, die bei eingeschaltetem Debugging entstehen, landen in ~/.claude/debug/. In ~/.claude/file-history/<session>/ liegen Schnappschüsse deiner Dateien, wie sie vor einer Bearbeitung aussahen, damit du zu einem Checkpoint zurückkehren kannst. Löschst du die Schnappschüsse, sind diese Wiederherstellungskopien weg.

Behalte deine Konfigurations- und Memory-Dateien, darunter settings.json, CLAUDE.md und die Memory-Ordner der Projekte. Der CLI-Cache kann auch außerhalb dieses Ordners liegen, unter ~/Library/Caches/claude-cli-nodejs/.

Claude Code entfernt einen Teil seiner Anwendungsdaten nach eigenen Aufbewahrungsregeln selbst. Was dabei wegfällt, hängt von der Version, deiner Konfiguration und dem Auslöser der Bereinigung ab. Lies also die aktuelle Dokumentation von Claude Code zu diesem Ordner, statt anzunehmen, dass nie etwas gekürzt wird. Ist CLAUDE_CONFIG_DIR gesetzt, nimm diesen Ort statt ~/.claude.

Erst messen, dann prüfen

Um die Ordner der obersten Ebene zu vergleichen, führ diesen Befehl aus, der nur liest: du -h -d 1 "${CLAUDE_CONFIG_DIR:-$HOME/.claude}" | sort -hr

Meldet der Befehl du Fehler wegen fehlender Berechtigungen oder Pfade, sind die Summen unvollständig. So oder so zeigt der Befehl, wohin der Platz geht. Was du gefahrlos löschen kannst, verrät er nicht.

  1. Beende alle laufenden Claude-Aufgaben, auch Sitzungen in anderen Terminalfenstern, bevor du ihre Dateien änderst.
  2. Sichere die Unterhaltungen und Wiederherstellungsdaten, die du noch brauchst.
  3. Sieh dir Debug-Logs getrennt von den Sitzungen an und entferne ein Log erst, wenn du es zur Fehlersuche nicht mehr brauchst. CLI-Caches lassen sich bei Bedarf neu anlegen, der Platz kann sich also wieder füllen.
  4. Entferne in projects/ nur die Sitzungen, die du bewusst aussortiert hast, zusammen mit ihrem Begleitordner, falls es einen gibt. Das Alter kann die Auswahl eingrenzen, aber dass eine Sitzung alt ist, heißt nicht, dass sie gefahrlos weg kann. Lösch die Memory-Ordner der Projekte nicht zusammen mit den Sitzungsdaten.
  5. Lass file-history/ in Ruhe, solange du seine Wiederherstellungskopien noch brauchst. Leg das, was du ausgewählt hast, zuerst in den Papierkorb und prüf alles, bevor du entscheidest, ob du ihn leerst. Dateien im Papierkorb belegen weiterhin Platz.

Ein gelöschtes Transkript nimmt die Unterhaltung mit

Entfernst du eine Sitzung, sind ihr Text und alle darin gespeicherten Bilder weg, und du kannst sie lokal nicht mehr fortsetzen. Eine Memory-Notiz, die auf die Sitzung verweist, zeigt dann womöglich auf einen Eintrag, den es nicht mehr gibt. Die Notiz selbst wird beim Löschen der Sitzung aber weder gelöscht noch beschädigt.

Entferne nicht einfach den ganzen Ordner ~/.claude, um schneller aufzuräumen. Neben den Sitzungsdaten liegen dort deine Konfiguration und deine Memory-Dateien.

Was Mint beiträgt

Mint zeigt im Tab „Disk“, wie viel Platz Claude belegt. Eine gemessene Größe ist keine Empfehlung zum Bereinigen. Prüf, wozu ein Eintrag dient und ob du ihn noch brauchst, bevor du eine Aktion wählst.

Häufig gestellte Fragen

Kann ich ~/.claude/projects gefahrlos löschen?

Nicht als Ganzes. Darin können Unterhaltungen, Begleitdaten und das Memory deiner Projekte liegen. Geh die Sitzungen einzeln durch und behalte die, die du noch fortsetzen oder nachlesen willst.

Warum ist ~/.claude so groß?

Das hängt vom Mac ab. Miss Sitzungen, Debug-Logs und Datei-Schnappschüsse getrennt, mit dem Befehl von oben, der nur liest. Was am meisten Platz belegt, ist von Mac zu Mac verschieden.

Sieh nach, wie viel Platz Claude Code belegt

Starte einen Scan und such im Tab „Disk“ nach Claude.

Speicher der KI-Agenten scannen