Deine CLAUDE.md · Agentenwerk

Lernziele

Du lässt deine CLAUDE.mdDie Anweisungsdatei, die Claude Code zu Beginn jeder Session liest. Claude Code lädt sie aus dem Startordner und aus jedem Ordner darüber und hängt die Inhalte aneinander.Im Glossar in einem Interview mit dem Agenten entstehen.
Du sortierst Inhalte in die Datei, in Projektdateien oder ganz hinaus.
Du ergänzt die Datei um eine Regel mit Begründung, wenn der Agent denselben Fehler zweimal macht.

Die CLAUDE.md im Wurzelordner des Vault · engl. vaultDer Ordner mit allen Markdown-Dateien deines Second Brain, so wie Obsidian ihn öffnet. Jede Seite ist eine eigene Textdatei.Im Glossar ist die Datei, die der Agent zu Beginn jeder Session · engl. sessionEin einzelnes Gespräch mit einem Agenten: der Verlauf aller Nachrichten und Tool-Ergebnisse plus der Arbeitszustand. Endet das Gespräch, endet die Session.Im Glossar liest. Mit ihr kennt der Agent deine Lage. Ohne sie briefst du ihn jedes Mal von vorn.

Ein leerer Vault mit einer guten CLAUDE.md ist nach unserer Einschätzung nützlicher als ein voller Vault ohne sie. Was der Agent über dich weiß, prägt jede Seite, die er danach schreibt.

Lass dich interviewen

Schreibst du die Datei aus dem Stand, wird sie dünn und allgemein. Beantwortest du Fragen, wird sie konkret. Gib dem Agenten diesen Auftrag:

Du richtest mein Second Brain ein. Interview mich, EINE Frage nach der
anderen, um mein Profil aufzubauen. Frag nach: wer ich bin und was ich
mache, meine Ziele für dieses Jahr, wie du mit mir sprechen sollst, meine
Stärken und Schwächen und meine aktuellen Projekte. Warte jede Antwort ab,
bevor du die nächste Frage stellst. Wenn wir fertig sind, schreib alles mit
Überschriften gegliedert in die CLAUDE.md im Wurzelordner des Vaults.

Antworte so, als würdest du eine Mitgründerin an ihrem ersten Tag einweisen. Vage Antworten ergeben eine vage Datei, und jede Session erbt sie.

Was hineingehört

Wer du bist und woran du arbeitest. So genau, dass eine fremde Person danach handeln könnte.
Ziele mit Zeitrahmen. Dieses Jahr, dieses Quartal. Ziele ohne Datum altern schlecht.
Wie der Agent mit dir spricht. Länge, Ton und wie viel Widerspruch du willst.
Deine Stärken und Schwachstellen. Daran erkennt der Agent, wann er dir widersprechen sollte.
Laufende Projekte, je eine Zeile, verlinkt mit ihren Ordnern.
Die Regeln des Vaults: Ordneraufbau, Seitenformate mit ihrem Frontmatter · engl. frontmatterEin Block mit Metadaten im YAML-Format ganz oben in einer Markdown-Datei, zwischen zwei Zeilen mit drei Bindestrichen. Obsidian zeigt ihn als Eigenschaften der Seite an.Im Glossar, Regeln für Links. Die CLAUDE.md im Ordner vault-template/ aus dem Werkzeugkasten des Kurses ist ein brauchbarer Ausgangspunkt.

Was nicht hineingehört

Gehört das in die CLAUDE.md?

Ordne jeden Inhalt ein.

Noch offen (7)

Ziel für dieses Quartal: zwölf Videos veröffentlichen, bis 31. März
Die Aufgaben dieser Woche für den Kanal
Der API-Key für den Kalender
„Widersprich mir, wenn ein Plan meinem Jahresziel nicht dient.“
Eine lange Erklärung, was Markdown ist
„Ich will irgendwann jeden Tag meditieren.“
Die Ordnerstruktur des Vaults und die Regeln für Links

In die CLAUDE.md (0)

Woandershin oder gar nicht (0)

Vier Dinge lässt du weg: alles, was sich wöchentlich ändert, lange Erklärungen zu Dingen, die das Modell schon kennt, Zugangsdaten jeder Art und Absichtserklärungen, nach denen du nicht handeln wirst. Die Anleitung von Claude Code empfiehlt außerdem, jede CLAUDE.md unter 200 Zeilen zu halten. Längere Dateien kosten mehr Kontext, und der Agent hält sich schlechter an sie.

Zwei Ebenen

Die CLAUDE.md im Wurzelordner ist die Strategieebene: wer du bist, worauf du hinarbeitest, wie der Vault funktioniert. Jeder Projektordner bekommt eine eigene CLAUDE.md, die nur dieses Projekt beschreibt.

Startest du Claude Code im Projektordner, lädt es die CLAUDE.md des Projekts und dazu jede CLAUDE.md in den Ordnern darüber, also auch die des Vaults. Die Dateien werden aneinandergehängt, die des Projekts steht zuletzt. So beschreibt es die Dokumentation von Claude Code. Wie du ein Projekt trotzdem eng hältst, zeigt die Lektion Projekte abgrenzen.

Weiter verbessern

Macht der Agent denselben Fehler zweimal, liegt das Problem nach unserer Einschätzung in der CLAUDE.md. Ergänz die Regel und schreib die Begründung dazu. Eine Regel ohne Begründung wendet der Agent in Fällen, an die du nicht gedacht hast, zu wörtlich an.

- Schreib Quellenseiten immer auf Deutsch, auch wenn die Quelle englisch ist.
  Grund: Ich durchsuche das Wiki auf Deutsch. Zitate bleiben im Original.

Lies die Datei einmal im Monat. Ziele verschieben sich, Projekte enden, und ein veraltetes Profil verschlechtert unbemerkt alles, was der Agent schreibt.

Merksätze

Die CLAUDE.md im Wurzelordner liest der Agent zu Beginn jeder Session.
Ein Interview, eine Frage nach der anderen, ergibt eine konkretere Datei als Schreiben aus dem Stand.
Hinein gehören Person, Ziele mit Datum, Ton, Stärken und Schwächen, Projekte und die Regeln des Vaults.
Wöchentliches, Bekanntes, Zugangsdaten und Wunschsätze bleiben draußen.
Claude Code lädt die CLAUDE.md des Projekts zusammen mit der des Vaults.

Prüf dich selbst

Denkfrage

Der Agent hat zum zweiten Mal eine Quellenseite ohne Links zu Konzepten angelegt. Was tust du?

Denkfrage

Warum gehört der Satz „Ich will irgendwann jeden Tag meditieren“ nicht in die Datei?

Deine CLAUDE.md steht

0 von 5 erledigt

Das Interview ist geführt, die CLAUDE.md liegt im Wurzelordner des Vaults.
Jedes Ziel hat einen Zeitrahmen.
Ordneraufbau, Seitenformate und Linkregeln stehen in der Datei.Die CLAUDE.md aus dem Werkzeugkasten des Kurses kannst du übernehmen und anpassen.
Keine Zugangsdaten, nichts Wöchentliches, keine Wunschsätze, unter 200 Zeilen.
Ein monatlicher Termin zum Nachlesen ist eingetragen.

Quellen

How Claude remembers your project · Anthropic, Stand: Nov. 2026
CLAUDE.md aus dem Startordner und allen Ordnern darüber, aneinandergehängt; Ziel unter 200 Zeilen pro Datei.