CLAUDE.md:
das Projektgedächtnis

Jede neue Claude-Code-Sitzung startet mit leerem Kopf. Claude erinnert sich nicht an das gestrige Gespräch. CLAUDE.md ist eine dauerhaft gespeicherte Datei mit Anweisungen und Regeln, die bei jedem Start automatisch geladen wird. Kurz: es ist das, was du sonst jede Sitzung neu in den Chat tippen würdest. Einmal geschrieben, und Claude erinnert sich immer.

Es gibt zwei Gedächtnis-Systeme: CLAUDE.md, die Regeln, die du bewusst schreibst, und das Auto-Gedächtnis, Notizen, die Claude selbst aus deinen Korrekturen ableitet. Diesen Guide widmen wir vor allem der ersten Datei.

Voraussetzung ist nur eins: Claude Code ist installiert (Claude, eingebettet in VS Code). Wie du das aufsetzt und dem Projekt ein Grundgerüst gibst, steht im Guide Projekt vorbereiten. CLAUDE.md selbst wird automatisch geladen, du brauchst keine Erweiterung.

CLAUDE.md kann an mehreren Orten liegen, jeder mit einem anderen Geltungsbereich. Geladen wird von breit nach eng:

Für die Solo-Arbeit zählen zwei: ./CLAUDE.md im Projekt (die Hauptdatei, kommt in git) und optional ./CLAUDE.local.md für deine persönlichen Anpassungen (kommt in die .gitignore).

Claude geht den Ordnerbaum vom Startpunkt nach oben durch und sammelt alle CLAUDE.md und CLAUDE.local.md ein. Startest du in foo/bar/, lädt er foo/bar/CLAUDE.md, foo/CLAUDE.md und die lokalen Dateien daneben.

Alle gefundenen Dateien werden kombiniert, nicht überschrieben. Anweisungen näher am Startpunkt werden zuletzt gelesen und haben Vorrang. Dateien in Unterordnern lädt Claude nur, wenn er deren Code bearbeitet. Praktische Regel: starte Claude vom Projekt-Stamm aus. Dann sieht er die Hauptdatei sofort und holt sich verschachtelte, wenn er sie braucht.

Grundregel: schreib auf, was du sonst jede Sitzung neu erklären müsstest. Eine Notiz lohnt sich, wenn:

• Claude zweimal denselben Fehler macht;
• ein Blick in den Code etwas zeigt, das er über dieses Projekt wissen sollte;
• du dieselbe Korrektur in einer neuen Sitzung wieder eintippst;
• ein neuer Mensch im Team denselben Kontext bräuchte.

Rein gehören Fakten, Befehle, Struktur: Build-Befehle, Namensregeln und Stil, Projektstruktur, feste Regeln wie „mach immer X".

Raus bleiben zu enge oder mehrstufige Sachen: ein Verfahren mit vielen Schritten gehört in einen eigenen Skill, und Regeln für nur einen Code-Teil in path-scoped rules (.claude/rules/), die nur unter bestimmten Dateien automatisch laden.

CLAUDE.md wird in jeden Sitzungs-Kontext geladen und verbraucht Token wie ein normales Gespräch. Wie du sie schreibst, entscheidet, wie zuverlässig Claude folgt. Fünf Regeln machen den Unterschied, drei davon schauen wir uns genauer an.

1. Konkret. Schreib so, dass die Anweisung überprüfbar ist:

2. Kurz. Ziel: unter 200 Zeilen pro Datei. Längere Dateien fressen mehr Kontext und senken die Regelbeachtung. Große Abschnitte lagerst du in path-scoped rules aus.

3. Ohne Widersprüche. Widersprechen sich zwei Regeln, wählt Claude eine zufällig. Lies CLAUDE.md und verschachtelte Dateien ab und zu durch und wirf Veraltetes und Konflikte raus.

Du musst nicht bei null anfangen. Der Befehl /init in Claude Code schaut dein Projekt an und erzeugt automatisch ein Start-CLAUDE.md mit Build-Befehlen, Test-Setup und Code-Konventionen. Gibt es schon eine, überschreibt /init sie nicht, sondern schlägt Verbesserungen vor. Und /memory öffnet die aktuelle Gedächtnis-Datei zum Bearbeiten.

Du kannst andere Dateien in CLAUDE.md hereinziehen, mit @pfad/zur/datei. So bleibt alles an einer Stelle, ohne Doppelung:

Importierte Dateien werden ausgerollt und mitgeladen. Pfade dürfen relativ oder absolut sein, verschachtelt bis vier Ebenen tief. Willst du einen Pfad nur erwähnen, nicht importieren, schreib ihn in Backticks.

CLAUDE.local.md im Stamm ist für deine persönlichen Anpassungen, verhält sich genauso, kommt aber in die .gitignore und nicht in git. Kleiner Trick: hast du schon eine AGENTS.md für andere KI-Tools, lässt du CLAUDE.md einfach @AGENTS.md importieren, dann lesen alle Werkzeuge dasselbe.

Das Auto-Gedächtnis sind Notizen, die Claude selbst schreibt, nicht du. Merkt er deine Korrekturen oder Vorlieben, speichert er die Erkenntnis, um denselben Fehler nicht zweimal zu machen. Der Unterschied: CLAUDE.md sind die Regeln, die du bewusst setzt, das Auto-Gedächtnis sind die Erkenntnisse aus der Zusammenarbeit. Grenze: die ersten rund 200 Zeilen oder 25 KB pro Projekt. Zusammen erzeugen beide das Gefühl, Claude kenne dich schon.

• Nicht erwarten, dass das #-Zeichen eine Notiz anlegt. Früher ging das schnell mit #. Heute bearbeitest du die Datei direkt oder nutzt /memory.
• Die Datei wird zu lang. Über 200 Zeilen kostet zu viel Kontext, und Claude beachtet die Regeln schlechter. Große Abschnitte in path-scoped rules auslagern.
• Widersprüchliche Regeln. Zwei, die sich beißen, und Claude würfelt. Regelmäßig die Datei und verschachtelte CLAUDE.md durchsehen und aufräumen.

Ohne CLAUDE.md arbeitest du mit einem allgemeinen Claude, dem du jedes Mal dasselbe erklärst. Mit CLAUDE.md arbeitest du mit einem Claude, der genau dein Projekt kennt: deine Build-Befehle, deine Ordnerstruktur, dein „so machen wir es nie". Eine Datei macht aus einem Universal-Werkzeug ein Werkzeug, das auf deine Arbeit zugeschnitten ist. Der Schmerz der Anfängerin, dass jeder neue Chat wieder bei null beginnt, ist damit weg. Die Arbeit fühlt sich an wie ein Gespräch mit jemandem, der dich schon versteht.

CLAUDE.md ist das Gedächtnis. Und das Gedächtnis lebt in einem Projekt-Rahmen: klare Ordnerstruktur, diese Datei und ein fester Arbeitszyklus. Hast du den Rahmen noch nicht, fang mit Projekt vorbereiten an. Darauf baut das ganze System auf, von den Trends über Karussells und Reels bis zu Funnel und Angebot. Diese komplette Kette bauen wir im Kurs Schritt für Schritt gemeinsam.

Alle Fakten stammen aus der offiziellen Claude-Code-Dokumentation: