SpyBara
Go Premium

claude-directory.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 85 additions and 84 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 23:58 Mon 5 23:58 Tue 6 23:59 Wed 7 23:59 Wed 14 22:58 Fri 16 22:59 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Mon 26 22:57 Thu 29 23:57

Erkunden Sie das .claude-Verzeichnis

Wo Claude Code CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules und auto memory liest. Erkunden Sie das .claude-Verzeichnis in Ihrem Projekt und ~/.claude in Ihrem Home-Verzeichnis.

Claude Code liest Anweisungen, Einstellungen, Skills, Subagents und Memory aus Ihrem Projektverzeichnis und aus ~/.claude in Ihrem Home-Verzeichnis. Committen Sie Projektdateien zu git, um sie mit Ihrem Team zu teilen; Dateien in ~/.claude sind persönliche Konfiguration, die für alle Ihre Projekte gilt.

Unter Windows wird ~/.claude zu %USERPROFILE%\.claude aufgelöst. Wenn Sie CLAUDE_CONFIG_DIR setzen, lebt jeder ~/.claude-Pfad auf dieser Seite stattdessen unter diesem Verzeichnis.

Die meisten Benutzer bearbeiten nur CLAUDE.md und settings.json. Wenn Ihr Repository bereits eine AGENTS.md für andere Coding-Agenten hat, kann Claude Code diese anstelle einer CLAUDE.md lesen. Der Rest des Verzeichnisses ist optional: Fügen Sie Skills, Regeln oder Subagenten hinzu, wenn Sie sie benötigen.

Erkunden Sie das Verzeichnis

Klicken Sie auf Dateien im Baum, um zu sehen, was jede Datei tut, wann sie geladen wird, und ein Beispiel.

Was nicht angezeigt wird

Der Explorer behandelt Dateien, die Sie erstellen und bearbeiten. Ein paar verwandte Dateien befinden sich an anderen Orten:

Datei Ort Zweck
managed-settings.json Systemebene, variiert je nach Betriebssystem Von Unternehmen erzwungene Einstellungen, die Ihre eigenen Einstellungsdateien und --settings-Werte nicht überschreiben können, mit Ausnahme von engen Ausnahmen. Siehe wo die Datei gespeichert werden soll und welche verwaltete Quelle Claude Code verwendet.
CLAUDE.local.md Projektstammverzeichnis Ihre privaten Voreinstellungen für dieses Projekt, geladen zusammen mit CLAUDE.md. Erstellen Sie es manuell und fügen Sie es zu .gitignore hinzu.
AGENTS.md Projektstammverzeichnis, .claude/ oder ein beliebiges Verzeichnis Projektanweisungen, die Sie für KI-Codierungs-Agenten schreiben. Claude Code kann sie anstelle einer CLAUDE.md laden.
Installierte Plugins ~/.claude/plugins Geklonte Marketplaces, installierte Plugin-Versionen, der installed_plugins.json-Installationsdatensatz und Pro-Plugin-Daten, verwaltet durch claude plugin-Befehle. Plugins synchronisiert von Ihrem claude.ai-Konto werden in ~/.claude/plugins/synced/ heruntergeladen. Für ein Plugin, das von einem Marketplace mit command-Quelle im Link-Modus installiert wurde, speichert Claude Code hier Links statt einer Kopie, und die Dateien des Plugins bleiben in dem Verzeichnis, das der Befehl ausgibt. Eine command-Quelle erfordert Claude Code v2.1.229 oder später. Ein Plugin, das nach relativem Pfad in einem Marketplace aufgelistet ist, den Sie über einen lokalen Pfad hinzugefügt haben, wird ebenfalls an Ort und Stelle geladen aus seinem Quellverzeichnis statt aus einer Cache-Kopie. Siehe Plugin-Caching für die Bereinigung verwaister Versionen.

~/.claude enthält auch Daten, die Claude Code während der Arbeit schreibt: Transkripte, Prompt-Verlauf, Datei-Snapshots, Caches und Logs. Siehe Anwendungsdaten unten.

Wählen Sie die richtige Datei

Verschiedene Arten von Anpassungen befinden sich in verschiedenen Dateien. Verwenden Sie diese Tabelle, um zu finden, wo eine Änderung hingehört.

Sie möchten Bearbeiten Bereich Referenz
Claude Projektkontext und Konventionen geben CLAUDE.md Projekt oder global Memory
Spezifische Tool-Aufrufe zulassen oder blockieren settings.json permissions oder hooks Projekt oder global Berechtigungen, Hooks
Ein Skript vor oder nach Tool-Aufrufen ausführen settings.json hooks Projekt oder global Hooks
Umgebungsvariablen für die Sitzung setzen settings.json env Projekt oder global Einstellungen
Persönliche Überschreibungen aus git halten settings.local.json Nur Projekt Einstellungsbereiche
Einen Prompt oder eine Fähigkeit hinzufügen, die Sie mit /name aufrufen skills/<name>/SKILL.md Projekt oder global Skills
Einen spezialisierten Subagent mit seinen eigenen Tools definieren agents/*.md Projekt oder global Subagents
Orchestrieren Sie viele Subagents aus einem Skript workflows/*.js Projekt oder global Dynamische Workflows
Externe Tools über MCP verbinden .mcp.json Nur Projekt MCP
Ändern Sie, wie Claude Antworten formatiert output-styles/*.md Projekt oder global Ausgabestile

Dateireferenz

Diese Tabelle listet jede Datei auf, die der Explorer behandelt. Dateien im Projektbereich befinden sich in Ihrem Repo unter .claude/ (oder im Stammverzeichnis für CLAUDE.md, .mcp.json und .worktreeinclude). Dateien im globalen Bereich befinden sich in ~/.claude/ und gelten für alle Projekte.

[!NOTE]

Mehrere Dinge können das überschreiben, was Sie in diese Dateien eingeben:

  • Verwaltete Einstellungen, die von Ihrer Organisation bereitgestellt werden, haben Vorrang vor jeder Einstellungsdatei und jedem --settings-Wert, abgesehen von den Ausnahmen unter Einstellungspriorität
  • CLI-Flags wie --permission-mode oder --settings überschreiben settings.json für diese Sitzung
  • Einige Umgebungsvariablen haben Vorrang vor ihrer entsprechenden Einstellung, aber dies variiert: Überprüfen Sie die Umgebungsvariablenreferenz für jede einzelne

Siehe Einstellungspriorität für die vollständige Reihenfolge.

Klicken Sie auf einen Dateinamen, um diesen Knoten im Explorer oben zu öffnen.

Datei Bereich Commit Was es tut Referenz
CLAUDE.md Projekt und global ✓ Anweisungen, die jede Sitzung geladen werden Memory
rules/*.md Projekt und global ✓ Themenbezogene Anweisungen, optional pfadgesteuert Rules
settings.json Projekt und global ✓ Berechtigungen, Hooks, Umgebungsvariablen, Modellstandards Einstellungen
settings.local.json Nur Projekt Ihre persönlichen Überschreibungen, automatisch gitignoriert, wenn Claude Code eine Einstellung darin speichert Einstellungsbereiche
.mcp.json Nur Projekt ✓ Team-gemeinsame MCP-Server MCP-Bereiche
.worktreeinclude Nur Projekt ✓ Gitignorierte Dateien zum Kopieren in neue Worktrees Worktrees
skills/<name>/SKILL.md Projekt und global ✓ Wiederverwendbare Prompts, aufgerufen mit /name oder automatisch aufgerufen Skills
commands/*.md Projekt und global ✓ Einzeldatei-Prompts; gleicher Mechanismus wie Skills Skills
output-styles/*.md Projekt und global ✓ Benutzerdefinierte Anweisungssätze, die anpassen, wie Claude funktioniert Ausgabestile
agents/*.md Projekt und global ✓ Subagent-Definitionen mit eigenem Prompt und Tools Subagents
workflows/*.js Projekt und global ✓ Dynamische Workflow-Skripte, geschrieben von Claude und gespeichert von /workflows; jede Datei wird zu einem /<name>-Befehl Dynamische Workflows
agent-memory/<name>/ Projekt und global ✓ Persistentes Memory für Subagents Persistentes Memory
~/.claude.json Nur global App-Status, Kontodetails, UI-Umschalter, persönliche MCP-Server Globale Konfiguration
projects/<project>/memory/ Nur global Auto Memory: Claudes Notizen für sich selbst über Sitzungen hinweg Auto Memory
keybindings.json Nur global Benutzerdefinierte Tastenkombinationen Tastenkombinationen
themes/*.json Nur global Benutzerdefinierte Farbthemen Benutzerdefinierte Designs

Frontmatter-Felder nach Datei

Skills, Befehlsdateien, Subagenten, Ausgabestile und Regeln lesen ihre Konfiguration aus YAML Frontmatter am Anfang der Datei, und jede akzeptiert ihren eigenen Satz von Feldern. Diese Tabelle listet die Feldnamen für jede Datei auf und verlinkt auf die Referenz, die sie beschreibt.

Datei Frontmatter-Felder Referenz
skills/<name>/SKILL.md name, description, when_to_use, argument-hint, arguments, disable-model-invocation, user-invocable, allowed-tools, disallowed-tools, model, effort, context, agent, background, hooks, paths, shell, metadata, license, compatibility Skill-Frontmatter
commands/*.md Die Skill-Felder außer name und paths Skill-Frontmatter
agents/*.md name, description, tools, disallowedTools, model, permissionMode, maxTurns, autoCompactWindow, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt, omitClaudeMd, experimental Subagenten-Frontmatter
output-styles/*.md name, description, keep-coding-instructions, force-for-plugin Ausgabestil-Frontmatter
rules/*.md paths Regel-Frontmatter

Agenten, die in einem Plugin ausgeliefert werden, berücksichtigen eine Teilmenge der Subagenten-Felder.

Fehlerbehebung bei der Konfiguration

Wenn eine Einstellung, ein Hook oder eine Datei nicht wirksam wird, siehe Debuggen Sie Ihre Konfiguration für die Inspektionsbefehle und eine Symptom-erste Nachschlagetabelle.

Anwendungsdaten

Über die Konfiguration, die Sie erstellen, hinaus, enthält ~/.claude Daten, die Claude Code während Sitzungen schreibt. Diese Dateien sind Klartext. Alles, das durch ein Tool läuft, wird in einem Transkript auf der Festplatte geschrieben: Dateiinhalte, Befehlsausgabe, eingefügter Text.

Automatisch bereinigt

Claude Code löscht die Dateien in den folgenden Pfaden, sobald sie älter als cleanupPeriodDays sind, solange es die Aufbewahrungsfrist sicher bestimmen kann. Der Standard ist 30 Tage und das Minimum ist 1; das Setzen von 0 schlägt mit einem Validierungsfehler fehl. Die gleiche Altersgrenze gilt für die automatische Entfernung von verwaisten Worktrees.

Pfad unter ~/.claude/ Inhalte
projects/<project>/<session>.jsonl Vollständiges Gesprächstranskript: jede Nachricht, jeder Tool-Aufruf und jedes Tool-Ergebnis
projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl, projects/<project>/<session>.jsonl.superseded-<timestamp> Ein vorheriges Transkript für die Sitzung, das Claude Code beiseite gelegt hat, anstatt es zu überschreiben oder zu löschen. Es wird nicht in der Sitzungsauswahl angezeigt
projects/<project>/<session>/subagents/ Subagent Gesprächstranskripte, entfernt mit dem übergeordneten Sitzungstranskript, wenn es veraltet
projects/<project>/<session>/tool-results/ Große Tool-Ausgaben, die in separate Dateien verschoben werden, und vollständige Kopien von Bildern, die MCP-Tools zurückgeben
projects/<project>/<session>/mcp-tasks/ Was eine fortgesetzte Sitzung benötigt, um ihren laufenden MCP-Tasks wieder zu folgen, und die Ergebnisse abgeschlossener Tasks, die Claude noch nicht gelesen hat
file-history/<session>/ Vor-Bearbeitungs-Snapshots von Dateien, die Claude geändert hat, verwendet für Checkpoint-Wiederherstellung. Enthält Snapshots für die 100 neuesten Checkpoints; Snapshot-Dateien, auf die kein beibehaltener Checkpoint verweist, werden gelöscht, außer dem ersten Snapshot jeder Datei
plans/ Plan-Dateien, die während des Plan-Modus geschrieben werden
debug/ Pro-Sitzungs-Debug-Logs, geschrieben während Debug-Logging aktiviert ist, z. B. wenn Sie mit --debug starten oder /debug ausführen
paste-cache/ Inhalte großer Einfügungen
image-cache/<session>/ Angehängte Bilder, die von Claude Code v2.1.274 und früher gespeichert wurden. Spätere Versionen speichern eingefügte und angehängte Bilder außerhalb von ~/.claude, in einem images/-Verzeichnis für jede Sitzung unter dem temporären Verzeichnis, das CLAUDE_CODE_TMPDIR steuert. Der Durchlauf entfernt die Verzeichnisse anderer Sitzungen, die hier übrig gelassen wurden, unabhängig von ihrem Alter.
uploads/<session>/ Dateien, die Sie aus dem Web oder der mobilen App anhängen, und Fotos, die Sie aus der mobilen App anhängen, wenn Sie eine Remote Control Sitzung anschreiben. Ein Anhang zu einer Cloud-Sitzung wird stattdessen in der eigenen Cloud-Umgebung dieser Sitzung gespeichert, nicht auf Ihrem Computer.
dev-mods/<session>/ Mods, die Claude geschrieben hat während der Sitzung
session-env/ Pro-Sitzungs-Umgebungsmetadaten
tasks/ Aufgabenlisten, die von den Task-Tools geschrieben werden, ein Verzeichnis pro Liste
shell-snapshots/ Aliase, Funktionen und Shell-Optionen, die beim Start erfasst und vom Bash-Tool auf jeden Befehl angewendet werden. Wird bei sauberer Beendigung entfernt. Die Bereinigung löscht alle, die nach einem Absturz übrig bleiben.
backups/ Frühere Versionen von ~/.claude.json, kopiert, wenn Claude Code die Datei umschreibt. Claude Code behält die fünf neuesten, plus eine Kopie jeder Version, die es nicht analysieren konnte.
feedback-bundles/ Redigierte Transkript-Archive, die von /feedback auf Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind geschrieben werden, um an Ihr Anthropic-Kontoteam gesendet zu werden
feedback/drafts/ Warteschlange Claude-entworfener Feedback in Erwartung Ihrer Überprüfung in /feedback. Bereinigt nach cleanupPeriodDays oder 30 Tagen, je nachdem, welcher Wert kürzer ist. Wenn die Warteschlange ihre Grenze von 10 Entwürfen erreicht, löscht Claude Code den ältesten Entwurf, um Platz zu schaffen.
usage-data/ report.html und zeitgestempelte Report-Kopien, die von /insights geschrieben werden, plus zwischengespeicherte Pro-Sitzungs-Analysedaten, die zu ihrer Erstellung verwendet werden
skills/.trash/, plugins/.trash/ Skills und Plugins, die die claude.ai-Synchronisierung entfernt hat, z. B. nachdem Sie eine auf claude.ai ausgeschaltet haben oder die Synchronisierung beendet haben. Die Dateien bleiben hier, damit Sie sie wiederherstellen können, bis der Durchlauf sie löscht
plugins/installed_plugins.set-aside.<date>.<hash>.json, plugins/installed_plugins.unreadable.<date>.<hash>.kept Datierte Kopien, die Claude Code vor dem Umschreiben von installed_plugins.json erstellt: Installationsdatensätze, die es gelöscht hat, und der Inhalt einer Datei, die es nicht lesen konnte.
todos/, statsig/, logs/ Legacy-Verzeichnisse aus älteren Versionen. Nicht mehr geschrieben. Die Bereinigung entfernt deren Inhalte und dann das leere Verzeichnis.

Sitzungsdateien in sessions/, automatisches Memory und Claude Desktop und Cowork Transkripte folgen jeweils ihrer eigenen Aufbewahrungsregel:

  • sessions/: enthält eine kleine Datei pro laufender Sitzung, verwendet zur Erkennung gleichzeitiger Sitzungen und Abstürze. Es ist nicht Teil des altersgestützten Durchlaufs: Claude Code entfernt jede Datei, wenn ihre Sitzung beendet wird, und löscht Absturzreste beim nächsten Start.

  • Automatisches Memory: Der Durchlauf löscht nicht die Memory-Dateien im automatischen Memory Verzeichnis eines Projekts, projects/<project>/memory/. Claude Code entfernt dieses Verzeichnis nur, wenn es für die gesamte Aufbewahrungsfrist leer war. Vor v2.1.228 behandelte der Durchlauf Ordner im Memory-Verzeichnis als Sitzungsdaten und konnte alte Dateien darunter löschen.

  • Claude Desktop- und Cowork-Transkripte: Claude Code behält das Transkript einer Sitzung, die Sie in Claude Desktop oder Cowork gestartet oder zuletzt fortgesetzt haben, in jedem Alter. Um diesen Transkripten eine Altersgrenze zu geben, setzen Sie desktopSessionCleanupPeriodDays. Erfordert Claude Code v2.1.248 oder später; frühere Versionen löschen sie nach cleanupPeriodDays.

    In einem der folgenden Fälle löscht Claude Code diese Transkripte stattdessen nach cleanupPeriodDays:

Claude Code überspringt den altersgestützten Durchlauf in diesen Fällen:

  • Bare-Modus: Wenn Sie claude -p mit --bare ausführen, führt Claude Code den Durchlauf in dieser Sitzung nicht aus.
  • Angehaltener Durchlauf: Wenn Claude Code die Aufbewahrungsfrist nicht sicher bestimmen kann, hält es den Aufbewahrungsbereinigungsdurchlauf an; das retention_sweep Ereignis listet jede Konfiguration auf, die es anhält. Wenn die Ursache eine Einstellungsdatei ist, die nicht gelesen oder analysiert werden kann, oder Einstellungsfehler mit cleanupPeriodDays oder desktopSessionCleanupPeriodDays explizit gesetzt, zeigt Claude Code auch eine Warnung in /status an, bis Sie die Einstellungsfehler beheben. Wenn verwaltete Einstellungen cleanupPeriodDays bereitstellen, führt Claude Code den Durchlauf in jedem Fall mit dem verwalteten Wert aus.

Um zu prüfen, ob die Rechner in Ihrer Organisation den Durchlauf mit der von Ihnen festgelegten Aufbewahrungsfrist ausführen, siehe Aufbewahrungsdurchlauf prüfen.

Sitzungs-Scratchpad-Verzeichnis

Das Scratchpad ist ein Pro-Sitzungs-Verzeichnis, das Claude Code Claude für temporäre Dateien bereitstellt: Zwischenergebnisse, Hilfsskripte und Entwürfe, die nicht in Ihr Projekt gehören. Wenn Claude sagt, dass es etwas „in das Scratchpad“ gespeichert hat, befindet sich die Datei dort. Claude verwendet es anstelle von /tmp und kann Dateien darin erstellen, bearbeiten und lesen, ohne eine Berechtigungsaufforderung.

Das Scratchpad befindet sich unter Claude Codes temporärem Verzeichnis statt unter ~/.claude. Finden Sie den aktuellen Sitzungspfad für Ihre Plattform:

  • macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
  • Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/, oder die gleiche Form unter $TMPDIR, wenn Ihr System eine setzt
  • Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> ist Ihr Arbeitsverzeichnispfad mit jedem Zeichen außer Buchstaben und Ziffern durch - ersetzt, z. B. -Users-you-my-project. Wenn Sie CLAUDE_CODE_TMPDIR setzen, bewegt sich der Baum stattdessen unter dieses Verzeichnis. Hooks erhalten den aktuellen Sitzungspfad als scratchpad_dir.

Scratchpad-Dateien halten so lange wie das Transkript der Sitzung: Der Aufbewahrungsdurchlauf löscht das Verzeichnis, wenn es das Transkript löscht, und claude purge berührt das temporäre Verzeichnis nicht. Da sich das Verzeichnis unter dem System-Temp-Speicherort befindet, kann Ihr Betriebssystem es auch löschen, z. B. beim Neustart. Um etwas zu behalten, das Claude dort geschrieben hat, bitten Sie Claude, es in Ihr Projekt zu verschieben.

Eine Sitzung hat ein Scratchpad nur, wenn alle diese Bedingungen erfüllt sind:

  • Sie sind mit einem claude.ai-Konto angemeldet, nicht mit einem API-Schlüssel
  • Die Sitzung verwendet die Anthropic API, nicht Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry
  • enableArtifact ist nicht auf false gesetzt

Behalten, bis Sie sie löschen

Abgesehen von den Zeilen, in denen etwas anderes angegeben ist, entfernt der Aufbewahrungsbereinigungsdurchlauf die folgenden Pfade nicht, und Claude Code behält sie, bis Sie sie löschen.

Pfad unter ~/.claude/ Inhalte
history.jsonl Prompts, die Sie eingegeben haben, mit Zeitstempel und Projektpfad. Verwendet für Up-Arrow-Abruf, Ctrl+R Verlaufssuche und ! Shell-Befehl-Vervollständigung. Jeder Durchlauf entfernt die Einträge, die älter als cleanupPeriodDays sind, wenn die HIPAA-Konfiguration für Ihre Sitzungen gilt.
stats-cache.json Aggregierte Token- und Kostenzählungen, die von /usage angezeigt werden
remote-settings.json Zwischengespeicherte Kopie von servergesteuerten Einstellungen für Ihre Organisation, oder {} wenn Ihre Organisation keine konfiguriert hat. Nur vorhanden, wenn die Sitzung sie abruft. Claude Code prüft beim Start und stündlich während einer Sitzung auf Updates. Claude Code löscht es beim Abmelden.
cache/changelog.md Zwischengespeicherte Kopie des Claude Code Änderungsprotokolls, angezeigt von /release-notes. Im Hintergrund aktualisiert.
policy-limits.json Zwischengespeicherte Feature-Policy-Einstellungen für Ihre Organisation. Nur für einige Kontotypen vorhanden. Automatisch aktualisiert. Eine policy-limits.json.stamp.json Sidecar-Datei zeichnet auf, welches Konto oder API-Schlüssel der Cache gehört. Claude Code löscht beide Dateien beim Abmelden.

Zu behaltende Zustandsdateien

Je nachdem, welche Funktionen Sie verwenden, enthält ~/.claude/ auch Dateien, die in den Tabellen unter Anwendungsdaten nicht aufgeführt sind. Davon können Caches und Lock-Dateien sicher gelöscht werden. Behalten Sie diese Zustandsdateien:

Klartext-Speicherung

Transkripte und Verlauf sind nicht verschlüsselt im Ruhezustand. OS-Dateiberechtigungen sind der einzige Schutz. Wenn ein Tool eine .env-Datei liest oder ein Befehl eine Anmeldeinformation ausgibt, wird dieser Wert in projects/<project>/<session>.jsonl geschrieben. Um die Exposition zu reduzieren:

  • Senken Sie cleanupPeriodDays, um zu verkürzen, wie lange Claude Code Transkripte behält
  • Setzen Sie desktopSessionCleanupPeriodDays, um Claude Desktop und Cowork Transkripten auch eine Altersgrenze zu geben
  • Setzen Sie die Umgebungsvariable CLAUDE_CODE_SKIP_PROMPT_HISTORY, um das Schreiben von Transkripten und Prompt-Verlauf in jedem Modus zu überspringen. Im nicht-interaktiven Modus können Sie stattdessen --no-session-persistence zusammen mit -p übergeben, oder persistSession: false im TypeScript Agent SDK setzen; das Python SDK hat keine entsprechende Option.
  • Verwenden Sie Berechtigungsregeln, um Lesevorgänge von Anmeldeinformationsdateien zu verweigern

Lokale Daten löschen

Führen Sie claude purge aus, um den Zustand zu löschen, den Claude Code für ein Projekt hält. Es löscht:

  • Transkripte und automatisches Memory unter projects/
  • Pro-Sitzungs-tasks/, debug/ und file-history/ Einträge
  • Übereinstimmende Prompt-Zeilen in history.jsonl
  • Der Projekteintrag in ~/.claude.json

Bilder, die Sie in den Sitzungen des Projekts eingefügt oder angehängt haben, und das Scratchpad jeder Sitzung werden unter Claude Codes temporärem Verzeichnis gespeichert, anstatt unter ~/.claude, daher entfernt der Purge sie nicht. Der Aufbewahrungsdurchlauf löscht die Bilder, sobald sie älter als cleanupPeriodDays sind; das Scratchpad einer bereinigten Sitzung bleibt, bis Sie es löschen oder Ihr Betriebssystem das temporäre Verzeichnis löscht.

Der Befehl gibt den vollständigen Löschplan aus und fordert zur Bestätigung auf, bevor etwas entfernt wird.

Vor v2.1.288 lautete der Befehl claude project purge.

Die folgenden Beispiele verwenden ~/work/my-repo als Platzhalter. Ersetzen Sie es mit dem Pfad zu Ihrem Projekt. Wenn kein Zustand dem Pfad entspricht, gibt der Befehl einen Fehler aus und beendet sich mit Status 1.

Zeigen Sie den Plan in der Vorschau an, ohne etwas zu löschen:

claude purge ~/work/my-repo --dry-run

Der Plan listet jedes übereinstimmende Element und den Grund auf, warum es enthalten ist:

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Löschen Sie mit einer einzelnen Bestätigungsaufforderung:

claude purge ~/work/my-repo

Der Befehl gibt den gleichen Plan aus, fragt dann Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] und löscht nur, wenn Sie y antworten.

Lassen Sie den Pfad weg, um ein Projekt aus einer interaktiven Liste auszuwählen.

Überspringen Sie die Bestätigungsaufforderung zur Verwendung in Skripten:

claude purge ~/work/my-repo --yes

Weitere Optionen:

  • Übergeben Sie --all statt eines Pfads, um den Status für jedes Projekt auf einmal zu bereinigen, was history.jsonl vollständig löscht, anstatt es zu filtern.
  • Übergeben Sie -i, um den Löschplan Schritt für Schritt durchzugehen.

Der Befehl lässt shell-snapshots/ und backups/ unberührt, da diese nicht projektbezogen sind, und warnt in der Plan-Ausgabe davor. Wenn jemand auf dem Rechner /heapdump ausgeführt hat, löschen Sie auch die .heapsnapshot-Dateien, die dabei geschrieben wurden. Ein Heap-Snapshot enthält die vollständige Konversation und alle Anmeldedaten, die der Prozess gehalten hat, und weder der Aufbewahrungsdurchlauf noch der Purge berührt ihn.

Sie können auch jeden der oben genannten Anwendungsdaten-Pfade manuell löschen, abgesehen von den Zustandsdateien zum Behalten.

Löschen Sie verlieren
~/.claude/projects/ Fortsetzen, Fortfahren und Zurückspulen für vergangene Sitzungen, und automatisches Memory für jedes Projekt
~/.claude/history.jsonl Up-Arrow-Prompt-Abruf, Ctrl+R Verlaufssuche und ! Shell-Befehl-Vervollständigung
~/.claude/paste-cache/ Eingefügter Text in abgerufenen Prompts; siehe großen Inhalt einfügen
~/.claude/uploads/ Anhänge, auf die vergangene Remote Control Sitzungen nach Pfad verweisen
~/.claude/file-history/ Checkpoint-Wiederherstellung für vergangene Sitzungen
~/.claude/stats-cache.json Historische Gesamtwerte, die von /usage angezeigt werden
~/.claude/usage-data/ Vergangene /insights Reports und die zwischengespeicherten Analysedaten, die zu ihrer Erstellung verwendet werden
~/.claude/feedback-bundles/ Feedback und Bug-Report-Archive, die Sie noch nicht an Ihr Anthropic-Kontoteam gesendet haben
~/.claude/feedback/drafts/ Claude-entworfener Feedback, den Sie nicht gesendet haben
~/.claude/remote-settings.json Nichts. Wird beim nächsten Start erneut abgerufen.
~/.claude/cache/changelog.md Nichts. Im Hintergrund aktualisiert.
~/.claude/policy-limits.json Nichts. Automatisch aktualisiert.
~/.claude/tasks/ Ihre Aufgabenlisten, einschließlich solcher, die noch verwendet werden
~/.claude/skills/.trash/, ~/.claude/plugins/.trash/ Die Möglichkeit, synchronisierte Skills und synchronisierte Plugins wiederherzustellen, die Claude Code entfernt hat
~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json, ~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept Die Kopien von Plugin-Installationsdatensätzen, die Claude Code gelöscht hat oder nicht lesen konnte. Nichts liest sie zurück
~/.claude/debug/, ~/.claude/plans/, ~/.claude/session-env/, ~/.claude/shell-snapshots/, ~/.claude/backups/ Nichts für Benutzer sichtbar
~/.claude/todos/, ~/.claude/statsig/, ~/.claude/logs/, ~/.claude/image-cache/ Nichts. Legacy-Verzeichnisse nicht von aktuellen Versionen geschrieben.

Löschen Sie nicht ~/.claude.json, ~/.claude/settings.json oder ~/.claude/plugins/: Diese enthalten Ihre Kontodaten, Voreinstellungen und installierten Plugins.

Verwandte Ressourcen