CLAUDE.md oder Wissensdatenbank: Wann reicht eine Datei?
Stand: 6. November 2026 · von Michael Schwarz
Eine CLAUDE.md reicht, solange sie Regeln enthält, die bei fast jeder Aufgabe gelten: wie gebaut und getestet wird, welche Konventionen ihr nutzt, was tabu ist. Sobald darin Wissen landet, das nur manchmal gebraucht wird, etwa Sonderfälle, Kundenabsprachen und das Warum hinter Entscheidungen, gehört es in eine Wissensdatenbank, die Claude Code gezielt durchsucht. Die CLAUDE.md bleibt dann kurz und behält ihre Aufgabe.
Wofür die CLAUDE.md gemacht ist
Claude Code liest die CLAUDE.md bei jedem Start einer Sitzung. Alles, was darin steht, ist von der ersten Nachricht an im Kontext. Das ist ihre Stärke: Was immer gelten soll, muss niemand erst suchen. Der Befehl für die Tests, die Reihenfolge beim Bauen, die Regel, dass Migrationen nie nachträglich geändert werden. Solche Sätze gehören genau dorthin.
Sie liegt im Repository, wird mit dem Code versioniert und im Review gelesen. Für ein Team, das Regeln zum Code festhalten will, gibt es kaum einen besseren Ort.
Woran ihr merkt, dass die Datei zu groß wird
Die CLAUDE.md wächst leise. Nach jeder Sitzung, in der Claude Code etwas falsch verstanden hat, kommt ein Absatz dazu. Nach ein paar Monaten steht darin nicht mehr nur, wie gearbeitet wird, sondern auch, was das Team über die Zeit gelernt hat. Diese Anzeichen sprechen dafür, dass ein Teil davon einen anderen Ort braucht:
- Viele Abschnitte betreffen nur einzelne Kunden, Module oder Störungen und sind für die meisten Aufgaben egal.
- Ihr kürzt Erklärungen, damit die Datei überschaubar bleibt, und verliert dabei das Warum.
- Dasselbe Wissen steht in mehreren Repositories, weil es mehr als ein Projekt betrifft.
- Kolleginnen und Kollegen ohne Zugang zum Repository wissen etwas, das Claude Code bräuchte, und können es nicht eintragen.
- Neues kommt nur noch per Pull Request hinein, also kommt es meistens gar nicht hinein.
Dazu kommt der Kontext. Was in der CLAUDE.md steht, belegt in jeder Sitzung Platz, auch wenn die Aufgabe nur einen kleinen Teil davon braucht. Bei zwanzig Zeilen spielt das keine Rolle. Bei Hunderten Zeilen über Sonderfälle zahlt ihr bei jeder Sitzung für Wissen, das gerade niemand braucht.
Was eine Wissensdatenbank anders macht
Eine Wissensdatenbank wird nicht vorab geladen, sondern befragt. Claude Code sucht dort, wenn eine Aufgabe es verlangt, und holt nur die Notizen, die passen. Ob darin zehn oder tausend Notizen stehen, macht für die einzelne Sitzung kaum einen Unterschied.
Knotenhirn ist ein gehostetes Team-Gedächtnis für KI-Agenten mit eingebautem MCP-Server. Die Suche verbindet Volltext und Bedeutung, damit Claude Code eine Notiz auch dann findet, wenn sie andere Wörter benutzt als die Frage. Notizen schreiben Menschen im Browser in Markdown, und Claude Code schreibt sie selbst, wenn ihr es darum bittet. Ein Pull Request ist dafür nicht nötig, und auch Leute aus Support oder Vertrieb können festhalten, was sie wissen.
Gruppen legen fest, wer welche Notizen sieht. Claude Code sieht nur, was die verbundene Person sehen darf. Jede Änderung bleibt in der Historie, mit Person, Zeitpunkt und dem Hinweis, ob sie im Browser oder per MCP entstand.
Eine einfache Faustregel
Fragt bei jedem Absatz: Braucht Claude Code das bei fast jeder Aufgabe in diesem Repository?
- Ja: Es bleibt in der CLAUDE.md. Beispiele sind Befehle, Konventionen, Verbote und der Aufbau des Projekts.
- Nur manchmal: Es gehört in die Wissensdatenbank. Beispiele sind Entscheidungen mit ihrem Grund, Sonderfälle, Absprachen mit Kunden, Fallstricke und Lösungen für frühere Störungen.
- Menschen sollen es am Stück lesen: Es gehört ins Wiki. Beispiele sind Architektur, Handbücher und Abläufe.
Die drei Orte schließen sich nicht aus. Jeder hat eine Aufgabe, und keiner muss die der anderen übernehmen.
Ein Beispiel für die Aufteilung
Ein Beispiel: Ein Team pflegt einen Webshop. Seine CLAUDE.md beginnt mit fünfzehn Zeilen zu Build, Tests und Stil. Mit der Zeit kommen Abschnitte dazu: warum Versandkosten für Inseln eigens berechnet werden, welcher Großkunde eine eigene Rabattlogik hat, warum der nächtliche Export erst nach dem Lagerabgleich startet, was bei der letzten Störung im Zahlungsablauf half. Am Ende sind es mehrere hundert Zeilen, und das meiste davon betrifft die aktuelle Aufgabe nicht.
Das Team zieht die Abschnitte über Kunden, Störungen und Entscheidungen als einzelne Notizen nach Knotenhirn, eine Notiz pro Thema, mit dem Grund ausgeschrieben statt gekürzt. In der CLAUDE.md bleiben die fünfzehn Zeilen und ein Satz dazu: Bei Fragen nach dem Warum, nach Kunden oder früheren Störungen sucht Claude Code zuerst in Knotenhirn. Fragt jemand später, warum der Rabatt für diesen Kunden anders berechnet wird, findet Claude Code die Notiz und nennt sie als Quelle.
Den Kundenabschnitt kann jetzt auch das Support-Team ergänzen, das die Absprache kennt, ohne das Repository anzufassen. Und wenn ein Kunde die Sonderregel nicht mehr hat, ändert jemand eine Notiz, statt nach der richtigen Stelle in einer langen Datei zu suchen.
So verbindet ihr Claude Code
Meldet euch mit Microsoft oder Google an, legt euer Team an und verbindet Claude Code mit einer Zeile im Terminal:
claude mcp add --transport http --scope user knotenhirn https://knotenhirn.dev/mcp
Danach ruft ihr in Claude Code /mcp auf, wählt knotenhirn und meldet euch im Browser an. Andere Clients
beschreibt die Anleitung MCP verbinden. Wie Claude Code mit dem Gedächtnis arbeitet,
zeigt der Ratgeber Claude Code ein Gedächtnis fürs Team geben.
Probiert es mit eurem Team aus
Testet Knotenhirn 14 Tage kostenlos, ohne Zahlungsdaten. Die Testphase geht nicht automatisch in ein Abo über.