Direkt zur Anleitung
buildwith.enzo / Guides Guide 008
Guide 008, die CLAUDE.md. Vorlage zum Reel.

Der Spickzettelfür dein Projekt.

Hier ist meine Vorlage zum Reel: ein Prompt, mit dem Claude Code deine CLAUDE.md anlegt oder ausmistet. Claude schlägt vor, was drin bleibt, und du prüfst jede Zeile. Am Ende hast du eine kurze Datei, die Claude nachweislich lädt.

  • Rund 30 Min Umsetzung
  • 2 Prompts
  • 5 Schritte
  • Ab Claude Pro
Los geht’s Direkt zur Vorlage

So geht’s, in fünf Schritten

  1. 1Prompt schickenZwei Stellen ausfüllen, im Projektordner abschicken.
  2. 2RückfragenSagen, was nicht in den Dateien steht.
  3. 3Entwurf prüfenJede Zeile: immer nötig oder nur manchmal?
  4. 4Laden prüfenNeu starten und unter /context nachsehen.
  5. 5Gezielt ergänzenErst beim zweiten gleichen Fehler.

Du brauchst

  • Claude Code mit Pro, Max, Team, Enterprise oder einem Console-Konto, installiert und angemeldet. Im kostenlosen Plan ist Claude Code nicht enthalten. Wie du es unter Windows installierst, steht in Guide 015, Schritt 1.
  • Einen Projektordner, in dem Claude arbeiten soll. Ob dort schon eine CLAUDE.md liegt, ist egal.
  • Einen Rechner mit Terminal, also PowerShell unter Windows oder das Terminal am Mac.
Was ist eine CLAUDE.md überhaupt?

Eine normale Textdatei in deinem Projektordner. Claude Code liest sie zu Beginn jeder Sitzung und weiß dadurch, wie dein Projekt funktioniert und wie es dort arbeiten soll. Du musst es also nicht jedes Mal neu erklären.

Brauche ich vorher /init?

Nein. /init schreibt eine erste Datei aus dem, was Claude in deinem Code findet. Wie das geht, steht in Guide 005. Mein Prompt geht andersherum vor: Er lässt weg, was Claude selbst lesen kann, und fragt nach dem, was nirgends steht.

1

Schick meine Vorlage

Die Vorlage ist ein Prompt. Claude sieht sich damit dein Projekt an, fragt nach und zeigt dir einen Entwurf mit fünf festen Abschnitten. Geschrieben wird erst, wenn du zustimmst. Gibt es schon eine CLAUDE.md, liest Claude sie zuerst und schlägt vor, was rausfliegt.

Hast du schon eine CLAUDE.md? Dann kopier sie vorher selbst, zum Beispiel als CLAUDE-alt.md in denselben Ordner, oder sichere sie mit Git. Der Prompt verlangt zwar eine Sicherung als CLAUDE.md.bak, aber ob Claude sie anlegt, liegt bei Claude.

  1. Öffne das Terminal in deinem Projektordner und starte Claude Code mit claude.
  2. Kopier den Prompt und ersetz die zwei Stellen in eckigen Klammern. Oben kommt ein Satz hin, was dein Projekt tut und für wen. Darunter etwas, das du Claude schon mehr als einmal erklären musstest, oder „noch nichts“.
  3. Schick den Prompt ab.

01 Die CLAUDE.md-Vorlage

Für eine neue Datei und zum Ausmisten einer vorhandenen. Ersetz vorher die zwei Stellen in eckigen Klammern.

  1. 1 Projekt
  2. 2 Wiederholung
Leg mir für dieses Projekt eine kurze CLAUDE.md an. Sie ist dein Onboarding: nur das, was du in jeder Sitzung wissen musst, um direkt sinnvoll loszulegen.

Worum es geht: [WAS DEIN PROJEKT TUT UND FÜR WEN, IN EINEM SATZ]
Das musste ich schon mehr als einmal erklären: [DEIN BEISPIEL ODER „NOCH NICHTS“]

Bevor du schreibst:
1. Sieh dir das Projekt an. Gibt es schon eine CLAUDE.md oder .claude/CLAUDE.md, lies sie vollständig. Ändere noch nichts.
2. Stell mir höchstens fünf Rückfragen zu dem, was du nicht aus den Dateien lesen kannst: Befehle, die du nicht erraten kannst, Regeln, die vom Üblichen abweichen, Stolperfallen und Bereiche, die du nicht anfassen sollst. Warte auf meine Antworten.

Dann zeig mir einen Entwurf mit diesen Abschnitten. Abschnitte ohne Inhalt lässt du weg.
- Worum es geht, höchstens zwei Sätze
- Befehle
- So arbeitest du hier
- Nicht anfassen
- Stolperfallen

Regeln für jede Zeile:
- Frag dich bei jeder Zeile: Brauchst du das in jeder Sitzung oder nur bei einer bestimmten Aufgabe? Nur was du in jeder Sitzung brauchst, kommt hinein.
- Regeln, die nur beim Arbeiten in einem bestimmten Ordner gelten, kommen nicht hinein.
- Lass weg, was du selbst aus den Dateien lesen kannst, zum Beispiel Ordnerbaum, Abhängigkeiten oder eine Beschreibung jeder Datei.
- Schreib jede Regel so konkret, dass ich nachprüfen kann, ob du sie befolgst.
- Übernimm nur, was in den Dateien oder in meinen Antworten steht.
- Bleib deutlich unter 200 Zeilen.

Unter den Entwurf schreibst du die Zeilenzahl und eine Liste der Zeilen, die aus einer vorhandenen Datei wegfallen, je mit Grund und dem besseren Ort: ein Skill, eine Regel unter .claude/rules/ oder nirgends.

Schreib die Datei erst, wenn ich den Entwurf freigebe. Gibt es schon eine CLAUDE.md, sicherst du sie vorher als CLAUDE.md.bak im selben Ordner.

2

Beantworte die Rückfragen

Claude stellt dir höchstens fünf Fragen. Sie drehen sich um das, was in keiner Datei steht: Befehle mit Haken, Regeln, die bei dir anders sind als üblich, und Bereiche, die tabu sind.

  • Kurz antworten: ein Satz je Frage reicht.
  • Ehrlich bleiben: Weißt du etwas nicht, sag das. Der Prompt erlaubt Claude nur, was in den Dateien oder in deinen Antworten steht.
  • Nur Dauerhaftes: Was nur für die Aufgabe dieser Woche gilt, gehört nicht in die Antwort.
Aus meinem Test, gekürztBeispiel
Claude fragt:Die aktuelle CLAUDE.mdverlangt „Neue Routen insrc/api/index.js eintragen",aber diese Datei existiertim Projekt gar nicht […]Ist die Regel veraltet […]?Meine Antwort:Die Regel ist veraltet, eineindex.js gibt es nicht mehr.

3

Prüf den Entwurf Zeile für Zeile

Hier entscheidet sich, ob die Datei kurz bleibt. Geh jede Zeile durch und stell dir die Frage aus dem Reel: Braucht Claude das wirklich immer oder nur in einem bestimmten Fall? Anthropic empfiehlt dieselbe Probe: Würde Claude ohne diese Zeile Fehler machen? Wenn nicht, fliegt sie raus.

  • Nur fürs Ganze: keine Abläufe in mehreren Schritten, keine Regeln für nur einen Ordner, keine Aufgaben dieser Woche.
  • Nichts aus dem Code: kein Ordnerbaum, keine Liste der Abhängigkeiten. Das liest Claude selbst.
  • Kurz: Anthropic nennt unter 200 Zeilen als Ziel, weniger ist besser. Zähl die Zahl, die Claude nennt, im Zweifel selbst nach. In meinem Test stimmte sie unter dem Entwurf, beim Nachtrag später lag sie zweimal um eins zu hoch.
  • Nachprüfbar: „Einrückung mit zwei Leerzeichen“ statt „sauber formatieren“.
  • Nichts Erfundenes: Jede Angabe stammt aus deinem Projekt oder aus deinen Antworten.
Aus meinem Test, gekürzt: gestrichen und behaltenBeispiel
## Ordnerstruktur- Schreib sauberen Code## Release## Aktuell## Befehle[…]- Immer pnpm, nie npm## So arbeitest du hier[…]- Beträge immer in Cent […]## Nicht anfassen- kasse.sqlite nie committen[…]

Findest du Zeilen, die nur manchmal gelten, nenn sie Claude beim Namen. Die Prüffrage hilft dir beim Aussortieren, die Auswahl triffst du. In meinem Test hat Claude die Frage auf die Bitte hin selbst angewendet und dabei die falschen Zeilen gestrichen. Passt der Entwurf, gibst du ihn frei. Was die besseren Orte bedeuten, steht unten.

Wenn Zeilen nur manchmal gelten
Nimm diese Zeilen aus dem Entwurf: [WELCHE ZEILEN]. Sie gelten nur bei bestimmten Aufgaben. Zeig mir den neuen Entwurf mit Zeilenzahl und sag mir, wo die gestrichenen Zeilen besser hinpassen.
Wenn er passt
Der Entwurf ist freigegeben. Schreib die Datei so, wie du sie mir gezeigt hast.

4

Prüf, ob Claude sie lädt

Claude liest die CLAUDE.md zu Beginn einer Sitzung. Deshalb startest du einmal neu und siehst nach, ob sie wirklich ankommt.

  1. Beende Claude Code mit /exit und starte es im selben Ordner wieder mit claude.
  2. Gib /context ein.
  3. Such in der Übersicht den Eintrag Memory files, also die Liste der geladenen Merkdateien.

Hattest du schon eine CLAUDE.md, sollte daneben jetzt CLAUDE.md.bak liegen. Bist du mit der neuen Fassung zufrieden, kannst du die Sicherungen löschen.

  • Das zeigt es: Steht deine CLAUDE.md unter Memory files, hat Claude sie geladen. Fehlt sie dort, sieht Claude sie nicht.
  • Das zeigt es nicht: dass Claude jede Zeile befolgt. Die Datei ist ein Hinweis, keine Sperre. Was nie passieren darf, sperrst du mit einer Regel in den Einstellungen oder mit einem Hook. Die Regel in den Einstellungen zeigt Guide 013, den Hook die Tabelle unten.

5

Ergänze sie gezielt

Ich würde die Datei nicht nach jedem Ausrutscher erweitern. Anthropic nennt als Anlass, dass Claude denselben Fehler zum zweiten Mal macht. Auch dann kommt die Zeile nur hinein, wenn Claude sie in jeder Sitzung braucht.

  1. Passiert ein Fehler zum zweiten Mal, kopier den Nachtrag.
  2. Ersetz die Stelle in eckigen Klammern: was falsch war und wie es richtig ist.
  3. Schick ihn in der laufenden Sitzung ab.
  • Kontrolle: Claude nennt dir die neue Zeile und die Zeilenzahl, oder einen besseren Ort und schreibt nichts. Die Zahl ist ein Richtwert, im Test lag sie zweimal um eins zu hoch.
02 · Der Nachtrag
Du hast hier zum zweiten Mal denselben Fehler gemacht: [WAS FALSCH WAR UND WIE ES RICHTIG IST]
Prüf zuerst, ob du das in jeder Sitzung wissen musst oder nur bei bestimmten Aufgaben. Nur im ersten Fall ergänzt du die CLAUDE.md um eine kurze Zeile, die ich nachprüfen kann. Sonst schreibst du nichts und sagst mir, wo es besser hinpasst. Nenn mir zum Schluss die neue Zeilenzahl.

Fertig

Dein Spickzettel steht

Claude startet ab jetzt jede Sitzung mit dem, was es bei dir wirklich braucht. Alles andere bleibt draußen, damit die wichtigen Zeilen nicht untergehen.

Den nächsten Guide gibt’s mit dem nächsten Reel: @buildwith.enzo auf Instagram

  • Du hast jede Zeile mit der Frage „immer oder nur manchmal?“ geprüft.

  • Die Datei liegt deutlich unter 200 Zeilen.

  • Sie steht unter Memory files in /context.

Wenn du mehr wissen willst

Was dahinter steckt: warum kurz, und wohin mit dem Rest

Warum die Datei kurz bleiben soll

Claude lädt die CLAUDE.md in jede Sitzung, und jede Zeile kostet Platz im Kontext, also in dem, was Claude gleichzeitig im Blick hat. Anthropic schreibt, dass längere Dateien mehr Platz verbrauchen und schlechter befolgt werden. Die 200 Zeilen sind ein Zielwert, keine Grenze: Claude Code lädt eine CLAUDE.md bis 4 MiB vollständig. Hält sich Claude trotz Regel nicht an etwas, ist die Datei laut Anthropic wahrscheinlich zu lang.

Wo die Datei liegt

Für ein Projekt liegt sie als CLAUDE.md im Projektordner, alternativ als .claude/CLAUDE.md. Was für alle deine Projekte gilt, gehört nach ~/.claude/CLAUDE.md. Persönliches nur für dieses Projekt kommt in CLAUDE.local.md. Trag diese Datei in deine .gitignore ein, dann landet sie nicht bei anderen. Claude liest alle diese Dateien zusammen, keine ersetzt die andere.

Wohin mit dem, was rausfliegt

OrtWann Claude es siehtGut für
CLAUDE.mdin jeder SitzungBefehle, Konventionen, „immer so“-Regeln
Regel unter .claude/rules/mit paths im Kopf nur bei passenden DateienRegeln für einen Teil des Projekts
Skillnur wenn er gebraucht oder aufgerufen wirdAbläufe in mehreren Schritten
Hookläuft fest an einem Zeitpunkt, egal was Claude entscheidet„vor jedem Commit“, „nach jeder Änderung“

Eine Datei per @pfad einzubinden, macht die CLAUDE.md übersichtlicher, spart aber keinen Platz. Eingebundene Dateien lädt Claude ebenfalls beim Start.

Es klemmtHilfe

Meine CLAUDE.md fehlt unter Memory files

Prüf, ob du Claude Code im Projektordner gestartet hast und ob die Datei genau CLAUDE.md heißt. Mit /memory siehst du, an welchen Orten Claude nach Merkdateien sucht.

Zurück zu Schritt 4

Claude hält sich nicht an eine Regel

Schreib sie konkreter und such nach einer zweiten Regel, die ihr widerspricht. Dann wählt Claude laut Anthropic womöglich willkürlich. Überspringt Claude immer dieselbe Zeile, darfst du genau diese eine mit „IMPORTANT“ betonen. Betonst du viele, sticht keine heraus.

Claude fragt nach etwas, das in der Datei steht

Dann ist die Zeile vermutlich missverständlich formuliert. Schreib sie so um, dass sie nur eine Lesart zulässt.

Der Entwurf bleibt zu lang

Geh die Zeilen mit der Frage aus Schritt 3 durch und nenn Claude die, die nur manchmal gelten. Liegt die Datei schon in Git, schlägt dir auch /doctor Kürzungen vor, ab Claude Code 2.1.206. Es fragt, bevor es etwas ändert.

Zurück zu Schritt 3

Claude hat ohne Freigabe geschrieben

Die alte Fassung liegt in CLAUDE.md.bak, sofern Claude sie angelegt hat. Wie du Änderungen sonst zurückholst, steht in Guide 013, Schritt 3.

Quellen und StandBelege

Die Fakten stammen aus der Dokumentation und dem Änderungsprotokoll von Claude Code. Die Vorlage, der Nachtrag, die fünf Abschnitte und die Frage „immer oder nur manchmal?“ sind von mir.

A · Offizielle Quellen

Anthropic · Claude Code, „How Claude remembers your project“

  • „You write these files in plain text; Claude reads them at the start of every session.“
  • „Claude makes the same mistake a second time“
  • „target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence.“
  • „Claude Code loads a CLAUDE.md file of up to 4 MiB in full and skips a larger file.“
  • „To confirm the file loaded, run /context in a session and check the list under Memory files.“
  • „Claude treats them as context, not enforced configuration.“

Was die Datei ist und wann sie lädt, Anlässe für einen Eintrag, Größe, Speicherorte, Zusammenspiel mehrerer Dateien, Regeln unter .claude/rules/ mit paths, Importe ohne Platzersparnis, Widersprüche, /memory, /context, Hooks für feste Zeitpunkte, Sperren über permissions.deny in den Einstellungen, CLAUDE.local.md in die .gitignore, Kürzungsvorschläge von /doctor ab 2.1.206. Abgerufen am 17.09.2026.

code.claude.com/docs/en/memory

Anthropic · Claude Code, „Best practices“

  • „For each line, ask: Would removing this cause Claude to make mistakes? If not, cut it.“
  • „If Claude keeps doing something you don't want despite having a rule against it, the file is probably too long and the rule is getting lost.“
  • „If Claude keeps skipping one instruction, add emphasis such as "IMPORTANT" to that line alone.“

Die Probe je Zeile, was hineingehört und was nicht (Code, den Claude selbst lesen kann, Beschreibungen jeder Datei), missverständliche Zeilen, Betonung einer einzelnen Zeile. Abgerufen am 17.09.2026.

code.claude.com/docs/en/best-practices

Anthropic · Claude Code, Extend Claude Code, Commands, Setup, Changelog

  • „Put guardrails in hooks. An instruction like "never edit .env" in CLAUDE.md or a skill is a request, not a guarantee.“
  • „Claude Code requires a Pro, Max, Team, Enterprise, or Console account. The free claude.ai plan does not include Claude Code access.“
  • „Added a /doctor check that proposes trimming checked-in CLAUDE.md files by cutting content Claude could derive from the codebase“

Wann CLAUDE.md, Regel, Skill oder Hook passt, /init, /exit, /context, /memory und /doctor, nötiges Konto. Der Eintrag zu /doctor stammt aus Version 2.1.206, aktuell ist am 17.09.2026 Version 2.1.274. Abgerufen am 17.09.2026.

Extend Claude Code · Commands · Setup · Changelog

B · Was hier bewusst nicht steht

Angaben ohne Beleg

„Mehr als 200 Zeilen liest Claude nicht“: falsch, das gilt nur für die MEMORY.md des automatischen Gedächtnisses, eine CLAUDE.md lädt bis 4 MiB vollständig. Um wie viel besser eine kurze Datei befolgt wird: Dazu nennt Anthropic keine Zahl. Eine richtige Zeilenzahl oder ein Pflichtformat: Laut Anthropic gibt es kein vorgeschriebenes Format, meine fünf Abschnitte sind ein Vorschlag. „Was in der CLAUDE.md steht, hält Claude immer ein“: widerlegt Anthropic selbst.

C · Stand und eigener Test

Getestet am 17.09.2026 in einem Übungsprojekt

Ein ausgedachtes Projekt mit einer absichtlich überfüllten CLAUDE.md von 52 Zeilen, Claude Sonnet als Unteragent in Claude Code, zwei Läufe. Claude hat wie verlangt zuerst gefragt, einen Entwurf mit den fünf Abschnitten gezeigt, erst nach der Freigabe geschrieben und die alte Datei als CLAUDE.md.bak gesichert. Die neue Datei hatte 26 Zeilen. Ordnerbaum, Abhängigkeiten, Floskeln und Aufgaben der Woche flogen raus. Regeln für nur einen Ordner blieben in beiden Läufen drin, in einem Lauf auch ein Ablauf in fünf Schritten. Die Bitte, jede Zeile zu streichen, ohne die Claude keinen Fehler machen würde, strich die falschen Zeilen. Der Satz mit den genannten Zeilen strich die richtigen. Der Nachtrag hat eine dauerhafte Regel ergänzt und eine aufgabenbezogene abgelehnt, die Zeilenzahl dabei zweimal um eins zu hoch genannt. Nicht getestet: das Laden in einer echten Sitzung mit /context, /doctor, andere Modelle und echte Projekte.

Wenn du noch Lust hast

Meine anderen Reels