~/blog/2026/11/ein-gedaechtnis-fuer-claude-was-ob.md

Ein Gedächtnis für Claude: Was Obsidian und das Projekt Obsidian Mind daraus machen

8 min
Offizielles Vorschaubild des Projekts Obsidian Mind: Kristall-Logo mit Wissensnetz und Text „One memory layer for every agent and every project.“

Keine Zeit? Hier die Kurzversion in 30 Sekunden.

  • Claude Code vergisst zwischen zwei Sitzungen fast alles. Abhilfe schaffen CLAUDE.md-Dateien und das eingebaute Memory, das Erkenntnisse als kleine Markdown-Dateien ablegt.
  • Weil das alles reines Markdown ist, passt es perfekt zu Obsidian. Dort wird aus losen Notizen ein verlinktes, durchsuchbares Wissensnetz, das man selbst lesen und korrigieren kann.
  • Das Open-Source-Projekt Obsidian Mind (MIT-Lizenz, kostenlos) liefert dafür eine fertige Vorlage mit Hooks, Befehlen wie /om-standup und /om-wrap-up und optionaler semantischer Suche.
  • Der Gewinn: weniger Wiederholen, Entscheidungen bleiben erhalten, Wissen wächst über Wochen mit. Der Preis: etwas Einrichtung und die Disziplin, das Gedächtnis sauber zu halten.
  • Mein Rat: klein anfangen, erst das eingebaute Memory nutzen, dann den Ordner in Obsidian öffnen und schauen, ob man mehr braucht.

Wer regelmäßig mit Claude Code arbeitet, kennt dieses Gefühl. Man hat am Vortag eine Stunde lang mit dem Agenten an einem Problem gesessen, hat Entscheidungen getroffen, Sackgassen ausprobiert und am Ende eine Lösung gefunden. Am nächsten Morgen startet man eine neue Sitzung, und Claude weiß von alledem nichts mehr. Man fängt wieder bei null an und erklärt dieselben Dinge ein zweites Mal.

Das ist kein Fehler, sondern liegt in der Natur der Sache. Ein Sprachmodell hat kein Langzeitgedächtnis im menschlichen Sinn. Es sieht nur das, was in der aktuellen Unterhaltung steht. Alles andere muss man ihm irgendwie mitgeben. Genau an dieser Stelle wird es spannend, denn inzwischen gibt es ziemlich clevere Wege, genau das zu tun. Einer davon verbindet Claude mit Obsidian, und der hat mich in den letzten Tagen mehr beschäftigt, als ich zugeben möchte.

Wie Claude sich überhaupt etwas merkt

Claude Code bringt schon von Haus aus zwei Mechanismen mit. Der erste ist die Datei CLAUDE.md. Darin stehen Anweisungen, die bei jedem Start automatisch geladen werden, entweder global für alle Projekte oder nur für ein bestimmtes Projekt. Ich habe dort zum Beispiel festgelegt, wie knapp Claude mir antworten soll und dass zu jeder Anfrage eine Übergabe-Datei entsteht. Darin hält Claude fest, was erledigt ist, was entschieden wurde und was noch offen ist. Startet eine neue Sitzung, kann sie dort einfach weitermachen.

Der zweite Mechanismus ist das eigentliche Memory. Claude legt dabei selbst kleine Markdown-Dateien an, jeweils eine pro Erkenntnis. Das kann eine Vorliebe von mir sein, eine Korrektur, die ich einmal gegeben habe, oder ein fester Ablauf, etwa wie ein neuer Blogbeitrag bei mir entsteht. Eine Indexdatei namens MEMORY.md listet alle Einträge mit einer kurzen Beschreibung auf und wird zu Beginn jeder Sitzung mitgeladen. So weiß Claude, was es schon weiß, und liest die Details nur bei Bedarf nach.

Das Schöne daran: Es sind ganz normale Textdateien. Keine Datenbank, keine Cloud-Magie, nichts Verschlüsseltes. Man kann sie öffnen, lesen, ändern oder löschen. Und in den Dateien verweisen die Einträge untereinander mit doppelten eckigen Klammern aufeinander, also etwa so: [[blog-beitrag-ablauf]]. Wer Obsidian kennt, stutzt an dieser Stelle. Genau so sehen dort Links zwischen Notizen aus.

Warum Obsidian so gut dazu passt

Obsidian ist ein Notizprogramm, das auf einem ganz einfachen Prinzip beruht. Alle Notizen liegen als Markdown-Dateien in einem normalen Ordner auf der eigenen Festplatte. Obsidian nennt so einen Ordner Vault, also Tresor. Das Programm selbst ist im Grunde nur ein sehr komfortables Fenster auf diesen Ordner. Es zeigt die Notizen schön an, macht die Links klickbar, findet Rückverweise und zeichnet auf Wunsch eine Grafik, in der man sieht, wie alles miteinander zusammenhängt.

Für ein KI-Gedächtnis ist das fast ideal. Claude schreibt Markdown, Obsidian liest Markdown. Beide arbeiten auf denselben Dateien, ohne sich in die Quere zu kommen. Der Agent pflegt das Wissen, und ich kann jederzeit hineinschauen, querlesen und nachbessern. Gerade dieser letzte Punkt ist mir wichtig. Ein Gedächtnis, das ich nicht einsehen kann, wäre mir unheimlich. Eines, das ich wie ein Notizbuch durchblättern kann, fühlt sich dagegen eher wie ein gemeinsames Projekt an.

Der einfachste Einstieg ist deshalb erstaunlich unspektakulär. Man öffnet den Ordner, in dem Claude seine Erinnerungen ablegt, einfach als Vault in Obsidian. Schon sieht man das eigene KI-Gedächtnis als vernetzte Sammlung von Notizen. Ich fand das beim ersten Mal ziemlich aufschlussreich, weil man plötzlich merkt, was der Agent eigentlich so alles über einen gespeichert hat.

Obsidian Mind: Die Idee zu Ende gedacht

Ein Projekt treibt diesen Gedanken deutlich weiter. Es heißt Obsidian Mind, stammt von dem Entwickler Brenno Ferrari aus Berlin und steht unter der MIT-Lizenz, ist also frei nutzbar. Auf GitHub hat es inzwischen einige Tausend Sterne gesammelt. Die Grundidee steht gleich oben in der Beschreibung: Ein Obsidian-Vault soll KI-Coding-Agenten ein dauerhaftes Gedächtnis geben. Gebaut ist es in erster Linie für Claude Code, es funktioniert aber auch mit Codex CLI und Gemini CLI.

Statt eines lose wachsenden Ordners bekommt man eine durchdachte Struktur. Es gibt Bereiche für das langfristige Wissen, für laufende Arbeit, für Personen, Entscheidungen und Notizen aus Besprechungen. Ganz oben steht eine Datei namens North Star, in die man seine Ziele schreibt. An ihr orientiert sich der Agent, wenn er Prioritäten vorschlägt.

Das Herzstück sind sogenannte Hooks. Das sind kleine Skripte, die an bestimmten Stellen automatisch laufen. Beim Start einer Sitzung laden sie die Ziele, aktive Projekte, offene Aufgaben und die jüngsten Änderungen in den Kontext. Bei jeder Nachricht ordnen sie ein, ob es gerade um eine Entscheidung, einen Vorfall oder ein Projekt-Update geht, und geben dem Agenten einen Hinweis, wo das hingehört. Nach dem Schreiben einer Notiz prüfen sie, ob Links und Kopfdaten stimmen. Und bevor das Gesprächsfenster zusammengefasst wird, sichern sie den Verlauf.

Dazu kommen fertige Befehle. Mit /om-standup beginnt man den Tag und bekommt einen Überblick über das, was ansteht. Mit /om-dump erzählt man einfach drauflos, etwa nach einem Gespräch, und der Agent verteilt die Informationen auf die passenden Notizen. Mit /om-wrap-up schließt man eine Sitzung ab, dann werden Links geprüft, Verzeichnisse aktualisiert und vergessene Erfolge eingesammelt. Einige Befehle sind deutlich auf den Berufsalltag in Softwareteams zugeschnitten, bis hin zur Vorbereitung von Mitarbeitergesprächen. Das braucht nicht jeder, aber man sieht gut, wohin die Reise geht.

Wie man es nutzt

Die Einrichtung ist überschaubar, setzt aber etwas Technikfreude voraus. Man braucht Obsidian ab Version 1.12, weil das Projekt dessen Kommandozeilen-Schnittstelle nutzt, außerdem Node.js ab Version 22, Git und natürlich Claude Code. Installiert wird entweder über das Hilfsprogramm ShardMind, das einen kleinen Assistenten mitbringt, oder ganz klassisch, indem man das Repository klont.

Danach öffnet man den Ordner als Vault in Obsidian, schaltet in den Einstellungen die Kommandozeilen-Schnittstelle ein und startet Claude Code direkt in diesem Ordner. Den Rest erledigt der Agent im Gespräch. Wer möchte, installiert zusätzlich das Suchwerkzeug QMD. Es arbeitet mit drei kleinen Modellen, die lokal auf dem eigenen Rechner laufen, und findet Notizen nach ihrer Bedeutung statt nur nach Stichworten. Die Frage, was man eigentlich zum Thema Caching entschieden hatte, findet dann auch die Notiz, die ganz anders heißt.

Ein Detail fand ich besonders durchdacht. Obsidian Mind lädt nicht einfach den ganzen Vault in jede Sitzung. Das würde schnell teuer und unübersichtlich. Stattdessen gibt es Stufen: Ein kleiner Grundstock wird immer geladen, alles andere holt der Agent nur, wenn er es wirklich braucht. Und mit einem eigenen MCP-Server kann man den Vault sogar aus anderen Projekten heraus ansprechen, sodass das Gedächtnis nicht an einen Ordner gebunden ist.

Ehrlicherweise sei gesagt: Ich habe mir das Projekt gründlich angesehen, nutze im Alltag aber bisher vor allem das eingebaute Memory von Claude Code und meine Übergabe-Dateien. Obsidian Mind ist der nächste Schritt, den ich mir vorgenommen habe.

Was es wirklich bringt

Der offensichtlichste Gewinn ist Zeit. Man muss Dinge nicht ständig wiederholen. Wenn Claude einmal gelernt hat, wie ich Blogbeiträge aufbaue oder welche Fehler ich nicht noch einmal sehen will, dann bleibt das. Das merkt man nicht an einem einzelnen Tag, aber nach ein paar Wochen sehr deutlich.

Wichtiger finde ich aber etwas anderes. Entscheidungen gehen nicht mehr verloren. In vielen Projekten weiß nach drei Monaten niemand mehr, warum etwas so gebaut wurde, wie es gebaut wurde. Ein Gedächtnis, das solche Begründungen festhält und verlinkt, hilft nicht nur der KI, sondern auch mir selbst. Es ist am Ende eine Art Projekttagebuch, das sich fast von allein schreibt.

Und schließlich bleibt das Wissen bei mir. Es liegt in meinem Ordner, auf meiner Festplatte, in einem Format, das ich auch in zwanzig Jahren noch öffnen kann. Wenn ich morgen ein anderes Werkzeug nutze, nehme ich die Notizen einfach mit. Das ist ein angenehmer Gegensatz zu vielen Diensten, bei denen die eigenen Daten irgendwo verschwinden.

Wo man aufpassen sollte

Ganz ohne Haken ist das natürlich nicht. Ein Gedächtnis kann veralten. Was vor drei Monaten richtig war, stimmt heute vielleicht nicht mehr, und der Agent verlässt sich trotzdem darauf. Man muss also gelegentlich aufräumen. Obsidian Mind bringt dafür eigene Befehle mit, aber ein kritischer Blick von Zeit zu Zeit ersetzt das nicht.

Dann ist da die Frage, was man eigentlich alles speichert. Wer Notizen zu Kolleginnen und Kollegen, Gesprächen oder Vorfällen anlegt, sammelt schnell sensible Informationen. Dass alles lokal liegt, ist ein Vorteil. Trotzdem sollte man sich überlegen, was davon in ein Git-Repository wandert und wer darauf Zugriff hat.

Und zuletzt: Hooks und Erweiterungen sind Code, der mit den eigenen Rechten auf dem eigenen Rechner läuft. Das Projekt weist selbst ausdrücklich darauf hin und erklärt, wie man prüft, was genau ausgeführt wird. Das sollte man auch tun. Wer sich mit dem Thema Absicherung beschäftigt, findet vielleicht auch meinen Beitrag über Code Guardian interessant.

Mein Fazit

Das Gedächtnis ist für mich der Punkt, an dem aus einem klugen Werkzeug ein echter Arbeitspartner wird. Ein Agent, der sich erinnert, wird mit der Zeit besser auf mich eingestellt, statt jeden Tag neu anzufangen. Obsidian ist dafür ein naheliegender Partner, weil es genau das tut, was ein gutes Gedächtnis braucht: Es macht Wissen sichtbar, verknüpft es und lässt mich die Kontrolle behalten.

Mein Rat wäre, klein anzufangen. Erst das eingebaute Memory von Claude Code arbeiten lassen. Dann den Ordner einmal in Obsidian öffnen und schauen, was sich dort angesammelt hat. Und wenn man merkt, dass man mehr Struktur will, lohnt sich ein Blick auf Obsidian Mind. Man muss nicht gleich alles übernehmen. Manchmal reicht schon die Erkenntnis, dass die KI sich nur so gut erinnern kann, wie man ihr das Erinnern ermöglicht.

$ whoami
Christian Ackermann

Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.

gast@exception: ~ — bash
[gast@exception ~]$

Befehle wie help, ls, cd, cat, grep oder shuf eingeben und mit Enter ausführen. Esc schließt.