CLAUDE.md ist die Datei, die bestimmt, wie Claude Ihr Projekt versteht. Eine gut geschriebene Datei bedeutet weniger Korrekturen, besseren Code und Agenten, die tatsaechlich wissen, woran sie arbeiten.
Diese Anleitung fuehrt Sie durch jeden Abschnitt einer CLAUDE.md-Datei, von der Tech-Stack-Deklaration bis zu agentenspezifischen Hinweisen. Folgen Sie Schritt fuer Schritt und erstellen Sie Ihre eigene.
CLAUDE.md ist eine Markdown-Datei im Stammverzeichnis Ihres Projekts. Wenn Claude Code eine Sitzung startet, liest es diese Datei zuerst. Alles darin wird Teil von Claudes Kontext: Ihr Tech-Stack, Ihre Dateistruktur, die Konventionen Ihres Teams und alle spezifischen Anweisungen, die jeder Agent befolgen soll.
Stellen Sie es sich als Briefing-Dokument vor. Ohne diese Datei muss Claude raten, wie Ihr Projekt aufgebaut ist. Mit einer guten CLAUDE.md weiss Claude bereits, wo Dinge liegen, welchen Mustern es folgen soll und was es vermeiden muss. Der Unterschied in der Ausgabequalitaet 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
Die Struktur und Genauigkeit Ihrer CLAUDE.md beeinflusst direkt, wie gut Claude in Ihrer Codebasis arbeitet.
Eine gut strukturierte CLAUDE.md deckt diese sechs Bereiche ab. Jeder gibt Claude konkrete Informationen, mit denen es sofort arbeiten kann.
Listen Sie Ihre Frameworks, Bibliotheken und deren Versionen explizit auf. Geben Sie Ihren Package Manager, die Node-Version und alle Laufzeitanforderungen an. Claude nutzt dies, um kompatiblen Code zu generieren, ohne raten zu muessen.
Beschreiben Sie Ihre wichtigsten Verzeichnisse und was sich darin befindet. Komponenten, Stores, Services, API-Routen, Typen. Ein kurzes Baumdiagramm mit einzeiligen Beschreibungen pro Ordner funktioniert gut.
Dokumentieren Sie Ihre Namenskonventionen (camelCase fuer Dateien, PascalCase fuer Komponenten), Ihren Ansatz zur Fehlerbehandlung, die Import-Reihenfolge und alle projektspezifischen Regeln. So bleibt Claudes Ausgabe konsistent mit Ihrem bestehenden Code.
Fuegen Sie Ihre Dev-, Build-, Test- und Lint-Befehle ein. Wenn Claude etwas ueberpruefen oder ein Skript vorschlagen muss, verwendet es genau die Befehle, die Ihr Projekt erwartet.
Wenn Sie mehrere Agenten verwenden (QA, Frontend, Backend, DevOps), fuegen Sie einen Abschnitt hinzu, der beschreibt, worauf sich jede Rolle konzentrieren soll. Das ist besonders nuetzlich mit dem Multi-Agenten-Setup von AgentsRoom.
Sagen Sie Claude, was es NICHT tun soll. Keine Konfigurationsdateien aendern, nicht das Auth-System anfassen, keine Refaktorierung der Datenbankschicht. Explizite Grenzen verhindern, dass Agenten ungewollte Aenderungen vornehmen.
Sie muessen nicht alles auf einmal schreiben. Beginnen Sie mit den Grundlagen und erweitern Sie, wenn Sie herausfinden, was Claude wissen muss.
Oeffnen Sie Ihre package.json und listen Sie jedes Framework, jede Bibliothek und jedes Tool auf, das Ihr Projekt verwendet. Notieren Sie die Versionen. Pruefen Sie Ihre Laufzeitanforderungen (Node-Version, Python-Version, Datenbank). Daraus wird Ihr Tech-Stack-Abschnitt.
package.json + Laufzeitversionen + Datenbank
Erstellen Sie einen schnellen Baum Ihres src-Verzeichnisses. Identifizieren Sie die Ordner der obersten Ebene und schreiben Sie eine einzeilige Beschreibung fuer jeden. Konzentrieren Sie sich darauf, wo Komponenten, Stores, Services, Typen und API-Routen liegen.
src/-Baum mit Zweckbeschreibungen
Schauen Sie sich Ihren bestehenden Code an und notieren Sie die Muster: wie Sie Dateien benennen, wie Sie Fehler behandeln, wie Sie Imports strukturieren, ob Sie Default- oder Named-Exports verwenden. Schreiben Sie diese als kurze Regeln auf.
Benennung, Imports, Fehlerbehandlung, Exports
Wenn Sie mit spezialisierten Agenten arbeiten, fuegen Sie Fokusbereiche fuer jede Rolle hinzu. Der Frontend-Agent sollte Ihre Komponentenbibliothek kennen. Der DevOps-Agent sollte Ihre Deployment-Pipeline kennen. Der QA-Agent sollte Ihr Test-Framework kennen.
Fokusbereiche und zu vermeidende Bereiche pro Rolle
AgentsRoom wurde mit CLAUDE.md als zentralem Konzept entwickelt, nicht als nachtraegliche Ergaenzung.
Bearbeiten Sie Ihre CLAUDE.md direkt in AgentsRoom mit Syntax-Hervorhebung und automatischem Speichern. Kein Wechsel zu einem Texteditor oder einer IDE noetig.
Sehen Sie in Echtzeit, wie jeder Agent Ihre CLAUDE.md interpretiert. Beobachten Sie die Terminal-Ausgabe, um zu ueberpruefen, ob Agenten Ihren Konventionen folgen und Ihre Vermeidungsbereiche respektieren.
Jedes Projekt in AgentsRoom hat seine eigene CLAUDE.md. Wechseln Sie zwischen Projekten und jeder Agent laedt automatisch die richtige Kontextdatei fuer diese Codebasis.
Die 14 Agentenrollen von AgentsRoom sind direkt mit CLAUDE.md-Abschnitten verknuepft. Definieren Sie Fokus- und Vermeidungsbereiche pro Rolle, und jeder Agent uebernimmt genau die Anweisungen, die fuer ihn bestimmt sind.
Laden Sie AgentsRoom herunter und nutzen Sie den integrierten CLAUDE.md-Editor, um Ihren Agenten den noetigen Kontext zu geben. Bessere Anweisungen, besserer Code.
AgentsRoom herunterladenFuer immer kostenlos. Eigenen API key mitbringen.