CLAUDE.md erklärt: Das eine File, das deinen Agenten wirklich kennt (mit Community-Tipps)

CLAUDE.md ist eine einfache Markdown-Datei im Projektstamm (oder Workspace), die Claude automatisch liest, bevor er antwortet. Keine API, kein Plugin, kein Setup-Wizard — nur eine Textdatei.

In OpenClaw heissen die gleichen Dateien oft SOUL.md, MEMORY.md, AGENTS.md oder USER.md. In Claude Code heisst sie CLAUDE.md. Das Prinzip ist dasselbe: Persistente Anweisungen, die den Agenten auf dich kalibrieren.

Das Resultat: Ein Agent, der von Anfang an weiss:

• Wer du bist und was du machst
• Welchen Ton er treffen soll
• Was er tun soll — und was nicht
• Welche Tools und Zugriffe er hat

---

Das folgende Beispiel basiert auf unserem eigenen Setup bei AInauten — vereinfacht und auf einen Einzelnutzer angepasst. Du kannst es direkt als Vorlage nutzen:

# CLAUDE.md — Mein persönlicher KI-Assistent

## Wer bin ich?
- Name: Max Müller
- Rolle: Selbstständiger Unternehmensberater, Fokus KMU und Digitalisierung
- Standort: Berlin, Deutschland (Zeitzone: Europe/Berlin)
- Wichtigste Projekte: Blog "digital-kmu.de", Newsletter (2.400 Abonnenten), Beratungsmandate

## Wie ich arbeite (Bitte genau lesen)

- **Sprache:** Immer Deutsch. Du-Form. Kein "Sie", kein "Gerne" und kein "Natürlich!".
- **Antworten:** Direkt und auf den Punkt. Keine Floskeln. Wenn ich eine Aufgabe gebe, erledige sie — erkläre nicht erst, was du tun wirst.
- **Vorschläge:** Ich will Entscheidungen, keine Optionslisten. Empfiehl die beste Lösung und erkläre kurz warum.
- **Umgang mit Unklarheiten:** Lieber eine sinnvolle Annahme treffen und ausführen als fragen.
- **Formatierung:** Markdown für längere Texte ok. Für kurze Antworten: Plaintext.

## Was du tun darfst (ohne zu fragen)
- Dateien lesen, analysieren, zusammenfassen
- Texte schreiben, überarbeiten, kürzen
- Recherchieren und zusammenfassen
- Code schreiben und erklären
- Kalender lesen

## Was du NICHT tun darfst (immer fragen)
- Emails oder Nachrichten versenden
- Dateien löschen oder überschreiben (außer temporäre Dateien)
- Öffentliche Posts veröffentlichen
- Zahlungen oder Buchungen auslösen

## Meine wichtigsten Tools und Zugänge
- **Obsidian Vault:** /Users/maxmueller/Vault/ — hier liegen alle Notizen und Projekte
- **Wichtige Ordner:** Vault/Clients/, Vault/Newsletter/, Vault/Blog/
- **Browser:** Chrome, Standard-Profil
- **Nein zu:** SSH-Befehlen auf Remote-Servern ohne explizite Freigabe

## Stil und Ton (für Texte)
- Blog digital-kmu.de: Praxisnah, konkret, keine Buzzwords. Leser sind KMU-Inhaber, keine Tech-Profis.
- Newsletter: Freundlich, persönlich, max. 5 Min Lesezeit.
- Kunden-Emails: Professionell, sachlich, du-Form (ich kenne meine Kunden persönlich).

## Aktueller Kontext (regelmäßig aktualisieren)
- Laufende Mandate: Bäckerei Huber GmbH (Digitale Prozesse), Schreinerei Meier (CRM-Einführung)
- Wichtige Deadlines: Newsletter KW13 bis 28. März, Abschlussbericht Huber bis 2. April
- Fokus diese Woche: LinkedIn-Beiträge für Q2 planen

## Bekannte Fehler (hier eintragen, wenn Claude etwas falsch macht)
- NIE den Firmennamen "Huber" als "Hubner" schreiben
- Meine Kunden sind im DACH-Raum — keine US-Beispiele verwenden
- Importe in Python: immer am Dateianfang, nie mitten im Code

---

Das Beispiel deckt fünf Kernbereiche ab, die jeden Assistenten sofort nützlicher machen:

1. Identität und Kontext — Der Agent weiß, wer du bist, ohne dass du es erklären musst. Zeitzone, Projekte, Mandanten — alles schon geladen.

2. Verhaltensgrenzen — Was darf er ohne Nachfragen, was nie? Das verhindert unerwünschte Aktionen (versehentlich gesendete Emails, überschriebene Dateien).

3. Ton und Stil — "Direkt, du-Form, keine Floskeln" macht mehr Unterschied als jeder Prompt-Trick. Der Agent passt seinen Kommunikationsstil dauerhaft an.

4. Aktueller Kontext — Der Abschnitt "Aktueller Kontext" ist dein wöchentliches Update. Neue Deadlines rein, alte raus. So bleibt der Agent immer auf dem Laufenden.

5. Bekannte Fehler — Wenn der Agent etwas falsch macht, trag es hier ein. Beim nächsten Mal weiß er es. Das ist der meistunterschätzte Abschnitt (mehr dazu bei den Community-Tipps).

---

Die folgenden Empfehlungen stammen aus Reddit-Diskussionen (r/ClaudeCode, r/ClaudeAI), Entwickler-Blogs und den offiziellen Best Practices von Anthropic. Sie gelten für Claude Code, OpenClaw und jedes Setup mit Markdown-Konfigurationsdateien.

1. Verbote wirken stärker als Gebote

"NEVER use X" bleibt hängen — "always prefer Y" wird vergessen. Wenn du willst, dass der Agent etwas konsequent unterlässt, formuliere es als klares Verbot. (Quelle: r/ClaudeCode — "Negatives enforce better than positives")

2. Zeig den Weg, statt alles reinzupacken

CLAUDE.md sollte unter 200 Zeilen bleiben. Wenn du mehr brauchst: Lagere Details in Unterordner aus (z.B. docs/style-guide.md) und verweise in CLAUDE.md nur darauf. Der Agent liest die Datei bei Bedarf nach. (Quelle: r/ClaudeCode — "Point, don't dump")

3. Lass den Agent seine eigenen Fehler dokumentieren

Wenn Claude etwas falsch macht: Sag ihm, er soll den Fehler selbst in CLAUDE.md eintragen. "Aktualisiere CLAUDE.md, damit du diesen Fehler nicht wiederholst." So wird die Datei mit der Zeit immer besser — ohne dass du alles selbst pflegen musst. (Quelle: TurboDocx Best Practices)

4. Trenne Global von Projekt

Claude Code unterstützt zwei Ebenen: ~/.claude/CLAUDE.md (gilt überall) und ./CLAUDE.md (gilt nur für dieses Projekt). Boris Cherny, der Entwickler von Claude Code, empfiehlt:

• Global: Wie du arbeitest (Sprache, Stil, Fehlerbehandlung)
• Projekt: Wie dieses Repo funktioniert (Architektur, Befehle, Konventionen)

Wenn beides in einer Datei steht, wird sie zum Sumpf. (Quelle: Kirill Markin — "Global CLAUDE.md First, Project CLAUDE.md Second")

5. Schreib nur rein, was der Agent nicht schon weiß

Vermeide Anweisungen wie "Verwende TypeScript für Type Safety" — das weiß Claude bereits. Konzentrier dich auf das, was spezifisch für dein Projekt ist: ungewöhnliche Ordnerstrukturen, interne Namenskonventionen, bekannte Eigenheiten deines Stacks. (Quelle: r/ClaudeCode Community Guidelines)

6. Tracke wiederkehrende Muster

Halte eine Sektion für Muster, die immer wieder auftauchen: "Dieser Fehler bedeutet meistens X" oder "Für Aufgabe Y verwende immer Ansatz Z". Das spart dir die gleiche Erklärung in jeder Session. (Quelle: r/ClaudeAI — "track patterns that keep recurring")

7. Neue Session bei neuem Thema

Wenn du von einem Thema zum nächsten wechselst, starte eine neue Session. Nach 20+ Nachrichten zum gleichen Thema ist der Kontext überladen. CLAUDE.md sorgt dafür, dass der Agent trotzdem sofort Bescheid weiß. (Quelle: Kirill Markin — Claude Code Rules)

---

Zu vage: "Antworte immer hilfsbereit und freundlich" bringt nichts. Konkret ist besser: "Keine Einleitungssätze, direkt zur Antwort."

Zu lang: Wenn CLAUDE.md 10.000 Wörter hat, liest der Agent nur den Anfang. Halte es unter 200 Zeilen für täglich relevante Anweisungen.

Nie aktualisiert: CLAUDE.md ist kein Set-and-Forget. Aktuelles Projekt, aktuelle Deadline, aktuelle Präferenz — einmal im Monat reviewen.

Alles reinpacken: CLAUDE.md ist für dauerhafte Grundregeln. Aufgabenspezifische Details gehören in den Prompt, nicht in die Datei.

Nur Positives: "Immer X tun" wird schneller ignoriert als "NIEMALS Y tun". Wenn etwas wichtig ist, formuliere es als Verbot.

---

Wenn du OpenClaw nutzt, hast du die Wahl:

Ansatz	Für wen
CLAUDE.md (eine Datei)	Einsteiger, Solo-User, einfache Setups
SOUL.md + USER.md + AGENTS.md	Multi-Agent-Setups, Teams, komplexere Workflows

Für die meisten Nutzer gilt: Fang mit CLAUDE.md an. Wenn du merkst, dass du mehrere Agenten mit unterschiedlichen Rollen brauchst, split das File dann auf.

Die Kerninhalte sind dieselben — nur die Struktur ändert sich. SOUL.md wird zur Persönlichkeitsdefinition, USER.md zum Nutzerprofil, AGENTS.md zu den Arbeitsanweisungen.

---

In Claude Code:

1. Navigiere in deinen Projektordner
2. Erstelle CLAUDE.md (einfach als Textdatei)
3. Füge den Inhalt aus der Vorlage oben ein und passe ihn an
4. Beim nächsten Start liest Claude Code die Datei automatisch

In OpenClaw:

1. Öffne deinen Workspace-Ordner (Standard: ~/.openclaw/workspace/ oder projektspezifisch)
2. Erstelle CLAUDE.md dort
3. OpenClaw lädt die Datei beim Session-Start automatisch

Tipp: Leg CLAUDE.md ins Stammverzeichnis deines Hauptprojekts — dann gilt es automatisch für alle Unterordner.

---

CLAUDE.md ist das Fundament für einen Assistenten, der sich wie ein eingespieltes Team anfühlt — nicht wie ein Fremder, dem du jede Session von vorne erklären musst. Einmal eingerichtet, laufend aktualisiert. Der Return on Investment ist enorm.

Und denk an den Trick, der alles ändert: Wenn Claude einen Fehler macht, lass ihn die Korrektur selbst in CLAUDE.md eintragen. So wird die Datei mit jeder Session besser — automatisch.

---

• Die Kontext-Pyramide zeigt dir, wie du globale Regeln, Kontext-Dateien und Projekt-Instruktionen sinnvoll trennst.
• Cowork vergisst alles erklärt, wie du Session-Verlust mit persistentem Kontext praktisch abfängst.
• OpenClaw Multi-Agent zeigt, wie du aus einer einzelnen Konfigurationsdatei ein sauberes Multi-Agent-Setup weiterentwickelst.