Workbranch › Anleitungen

So schreiben Sie eine CLAUDE.md-Datei für Claude Code

Jede Sitzung in Claude Code beginnt mit leerem Kontext, also wiederholen Sie immer wieder dieselben Build-Befehle und Hausregeln. Eine CLAUDE.md-Datei löst das. Diese Anleitung zeigt, wo sie hingehört, was hineingehört und wie Sie prüfen, ob Claude sie tatsächlich liest.

Aktualisiert am 30. Oktober 2026

Speicherorte und Befehle wurden im Oktober 2026 mit der Claude-Code-Dokumentation von Anthropic abgeglichen. Fehlt in Ihrer Version etwas, führen Sie claude update aus.

Wo CLAUDE.md-Dateien liegen

Sie können mehrere Dateien mit unterschiedlicher Reichweite haben. Claude Code kombiniert sie alle, statt eine durch eine andere zu ersetzen; die spezifischeren werden zuletzt gelesen.

Dateien im Startordner und in jedem Ordner darüber werden beim Start geladen. Eine CLAUDE.md in einem Unterordner wird erst später geladen, sobald Claude eine Datei in diesem Unterordner liest oder bearbeitet.

Die Datei mit /init erstellen

1. Öffnen Sie ein Terminal im Stammordner des Projekts und starten Sie claude.
2. Geben Sie /init ein. Claude sieht sich die Codebasis an und schreibt eine erste CLAUDE.md mit den Build-Befehlen, Testanweisungen und Konventionen, die es findet. Gibt es schon eine CLAUDE.md, schlägt es Verbesserungen vor, statt sie zu überschreiben.
3. Lesen Sie den Entwurf und löschen Sie alles, was offensichtlich oder falsch ist.
4. Ergänzen Sie, was Claude nicht aus dem Code ablesen kann: Entscheidungen, Eigenheiten der Umgebung, „niemals X tun“-Regeln.
5. Committen Sie die Datei, damit Ihr Team dieselben Anweisungen bekommt.

Zum späteren Bearbeiten führen Sie /memory aus. Der Befehl listet die Speicherorte Ihrer CLAUDE.md und CLAUDE.local.md für Benutzer- und Projektebene auf, auch solche, die es noch nicht gibt, und öffnet die gewählte Datei in Ihrem Editor. Sie können auch einfach add this to CLAUDE.md (füge das zur CLAUDE.md hinzu) schreiben.

Was hineingehört

Ein einfacher Test: Wenn Sie Claude etwas zweimal sagen mussten, gehört es in die Datei. Typische Anlässe für eine neue Zeile: Claude wiederholt einen Fehler, ein Code-Review findet etwas, das es hätte wissen müssen, oder Sie tippen dieselbe Korrektur wie in der letzten Sitzung.

• Befehle: wie das Projekt gebaut, getestet, gelintet und gestartet wird.
• Aufbau: wo wichtiger Code liegt, etwa API-Handler liegen in src/api/handlers/.
• Konventionen: Benennung, Formatierung, Regeln für Branches und Commits.
• Mühsam gewonnenes Wissen: Dinge, über die ein neues Teammitglied stolpern würde.

Schreiben Sie Regeln, die sich überprüfen lassen. Vor dem Commit npm test ausführen funktioniert besser als teste deine Änderungen. Gliedern Sie die Zeilen mit Überschriften und Aufzählungspunkten und entfernen Sie widersprüchliche Anweisungen, denn Claude folgt womöglich der einen oder der anderen. Mehrstufige Abläufe oder Regeln, die nur für einen Teil der Codebasis gelten, gehören stattdessen in einen Skill oder eine pfadbezogene Regel.

Kurz und übersichtlich halten

• Umfang: Zielen Sie auf unter 200 Zeilen pro Datei. Längere Dateien verbrauchen mehr Kontext und werden weniger zuverlässig befolgt.
• Importe: Mit @README oder @docs/git-instructions.md binden Sie eine andere Datei ein. Pfade sind relativ zur CLAUDE.md, und Importe lassen sich bis zu vier Ebenen tief verschachteln. Importierte Dateien kosten trotzdem Kontext; das hilft also bei der Ordnung, nicht beim Umfang. Wenn ein Projekt zum ersten Mal eine Datei von außerhalb des Ordners importiert, bittet Claude Code Sie um Zustimmung.
• Regelordner: Legen Sie Themendateien wie testing.md in .claude/rules/ ab. Fügen Sie oben ein Feld paths hinzu (zum Beispiel src/api/**/*.ts), dann wird die Regel nur geladen, wenn Claude an passenden Dateien arbeitet.
• Prüfung: In neueren Versionen lässt /doctor prompt-audit Claude nach veralteten oder widersprüchlichen Anweisungen suchen und Änderungen vorschlagen, ohne etwas zu ändern, bis Sie zustimmen.

CLAUDE.md und Auto Memory im Vergleich

Claude Code führt auch eigene Notizen, die sogenannte Auto Memory. CLAUDE.md schreiben Sie; die Auto Memory schreibt Claude aus Ihren Korrekturen und Vorlieben. Sie liegt pro Repository unter ~/.claude/projects/<project>/memory/, mit einem Index MEMORY.md, dessen erste 200 Zeilen (oder 25 KB) in jede Sitzung geladen werden. Sie bleibt auf Ihrem Rechner und wird nicht über git geteilt. Wenn Sie remember to always use pnpm (merk dir, immer pnpm zu verwenden) sagen, landet das in der Auto Memory; ein- und ausschalten lässt sich die Funktion mit dem Schalter in /memory. Nutzen Sie CLAUDE.md für alles, was das ganze Team bekommen soll.

Gut zu wissen

• Claude Code ist in den Tarifen Pro und Max enthalten, im selben Abo wie die Claude-Apps; für Mitglieder von Team und Enterprise gibt es einen eigenen Hilfeartikel.
• CLAUDE.md beeinflusst das Verhalten, erzwingt es aber nicht. Befehle oder Dateien sperren Sie mit Berechtigungsregeln in den Einstellungen.
• Die CLAUDE.md im Projektstamm wird nach /compact erneut von der Festplatte gelesen. Dort festgehaltene Regeln überdauern also lange Sitzungen, während Regeln, die Sie nur im Chat getippt haben, verloren gehen können. Dateien in Unterordnern und pfadbezogene Regeln kommen zurück, sobald Claude wieder auf passende Dateien zugreift.
• Dateien in Ordnern, die mit --add-dir hinzugefügt wurden, werden nur geladen, wenn Sie CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 setzen.

Wenn es nicht funktioniert

• Claude ignoriert eine Anweisung. Führen Sie /context aus und sehen Sie unter Memory files nach. Ist die Datei dort nicht aufgeführt, sieht Claude sie nicht: Prüfen Sie den Dateinamen und ob Sie Claude im richtigen Ordner gestartet haben.
• Regeln werden nur manchmal befolgt. Formulieren Sie sie konkreter, beseitigen Sie Widersprüche zu anderen CLAUDE.md- oder Regeldateien und kürzen Sie die Datei.
• Ein Import wird nicht geladen. Ein Pfad mit Leerzeichen braucht vor jedem Leerzeichen einen Backslash, ein Pfad in Anführungszeichen wird nicht importiert, und ein Pfad in Backticks bleibt wörtlich stehen. Importe von außerhalb des Projekts brauchen einmalig Ihre Zustimmung.
• Die CLAUDE.md eines Unterordners scheint zu fehlen. Sie wird erst geladen, wenn Claude auf eine Datei in diesem Unterordner zugreift.

Entscheidungen und To-dos außerhalb der Datei festhalten

CLAUDE.md ist für dauerhafte Regeln gedacht, nicht für die offenen Aufgaben dieser Woche. Dafür gibt es das Workbranch-Plugin für Claude Code: Führen Sie /workbranch:save aus, und Claude legt die Aufgaben, Entscheidungen und offenen Fragen der Sitzung in einem Workbranch-Projekt ab. Startet eine Sitzung in einem Ordner, der mit einem Workbranch-Projekt verknüpft ist, zeigt das Plugin, was dort noch offen ist. Es gibt eine kostenlose 3-Tage-Testphase auf app.workbranch.ai.

Quellen

• How Claude remembers your project (Claude Code Docs, geprüft am 30. Oktober 2026)
• Commands (Claude Code Docs, geprüft am 30. Oktober 2026)
• Use Claude Code with your Pro or Max plan (Claude Help Center, geprüft am 30. Oktober 2026)

Häufige Fragen