Zum Inhalt springen
AI Learning

CLAUDE.md & Memory

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.

*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.

iÜ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.

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