Regeln und Langzeitgedächtnis — damit Claude weiß wie du arbeitest.

Was ist das

Die CLAUDE.md wird bei JEDER Nachricht geladen — sie bestimmt wie Claude Code mit dir arbeitet: Sprache, Regeln, Konventionen, Workflow. Eine gute CLAUDE.md ist der Unterschied zwischen „Claude macht was er will" und „Claude macht genau was ich brauche". Memory ist der Layer drunter: Markdown-Dateien die Langzeitgedächtnis geben, ohne jeden Turn mitgeladen zu werden.

Installation / Aktivierung

Option 1 — Terminal:

# Globale CLAUDE.md (gilt überall)
nano ~/.claude/CLAUDE.md

# Projekt-CLAUDE.md (nur in diesem Projekt)
nano ./CLAUDE.md

Oder im Projekt einfach /init im Claude-Code-Chat — erstellt ein Template.

Option 2 — Prompt an Claude Code:

Bau mir eine globale CLAUDE.md nach ~/.claude/CLAUDE.md. Frag mich vorher durch: Sprache, Coding-Konventionen, Workflow-Präferenzen (Plan Mode, Subagents, Verifikation). Halt die Datei unter 100 Zeilen. Zeig sie mir vor dem Schreiben zur Bestätigung.

Die 7 Sektionen einer sauberen CLAUDE.md

1. Basics — Wer bist du?

Basics

• Sprache: Deutsch, per du
• Antworten: kurz und direkt, kein Overhead
• Wenn du etwas Wichtiges lernst: sag welche Memory-Datei du aktualisieren würdest

### 2. Coding-Konventionen

```markdown
## Coding-Konventionen
- Python bevorzugt
- Variablen auf Englisch, Kommentare auf Deutsch
- Flask für einfache APIs, FastAPI wenn Performance wichtig
- SQLite für einfache Datenhaltung
- Tests nur bei kritischer Logik

3. Plan Mode erzwingen

## Workflow
- Für JEDE nicht-triviale Aufgabe zuerst Plan Mode
- Wenn etwas schiefläuft: STOP, neu planen — nicht weiter pushen

4. Subagent-Strategie

## Subagents
- Default ist Subagent — jede Aufgabe die mehr als ein kurzes Grep/Edit braucht
- Code-Änderungen → Subagent liest, versteht, editiert. Hauptkontext bleibt sauber.
- Multi-File-Edits → mehrere Subagents parallel
- Hauptkontext nur für: Planung, Entscheidungen, kurze Status-Updates

5. Self-Improvement Loop

## Self-Improvement Loop
- Korrektur → SOFORT in lessons.md speichern
- "nein", "nicht so" → lessons.md
- Vor Code-Änderungen relevante Fehler-Patterns prüfen
- Nie denselben Fehler zweimal machen

6. Verifikation vor Abschluss

## Verifikation
- Niemals als erledigt markieren ohne Beweis dass es funktioniert
- Tests laufen lassen, Logs prüfen, Korrektheit demonstrieren

7. Core Principles

## Core Principles
- Simplicity First: Jede Änderung so einfach wie möglich
- No Laziness: Root Causes finden, keine temporären Fixes
- Minimal Impact: Nur das Notwendige anfassen

Use-Cases

• Neues Projekt starten — /init im Projekt, dann CLAUDE.md um Framework/Stack ergänzen.
• Workflow-Regel durchsetzen — "Plan Mode erzwingen" Eintrag hinzufügen, Claude hält sich dran.
• Korrekturen persistieren — "Korrektur → lessons.md" Regel macht dass Claude aus Fehlern lernt.
• Team-Setup — Projekt-CLAUDE.md committen, alle im Team bekommen denselben Claude-Stil.
• Memory-System bootstrappen — ~/.claude/memory/MEMORY.md als Index, Detail-Dateien pro Thema.

Pro-Tipp

Jede Zeile in CLAUDE.md kostet Token bei JEDER Nachricht. Faustregeln:

• Globale CLAUDE.md: unter 100 Zeilen
• Projekt-CLAUDE.md: unter 150 Zeilen
• Wird's länger: in separate Dateien auslagern und nur referenzieren

Memory-Dateien (außer MEMORY.md Index) werden nicht automatisch geladen — Claude liest sie bei Bedarf. Keine Duplikate reinschreiben. Regelmäßig aufräumen.

🚀 CLAUDE.md und Memory sind die Basis. Aber die richtigen Regeln zu schreiben die wirklich funktionieren — das ist eine Kunst.

In der Community teile ich meine komplette CLAUDE.md und zeige wie ich sie über Monate optimiert habe.

→ Zur Claude Code Mastery Community

Wird regelmäßig erweitert — folge @laurinbuilds für Updates.