Zum Hauptinhalt springen

CLAUDE.md & Memory-Dateien

Einsteiger

Wenn du eine Sache tust, um Claude Code besser zu machen, dann diese. CLAUDE.md ist eine Klartextdatei, die Claude zu Beginn jeder Session liest — das dauerhafte Briefing deines Projekts.

What you'll learn
  • Warum CLAUDE.md die Claude-Code-Einstellung mit dem größten Hebel ist
  • Wie die Memory-Hierarchie von global bis projektspezifisch zusammengeführt wird
  • Wie du mit /init eine Ausgangsdatei generierst und sie zurechtstutzt
  • Was in CLAUDE.md gehört — und was draußen bleiben sollte
  • Wie @imports dir erlauben, Dokumente zu referenzieren, ohne sie zu duplizieren

Warum es die Einstellung mit dem größten Hebel ist​

Ohne sie erklärst du dein Projekt in jeder Session erneut ("wir nutzen pnpm, Tests liegen in __tests__, fass /generated nicht an…"). Mit ihr weiß Claude es bereits. Gute Anweisungen hier verbessern jede zukünftige Interaktion auf einmal.

Die Memory-Hierarchie​

Claude Code liest Memory aus mehreren Quellen und führt sie zusammen, grob von am globalsten zu am spezifischsten:

  • User-Memory — deine persönlichen Vorlieben über alle Projekte hinweg.
  • Projekt-Memory (./CLAUDE.md, committed) — wie dieses Repo funktioniert. Mit deinem Team geteilt.
  • Verschachtelt — lege eine CLAUDE.md in einen Unterordner für Regeln, die nur dort gelten.
Kenne deine Memory-Ebenen
Drücke Enter oder die Leertaste, um die Karte umzudrehen. Nutze die Pfeiltasten links und rechts, um zwischen den Karten zu wechseln.Begriff angezeigt.
1 / 4

Erzeuge einen Startpunkt​

Guided walkthrough1 of 3
  1. Claude untersucht den Code und entwirft automatisch eine CLAUDE.md für dich.

Einen CLAUDE.md-Entwurf generieren

/init

Hol dir einen fertigen Starter aus den CLAUDE.md-Vorlagen.

Was hineingehört​

  • Was das Projekt ist, in zwei Sätzen.
  • Tech-Stack und wie man ausführt / testet / lintet.
  • Konventionen, die Claude nicht ableiten kann (Benennung, Struktur, Commit-Stil).
  • Leitplanken: "führe Tests aus, bevor du etwas für fertig erklärst", "bearbeite niemals /vendor", "committe niemals Geheimnisse".

Was NICHT hineingehört​

Watch out
  • Claude befolgt CLAUDE.md wörtlich — veraltete, vage oder wunschdenkende Anweisungen schaden aktiv.
  • Beschreibe, wie das Projekt heute tatsächlich funktioniert; kurz und wahr schlägt lang und ambitioniert.
  • Vermeide riesige eingefügte Dokumente (nutze stattdessen @imports), Geheimnisse und Regeln, die du nicht wirklich befolgst.
  • Überprüfe sie regelmäßig, damit sie korrekt bleibt, während sich das Projekt weiterentwickelt.

Imports​

Binde vorhandene Dokumente ein, statt sie zu duplizieren — referenziere z. B. deinen Styleguide mit einem @path/to/file-Import, sodass es eine einzige Quelle der Wahrheit gibt. Die genaue Syntax findest du in der offiziellen Memory-Dokumentation.

Pro tip
  • Eine einzige Quelle der Wahrheit: referenziere eine Datei mit @imports, statt ihren Inhalt in CLAUDE.md einzufügen.
  • Wenn ein Dokument bereits existiert, verlinke es — kopiere es nicht. Kopien veralten.

Überprüfe dich selbst​

Überprüfe dich selbst

0/3
  1. Welche Datei liest Claude Code zu Beginn jeder Session als dauerhaftes Briefing deines Projekts?
  2. Was bewirkt das Ausführen von /init in einem Projekt?
  3. Was ist der empfohlene Weg, ein großes vorhandenes Dokument wie einen Styleguide einzubinden?
Key takeaways
  • CLAUDE.md ist die Einstellung mit dem größten Hebel: sie verbessert jede zukünftige Session auf einmal.
  • Memory wird von global zu spezifisch zusammengeführt: Enterprise-Richtlinien, dann User-, Projekt- und verschachtelte CLAUDE.md-Dateien.
  • Beginne mit /init, dann kürze den Entwurf auf das ein, was tatsächlich wahr ist.
  • Nimm die Projektzusammenfassung, die Befehle zum Ausführen/Testen/Linten, Konventionen und Leitplanken auf.
  • Halte sie kurz und wahr — nutze @imports für große Dokumente und committe niemals Geheimnisse.

Weiter​