Bisher hast du Anweisungen und Kontext immer direkt im Gespräch mitgegeben. Das ist gut für einmalige Anliegen - für Regeln, die für ein ganzes Projekt dauerhaft gelten sollen, gibt es aber einen viel besseren Weg: die Datei CLAUDE.md.

Was ist CLAUDE.md?

CLAUDE.md ist eine ganz normale Textdatei im Markdown-Format, die im Hauptverzeichnis eines Projekts liegt. Startest du Claude Code in diesem Projekt, wird der Inhalt dieser Datei automatisch eingelesen und steht ab dann für die gesamte Sitzung als Hintergrundwissen zur Verfügung - du musst diese Informationen also nicht in jedem neuen Gespräch erneut wiederholen.

Damit ist CLAUDE.md das projektweite Gegenstück zu den projektbezogenen Hintergrundinformationen, die du in Kapitel 2 bei den Claude.ai-Projekten kennengelernt hast - nur eben direkt im Projekt selbst gespeichert, versioniert zusammen mit dem restlichen Code.

Was typischerweise in eine CLAUDE.md gehört

• Der verwendete Tech-Stack (Programmiersprache, Framework, Datenbank, Frontend-Technologie).
• Coding-Standards und bevorzugte Muster (z. B. "Nutze immer TypeScript-Interfaces statt any").
• Wie man Tests ausführt, Code baut, oder das Projekt lokal startet.
• Projektspezifische Konventionen (Namensschemata, Ordnerstruktur, Commit-Nachrichten-Format).
• Dinge, die bewusst vermieden werden sollen ("Keine neue Abhängigkeit ohne Rücksprache hinzufügen").

ein-einfaches-beispiel

# Projektregeln

## Tech-Stack
- Node.js mit Express
- Reine JSON-Datei als Speicher, keine Datenbank
- Tests mit dem eingebauten Node-Testrunner (`node --test`)

## Konventionen
- Immer aussagekräftige Variablennamen auf Englisch
- Neue Funktionen bekommen einen kurzen Kommentar, der beschreibt, was sie tun
- Nach jeder Änderung: `npm test` ausführen, bevor die Änderung als fertig gilt

Startest du Claude Code in einem Projekt mit dieser CLAUDE.md, weiß es ab der ersten Nachricht, dass es zum Beispiel keine Datenbank vorschlagen soll, sondern bei der reinen JSON-Datei bleibt - ohne dass du das jedes Mal wiederholen musst.

CLAUDE.md von Claude Code selbst erstellen lassen

Du musst eine CLAUDE.md nicht komplett von Hand schreiben: In einem bestehenden Projekt kann Claude Code das Projekt analysieren und einen ersten Entwurf einer passenden CLAUDE.md vorschlagen, den du danach nach Bedarf anpasst und ergänzt.

Warum sich das lohnt

Ohne CLAUDE.md musst du wiederkehrende Vorgaben ("benutze immer diese Teststrategie", "halte dich an dieses Namensschema") in jedem neuen Gespräch erneut erwähnen - das ist mühsam und wird leicht vergessen. Mit CLAUDE.md gelten diese Vorgaben automatisch, gespeichert an einem Ort, den auch andere Personen im Team einsehen und mitpflegen können. Genau darum geht es ausführlicher in Kapitel 25, wenn es um Teamarbeit geht.

Ab dem nächsten Block wird CLAUDE.md praktisch relevant: Du baust dort ein eigenes Beispielprojekt auf, den Rezept-Planer, und richtest ihm direkt zu Beginn eine eigene CLAUDE.md ein.