Claude · Claude Code Schritt für Schritt · Kapitel 9 · 4 Min.

CLAUDE.md — die Hausregeln

Der Zettel an der Werkstattwand. Was drin stehen muss, was nicht — und warum kurz besser ist als vollständig.

Jede neue Sitzung fängt bei null an. Claude weiß nicht, was ihr gestern besprochen habt, kennt deine Vorlieben nicht und muss sich jedes Mal neu orientieren.

Dagegen gibt es einen Zettel: eine Datei namens CLAUDE.md. Was darin steht, liest Claude bei jedem Start automatisch.

Wo die Datei hingehört

Die Dateien addieren sich. Persönliche Vorlieben oben, Projektregeln darunter, Sonderfälle ganz unten.

Sie schreiben lassen

Wenn dein Projekt schon existiert, musst du nicht selbst anfangen:

/init

Claude sieht sich um und schreibt einen ersten Entwurf: was das Projekt ist, wie es aufgebaut ist, womit gearbeitet wird. Den liest du durch, streichst die Hälfte und ergänzt, was er nicht sehen konnte.

Was reingehört

Alles, was er immer braucht und aus den Dateien allein nicht erkennen kann:

• Was das hier ist. Zwei Sätze. „Diese Seite ist die Firmenwebsite von X. Sie läuft auf einem einfachen Webspace ohne Datenbank.“
• Wo die Wahrheit steht. Wenn es zwei Ordner gibt und einer der maßgebliche ist, gehört das hier hin. Sonst ändert er den falschen.
• Womit gearbeitet wird. Sprachen, Werkzeuge, Versionen.
• Die Fallen. Das ist der wertvollste Teil. Alles, wo schon einmal etwas schiefgegangen ist.
• Wie du angesprochen werden willst. Sprache, Ton, Länge der Antworten.

Ein echtes Beispiel

Aus dem Projekt, in dem diese Seite entsteht — sinngemäß:

Wo gearbeitet wird
strato-paket\ ist die einzige Quelle der Wahrheit. Alle Änderungen ausschließlich dort. Der alte Ordner daneben ist stillgelegt und wird nicht zurückgespiegelt.

Zwei Fallen
1. Vor jeder Änderung an einer Seite den Live-Stand ziehen und vergleichen — die Seite wurde mehrfach aus parallelen Sitzungen verändert.
2. Die HTML-Dateien sind CRLF. Nicht durch ein Skript jagen, das auf LF umschreibt.

Zwei Absätze. Beide entstanden, nachdem genau das einmal schiefgegangen ist. Genau so soll diese Datei wachsen: nicht vorausgedacht, sondern nachgetragen.

Was nicht reingehört

Und jetzt kommt der Teil, den fast alle falsch machen.

Achtung

Die CLAUDE.md wird vollständig und bei jeder einzelnen Nachricht mitgeschickt. Jede Zeile darin kostet Kontext — dauerhaft. Eine Datei mit 300 Zeilen frisst deinen Platz auf, bevor du das erste Wort getippt hast.

Deshalb gilt: hier steht nur, was immer gilt. Alles andere gehört woanders hin:

Die Faustregel

Eine Bildschirmseite. Wenn du scrollen musst, ist zu viel drin.

Meine Projektdatei hat etwa dreißig Zeilen und deckt alles ab, was wirklich immer gilt. Alles Weitere steht in Skills und wird geholt, wenn es dran ist.

Der Test

Ob deine Datei etwas taugt, merkst du an einer einfachen Frage: Startet Claude in deinem Projekt und macht sofort das Richtige, ohne dass du drei Sätze Vorrede tippst?

Wenn ja, ist sie gut. Wenn du jedes Mal erst erklären musst, wo was liegt — dann fehlt genau das in der Datei.

In einem Satz

Eine Bildschirmseite. Wenn du scrollen musst, ist zu viel drin — die Datei wird bei jeder einzelnen Nachricht mitgeschickt und kostet dauerhaft Kontext.