~/.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-modeoder--settingsüberschreibensettings.jsonfür diese Sitzung - Einige Umgebungsvariablen haben Vorrang vor ihrer entsprechenden Einstellung, aber dies variiert: Überprüfen Sie die Umgebungsvariablenreferenz für jede einzelne
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 alscleanupPeriodDays 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-persistencezusammen mit-pübergeben oderpersistSession: falseim Agent SDK setzen. - Verwenden Sie Berechtigungsregeln, um Lesevorgänge von Anmeldeinformationsdateien zu verweigern
Lokale Daten löschen
Führen Sieclaude 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/undfile-history/Einträge - Übereinstimmende Prompt-Zeilen in
history.jsonl - Der Projekteintrag in
~/.claude.json
--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.
Verwandte Ressourcen
- Verwalten Sie Claudes Memory: Schreiben und organisieren Sie CLAUDE.md, Rules und Auto Memory
- Konfigurieren Sie Einstellungen: Setzen Sie Berechtigungen, Hooks, Umgebungsvariablen und Modellstandards
- Erstellen Sie Skills: Bauen Sie wiederverwendbare Prompts und Workflows
- Konfigurieren Sie Subagents: Definieren Sie spezialisierte Agenten mit eigenem Kontext