CLAUDE.md erklärt: Das Projektgedächtnis von Claude Code

Claude Code startet jede Sitzung ohne Erinnerung an die letzte. Damit du nicht jedes Mal erklären musst, worum es in einem Ordner geht und welche Regeln gelten, gibt es die Datei CLAUDE.md. Claude Code liest sie beim Start und arbeitet ab dann nach deinen Vorgaben. Hier erfährst du, wo die Datei liegt, was hineingehört und wie eine gute CLAUDE.md aussieht. Am Ende findest du eine Vorlage zum Kopieren.

Was die CLAUDE.md ist

Die CLAUDE.md ist eine einfache Textdatei im Markdown-Format. Du kannst sie mit jedem Texteditor öffnen. Sie ist das Projektgedächtnis von Claude Code: Alles, was darin steht, kennt Claude in jeder Sitzung in diesem Ordner. Typische Inhalte sind der Zweck des Projekts, der Aufbau der Ordner, Regeln für Texte oder Code und Befehle, die Claude häufig braucht.

Wo die Datei liegt

Laut Dokumentation von Anthropic gibt es mehrere Orte, die jeweils für einen anderen Bereich gelten:

Unternehmen können zusätzlich eine zentrale Datei für alle Mitarbeitenden ausrollen. Claude Code liest beim Start die CLAUDE.md im aktuellen Ordner und in allen übergeordneten Ordnern und führt die Inhalte zusammen. CLAUDE.md-Dateien in Unterordnern werden erst geladen, wenn Claude dort arbeitet.

Die erste CLAUDE.md erstellen

Der schnellste Weg führt über Claude Code selbst:

1. Öffne das Terminal im Ordner deines Projekts und starte claude.
2. Gib /init ein. Claude sieht sich den Ordner an und schreibt einen Entwurf.
3. Lies den Entwurf, streiche Allgemeines und ergänze deine eigenen Regeln.

Mit dem Befehl /memory siehst du jederzeit, welche Gedächtnisdateien gerade gelten, und kannst sie öffnen. Du kannst Claude auch einfach bitten: „Nimm in die CLAUDE.md auf, dass Dateinamen immer mit dem Datum beginnen.“

Was in eine gute CLAUDE.md gehört

• Zweck: in zwei Sätzen, worum es in diesem Ordner geht.
• Aufbau: welche Unterordner es gibt und was darin liegt.
• Regeln, die Claude sonst falsch machen würde, so konkret wie möglich.
• Befehle, die Claude zum Prüfen oder Bauen ausführen soll.

Vorlage zum Kopieren

Diese Vorlage ist für einen Ordner gedacht, in dem Claude Code Angebote und Rechnungen vorbereitet. Ersetze die Inhalte durch deine eigenen und lösche alles, was nicht passt.

# Projekt: Angebote und Rechnungen

## Worum es geht
Dieser Ordner enthält Angebote, Rechnungen und Vorlagen
für meine Beratung. Kunden sind kleine Unternehmen.

## Aufbau des Ordners
- vorlagen/   Word- und Markdown-Vorlagen
- angebote/   ein Unterordner pro Kunde
- rechnungen/ Dateien im Format JJJJ-MM Kunde.pdf

## Regeln
- Schreibe Kundentexte per Sie, klar und ohne Floskeln.
- Preise nur aus vorlagen/preise.md übernehmen.
- Dateinamen immer mit Datum vorne: JJMMTT Titel.
- Lösche oder überschreibe keine Datei ohne Rückfrage.

## Typische Aufgaben
- Angebot aus einer Gesprächsnotiz in notizen/ erstellen
- Offene Rechnungen auflisten und Mahnentwurf schreiben

## Wichtige Befehle
- Vorschau als PDF: pandoc datei.md -o datei.pdf

Andere Dateien einbinden

Wird die CLAUDE.md zu lang, lagerst du Teile aus. Mit @pfad/zur/datei.md bindest du eine andere Datei ein. Laut Dokumentation gelten relative Pfade ab der Datei, die importiert, und Importe lassen sich bis zu vier Ebenen tief verschachteln. So kannst du etwa eine ausführliche Stilanleitung in eine eigene Datei legen und in der CLAUDE.md nur darauf verweisen:

## Texte
Für alle Kundentexte gilt: @vorlagen/stil.md

Globale Regeln für alle Projekte

Manche Vorgaben gelten bei dir überall, egal in welchem Ordner du arbeitest. Die gehören in die Datei ~/.claude/CLAUDE.md in deinem Benutzerverzeichnis. Claude Code liest sie in jeder Sitzung zusätzlich zur Datei im Projekt. Eine schlanke globale Datei könnte so aussehen:

# Meine Regeln für alle Projekte

- Antworte auf Deutsch.
- Frag nach, bevor du Dateien löschst oder verschiebst.
- Dokumente bekommen ein Datum vorne im Namen: JJMMTT Titel.
- Fasse am Ende jeder Aufgabe in drei Sätzen zusammen,
  was du geändert hast.

Die Faustregel: Persönliche Arbeitsweise gehört in die globale Datei, alles Fachliche in die Datei des Projekts. Arbeitest du mit anderen am selben Ordner, teilt ihr die Projekt-Datei, während jede Person ihre eigene globale Datei behält.

Die Datei aktuell halten

Eine CLAUDE.md ist nie fertig. Die besten Regeln entstehen aus Fehlern: Macht Claude etwas falsch, das es beim nächsten Mal richtig machen soll, wird daraus eine Zeile. Bitte Claude direkt im Anschluss: „Nimm diese Regel in die CLAUDE.md auf.“ Einmal im Monat liest du die Datei komplett und streichst, was nicht mehr gilt.

Häufige Fehler

• Die Datei wird zu lang: Wichtige Regeln gehen zwischen Nebensachen unter.
• Regeln widersprechen sich zwischen globaler und Projekt-Datei.
• Die Datei ist veraltet, weil sich der Ordneraufbau geändert hat.
• Zugangsdaten stehen im Klartext in der Datei. Die gehören nie hinein.

Häufige Fragen

Wie lang darf eine CLAUDE.md sein?

Eine feste Grenze gibt es nicht, aber kürzer wirkt besser. Alles in der Datei liest Claude Code in jeder Sitzung mit. Lagere ausführliche Teile in eigene Dateien aus und binde sie per Import ein.

Funktioniert die CLAUDE.md auch ohne Programmierprojekt?

Ja. Claude Code arbeitet in jedem Ordner, also auch mit Angeboten, Berichten oder Rechercheunterlagen. Die CLAUDE.md beschreibt dann eben diesen Ordner und deine Regeln für Texte und Dateien.

Wie es weitergeht

Mit einer guten CLAUDE.md arbeitet Claude Code in deinem Ordner deutlich verlässlicher. Der nächste Schritt sind Skills: ganze Abläufe, die Claude bei Bedarf selbst lädt. Wenn du Claude Code noch nicht eingerichtet hast, beginnst du am besten mit dem Claude Code Tutorial.