Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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:
| 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 |
| 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-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. | 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 |
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 als cleanupPeriodDays 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 |
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. |
todos/ | Legacy-Pro-Sitzungs-Aufgabenlisten. Nicht mehr von aktuellen Versionen geschrieben; 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:
- 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:
claude project purge ~/work/my-repo --dry-run
claude project purge ~/work/my-repo
claude project purge ~/work/my-repo --yes
--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/ | Nichts. Legacy-Verzeichnis nicht von aktuellen Versionen geschrieben. |
~/.claude.json, ~/.claude/settings.json oder ~/.claude/plugins/: Diese enthalten Ihre Authentifizierung, Voreinstellungen und installierten Plugins.
Verwandte Ressourcen
