The CLAUDE.md file

Schlüsselkonzepte

Zweck

• Bietet Claude Code persistentes Gedächtnis über dein Projekt
• Eliminiert die Notwendigkeit, die Codebasis bei jedem Sitzungsstart erneut zu erkunden
• Fungiert als "Onboarding-Skript" für deine Codebasis

Funktionsweise

• Markdown-Datei im Projektstammverzeichnis platziert
• Wird von Claude Code beim Sitzungsstart automatisch gelesen
• Inhalte werden an deinen prompt angehängt
• Kann automatisch mit dem /slash init Befehl generiert werden

Was du einbeziehen solltest

• Tech Stack (Frameworks, Bibliotheken, Tools)
• Code-Stil-Präferenzen (Einrückung, Namenskonventionen, Export-Typen)
• Projektstruktur (wo Dateien/Routes hingehören)
• Befehle (Dev-Server, Tests, Lint)
• Best Practices (Server Actions gegenüber API Routes bevorzugen, etc. )

Speicherhierarchie

• **Projekt-Level Claude. md** (Stammverzeichnis) - mit Team über Versionskontrolle geteilt
• **Benutzer-Level Claude. md** (Konfigurationsordner) - persönliche Präferenzen über alle Projekte hinweg

Best Practices

• Beginne ohne Claude. md, um zu identifizieren, wo du Korrektionen vornehmen musst
• Halte die Datei kompakt mit nur wesentlichen Informationen
• Bitte Claude explizit, Korrektionen im Speicher für zukünftige Sitzungen zu speichern
• Referenziere Projektdokumentation mit dem @ Symbol und Dateipfaden
• Baue schrittweise auf, während du entdeckst, was Claude wissen muss

Hauptvorteil

• Transformiert Claude Code von frustrierend (ständige Korrektionen) zu produktiv (richtiger Kontext von Anfang an)

Erkenntnisse

• **Claude. md bietet persistentes Gedächtnis** für dein Projekt, wird automatisch bei jedem Sitzungsstart gelesen, um wiederholte Codebasis-Erkundungen zu eliminieren

• Beziehe wesentlichen Kontext ein: Tech Stack, Code-Stil-Präferenzen, Projektstruktur, Befehle und Best Practices, um Claude von Anfang an zu leiten

• Zwei-Ebenen-Speichersystem: Projekt-Level Claude. md (über Versionskontrolle geteilt) + Benutzer-Level Claude. md (persönliche Präferenzen über Projekte hinweg)

• Baue schrittweise auf und halte es kompakt—beginne ohne es, identifiziere Lücken, dann füge nur kritische Informationen hinzu; bitte Claude explizit, Korrektionen für zukünftige Sitzungen zu speichern

• Transformiert Produktivität: richtiger Kontext von Anfang an eliminiert ständige Korrektionen und macht Claude Code wirklich nützlich statt frustrierend