CLAUDE.md
CLAUDE.md ist eine Markdown-Datei mit dauerhaften Projektanweisungen, die Claude Code beim Sitzungsstart lädt und danach mit jeder Anfrage sendet.
Es enthält das, was der Agent wissen sollte, ohne es zu erfahren: Build- und Testbefehle, Konventionen, Architekturentscheidungen und Dinge, die er in Ruhe lassen sollte. Claude Code liest es aus dem Projektstammverzeichnis (./CLAUDE.md oder ./.claude/CLAUDE.md), aus ~/.claude/CLAUDE.md für persönliche Standardeinstellungen und aus einer unternehmensweit verwalteten Datei und verkettet alles, was es findet, anstatt zuzulassen, dass eine Datei eine andere überschreibt. Dateien in Unterverzeichnissen werden später geladen, wenn Claude etwas in diesem Verzeichnis liest.
Die Kosten sind leicht zu unterschätzen. Die Datei tritt als Nachricht nach dem System-Prompt in die Sitzung ein, und da bei jeder Anfrage der gesamte Kontext erneut gesendet wird, wird jede Zeile in jeder Runde erneut bezahlt: günstig, solange der Prompt-Cache hält, zum vollen Preis oder höher, wenn der Cache neu aufgebaut werden muss. Ein Abschnitt, der einmal im Monat wichtig ist, wird bei jeder Anfrage jeder Sitzung in Rechnung gestellt.
In der Dokumentation von Anthropic wird empfohlen, jede CLAUDE.md unter 200 Zeilen zu belassen (Stand September 2026), wobei darauf hingewiesen wird, dass längere Dateien mehr Kontext verbrauchen und die Einhaltung verringern. Das Aufteilen der Datei mit @path-Importen hilft bei der Organisation, aber nicht bei der Größe, da importierte Dateien auch beim Start geladen werden. Was es verkleinert, ist das Verschieben von Workflow-spezifischen Anweisungen in Skills oder pfadbezogene Regeln, die nur geladen werden, wenn sie relevant sind, und das Einfügen von Betreuernotizen in HTML-Kommentare auf Blockebene, die Claude Code entfernt, bevor der Text das Modell erreicht.
Zwei Verhaltensweisen sind wissenswert. Die Projektstammdatei überlebt /compact, da Claude Code sie anschließend erneut von der Festplatte liest. Und eine während der Sitzung vorgenommene Änderung wird erst beim nächsten /clear, /compact oder Neustart wirksam, da die Datei beim Start der Sitzung einmal gelesen wird. /context listet die tatsächlich geladenen Speicherdateien auf.