~/.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:| Datei | Ort | Zweck |
|---|---|---|
managed-settings.json | Systemebene, variiert je nach Betriebssystem | Von Unternehmen erzwungene Einstellungen, die Sie nicht überschreiben können. Siehe servergesteuerte Einstellungen. |
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. |
| Installierte Plugins | ~/.claude/plugins | Geklonte Marketplaces, installierte Plugin-Versionen und Pro-Plugin-Daten, verwaltet durch claude plugin-Befehle. Verwaiste Versionen werden 7 Tage nach einem Plugin-Update oder einer Deinstallation gelöscht. Siehe Plugin-Caching. |
~/.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.
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
| 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 | 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 System-Prompt-Abschnitte | 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, OAuth, 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 |
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.
Pfad unter ~/.claude/ | Inhalte |
|---|---|
projects/<project>/<session>.jsonl | Vollständiges Gesprächstranskript: jede Nachricht, jeder Tool-Aufruf und jedes Tool-Ergebnis |
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 |
file-history/<session>/ | Vor-Bearbeitungs-Snapshots von Dateien, die Claude geändert hat, verwendet für Checkpoint-Wiederherstellung |
plans/ | Plan-Dateien, die während des Plan-Modus geschrieben werden |
debug/ | Pro-Sitzungs-Debug-Logs, geschrieben nur, wenn Sie mit --debug starten oder /debug ausführen |
paste-cache/, image-cache/ | Inhalte großer Einfügungen und angehängter Bilder |
session-env/ | Pro-Sitzungs-Umgebungsmetadaten |
tasks/ | Pro-Sitzungs-Aufgabenlisten, die von den Task-Tools geschrieben werden |
shell-snapshots/ | Erfasste Shell-Umgebung, die vom Bash-Tool verwendet wird. Wird bei sauberer Beendigung entfernt. Die Bereinigung löscht alle, die nach einem Absturz übrig bleiben. |
backups/ | Zeitgestempelte Kopien von ~/.claude.json, die vor Konfigurationsmigrationenen erstellt werden |
feedback-bundles/ | Redigierte Transkript-Archive, die von /feedback auf Drittanbieter-Plattformen geschrieben werden, um an Ihr Anthropic-Kontoteam gesendet zu werden |
todos/, statsig/, logs/ | Legacy-Verzeichnisse aus älteren Versionen. Nicht mehr geschrieben. Die Bereinigung entfernt deren Inhalte und dann das leere Verzeichnis. |
Behalten, bis Sie sie löschen
Die folgenden Pfade sind nicht durch automatische Bereinigung abgedeckt und bleiben auf unbestimmte Zeit bestehen.Pfad unter ~/.claude/ | Inhalte |
|---|---|
history.jsonl | Jeder Prompt, den Sie eingegeben haben, mit Zeitstempel und Projektpfad. Verwendet für Up-Arrow-Abruf. |
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. Nur vorhanden, wenn Ihre Organisation diese konfiguriert hat. Wird bei jedem Start aktualisiert. |
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 verlieren |
|---|---|
~/.claude/projects/ | Fortsetzen, Fortfahren und Zurückspulen für vergangene Sitzungen |
~/.claude/history.jsonl | Up-Arrow-Prompt-Abruf |
~/.claude/file-history/ | Checkpoint-Wiederherstellung für vergangene Sitzungen |
~/.claude/stats-cache.json | Historische Gesamtwerte, die von /usage angezeigt werden |
~/.claude/remote-settings.json | Nichts. Wird beim nächsten Start erneut abgerufen. |
~/.claude/debug/, ~/.claude/plans/, ~/.claude/paste-cache/, ~/.claude/image-cache/, ~/.claude/session-env/, ~/.claude/tasks/, ~/.claude/shell-snapshots/, ~/.claude/backups/ | Nichts für Benutzer sichtbar |
~/.claude/todos/, ~/.claude/statsig/, ~/.claude/logs/ | Nichts. Legacy-Verzeichnisse nicht von aktuellen Versionen geschrieben. |
~/.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