Die CLAUDE.md-Datei
Eine der nützlichsten Funktionen in Claude Code ist die CLAUDE.md-Datei. Sie gibt Claude Code ein dauerhaftes Gedächtnis für dein Projekt.
Das Problem, das sie löst
Wenn du Claude Code ohne eine CLAUDE.md-Datei öffnest, startet es jedes Mal von vorne. Es muss deine Codebasis erneut erkunden, herausfinden, welche Abhängigkeiten benötigt werden, und verstehen, welche Funktionen bereits implementiert sind. Manchmal trifft es Annahmen, was es schwieriger macht, Claude in die richtige Richtung zu lenken.
CLAUDE.md löst dieses Problem. Es ist eine Markdown-Datei, die du im Stammverzeichnis deines Projekts ablegst, und Claude Code liest sie automatisch jedes Mal, wenn du eine Sitzung startest. Stell es dir wie ein Onboarding-Skript für deine Codebasis vor. Der Inhalt der CLAUDE.md-Datei wird an deinen Prompt angehängt.
Ein Beispiel
So sieht eine typische CLAUDE.md-Datei aus:
# Project
This is a Next.js 15 app using the App Router, Tailwind, and Drizzle ORM.
# Commands
- Dev server: `pnpm dev`
- Run tests: `pnpm test`
- Lint: `pnpm lint`
# Code Style
- Use 2-space indentation
- Prefer named exports
- All API routes go in app/api/
- Use server actions instead of API routes where possibleEs ist unkompliziert. Wenn du Claude Code jetzt bittest, eine React-Komponente zu erstellen, weiß es bereits, dass es Tailwind für das Styling verwenden und deinen Code-Konventionen folgen soll.

CLAUDE.md ist für Teams
Du kannst (und solltest) deine CLAUDE.md in die Versionskontrolle einchecken, damit dein Team davon profitiert. Es gibt tatsächlich eine Hierarchie von Gedächtnis-Dateien, je nachdem, für wen sie gedacht sind:
-
Projekt-Level-CLAUDE.md liegt im Stammverzeichnis deines Projekts. Mit dem Team geteilt.
-
Benutzer-Level-CLAUDE.md liegt in deinem Konfigurationsordner. Diese ist nur für dich und gilt für alle deine Projekte. Lege hier deine persönlichen Präferenzen ab.
Tipps
Korrekturen im Gedächtnis speichern. Wenn du feststellst, dass du Claude wiederholt korrigierst — zum Beispiel, indem du ihm sagst, immer Server-Actions statt API-Routen zu verwenden — bitte Claude explizit, diese Regel im Gedächtnis zu speichern. Beim nächsten Öffnen des Projekts wird es das wissen.

Projektdokumentation referenzieren. Wenn du Dokumentation in deinem Projekt hast, auf die Claude verweisen soll, verwende das @-Symbol mit dem Dateipfad:
## README.md
Please read if you need more info: @README.mdOhne eine starten. Wir empfehlen, ein Projekt ohne CLAUDE.md-Datei zu starten, damit du siehst, wo du das Modell ständig korrigieren musst. Das hält deine CLAUDE.md kompakt und auf die notwendigen Informationen fokussiert. Wenn du bereit bist, führe /init aus, damit Claude eine für dich generiert.
Probier es jetzt aus
Wähle ein Projekt ohne CLAUDE.md und führe /init aus. Lies, was Claude geschrieben hat, und streiche jede Zeile, die du dir nicht die Mühe machen würdest, einem neuen Teammitglied zu erklären. Füge eine Korrektur hinzu, die du immer wieder machst, starte dann eine neue Sitzung und bitte um etwas, das diese Korrektur betrifft. Hat Claude sie befolgt?
Zusammenfassung
Der Unterschied zwischen einer frustrierenden und einer produktiven Claude-Code-Sitzung liegt oft am Kontext — und die CLAUDE.md-Datei ist die Art, wie du diesen Kontext bereitstellst. Beginne mit deinem Stack, deinen Präferenzen und deinen Befehlen, und baue dann von dort aus weiter, während du vorankommst.