Claude-Code-Gedächtnis oder Markdown-Wiki: wo das eine endet
Von ReviewRamble editors ·
Das Gedächtnis von Claude Code ist eine Sammlung von Notizen, die das Modell liest, keine Sammlung von Regeln, die es befolgen muss. CLAUDE.md enthält deine Anweisungen, Auto Memory enthält, was Claude über dich gelernt hat, und keines von beiden kann eine Aktion stoppen. Wenn die Arbeit auf viele Quellen anwächst, die du aufbewahren, zitieren und prüfen willst, ist ein Markdown-Wiki die bessere Form, und Hooks, die es automatisch befüllen, sind eine Option, die du zuletzt und mit Vorsicht hinzufügst.
Dieser Beitrag zieht die Grenze zwischen diesen Schichten. Jede Aussage über Claude Code stammt aus Anthropics Dokumentation zu Memory, Hooks und dem Agent SDK; das Wiki-Muster stammt aus Andrej Karpathys LLM-Wiki-Gist, die Automatisierung aus dem README von claude-memory-compiler. Wir haben diese Setups nicht selbst ausprobiert.
CLAUDE.md: die Anweisungen, die du schreibst
CLAUDE.md ist eine Markdown-Datei, die du schreibst und die Claude Code zu Beginn jeder Sitzung liest. Sie kann in einem Projekt, in deinem Home-Ordner oder auf Organisationsebene liegen und mit @path-Importen weitere Dateien einbinden, bis zu vier Ebenen tief. Anthropic empfiehlt, jede Datei unter 200 Zeilen zu halten, weil längere Dateien mehr Kontext belegen und weniger zuverlässig befolgt werden, und bietet .claude/rules/ für Anweisungen, die nur für bestimmte Dateitypen gelten.

Stell sie dir als die Einweisung vor, die du einem neuen Kollegen geben würdest: Build-Befehle, Hausstil, der Ordner, den niemand anfassen soll. Sie ist kein Ort für einen wachsenden Haufen Fakten.
Auto Memory: die Notizen, die Claude für sich selbst führt
Auto Memory ist in lokalen Sitzungen standardmäßig an. Claude schreibt während der Arbeit eigene Notizen, ausgehend von deinen Korrekturen und Vorlieben, nach ~/.claude/projects/<project>/memory/. Eine Datei MEMORY.md indexiert sie, eine Zeile pro Erinnerung, und jede Erinnerung liegt in einer eigenen Themendatei. Nur die ersten 200 Zeilen oder 25KB von MEMORY.md, je nachdem, was zuerst erreicht ist, werden beim Sitzungsstart geladen; Themendateien liest Claude, wenn es sie zu brauchen meint.
Zwei Details zählen. Das Gedächtnis ist an den Rechner gebunden, es folgt dir also nicht auf einen anderen Computer oder in eine Cloud-Sitzung. Und es ist reines Markdown: Du kannst /memory öffnen, lesen, was Claude über dich entschieden hat, und löschen, was falsch ist. Pro Projekt lässt es sich abschalten, indem du autoMemoryEnabled auf false setzt.
Kontext ist keine Durchsetzung
Anthropics Memory-Seite sagt es direkt: Claude behandelt CLAUDE.md und Auto Memory als Kontext, nicht als erzwungene Konfiguration. Eine Zeile wie "lösche niemals den Migrations-Ordner" ist ein Rat, dem das Modell meist folgt. Widersprechen sich zwei Anweisungen, warnt die Dokumentation, dass Claude eine davon willkürlich wählen kann.
Was eine Aktion tatsächlich blockiert, ist ein PreToolUse-Hook. Er läuft vor einem Tool-Aufruf, und wenn er mit Code 2 endet oder eine permissionDecision mit deny zurückgibt, stoppt Claude Code den Aufruf. Die Aufteilung ist also einfach: Vorlieben gehören ins Gedächtnis, alles, was niemals passieren darf, in einen Hook oder in die Berechtigungseinstellungen.
Wo ein Wiki übernimmt
Das Gedächtnis beantwortet "wie arbeite ich gern". Schlecht ist es bei "was sagen diese vierzig Paper, Besprechungsnotizen und Anbieterseiten, und woher stammt jede Aussage". Dafür gibt es Karpathys LLM-Wiki-Muster, im April 2026 als Ideendatei veröffentlicht, die man in den eigenen Agenten einfügt.
Es hat drei Schichten. Ein Ordner raw/ enthält deine Quellen, die das Modell liest, aber nie verändert, sodass sie die maßgebliche Grundlage bleiben. Ein Ordner wiki/ enthält Markdown-Seiten, die das Modell schreibt und pflegt: Zusammenfassungen, Seiten zu Personen und Begriffen, Vergleiche. Eine Schema-Datei, in Claude Code die CLAUDE.md, legt die Struktur fest und die Schritte, um eine Quelle aufzunehmen, eine Frage zu beantworten und aufzuräumen. Zwei Dateien halten es navigierbar: index.md listet jede Seite mit Link und einzeiliger Zusammenfassung, und log.md ist ein Protokoll, an das nur angehängt wird, mit jeder Aufnahme, Abfrage und Prüfung.
Das Aufräumen macht aus Notizen Wissen, dem du trauen kannst. Karpathy nennt es Linting: ein regelmäßiger Durchgang, der Widersprüche zwischen Seiten sucht, Aussagen, die eine neuere Quelle ersetzt hat, Seiten, auf die nichts verlinkt, Begriffe, die eine eigene Seite verdienen, und fehlende Querverweise. Eine einzige neue Quelle, merkt er an, kann 10 bis 15 Seiten berühren.
Zwei unserer Tests zeigen das Muster in der Praxis. claude-obsidian (3.8) baut auf Karpathys Idee ein Obsidian-Wiki mit Quellenangaben, mit geplanten, protokollierten Schreibvorgängen, die es vertrauenswürdig und mühsam in der Einführung machen. OpenWiki (4.2) überträgt denselben Gedanken auf eine Codebasis und verfolgt, welche seiner eigenen Sätze veraltet sind, wenn sich der Code ändert. Für eine einmalige Karte eines unbekannten Repos baut Understand Anything (3.5) stattdessen einen Wissensgraphen, mit hohen Token-Kosten beim ersten Lauf.

Hooks, die das Wiki für dich füllen
Der nächste Schritt ist, nicht mehr von Hand zu kuratieren. claude-memory-compiler passt Karpathys Muster so an, dass das Rohmaterial deine eigenen Claude-Code-Sitzungen sind. Ein SessionEnd-Hook erfasst das Transkript, wenn eine Sitzung endet, ein PreCompact-Hook erfasst es erneut, bevor die automatische Verdichtung den Mittelteil zusammenfasst, und ein Hintergrundskript lässt das Modell Entscheidungen, Lehren und Stolperfallen in ein Tagesprotokoll ziehen. Ein Kompilierschritt macht aus diesen Protokollen verlinkte Begriffsartikel, und ein SessionStart-Hook gibt den Index in deine nächste Sitzung. Ein Lint-Skript führt sieben Prüfungen aus.
Das ist ein cleverer Kreislauf, und er birgt echte Risiken, bei denen sich das README nicht lange aufhält.
- Hooks führen Shell-Code aus. Ein Hook ist ein Befehl, den Claude Code mit seiner eigenen Umgebung ausführt, also mit den Rechten deines Benutzerkontos. Die .claude/settings.json eines anderen in dein Projekt zu kopieren, wie es die Einrichtung verlangt, heißt, dessen Skripte bei jedem Start und Ende einer Sitzung auszuführen. Lies sie vorher.
- Transkripte enthalten Geheimnisse. Ein Sitzungstranskript enthält alles, was durch die Sitzung lief: eingefügte Schlüssel, den Inhalt einer .env-Datei, die Claude gelesen hat, Kundendaten aus einem Log. Der Compiler schickt diesen Text an das Modell und schreibt die Auszüge in Markdown-Dateien, und nach unserer Lektüre von README und AGENTS.md gibt es keinen Schritt, der Sensibles schwärzt.
- Der Kompilierschritt schreibt ohne Nachfrage. Laut AGENTS.md läuft compile.py mit permission_mode auf acceptEdits, was jede Dateioperation in seinem Ordner automatisch genehmigt.
- Die Abrechnungsaussage widerspricht Anthropics Dokumentation. Das README sagt, Anthropic "has clarified that personal use of the Claude Agent SDK is covered under your existing Claude subscription", und AGENTS.md sagt, es brauche keinen API-Schlüssel, weil die gespeicherten Zugangsdaten von Claude Code genutzt werden. Eine Quelle nennt es nicht. Anthropics Agent-SDK-Überblick und Quickstart fordern dich auf, einen API-Schlüssel zu setzen, und sagen, dass Drittentwickler ohne vorherige Genehmigung weder den claude.ai-Login noch dessen Nutzungslimits in Agenten auf Basis des SDK anbieten dürfen. Behandle die Abo-Aussage als unbestätigt und plane API-Kosten ein; laut der eigenen Tabelle des Projekts kostet das Kompilieren eines Tagesprotokolls $0.45 bis $0.65.
Das Repository ist außerdem jung und ruhig: angelegt am 6. April 2026, zwei Commits, etwa 1.300 Sterne und keine Lizenzdatei, du hast also kein ausdrückliches Recht, den Code weiterzuverwenden.
Es gibt keine magische Größe für RAG
Jede Quelle hier nennt eine Schwelle, und sie sind sich nicht einig. Karpathy sagt, das Lesen des Index funktioniere gut bei etwa 100 Quellen und Hunderten Seiten, danach empfiehlt er ein richtiges Suchwerkzeug. Die Notizen des Compilers sagen, Index-Lesen schlage Vektorsuche bei 50 bis 500 Artikeln, und hybride Suche werde bei etwa 2.000 Artikeln oder 2 Millionen Tokens nötig. Keine von beiden liefert eine Messung.
Die nützliche Zahl ist deine eigene. Führe eine Liste mit zwanzig Fragen, deren Antworten du kennst, stelle sie alle paar Wochen und notiere, welche Seiten das Modell geöffnet hat und ob es die richtige Quelle zitiert. Wenn Antworten anfangen, vorhandene Seiten zu übersehen, oder der Index nicht mehr bequem in eine Sitzung passt, füge Suche hinzu. Gehostetes Gedächtnis wie Supermemory (4.0) oder ein lokaler Graph wie der Memory-Referenzserver (3.5) sind andere Werkzeuge für diesen Punkt; MemoryBase (3.2) löst ein anderes Problem, nämlich Chat-Kontext zwischen ChatGPT und Claude mitzunehmen.
Welche Schicht welche Aufgabe übernimmt
| Schicht | Wer sie schreibt | Wofür sie da ist | Kann sie eine Aktion stoppen |
|---|---|---|---|
| CLAUDE.md | Du | Arbeitsanweisungen und Hausregeln | Nein, sie ist Kontext |
| Auto Memory | Claude | Gelernte Vorlieben und Korrekturen | Nein, sie ist Kontext |
| PreToolUse-Hook | Du | Regeln, die gelten müssen | Ja |
| LLM Wiki | Claude, aus deinen Quellen | Kuratiertes Wissen mit Herkunft | Nein |
| Hooks zur Transkript-Erfassung | Skripte, automatisch | Das Wiki aus deinen Sitzungen füllen | Nein, und sie führen Code aus |
Eine Einführung in Stufen
- Beginne mit CLAUDE.md. Schreib die Anweisungen auf, die du am häufigsten wiederholst, halte die Datei unter 200 Zeilen und verschiebe dateispezifische Regeln nach .claude/rules/.
- Lass Auto Memory laufen, und lies es. Öffne alle ein bis zwei Wochen /memory und lösche, was falsch oder veraltet ist.
- Verlege harte Regeln in Hooks. Alles, dessen Bruch dich ärgern würde, wird ein PreToolUse-Hook oder eine Berechtigungssperre, kein Satz.
- Starte ein Wiki von Hand. Lege raw/, wiki/, index.md und log.md an, schreib die Regeln in CLAUDE.md, nimm eine Quelle nach der anderen auf und plane regelmäßige Lint-Durchgänge.
- Miss, bevor du Suche hinzufügst. Behalte deine Testfragen und füge Retrieval erst hinzu, wenn sie anfangen zu scheitern.
- Automatisiere die Erfassung zuletzt, wenn überhaupt. Lies jedes Hook-Skript, halte das Wiki aus geteilten Ordnern heraus, prüfe, was in den Protokollen landet, und nutze einen API-Schlüssel mit Ausgabenlimit.
Der Haken: Ein Wiki, das ein Modell pflegt, ist nur so gut wie seine Lint-Durchgänge und deine Lektüre davon. Lint kann einen Widerspruch melden, aber nicht sagen, welche Seite recht hat, und eine selbstsichere Zusammenfassung einer falsch gelesenen Quelle sieht genauso aus wie eine richtige. Dass raw/ unverändert bleibt, ermöglicht die Prüfung, und das hilft nur, wenn jemand prüft.
Unser Fazit: Sieh CLAUDE.md als Zettel am Kühlschrank, Auto Memory als die Gewohnheiten, die ein Mitbewohner annimmt, einen Hook als Schloss an der Tür und das Wiki als Aktenschrank mit Belegen. Die meisten brauchen die ersten drei diese Woche und den Aktenschrank erst, wenn sich die Belege stapeln. Der Roboter, der alles für dich ablegt, kann warten, bis du seinen Code gelesen hast.