WhyVault
AnmeldenenKostenlos starten

Claude Code Memory

Claude Code Memory: was ins Repo gehört, und was nicht.

Claude Code startet jede Sitzung ohne Erinnerung. `CLAUDE.md` und Auto-Memory helfen, aber beide bleiben bei einem Repository und einem Rechner. Hier liest du, was in die `CLAUDE.md` gehört, was in ein geteiltes Gedächtnis per MCP, und wie du beides in fünf Minuten verbindest.

Lesezeit: 8 MinutenStand:

01

Wie sich Claude Code Dinge merkt

Stand Oktober 2026, laut der offiziellen Claude-Code-Doku. Details ändern sich schnell; im Zweifel gilt die Doku.

CLAUDE.md ist das Gedächtnis, das du schreibst. Claude Code liest die Datei zu Beginn jeder Sitzung. Es gibt sie auf mehreren Ebenen: ./CLAUDE.md im Projekt (für alle im Team, per Git geteilt), ~/.claude/CLAUDE.md für dich in allen Projekten und CLAUDE.local.md für persönliche Notizen zu einem Projekt, die nicht ins Repo sollen. Liegen mehrere vor, werden sie zusammengefügt, nicht ersetzt. Mit /init lässt du dir einen ersten Entwurf erzeugen.

Imports halten die Datei schlank. Mit @pfad/zur/datei holst du weitere Dateien dazu, etwa @README oder @docs/git-workflow.md. Für Regeln, die nur für einen Teil des Codes gelten, gibt es .claude/rules/. Die Doku empfiehlt, eine CLAUDE.md unter etwa 200 Zeilen zu halten: Alles darin kostet in jeder Sitzung Kontext.

Auto-Memory ist das Gedächtnis, das Claude schreibt. Claude Code legt sich pro Repository Notizen an: deine Vorlieben, Korrekturen, laufende Arbeit. Sie liegen als Markdown unter ~/.claude/projects/<projekt>/memory/, und ein Index namens MEMORY.md wird zu Beginn jeder Sitzung geladen. Mit /memory siehst du die Dateien und schaltest Auto-Memory an oder aus.

Beides ist gut gemacht und kostet nichts extra. Aber beides hat dieselbe Grenze: Es bleibt bei einem Repository, auf einem Rechner, in einem Tool. Auto-Memory wird laut Doku nicht zwischen Rechnern geteilt, und die CLAUDE.md von Projekt A sieht Claude Code in Projekt B nicht. Claude im Browser, ChatGPT und Cursor sehen keins von beiden.

02

Wo Claude Codes Gedächtnis liegt

Die Dateien, die Claude Code zu Beginn einer Sitzung liest, und wo WhyVault dazukommt:

~/.claude/
├── CLAUDE.md                 du, alle Projekte
└── projects/<projekt>/memory/
    └── MEMORY.md             Auto-Memory, schreibt Claude

mein-repo/
├── CLAUDE.md                 Team, per Git geteilt
├── CLAUDE.local.md           nur du, nicht committen
└── .claude/rules/            Regeln für Teile des Codes

https://mcp.whyvault.io       geteiltes Gedächtnis per MCP
~/.claude/CLAUDE.md
Deine Regeln für jedes Projekt. Hier steht der kurze Verweis auf WhyVault, damit Claude Code das Gedächtnis in jedem Repo von selbst nutzt.
CLAUDE.md
Was jeder im Team über dieses Repo wissen muss: Befehle, Konventionen, Aufbau. Wird mit dem Code versioniert und reviewt.
memory/MEMORY.md
Claudes eigene Notizen zu diesem Repo. Praktisch, aber nur auf deinem Rechner und nur für Claude Code.
mcp.whyvault.io
Notizen außerhalb jedes Repos, die Claude Code, Claude, ChatGPT und Cursor lesen und schreiben. Jede Änderung als Version, rückgängig mit einem Klick. Claude Code verbinden

03

Die Faustregel: CLAUDE.md oder MCP-Gedächtnis?

Frag bei jedem Eintrag: Gilt das nur für diesen Code, oder auch darüber hinaus?

–CLAUDE.mdGeteiltes Gedächtnis (WhyVault per MCP)
Typischer InhaltBuild-, Test- und Lint-Befehle, Code-Konventionen, Ordneraufbau, „immer X, nie Y“Entscheidungen und ihr Warum, verworfene Ansätze, Annahmen, Projektstand
Gilt fürDieses eine RepositoryAlle deine Projekte, Repos und Themen jenseits des Codes
Wer es liestClaude Code in diesem RepoJeder MCP-Client: Claude Code, Claude, ChatGPT, Cursor und mehr
VersioniertMit Git, zusammen mit dem Code, per Pull Request reviewtJede Änderung als Version mit Agentennamen, rückgängig mit einem Klick
LängeKurz, unter etwa 200 Zeilen: alles wird in jeder Sitzung geladenBeliebig viele Notizen: der Agent sucht gezielt, was er braucht
Persönliche VorliebenNur fürs Coden, in ~/.claude/CLAUDE.mdWie du arbeitest und schreibst, für jedes Tool in 9_System
Wo es liegtIn deinem Repo und auf deinem RechnerIn der EU gehostet (Frankfurt), DSGVO-konform; was ein Agent liest, verarbeitet auch sein Anbieter
Typischer Inhalt
CLAUDE.mdBuild-, Test- und Lint-Befehle, Code-Konventionen, Ordneraufbau, „immer X, nie Y“
Geteiltes Gedächtnis (WhyVault per MCP)Entscheidungen und ihr Warum, verworfene Ansätze, Annahmen, Projektstand
Gilt für
CLAUDE.mdDieses eine Repository
Geteiltes Gedächtnis (WhyVault per MCP)Alle deine Projekte, Repos und Themen jenseits des Codes
Wer es liest
CLAUDE.mdClaude Code in diesem Repo
Geteiltes Gedächtnis (WhyVault per MCP)Jeder MCP-Client: Claude Code, Claude, ChatGPT, Cursor und mehr
Versioniert
CLAUDE.mdMit Git, zusammen mit dem Code, per Pull Request reviewt
Geteiltes Gedächtnis (WhyVault per MCP)Jede Änderung als Version mit Agentennamen, rückgängig mit einem Klick
Länge
CLAUDE.mdKurz, unter etwa 200 Zeilen: alles wird in jeder Sitzung geladen
Geteiltes Gedächtnis (WhyVault per MCP)Beliebig viele Notizen: der Agent sucht gezielt, was er braucht
Persönliche Vorlieben
CLAUDE.mdNur fürs Coden, in ~/.claude/CLAUDE.md
Geteiltes Gedächtnis (WhyVault per MCP)Wie du arbeitest und schreibst, für jedes Tool in 9_System
Wo es liegt
CLAUDE.mdIn deinem Repo und auf deinem Rechner
Geteiltes Gedächtnis (WhyVault per MCP)In der EU gehostet (Frankfurt), DSGVO-konform; was ein Agent liest, verarbeitet auch sein Anbieter

Kurz: Die CLAUDE.md sagt, wie in diesem Repo gearbeitet wird. Das Vault weiß, warum es so ist, und erinnert sich auch dann daran, wenn du das Repo wechselst.

04

Drei Beispiele, wohin was gehört

Im Alltag ist die Grenze meist schnell klar:

  • „Tests laufen mit pnpm test“

    Gehört in die CLAUDE.md. Es gilt nur für dieses Repo, ändert sich mit dem Code und muss in jeder Sitzung sofort da sein.

  • „Wir nehmen Postgres statt MongoDB, weil …“

    Gehört ins Vault, als Entscheidungsnotiz mit Optionen und Annahmen. In die CLAUDE.md kommt höchstens eine Zeile: „Datenbank ist Postgres.“

  • „Ich mag kleine Commits und deutsche Messages“

    Gilt es nur fürs Coden, reicht ~/.claude/CLAUDE.md. Soll es auch Claude im Browser oder ChatGPT wissen, gehört es ins Vault unter 9_System.

05

Claude Code mit WhyVault verbinden

Ein Befehl, eine Anmeldung, ein paar Zeilen in der CLAUDE.md. Getestet mit Claude Code 2.1.

  1. 1

    WhyVault hinzufügen

    Ohne Schlüssel, mit Anmeldung im Browser. Mit --scope user gilt das Gedächtnis in allen Projekten. Wer lieber einen Zugangsschlüssel nimmt, etwa auf Servern oder in Containern, findet den fertigen Befehl in der App unter Agenten verbinden.

    claude mcp add --transport http --scope user whyvault https://mcp.whyvault.io
  2. 2

    Anmelden

    Starte Claude Code, tipp /mcp, wähl whyvault und melde dich im Browser an – oder führ claude mcp login whyvault aus. Danach zeigt claude mcp list den Server als verbunden.

    claude mcp login whyvault
  3. 3

    Ausprobieren

    Frag in einem beliebigen Projekt nach dem Stand. Claude Code ruft zuerst vault_overview auf und sucht dann gezielt.

    Lies mein WhyVault und sag mir, welche Entscheidungen es für dieses Projekt gibt.
  4. 4

    Auf das Vault verweisen

    Ein paar Zeilen in ~/.claude/CLAUDE.md sorgen dafür, dass Claude Code das Gedächtnis nutzt, ohne dass du fragen musst. Die ganze Anleitung

    ## Gedächtnis

- WhyVault (MCP-Server „whyvault“) ist mein Langzeitgedächtnis über alle Projekte.
- Vor größeren Änderungen in WhyVault nach früheren Entscheidungen zum Thema suchen.
- Entscheiden wir etwas mit Folgen, im Raum des Projekts in WhyVault festhalten.
- Befehle und Konventionen dieses Repos gehören in die CLAUDE.md, nicht ins Vault.
9_System/Coding-Regeln.md
# Coding-Regeln## Was ins Vault gehört- Entscheidungen mit Folgen: Frage, Optionen, Begründung, Annahmen.  Ablage: 3_Räume/<Kontext>/<Projekt>/01 Entscheidungen/- Verworfene Ansätze und warum sie nicht funktioniert haben.- Der Stand am Ende einer Sitzung, in der Übersicht des Raums.- Wissen, das in mehreren Projekten gilt, in 1_Wissen/.## Was nicht ins Vault gehört- Build-Befehle, Konventionen, Ordneraufbau eines Repos.  Das steht in der CLAUDE.md des Repos.- Code, Logs, Zugangsdaten, Kundendaten.## Wie- Erst suchen, dann schreiben. Bestehende Notizen ergänzen.- Eine Zeile Zusammenfassung pro Änderung.- Sag mir am Ende, was du gespeichert hast.

06

Eine Regel-Notiz für den Vault

Die CLAUDE.md erreicht nur Claude Code. Diese Notiz liest jeder verbundene Agent, weil vault_overview die Regeln aus 9_System mitliefert.

  1. Was ins Vault gehört: Je klarer die Liste, desto weniger Kleinkram landet im Gedächtnis. Entscheidungen und verworfene Wege sind das, was ein Repo nicht erzählt.

  2. Was nicht ins Vault gehört: Die Grenze zur CLAUDE.md steht ausdrücklich da. Sonst pflegst du dieselben Befehle an zwei Orten.

  3. Keine Zugangsdaten: Was ein Agent liest, verarbeitet auch sein Anbieter. Geheimnisse gehören in deinen Passwort-Manager, nicht in Notizen.

  4. Wie: Gezielte Änderungen statt neuer Notizen für alles. Jede Änderung landet mit dem Namen der Verbindung im Verlauf. Verlauf und Datenschutz

07

Entscheidungslog beim Coden

Mitten in der Arbeit, in einem Repo, das du ein paar Wochen nicht angefasst hast:

Claude Code

  1. Du: Wir haben inzwischen rund 4.000 Bestellungen am Tag und brauchen Hintergrundjobs. Haben wir dazu schon mal was entschieden?

  2. Werkzeug: search_notes · „Hintergrundjobs Queue“

    Claude Code: Ja: „2026-08-03 Keine eigene Queue“ im Raum Shop. Damals verworfen, weil Cron-Jobs reichten. Die Annahme dahinter: unter 1.000 Bestellungen am Tag. Die trägt bei 4.000 nicht mehr.

  3. Du: Dann bauen wir die Queue. Halt die neue Entscheidung fest und verweis auf die alte.

  4. Werkzeug: create_note · „01 Entscheidungen/2026-10-12 Queue für Hintergrundjobs“

    Claude Code: Gespeichert, mit Frage, Optionen, Begründung, Annahmen und einem Link auf die Entscheidung vom August. Den Befehl zum Starten des Workers trag ich in die CLAUDE.md ein – der gehört ins Repo.

Das Warum steht im Vault, das Wie in der CLAUDE.md. [Vorlage für Entscheidungen](/guides/decision-log)

08

Zwei weitere Workflows

Neben dem Entscheidungslog sind es vor allem diese beiden, bei denen ein geteiltes Gedächtnis den Unterschied macht.

  • Übergabe zwischen Sitzungen

    Bevor du eine Sitzung schließt: „Schreib den Stand in die Übersicht des Raums: was fertig ist, was offen ist, was als Nächstes kommt.“ Morgen, auf einem anderen Rechner oder in Cursor, fängst du mit „Wo waren wir?“ an. Claude Code ändert dabei nur diesen einen Abschnitt.

  • Mehrere Repos, ein Gedächtnis

    Frontend, Backend, Infrastruktur: Jedes Repo hat seine eigene CLAUDE.md, aber alle teilen sich einen Raum im Vault. Wissen, das überall gilt, etwa wie du APIs benennst, liegt in 1_Wissen. Eine Entscheidung im Backend kennt Claude Code dann auch im Frontend.

Die CLAUDE.md erklärt den Code. Das Vault erklärt die Entscheidungen dahinter.

?

Häufige Fragen

Hat Claude Code ein Gedächtnis?

Ja, zwei: CLAUDE.md-Dateien, die du schreibst und die zu Beginn jeder Sitzung geladen werden, und Auto-Memory, in dem Claude selbst Notizen pro Repository auf deinem Rechner anlegt. Mit /memory siehst und bearbeitest du beides. Über Repos, Rechner und andere Tools hinweg reicht keins von beiden; dafür verbindest du ein Gedächtnis per MCP.

Was ist der Unterschied zwischen CLAUDE.md und Auto-Memory?

Die CLAUDE.md schreibst du: Anweisungen und Regeln, im Projekt auch fürs ganze Team per Git. Auto-Memory schreibt Claude: Vorlieben, Korrekturen und Projektkontext, nur auf deinem Rechner und nur für dieses Repository.

Brauche ich die CLAUDE.md noch, wenn ich WhyVault nutze?

Ja. Befehle, Konventionen und Aufbau eines Repos gehören weiter in die CLAUDE.md, versioniert mit dem Code. WhyVault ersetzt sie nicht, sondern hält, was darüber hinausgeht: Entscheidungen, ihr Warum und Wissen über mehrere Projekte.

Wie füge ich einen MCP-Server zu Claude Code hinzu?

Mit claude mcp add. Für WhyVault: claude mcp add --transport http --scope user whyvault https://mcp.whyvault.io, dann mit /mcp oder claude mcp login whyvault im Browser anmelden. claude mcp list zeigt, ob die Verbindung steht. Anleitung für Claude Code

Kann ich das Gedächtnis mit meinem Team teilen?

Die Projekt-CLAUDE.md teilst du per Git. WhyVault ist ein persönliches Vault, aber die Einrichtung kannst du teilen: Mit --scope project landet die Verbindung in der .mcp.json des Repos, und jeder meldet sich mit seinem eigenen Konto an. Einen Zugangsschlüssel committest du dabei nie.

Kann Claude Code im Vault etwas kaputt machen?

Jede Änderung wird zur Version mit dem Namen der Verbindung, und du machst sie mit einem Klick rückgängig. Löschen ist aus, bis du es für eine Verbindung erlaubst. Soll Claude Code nur lesen, stell die Verbindung auf Nur lesen. Verlauf, Export und Datenschutz

Wo liegen meine Notizen?

WhyVault ist in der EU gehostet, in Frankfurt, und DSGVO-konform. Was Claude Code aus deinem Vault liest, verarbeitet auch Anthropic. Bis 20 Notizen ist WhyVault kostenlos, Pro kostet 9,99 € im Monat. Mehr zu Claude Memory

Alle Guides

Ein Gedächtnis für jedes Repo.

Ein Befehl in Claude Code, und deine Entscheidungen gelten in jedem Projekt, auch in Claude, ChatGPT und Cursor. Kostenlos, ohne Kreditkarte.

Kostenlos starten