Zum Hauptinhalt springen
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. Dasselbe gilt für .claude.json, das sich andernfalls unter ~/.claude.json befindet. 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: ~/.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.

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.
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.

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. 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. Das Transkript kann auch enthalten, was Claude Code zusammen mit Ihren Nachrichten an das Modell sendet:
  • Den System-Prompt
  • Tool-Definitionen
  • Anfrageparameter
  • Die geladenen Anweisungsdateien, z. B. CLAUDE.md

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. 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.
  • seed-admin/: temporäre Git-Verzeichnisse, die Claude Code anlegt, während es Ihr Repository für ein ultrareview oder einen Cloud-Sitzungs-Upload verpackt. Wenn ein Upload endet, oder in einer späteren Sitzung, falls er unterbrochen wurde, entfernt Claude Code das Verzeichnis dieses Uploads und lässt seed-admin/ bestehen.
  • 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. Claude Code löscht diese Transkripte stattdessen nach cleanupPeriodDays, etwa in folgenden Fällen:
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 Durchlauf an; das retention_sweep Ereignis listet jede Konfiguration auf, die ihn anhält. Wenn die Ursache eine Einstellungsdatei ist, die nicht gelesen oder analysiert werden kann, oder Einstellungsfehler bei gesetztem cleanupPeriodDays oder desktopSessionCleanupPeriodDays, zeigt /status eine Warnung an, bis Sie die Ursache beheben.
Wenn verwaltete Einstellungen cleanupPeriodDays bereitstellen, führt Claude Code den Durchlauf mit dem verwalteten Wert aus, auch wenn eine Einstellungsdatei mit niedrigerer Priorität Fehler enthält. 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. Unter Windows ist <project> ein 16-stelliger Hash dieser Zeichenfolge, z. B. 73295dabccd14c56. In einer Sitzung der Desktop-App kann es die Zeichenfolge selbst sein. Um den genauen Pfad zu erhalten, fragen Sie Claude. 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.

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:
Der Plan listet jedes übereinstimmende Element und den Grund auf, warum es enthalten ist:
Löschen Sie mit einer einzelnen Bestätigungsaufforderung:
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:
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 nicht ~/.claude.json, ~/.claude/settings.json oder ~/.claude/plugins/: Diese enthalten Ihre Kontodaten, Voreinstellungen und installierten Plugins.