CLAUDE.md ist die Datei, die bestimmt, wie Claude Ihr Projekt versteht. Eine gut geschriebene Datei bedeutet weniger Korrekturen, besseren Code und Agenten, die tatsächlich wissen, woran sie arbeiten.
Diese Anleitung führt Sie durch jeden Abschnitt einer CLAUDE.md-Datei, von der Tech-Stack-Deklaration bis zu agentenspezifischen Hinweisen. Folgen Sie Schritt für 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 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
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 müssen.
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 für Dateien, PascalCase für Komponenten), Ihren Ansatz zur Fehlerbehandlung, die Import-Reihenfolge und alle projektspezifischen Regeln. So bleibt Claudes Ausgabe konsistent mit Ihrem bestehenden Code.
Fügen Sie Ihre Dev-, Build-, Test- und Lint-Befehle ein. Wenn Claude etwas überprüfen oder ein Skript vorschlagen muss, verwendet es genau die Befehle, die Ihr Projekt erwartet.
Wenn Sie mehrere Agenten verwenden (QA, Frontend, Backend, DevOps), fügen Sie einen Abschnitt hinzu, der beschreibt, worauf sich jede Rolle konzentrieren soll. Das ist besonders nützlich mit dem Multi-Agenten-Setup von AgentsRoom.
Sagen Sie 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.
Sie müssen nicht alles auf einmal schreiben. Beginnen Sie mit den Grundlagen und erweitern Sie, wenn Sie herausfinden, was Claude wissen muss.
Öffnen Sie Ihre package.json und listen Sie jedes Framework, jede Bibliothek und jedes Tool auf, das Ihr Projekt verwendet. Notieren Sie die Versionen. Prüfen 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 für 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, fügen Sie Fokusbereiche für 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 nachträgliche Ergänzung.
Bearbeiten Sie Ihre CLAUDE.md direkt in AgentsRoom mit Syntax-Hervorhebung und automatischem Speichern. Kein Wechsel zu einem Texteditor oder einer IDE nötig.
Sehen Sie in Echtzeit, wie jeder Agent Ihre CLAUDE.md interpretiert. Beobachten Sie die Terminal-Ausgabe, um zu überprüfen, 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 lädt automatisch die richtige Kontextdatei für diese Codebasis.
Die 14 Agentenrollen von AgentsRoom sind direkt mit CLAUDE.md-Abschnitten verknüpft. Definieren Sie Fokus- und Vermeidungsbereiche pro Rolle, und jeder Agent übernimmt genau die Anweisungen, die für ihn bestimmt sind.
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 trackerAGENTS.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.
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.
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.
Laden Sie AgentsRoom herunter und nutzen Sie den integrierten CLAUDE.md-Editor, um Ihren Agenten den nötigen Kontext zu geben. Bessere Anweisungen, besserer Code.
Companion-App: Agenten auch unterwegs im Blick behalten
Nutzen Sie Claude, Codex, Antigravity CLI oder einen anderen KI-Anbieter.
Bugs und Wünsche direkt in dein öffentliches Backlog schicken.