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. 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:
  • Verwaltete Einstellungen, die von Ihrer Organisation bereitgestellt werden, haben Vorrang vor allem anderen
  • 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.

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, landet in einem Transkript auf der Festplatte: Dateiinhalte, Befehlsausgabe, eingefügter Text.

Automatisch bereinigt

Dateien in den folgenden Pfaden werden beim Start gelöscht, sobald sie älter als cleanupPeriodDays sind. Der Standard ist 30 Tage.

Behalten, bis Sie sie löschen

Die folgenden Pfade sind nicht durch automatische Bereinigung abgedeckt und bleiben auf unbestimmte Zeit bestehen. Andere kleine Cache- und Lock-Dateien erscheinen je nachdem, welche Funktionen Sie verwenden, und sind sicher zu löschen.

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 Transkripte aufbewahrt werden
  • 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 Agent SDK setzen.
  • Verwenden Sie Berechtigungsregeln, um Lesevorgänge von Anmeldeinformationsdateien zu verweigern

Lokale Daten löschen

Führen Sie claude project purge aus, um den Status zu löschen, den Claude Code für ein Projekt hält. Der Befehl erfordert Claude Code v2.1.124 oder später. Er 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
Der Befehl gibt den vollständigen Löschplan aus und fordert zur Bestätigung auf, bevor etwas entfernt wird. Zeigen Sie den Plan in der Vorschau an, ohne etwas zu löschen:
Löschen Sie mit einer einzelnen Bestätigungsaufforderung:
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. Er wird mit Status 1 beendet, wenn kein Status dem angegebenen Pfad entspricht. Sie können auch jeden der oben genannten Anwendungsdaten-Pfade manuell löschen. 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.