CLAUDE.md Anleitung

Die richtige CLAUDE.md schreiben

CLAUDE.md ist die Datei, die bestimmt, wie Claude dein Projekt versteht. Eine gut geschriebene Datei bedeutet weniger Korrekturen, besseren Code und Agenten, die tatsächlich wissen, woran sie arbeiten.

Diese Anleitung führt dich durch jeden Abschnitt einer CLAUDE.md-Datei, von der Tech-Stack-Deklaration bis zu agentenspezifischen Hinweisen. Folge Schritt für Schritt und erstelle deine eigene.

Was ist CLAUDE.md?

CLAUDE.md ist eine Markdown-Datei im Stammverzeichnis deines Projekts. Wenn Claude Code eine Sitzung startet, liest es diese Datei zuerst. Alles darin wird Teil von Claudes Kontext: dein Tech-Stack, deine Dateistruktur, die Konventionen deines Teams und alle spezifischen Anweisungen, die jeder Agent befolgen soll.

Stell es dir als Briefing-Dokument vor. Ohne diese Datei muss Claude raten, wie dein Projekt aufgebaut ist. Mit einer guten CLAUDE.md weiß Claude bereits, wo Dinge liegen, welchen Mustern es folgen soll und was es vermeiden muss. Der Unterschied in der Ausgabequalität ist erheblich.

“10 Minuten Arbeit an der CLAUDE.md sparen Stunden an Korrekturen von KI-generiertem Code, der nicht zu den Mustern Ihres Projekts passt.”

Beobachtet bei Hunderten von Claude Code Projekten

Schlechte vs. gute CLAUDE.md

Die Struktur und Genauigkeit deiner CLAUDE.md beeinflusst direkt, wie gut Claude in deiner Codebasis arbeitet.

Schwache CLAUDE.md

✗Vage Anweisungen wie "nutze Best Practices" ohne konkrete Details
✗Keine Dateistruktur, sodass Claude raten muss, wohin neuer Code gehört
✗Fehlende Coding-Konventionen; der Ausgabestil variiert zwischen Sitzungen
✗Keine Build- oder Test-Befehle angegeben, was zu fehlerhaften Vorschlägen führt

Starke CLAUDE.md

✓Expliziter Tech-Stack mit Versionen: React 19, Vite 6, Zustand 5, Tailwind 4
✓Klare Dateistruktur mit den wichtigsten Verzeichnissen und deren Zweck
✓Dokumentierte Namenskonventionen, Fehlerbehandlung und Stil-Präferenzen
✓Build-, Test- und Dev-Befehle, die direkt kopiert und ausgeführt werden können

6 wichtige Abschnitte

Eine gut strukturierte CLAUDE.md deckt diese sechs Bereiche ab. Jeder gibt Claude konkrete Informationen, mit denen es sofort arbeiten kann.

Tech-Stack-Deklaration

Liste deine Frameworks, Bibliotheken und deren Versionen explizit auf. Gib deinen Package Manager, die Node-Version und alle Laufzeitanforderungen an. Claude nutzt dies, um kompatiblen Code zu generieren, ohne raten zu müssen.

Dateistruktur

Beschreibe deine wichtigsten Verzeichnisse und was sich darin befindet. Komponenten, Stores, Services, API-Routen, Typen. Ein kurzes Baumdiagramm mit einzeiligen Beschreibungen pro Ordner funktioniert gut.

Coding-Konventionen

Dokumentiere deine Namenskonventionen (camelCase für Dateien, PascalCase für Komponenten), deinen Ansatz zur Fehlerbehandlung, die Import-Reihenfolge und alle projektspezifischen Regeln. So bleibt Claudes Ausgabe konsistent mit deinem bestehenden Code.

Build- und Test-Befehle

Füge deine Dev-, Build-, Test- und Lint-Befehle ein. Wenn Claude etwas überprüfen oder ein Skript vorschlagen muss, verwendet es genau die Befehle, die dein Projekt erwartet.

Agentenrollen-Hinweise

Wenn du mehrere Agenten verwendest (QA, Frontend, Backend, DevOps), füge einen Abschnitt hinzu, der beschreibt, worauf sich jede Rolle konzentrieren soll. Das ist besonders nützlich mit dem Multi-Agenten-Setup von AgentsRoom.

Zu vermeidende Bereiche

Sage Claude, was es NICHT tun soll. Keine Konfigurationsdateien ändern, nicht das Auth-System anfassen, keine Refaktorierung der Datenbankschicht. Explizite Grenzen verhindern, dass Agenten ungewollte Änderungen vornehmen.

CLAUDE.md in 4 Schritten erstellen

Du musst nicht alles auf einmal schreiben. Beginne mit den Grundlagen und erweitere, wenn du herausfindest, was Claude wissen muss.

Projekt prüfen

Öffne deine package.json und liste jedes Framework, jede Bibliothek und jedes Tool auf, das dein Projekt verwendet. Notiere die Versionen. Prüfe deine Laufzeitanforderungen (Node-Version, Python-Version, Datenbank). Daraus wird dein Tech-Stack-Abschnitt.

package.json + Laufzeitversionen + Datenbank

Dateibaum dokumentieren

Erstelle einen schnellen Baum deines src-Verzeichnisses. Identifiziere die Ordner der obersten Ebene und schreibe eine einzeilige Beschreibung für jeden. Konzentriere dich darauf, wo Komponenten, Stores, Services, Typen und API-Routen liegen.

src/-Baum mit Zweckbeschreibungen

Konventionen dokumentieren

Schau dir deinen bestehenden Code an und notiere die Muster: wie du Dateien benennst, wie du Fehler behandelst, wie du Imports strukturierst, ob du Default- oder Named-Exports verwendest. Schreibe diese als kurze Regeln auf.

Benennung, Imports, Fehlerbehandlung, Exports

Agentenspezifische Abschnitte hinzufügen

Wenn du mit spezialisierten Agenten arbeitest, füge Fokusbereiche für jede Rolle hinzu. Der Frontend-Agent sollte deine Komponentenbibliothek kennen. Der DevOps-Agent sollte deine Deployment-Pipeline kennen. Der QA-Agent sollte dein Test-Framework kennen.

Fokusbereiche und zu vermeidende Bereiche pro Rolle

Warum AgentsRoom für CLAUDE.md?

AgentsRoom wurde mit CLAUDE.md als zentralem Konzept entwickelt, nicht als nachträgliche Ergänzung.

Integrierter CLAUDE.md-Editor

Bearbeite deine CLAUDE.md direkt in AgentsRoom mit Syntax-Hervorhebung und automatischem Speichern. Kein Wechsel zu einem Texteditor oder einer IDE nötig.

Live-Vorschau pro Agent

Sieh in Echtzeit, wie jeder Agent deine CLAUDE.md interpretiert. Beobachte die Terminal-Ausgabe, um zu überprüfen, ob Agenten deinen Konventionen folgen und deine Vermeidungsbereiche respektieren.

Kontext pro Projekt

Jedes Projekt in AgentsRoom hat seine eigene CLAUDE.md. Wechsle zwischen Projekten und jeder Agent lädt automatisch die richtige Kontextdatei für diese Codebasis.

Integration der Agentenrollen

Die 14 Agentenrollen von AgentsRoom sind direkt mit CLAUDE.md-Abschnitten verknüpft. Definiere Fokus- und Vermeidungsbereiche pro Rolle, und jeder Agent übernimmt genau die Anweisungen, die für ihn bestimmt sind.

Watch what your CLAUDE.md does to Claude Code token usage

CLAUDE.md is prepended to every Claude turn. A bloated CLAUDE.md silently inflates Claude Code token usage on every message. AgentsRoom puts a per-session token meter on each agent so you can see exactly how much your CLAUDE.md is costing you, with a live cache hit rate to confirm it stays cached.

See the Claude Code token usage tracker

CLAUDE.md FAQ

Frag uns etwas anderes

Wo soll ich meine CLAUDE.md-Datei platzieren?

Platziere sie im Stammverzeichnis deines Projekts, neben deiner package.json oder einer vergleichbaren Konfigurationsdatei. Claude Code liest sie automatisch beim Start einer Sitzung in diesem Verzeichnis. Du kannst auch verschachtelte CLAUDE.md-Dateien in Unterverzeichnissen für spezifischeren Kontext haben.

Wie lang sollte eine CLAUDE.md-Datei sein?

Es gibt kein striktes Limit, aber 50 bis 300 Zeilen sind ein guter Richtwert. Decke die Grundlagen ab: Tech-Stack, Dateistruktur, Konventionen und Befehle. Zu kurz, und Claude fehlt der Kontext. Zu lang, und du riskierst, die wichtigen Teile mit Rauschen zu verwischen.

Funktioniert CLAUDE.md mit allen Claude-Modellen?

Ja. CLAUDE.md wird von Claude Code unabhängig vom gewählten Modell gelesen (Opus, Sonnet oder Haiku). Alle Modelle profitieren von explizitem Projektkontext, wobei größere Modelle wie Opus detailliertere Anweisungen besser aufnehmen und umsetzen können.

Soll ich CLAUDE.md in die Versionskontrolle einpflegen?

Ja, für gemeinsame Projektanweisungen. Dein Team profitiert von konsistentem KI-Verhalten bei allen Entwicklern. Für persönliche Präferenzen unterstützt AgentsRoom persönliche Agenten-Konfigurationen, die automatisch gitignored werden.

Kann ich CLAUDE.md mit Multi-Agenten-Setups verwenden?

Auf jeden Fall. In AgentsRoom liest jeder Agent in deinem Projekt dieselbe CLAUDE.md. Du kannst rollenspezifische Abschnitte hinzufügen (z.B. Hinweise für den QA-Agenten im Vergleich zum Frontend-Agenten), damit jeder Spezialist gezielte Anweisungen erhält.

Wie oft sollte ich meine CLAUDE.md aktualisieren?

Aktualisiere sie, wenn sich die Struktur oder Konventionen deines Projekts ändern. Ein neues Framework hinzugefügt? Tech-Stack aktualisieren. Zu einem neuen Verzeichnislayout gewechselt? Dateistruktur aktualisieren. Eine veraltete CLAUDE.md führt zu veralteten Vorschlägen.

Mehr zum Thema

AGENTS.md: eine Kontextdatei für jeden Coding-Agenten (Codex, Antigravity, Claude)

AGENTS.md ist die portable Anweisungsdatei, die deine KI-Coding-Agenten lesen, bevor sie deinen Code anfassen. Was reingehört, wie sie sich von CLAUDE.md unterscheidet und wie du einen einzigen Kontext über Codex, Antigravity und Claude hinweg behältst.

Mit KI-Coding-Agenten kommunizieren: Claude, Codex, Antigravity, Grok Build

Code ist nicht mehr der Flaschenhals, Kommunikation ist es. Wie du mit deinen KI-Agenten Claude, Codex, Antigravity und Grok Build redest, um schneller und präziser zu liefern und Tokens zu sparen.

Wie viele Tokens habe ich noch bei Claude? Die zwei Bildschirme, die es zeigen.

Ihr Claude-Abo wird nicht in Tokens abgerechnet, deshalb zeigt kein Bildschirm einen Token-Stand. Hier steht, was tatsächlich gemessen wird, welche zwei Bildschirme es wirklich anzeigen, warum es schrumpft, während Sie gar nichts tippen, und was die Änderung am Wochenfenster im September 2026 für Ihre Woche bedeutet.

Bessere CLAUDE.md-Dateien schreiben

Lade AgentsRoom herunter und nutze den integrierten CLAUDE.md-Editor, um deinen Agenten den nötigen Kontext zu geben. Bessere Anweisungen, besserer Code.

AgentsRoom herunterladenKostenlos

Companion-App: Agenten auch unterwegs im Blick behalten

Nutze Claude, Codex, Antigravity CLI oder einen anderen KI-Anbieter.

Erweiterung installieren

Chrome Web Store

Bugs und Wünsche direkt in dein öffentliches Backlog schicken.

Agenten, die du wie eine Unterhaltung liest

Jeder Agent hat eine Rolle, ein Gesicht und einen Verlauf, den du wie in einer Messaging-App liest.