Zum Inhalt springen

CLAUDE.md & Memory

  • Claude Code · Modul 03
  • Lektion 1 von 4 · danach Quellen und Quiz

Wissen

Das Projektgedächtnis von Claude Code

Stell dir vor, du arbeitest mit einem brillanten Kollegen zusammen, der jeden Morgen alles vergessen hat. Du musst ihm jeden Tag erklären: "Wir nutzen pnpm statt npm. Tests laufen mit Vitest. Bitte keine Semikolons." Frustrierend, oder?

Genau dieses Problem löst CLAUDE.md. Es ist das Projektgedächtnis von Claude Code -- eine einfache Markdown-Datei, in der du einmal festhältst, was Claude über dein Projekt wissen muss. Bei jeder neuen Session liest Claude diese Datei automatisch und kennt sofort deine Regeln, Konventionen und Eigenheiten.

Tipp
Schnellstart mit /init

Der Befehl /init analysiert dein Projekt und generiert automatisch eine Starter-CLAUDE.md. Claude schaut sich deine Projektstruktur, package.json und bestehende Config-Dateien an und erstellt einen sinnvollen Ausgangspunkt, den du dann anpassen kannst.

Zwei Gedächtnis-Systeme

Claude Code hat zwei sich ergänzende Gedächtnis-Systeme:

CLAUDE.md -- Du schreibst für Claude. Hier definierst du bewusst Regeln und Kontext: Build-Befehle, Code-Konventionen, Architektur-Entscheidungen. Du hast die volle Kontrolle über den Inhalt. Denk daran wie an ein Onboarding-Dokument für einen neuen Kollegen.

Auto Memory -- Claude schreibt für sich selbst. Während der Arbeit merkt sich Claude Dinge, die es gelernt hat: Debug-Strategien die funktioniert haben, deine Präferenzen, wiederkehrende Muster. Diese Notizen speichert Claude automatisch in einer separaten Memory-Datei und lädt sie in künftigen Sessions.

Die 4-Ebenen-Hierarchie

CLAUDE.md existiert nicht nur einmal. Es gibt vier Ebenen, die aufeinander aufbauen -- von global bis lokal. Je spezifischer eine Regel ist, desto höher ist ihre Priorität. Eine Regel in einem Unterverzeichnis überschreibt eine globale Regel, genau wie CSS-Spezifität.

Hinweis
Übersicht der Ebenen
  1. Global (~/.claude/CLAUDE.md) -- Gilt für alle deine Projekte
  2. Projekt-Root (./CLAUDE.md) -- Via Git geteilt, für das ganze Team
  3. Projekt-Config (./.claude/CLAUDE.md) -- User-spezifisch, nicht im Git
  4. Unterverzeichnis (subdir/CLAUDE.md) -- Nur bei Bedarf geladen

In den folgenden Abschnitten schauen wir uns jede Ebene im Detail an, lernen das Auto-Memory-System kennen und entwickeln Best Practices für effektive CLAUDE.md-Dateien.

Frage · Selbstcheck
Was ist der Hauptunterschied zwischen CLAUDE.md und Auto Memory?