Kurz und knapp: Was ist die CLAUDE.md?

Die CLAUDE.md ist eine Markdown-Konfigurationsdatei, die Claude Code und Claude Cowork zu Beginn jeder Arbeitssession automatisch einliest und als dauerhaften Projektkontext nutzt. Sie liegt im Wurzelverzeichnis eines Projekts oder Workspace-Ordners und enthält projektspezifische Informationen, die das KI-System sonst nicht kennen würde: bevorzugte Code-Stile, Architekturprinzipien, verbotene Patterns, wichtige Dateipfade, Tonalitätsvorgaben oder Hinweise auf kritische Abhängigkeiten. CLAUDE.md ist kein Prompt, der vor jede Anfrage kopiert wird – sie ist das Langzeitgedächtnis des Projekts für die KI.

Einordnung: Warum die CLAUDE.md heute relevant ist

KI-Agenten wie Claude Code oder Claude Cowork starten jede Session ohne Erinnerung an vergangene Sitzungen. Was beim letzten Mal besprochen wurde, welche Konventionen im Team gelten, welche Dateien nicht angefasst werden dürfen – all das ist dem System zu Beginn unbekannt, sofern es nicht explizit mitgegeben wird. Dieses Grundproblem – die Zustandslosigkeit von KI-Agenten – ist einer der häufigsten Gründe dafür, dass KI-generierte Outputs nicht zum Projektkontext passen. Die CLAUDE.md ist die Lösung: eine persistente Textdatei im Repository oder Workspace, die der KI bei jedem Start übergeben wird und den Kontext herstellt, der für konsistente Ergebnisse notwendig ist.

Was als Entwickler-Feature in Claude Code begann, ist mit Claude Cowork auf Wissensarbeiter ausgeweitet worden. Wer regelmäßig Dokumente, Präsentationen oder Content in einem festen Workspace-Ordner produziert, kann in einer CLAUDE.md festhalten, wie Outputs aussehen sollen, welchen Tonfall Texte haben, wer die Zielgruppe ist und welche Vorlagen als Basis dienen. Das Ergebnis: weniger Rückfragen, konsistentere Qualität, weniger Korrekturrunden. Die CLAUDE.md ist damit nicht nur ein technisches Hilfsmittel für Entwickler, sondern ein produktivitätskritisches Dokument für alle, die mit KI-Agenten wiederkehrende Aufgaben erledigen.

Was bedeutet die CLAUDE.md konkret?

Die CLAUDE.md ist im Kern eine Antwort auf eine einfache Frage: Was muss die KI über dieses Projekt wissen, das sie nicht selbst aus den Dateien ableiten kann? Ein gut strukturiertes Repository gibt Claude Code bereits viel Kontext – Dateinamen, Kommentare, Package-Manifeste, README. Aber implizites Wissen – Teamkonventionen, strategische Entscheidungen, Dinge die aus gutem Grund so gelöst wurden wie sie gelöst sind – ist in Dateien nicht sichtbar. Genau das gehört in die CLAUDE.md. Sie macht implizites Projektwissen explizit und damit für die KI nutzbar.

Die praktische Konsequenz ist erheblich: Ohne CLAUDE.md arbeitet Claude Code mit dem, was es sieht – und schreibt Code, der technisch korrekt, aber kontextfremd sein kann. Mit einer gepflegten CLAUDE.md passt der Output zum Projekt, zum Team und zu den bestehenden Entscheidungen. Für Wissensarbeiter in Claude Cowork gilt dasselbe: Wer die eigene Tonalität, Zielgruppe und Outputstruktur in einer CLAUDE.md festhält, bekommt Ergebnisse, die sofort verwendbar sind statt eines generischen Rohlings, der noch drei Überarbeitungsrunden braucht.

Das System hinter der CLAUDE.md

Die CLAUDE.md folgt keiner festen Schema-Vorgabe – ihr Inhalt ist frei strukturierbar. In der Praxis haben sich bestimmte Inhaltstypen als besonders wirksam erwiesen, weil sie genau das liefern, was die KI aus Dateien allein nicht ableiten kann.

Projektbeschreibung und Ziel

Eine kurze Beschreibung, was das Projekt ist, wofür es steht und welche übergeordneten Ziele es verfolgt. Für ein Software-Projekt: Produktvision, Zielnutzer, kritische Business-Logik. Für einen Content-Workspace: Markenpositionierung, Zielgruppe, Differenzierung. Diese Beschreibung gibt der KI den Rahmen, innerhalb dessen alle Entscheidungen getroffen werden sollen.

Konventionen und Standards

Codierungsstandards, Namenskonventionen, bevorzugte Bibliotheken, Formatierungsregeln – bei Entwicklungsprojekten. Für Content-Workspaces: Tonalitätsvorgaben, verbotene Formulierungen, Stilprinzipien, Satzlängenpräferenzen. Diese Informationen verhindern, dass die KI zwar korrekte, aber stilfremde Ergebnisse produziert.

Verbote und Einschränkungen

Was darf die KI nicht tun, nicht anfassen, nicht verwenden? In Codeprojekten: bestimmte Dateien nicht editieren, keine bestimmten Libraries einführen, keine globalen Konfigurationen verändern. In Content-Workspaces: keine bestimmten Begriffe verwenden, keine direkte Ansprache, keine Tabellen. Verbote sind oft wichtiger als positive Vorgaben, weil sie kostspielige Fehler verhindern.

Kritische Dateipfade und Ressourcen

Hinweise auf besonders wichtige oder besonders heikle Dateien: Konfigurationsdateien, die manuell gepflegt werden und nicht überschrieben werden dürfen; Vorlagen, die als Basis für Outputs genutzt werden sollen; Referenzdokumente, die als inhaltliche Grundlage dienen. Diese Hinweise ersparen der KI das Raten und dem Nutzer das Nachkorrigieren.

Hintergrundwissen und Entscheidungshistorie

Bestimmte Entscheidungen im Projekt wurden aus Gründen getroffen, die im Code oder in den Dateien nicht sichtbar sind – technische Schulden, bewusste Kompromisse, externe Constraints. Wenn die KI diese Gründe nicht kennt, wird sie die Entscheidungen korrigieren wollen. Die CLAUDE.md ist der richtige Ort, um solches Hintergrundwissen festzuhalten: „Diese Datei sieht ungewöhnlich aus, weil X – bitte nicht ändern.“

Die CLAUDE.md ist nicht dasselbe wie …

Das Konzept der CLAUDE.md wird in der Praxis mit mehreren anderen Mechanismen verwechselt. Diese Abgrenzungen sind relevant für alle, die KI-Agenten in ihrem Arbeitsalltag produktiv einsetzen wollen.

Die CLAUDE.md ist nicht dasselbe wie ein System-Prompt

Ein System-Prompt wird vom Plattformbetreiber vor jede Interaktion gesetzt und ist für den Nutzer nicht direkt editierbar. Die CLAUDE.md wird vom Nutzer selbst geschrieben, liegt im eigenen Dateisystem und ist vollständig unter eigener Kontrolle. Sie ist projektspezifisch, nicht global – und wirkt nur für den Workspace oder das Repository, in dem sie liegt.

Die CLAUDE.md ist nicht dasselbe wie eine README

Eine README richtet sich an menschliche Mitarbeitende und erklärt, wie ein Projekt funktioniert und wie man es nutzt. Die CLAUDE.md richtet sich an die KI und enthält Informationen, die für die KI-Arbeit relevant sind – nicht für den menschlichen Onboarding-Prozess. Beide Dateien können inhaltliche Überschneidungen haben, aber ihre Zielgruppe und damit ihr Fokus unterscheiden sich grundlegend.

Die CLAUDE.md ist nicht dasselbe wie ein Prompt-Template

Ein Prompt-Template ist eine Vorlage für eine einzelne Aufgabe, die vor jeder Nutzung manuell ausgefüllt wird. Die CLAUDE.md liegt dauerhaft im Projekt, wird automatisch eingelesen und gilt für alle Aufgaben innerhalb des Workspaces – ohne dass der Nutzer bei jeder Anfrage daran denken muss. Sie ist Hintergrundwissen, kein Vordergrund-Prompt.

Die CLAUDE.md ist nicht dasselbe wie eine Dokumentationsdatei

Dokumentation beschreibt den Ist-Zustand eines Systems. Die CLAUDE.md enthält Handlungsanweisungen und Einschränkungen für die KI – sie ist prescriptiv, nicht deskriptiv. Was in der CLAUDE.md steht, gilt als Vorgabe für das Verhalten der KI, nicht als Beschreibung des Systems für menschliche Leser.

Wie funktioniert die CLAUDE.md in der Praxis?

Die CLAUDE.md ist eine einfache Textdatei im Markdown-Format, die im Wurzelverzeichnis des Projekts oder Workspace-Ordners liegt. Claude Code und Claude Cowork lesen sie beim Start einer Session automatisch ein – kein zusätzlicher Schritt, kein manuelles Einfügen. Der Inhalt wird als Kontext für alle nachfolgenden Aufgaben in dieser Session genutzt. Änderungen an der CLAUDE.md wirken ab der nächsten Session. Eine einmalige Investition in eine gut strukturierte CLAUDE.md zahlt sich bei jedem weiteren KI-Einsatz im Projekt aus.

Markdown-Datei mit dem Namen CLAUDE.md im Projektwurzel oder Workspace-Ordner anlegen
Projektbeschreibung, Ziele und Zielgruppe in wenigen Absätzen festhalten
Konventionen, Stilregeln und Standards dokumentieren – was soll wie aussehen?
Verbote explizit benennen – was darf die KI nicht tun oder verändern?
Kritische Ressourcen und Referenzdateien verlinken oder benennen
Datei über Zeit aktualisieren – wenn Projektentscheidungen sich ändern, ändert sich auch die CLAUDE.md

Was diese Schritte in der Summe bewirken: Die KI arbeitet nicht mehr im Blindflug durch ein unbekanntes Projekt, sondern mit dem Kontext, der für konsistente und verwendbare Ergebnisse notwendig ist. Der Aufwand für eine initiale CLAUDE.md beträgt typischerweise 30 bis 60 Minuten; der kumulierte Zeitgewinn durch weniger Korrekturrunden übersteigt das schnell.

Beispiele für die CLAUDE.md

Ein Entwicklungsteam arbeitet an einem Python-Backend mit strikten Konventionen: alle Funktionen typisiert, keine externen Libraries ohne Ticket, bestimmte Legacy-Module nicht anfassen. Die CLAUDE.md hält diese Regeln fest, nennt die heiklen Dateipfade beim Namen und erklärt, warum das Legacy-Modul so gebaut ist wie es ist. Claude Code schreibt fortan konventionskonformen Code, ohne dass das Team bei jeder Anfrage dieselben Vorgaben wiederholen muss.

Ein SEO-Berater betreibt einen Content-Workspace in Claude Cowork, aus dem regelmäßig Blog-Artikel, LinkedIn-Posts und Glossar-Einträge entstehen. Seine CLAUDE.md beschreibt die Zielgruppe, den Tonfall, verbotene Formulierungen, die bevorzugte Satzstruktur und verweist auf eine Positionierungsdatei im selben Ordner. Jeder neue Content-Output passt zur Marke – ohne Briefing zu Beginn jeder Session.

Eine Marketingmanagerin nutzt Claude Cowork für die regelmäßige Erstellung von Kampagnen-Reports. Ihre CLAUDE.md enthält die Struktur des Standard-Reports, die KPIs, die immer enthalten sein müssen, das Farbschema der Präsentationen und den Hinweis, dass Rohdaten in einem bestimmten Unterordner liegen. Claude Cowork greift auf diese Vorgaben zurück und produziert Reports, die direkt in Meetings verwendbar sind.

Ein Solo-Entwickler arbeitet an mehreren Projekten parallel. Jedes Repository hat eine eigene CLAUDE.md mit projektspezifischen Vorgaben. Claude Code erkennt beim Start automatisch, in welchem Projekt es sich befindet, und wendet die jeweiligen Regeln an – ohne Verwechslungen zwischen Projekten, ohne manuelle Kontextübergabe bei jedem Start.

Häufige Fehler und Missverständnisse

Die CLAUDE.md zu lang und zu detailliert schreiben

Eine CLAUDE.md, die jede Kleinigkeit dokumentiert, wird unübersichtlich und schwer zu pflegen. Wichtiger als Vollständigkeit ist Fokus: Was sind die fünf bis zehn Dinge, die die KI am dringendsten wissen muss, um keine kostspieligen Fehler zu machen? Eine kompakte, präzise CLAUDE.md ist wirkungsvoller als ein umfassendes Kompendium, das niemand aktuell hält.

Die CLAUDE.md nie aktualisieren

Projekte entwickeln sich. Entscheidungen werden revidiert, Konventionen ändern sich, neue kritische Dateien entstehen. Eine CLAUDE.md, die den Stand von vor sechs Monaten abbildet, liefert veralteten Kontext – und kann die KI in die falsche Richtung lenken. Die CLAUDE.md sollte als lebendiges Dokument behandelt werden, das bei relevanten Projektänderungen mitgepflegt wird.

Erwarten, dass die CLAUDE.md alle Kontextprobleme löst

Die CLAUDE.md liefert dauerhaften Hintergrundkontext. Aufgabenspezifischen Kontext – den genauen Fehler, das spezifische Ziel, die relevante Datei – muss der Nutzer weiterhin in der konkreten Aufgabenbeschreibung mitgeben. CLAUDE.md und Aufgabenformulierung ergänzen sich; eine kann die andere nicht ersetzen.

Die CLAUDE.md mit sensitiven Daten befüllen

Da die CLAUDE.md im Repository oder Workspace liegt, ist sie potenziell für alle sichtbar, die Zugriff auf dieses Verzeichnis haben. API-Keys, Passwörter, vertrauliche Kundendaten, persönliche Identifikatoren gehören nicht in die CLAUDE.md – unabhängig davon, wie praktisch es erscheinen mag, sie dort zu hinterlegen.

Nur eine globale CLAUDE.md für alle Projekte nutzen

Claude Code unterstützt CLAUDE.md-Dateien auf verschiedenen Ebenen: im Home-Verzeichnis für globale Präferenzen, im Repository-Wurzelverzeichnis für projektspezifische Vorgaben, in Unterverzeichnissen für modulspezifische Regeln. Wer alles in eine globale Datei packt, verliert die Trennschärfe zwischen Projekten. Die Stärke des Systems liegt in der Granularität: globale Standards global, projektspezifische Regeln lokal.

Die CLAUDE.md auf LinkedIn

Auf LinkedIn ist die CLAUDE.md ein Randthema – sie taucht gelegentlich in Posts über Claude Code auf, wird aber selten als eigenständiges Konzept diskutiert. Das ist ein blinder Fleck: Wer über KI-Agenten im Entwicklungsalltag oder in der Wissensarbeit schreibt, spricht oft über Prompts und Outputs, aber selten über die Infrastruktur, die konsistente Outputs überhaupt erst ermöglicht. Die CLAUDE.md gehört zu dieser Infrastruktur. Teams und Einzelpersonen, die ihre KI-Workflows auf ein professionelles Niveau heben wollen, kommen an einer gepflegten CLAUDE.md nicht vorbei – aber in der öffentlichen Diskussion wird dieser Baustein noch regelmäßig übersehen.

Was sich auf LinkedIn beobachten lässt: Posts, die konkrete CLAUDE.md-Inhalte zeigen – also was tatsächlich drinsteht und welchen Unterschied es macht – werden besser aufgenommen als abstrakte Beschreibungen des Konzepts. Der Grund ist naheliegend: Das Konzept klingt simpel, der Unterschied wird erst greifbar, wenn man sieht, wie ein Output ohne und mit CLAUDE.md aussieht.

Wer sich für den strukturierten Einsatz von KI-Agenten in Wissensarbeits- und Entwicklungs-Workflows interessiert, findet auf dem Profil von Denis Treter regelmäßig Einordnungen dazu: https://www.linkedin.com/in/denistreter/

Fazit

Die CLAUDE.md ist eine der wirkungsvollsten Maßnahmen, um KI-Agenten wie Claude Code oder Claude Cowork konsistent und projektkonform arbeiten zu lassen. Sie löst das Grundproblem der Zustandslosigkeit von KI-Systemen: Wer das implizite Wissen eines Projekts einmal in einer CLAUDE.md dokumentiert, muss es nicht bei jeder Session neu erklären. Das Konzept ist technisch simpel – eine Markdown-Datei im richtigen Verzeichnis – aber strategisch anspruchsvoll, weil es erfordert, das eigene Projektwissen explizit zu machen. Genau darin liegt der Wert: Die CLAUDE.md zwingt dazu, Konventionen, Ziele und Einschränkungen klar zu formulieren – eine Klarheit, die nicht nur der KI nützt, sondern jedem menschlichen Teammitglied, das neu ins Projekt kommt.

Interessante Blog-Artikel

Was ist die CLAUDE.md?