Skip to main content
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 eigenständig oder zusammen mit CLAUDE.md lesen. Der Rest des Verzeichnisses ist optional: Fügen Sie Skills, Rules oder Subagents 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: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.

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.
  • 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. Wenn verwaltete Einstellungen cleanupPeriodDays setzen, löscht Claude Code diese Transkripte stattdessen nach diesem Zeitraum. Erfordert Claude Code v2.1.248 oder später; frühere Versionen löschen sie 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.

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

Der Aufbewahrungsbereinigungsdurchlauf entfernt die folgenden Pfade nicht. Claude Code behält sie, bis Sie sie löschen, abgesehen von den zwei Caches, die es beim Abmelden löscht. Andere Dateien erscheinen je nachdem, welche Funktionen Sie verwenden. Caches und Lock-Dateien können 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 project 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. 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:
Ü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/ allein, da diese nicht projektbezogen sind, und warnt in der Plan-Ausgabe davor. Sie können auch jeden der oben genannten Anwendungsdaten-Pfade manuell löschen, abgesehen von den Zustandsdateien zum Behalten. Neue Sitzungen sind nicht betroffen. Die folgende Tabelle zeigt, was Sie für vergangene Sitzungen verlieren. Löschen Sie nicht ~/.claude.json, ~/.claude/settings.json oder ~/.claude/plugins/: Diese enthalten Ihre Authentifizierung, Voreinstellungen und installierten Plugins.