Die CLAUDE.md-Datei

Das Problem, das sie löst

Wenn du Claude Code ohne eine CLAUDE.md-Datei öffnest, startet es jedes Mal von Neuem. 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 hinzufügst, und Claude Code liest sie automatisch jedes Mal, wenn du eine Sitzung startest. Stell dir das 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 possible

Es 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ächtnisdateien, abhängig davon, für wen sie bestimmt sind:

• Projektweite CLAUDE.md liegt im Stammverzeichnis deines Projekts. Wird mit dem Team geteilt.

• Benutzerweite 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

Speichere Korrekturen im Gedächtnis. Wenn du dich dabei erwischst, Claude wiederholt zu korrigieren — etwa indem du ihm sagst, immer Server Actions statt API-Routen zu verwenden — bitte Claude explizit, diese Regel im Gedächtnis zu speichern. Wenn du das Projekt das nächste Mal öffnest, wird es das wissen.



Verweise auf Projektdokumentation. 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.md

Starte ohne eine. Wir empfehlen, ein Projekt ohne CLAUDE.md-Datei zu starten, damit du sehen kannst, wo du das Modell ständig nachjustieren 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.

Zusammenfassung

Der Unterschied zwischen einer frustrierenden Claude Code-Sitzung und einer produktiven liegt oft am Kontext — und die CLAUDE.md-Datei ist die Art und Weise, wie du diesen Kontext bereitstellst. Beginne mit deinem Stack, deinen Präferenzen und deinen Befehlen, und baue von dort aus weiter aus, während du fortschreitest.