Eine veraltete Notiz fällt nicht auf. Der Eintrag «die Preisliste ist in der Datei preisliste-2025.xlsx» sieht im Gedächtnis von Claude Code genau gleich aus, unabhängig davon, ob die Datei im Ordner liegt oder seit drei Monaten verschwunden ist. Nichts leuchtet rot, nichts bricht mit einer Fehlermeldung ab – die KI irrt sich einfach immer öfter, sucht zum Beispiel Preise in einer Datei, die es nicht mehr gibt, und woran das liegt, ist schwer zu erraten.

Deshalb gehört das Aufräumen in die Agenda, statt zu warten, bis etwas kaputtgeht.

Diese Lektion geht davon aus, dass du seit ein paar Wochen in einem Ordner mit Claude Code arbeitest und darin eine Datei CLAUDE.md hast – falls nicht, fang mit der Lektion zur ersten CLAUDE.md an. Was das Gedächtnis von Claude Code ist und wo du es findest, steht in der Lektion über das Gedächtnis von Claude Code.

Beginne mit /doctor

Die erste Liste liefert dir ein einziger Befehl. Starte Claude Code in dem Ordner, in dem du normalerweise arbeitest, und tippe:

/doctor

Der Befehl /doctor ist eine eingebaute Gesamtkontrolle von Claude Code. Er prüft, ob das Programm doppelt installiert ist und ob von einer alten Installation Reste übrig geblieben sind. Ausserdem sucht er nach Skills, MCP-Servern und Plugins, die du nicht brauchst, und zeigt, wie viel Platz sie im Kontext belegen, also in dem, was die KI in jedem Chat vor sich hat.

Bevor /doctor etwas ändert, zeigt er dir, was er gefunden hat, und fragt um Erlaubnis. Du kannst das Resultat also ohne Bedenken lesen, und bei jedem Vorschlag entscheidest du. Einen Skill, den du einmal im Quartal brauchst, lässt du ruhig stehen, auch wenn /doctor ihn für unbenutzt hält. Weisst du nicht, worum es bei einem Vorschlag geht, frag Claude Code im selben Chat danach.

/doctor kann auch die Datei CLAUDE.md kürzen, allerdings nur in einem Ordner, der ein Git-Repository ist. Wenn du nicht weisst, was ein Git-Repository ist, macht das nichts – Claude Code prüft die CLAUDE.md auch bei der Durchsicht des Gedächtnisses im nächsten Schritt und schlägt vor, was darin zu korrigieren ist.

Zeigt /doctor nur einen Bildschirm mit der Diagnose und schlägt nichts vor, hast du eine ältere Version des Programms. Schliesse Claude Code, tippe im Terminal claude update ein und starte claude noch einmal.

Der Befehl /doctor prompt-audit (ab Version 2.1.283) prüft CLAUDE.md-Dateien und Skills auf veraltete oder widersprüchliche Anweisungen. Du kannst ihn nach dem normalen /doctor starten, das automatische Gedächtnis sieht er aber nicht durch – diesen Teil erledigst du also ohnehin mit der Bitte weiter unten.

Befehle von Claude Code

Bitte Claude Code, sein Gedächtnis durchzusehen

Die Durchsicht des Gedächtnisses gibst du Claude Code im selben Ordner in Auftrag, in dem eben /doctor gelaufen ist. Jeder Ordner hat sein eigenes Gedächtnis, deshalb umfasst die Durchsicht die Notizen aus der Arbeit genau in diesem Ordner. Die Ausnahme ist ein Git-Repository: Das ganze Repository hat ein gemeinsames Gedächtnis, und es reicht eine Durchsicht in seinem Hauptordner. Sagt dir dieser Begriff nichts, betrifft dich die Ausnahme nicht. Füge diese Bitte in den Chat ein:

Sieh dein automatisches Gedächtnis (auto memory) für diesen Ordner durch. Lies die Datei MEMORY.md und alle Gedächtnisdateien daneben, die Datei CLAUDE.md in diesem Ordner und meine globale CLAUDE.md. Suche nach Einträgen, die nicht mehr stimmen, nach doppelt gespeicherten Einträgen, nach Einträgen am falschen Ort und nach Verweisen auf Dateien oder Ordner, die es nicht mehr gibt. Prüfe jeden Eintrag, der sich prüfen lässt: Gibt es die Datei, den Ordner, den Skill oder den Befehl aus dem Eintrag noch? Ändere und lösche nichts. Gib mir eine Liste von Vorschlägen, aufgeteilt in drei Gruppen: ändern, zusammenführen, löschen. Schreib bei jedem Punkt dazu, woher du es weisst. Frag mich am Schluss, was mit der Liste geschehen soll: nur zeigen, der Reihe nach korrigieren oder alles auf einmal korrigieren. Einen Eintrag löschst du immer erst nach meiner separaten Bestätigung.

Der Satz «Ändere und lösche nichts» ist deine Sicherung. Dank ihm lässt die erste Durchsicht deine Dateien unangetastet, auch wenn Claude Code auf etwas stösst, das seiner Meinung nach sofort korrigiert gehört.

Fragt Claude Code um Erlaubnis, eine der Dateien zu lesen, kannst du zustimmen. Lesen allein ändert nichts.

Manchmal ist die Liste leer oder hat nur zwei Punkte. Das kann heissen, dass im Gedächtnis Ordnung herrscht, aber prüfe es mit einer Frage: «Wie viele Gedächtnisdateien hast du gelesen, und wie heissen sie?» Stehen auf der Liste der gelesenen Dateien nur MEMORY.md und CLAUDE.md, bitte Claude Code, auch die übrigen Gedächtnisdateien zu lesen und die Durchsicht zu Ende zu führen.

Worauf Claude Code bei der Durchsicht achtet

Claude Code sucht bei der Durchsicht nach vier Arten von Mängeln: veralteten Einträgen, doppelt gespeicherten Einträgen, Einträgen am falschen Ort und Verweisen auf Dateien, die es nicht mehr gibt. So könnte seine Liste in einem Ordner mit Offerten und Preislisten nach zwei Monaten Arbeit aussehen:

Ändern

  1. Der Eintrag «die Preisliste ist in der Datei preisliste-2025.xlsx» – im Ordner liegt nur noch preisliste-2026.xlsx. Ich schlage vor, den Dateinamen zu korrigieren.
  2. In der CLAUDE.md steht «diese Woche schliesse ich die Offerte für den Grosshändler ab» – das ist der Arbeitsstand von vor fünf Wochen. Ich schlage vor, das ins Gedächtnis zu verschieben oder zu löschen.
  3. Die Regel «schicke nie eine Offerte ohne meine Freigabe» liegt in einer der Gedächtnisdateien und nicht in der CLAUDE.md. Ich schlage vor, sie in die CLAUDE.md zu verschieben.

Zusammenführen

  1. Die Regel «Offerten unterschreibe ich mit Vor- und Nachnamen, ohne Firmennamen» steht im Gedächtnis und in der CLAUDE.md. Ich schlage vor, sie nur in der CLAUDE.md zu behalten.

Löschen

  1. Ein Eintrag verweist auf den Ordner vertragsvorlagen, den es nicht mehr gibt. Ich weiss nicht, ob die Vorlagen anderswo gelandet sind – ich frage nach, bevor ich etwas unternehme.

Punkt 4 ist ein Duplikat, und bei Duplikaten laufen die Fassungen leicht auseinander: Du korrigierst die eine Kopie, und die andere behält den alten Wortlaut.

Die Punkte 2 und 3 sind Einträge am falschen Ort. Die CLAUDE.md funktioniert wie ein Zettel am Bildschirm: Claude Code liest ihn zu Beginn jedes Chats ganz, deshalb belegt jeder Satz auf diesem Zettel Platz im Kontext. Auf den Zettel gehört also, was immer gelten soll, und nicht der Plan für diese Woche, der in einem Monat nur noch Ballast ist.

Das Gedächtnis gleicht eher einem Ringbuch. Das Inhaltsverzeichnis, die Datei MEMORY.md, liegt zuoberst, und Claude Code liest es beim Start, wenn auch nur bis zu einer gewissen Länge. Die übrigen Gedächtnisdateien sind die Kapitel dahinter: Claude Code schlägt sie erst auf, wenn es sie seiner Einschätzung nach braucht. Eine Regel, die in einem solchen Kapitel steckt, wird deshalb in manchem Chat gar nicht geladen – darum der Vorschlag, sie auf den Zettel zu holen.

Dokumentation zum Gedächtnis

Was du mit der Liste der Vorschläge machst

Die Liste von Claude Code besteht aus Vorschlägen, nicht aus einem Urteil. Die letzten Sätze der Bitte weisen Claude Code an, dich am Schluss der Durchsicht zu fragen, was mit der Liste geschehen soll, und dir drei Möglichkeiten zu geben:

  1. Nur zeigen – die Liste bleibt im Chat, die Dateien bleiben unverändert.
  2. Der Reihe nach – Claude Code schlägt die Änderungen eine nach der anderen vor, und du nimmst jede an oder lehnst sie ab.
  3. Alles korrigieren – Claude Code setzt alle Änderungen aus der Liste sofort um.

Bei der ersten Durchsicht wählst du «nur zeigen». Lies die Liste in Ruhe und antworte mit eigenen Worten, zum Beispiel: «Die Punkte 1, 3 und 4 machst du so, wie du vorschlägst, Punkt 2 verschiebst du ins Gedächtnis, bei Punkt 5 korrigierst du den Pfad – die Vorlagen liegen jetzt im Ordner vertraege». Weisst du bei einem Punkt nicht, ob der Eintrag noch aktuell ist, lass ihn einfach stehen und schreib das Claude Code. In einem Monat kannst du darauf zurückkommen.

Das Löschen eines Eintrags bestätigst du immer separat, auch wenn du «alles korrigieren» gewählt hast. Ein alter Eintrag ist manchmal die einzige Spur davon, warum etwas so und nicht anders eingestellt ist, und wenn er gelöscht ist, kann das niemand mehr rekonstruieren.

Halte das Datum der Durchsicht fest

Wenn du über jeden Punkt der Liste entschieden hast, bitte Claude Code, das Datum zu speichern:

Speichere das Datum der heutigen Durchsicht des Gedächtnisses ganz oben in der Datei MEMORY.md in deinem automatischen Gedächtnis. Ergänze die Datei CLAUDE.md in diesem Ordner um einen Satz: Wenn seit der letzten Durchsicht des Gedächtnisses mehr als ein Monat vergangen ist, erinnere mich in deiner ersten Antwort im Chat daran.

Das Datum kommt ganz oben in die MEMORY.md, weil Claude Code diesen Teil der Datei zu Beginn jedes Chats liest, auch wenn das Gedächtnis schon lang ist. Der Satz zur Erinnerung kommt in die CLAUDE.md – er ist eine feste Regel und gehört deshalb auf den Zettel am Bildschirm, nicht ins Ringbuch.

Die Erinnerung erscheint nur in einem Chat, den du öffnest – Claude Code meldet sich nicht von sich aus bei dir. Wenn du sicher sein willst, dass die Durchsicht nicht in Vergessenheit gerät, trag sie in die Agenda ein, zum Beispiel auf den ersten Freitag im Monat.

Mach aus der Durchsicht einen Skill

Bei der nächsten Durchsicht musst du nicht alle Bitten neu einfügen. Ein Skill ist eine Datei mit Anweisungen, die Claude Code ausführt, sobald du einen einzigen Befehl tippst. Die Durchsicht des Gedächtnisses eignet sich gut als Skill, weil sie jedes Mal gleich abläuft: dieselben Schritte, dieselbe Liste und dasselbe Verbot, ohne deine Zustimmung etwas zu ändern. Schreiben musst du den Skill nicht selbst – bitte Claude Code darum:

Erstelle einen Skill mit dem Namen gedaechtnis-durchsicht. Der Skill soll das automatische Gedächtnis (auto memory) in dem Ordner durchsehen, in dem ich ihn starte: die Datei MEMORY.md und die Gedächtnisdateien daneben, die Datei CLAUDE.md in diesem Ordner und meine globale CLAUDE.md lesen und dann veraltete Einträge finden, doppelt gespeicherte, solche am falschen Ort und Verweise auf Dateien, die es nicht mehr gibt. Jeden Eintrag, der sich prüfen lässt, soll er prüfen. Die Liste der Vorschläge teilt er in drei Gruppen: ändern, zusammenführen, löschen, und schreibt bei jedem Punkt dazu, woher er es weiss. Er ändert und löscht nichts, bis ich entschieden habe, was mit der Liste geschehen soll: nur zeigen, der Reihe nach korrigieren oder alles korrigieren. Einen Eintrag löscht er immer erst nach meiner separaten Bestätigung. Am Schluss trägt er das Datum der Durchsicht ganz oben in der MEMORY.md ein, anstelle des bisherigen. Speichere ihn als globalen Skill, der in jedem meiner Ordner verfügbar ist.

Der Skill sieht das Gedächtnis des Ordners durch, in dem du ihn startest, und so erledigst du mit einem einzigen Skill die Durchsicht in jedem Ordner, in dem du mit Claude Code arbeitest.

In einem Monat öffnest du einen Chat in deinem Ordner, tippst zuerst /doctor und dann /gedaechtnis-durchsicht. Ab dem zweiten Mal besteht die ganze Durchsicht aus diesen zwei Befehlen.

Wenn du noch gar keinen Skill hast, schau zuerst in die Lektion über den ersten Skill und komm dann hierher zurück. Dort steht auch, was du tust, wenn ein neuer Skill nach dem Schrägstrich nicht erscheint.

Dokumentation zu Skills

Was du aus dieser Lektion mitnimmst

  • Ein veralteter Eintrag im Gedächtnis sieht genau gleich aus wie ein aktueller, deshalb wird einmal im Monat aufgeräumt und nicht erst dann, wenn die KI sich zu irren beginnt.
  • Die Gedächtnisdateien und die CLAUDE.md sieht Claude Code durch. Du liest nur seine Liste und entscheidest.
  • Die erste Durchsicht immer im Modus «nur zeigen» – die Dateien ändern sich erst, wenn du gesagt hast, was du von der Liste übernimmst.
  • Was immer gelten soll, gehört in die CLAUDE.md, der laufende Arbeitsstand ins Gedächtnis. Ein Eintrag am falschen Ort belegt entweder in jedem Chat Platz im Kontext oder wird womöglich gar nicht geladen.
  • Das Löschen bestätigst du separat, weil ein alter Eintrag manchmal die einzige Spur einer Entscheidung ist.

Aufgaben

Hake ab, was du erledigt hast. Der Stand wird im Browser gespeichert, so kannst du morgen zu dieser Liste zurückkehren.

  • /doctor gestartet, Resultat gelesen, bei jedem Vorschlag entschieden
  • Durchsicht des Gedächtnisses im Ordner in Auftrag gegeben, in dem du normalerweise arbeitest
  • Liste der Vorschläge im Modus «nur zeigen» gelesen
  • Bei jedem Punkt eine Antwort: ändern, zusammenführen, löschen oder stehen lassen
  • Jede Löschung separat bestätigt
  • Datum der Durchsicht in der MEMORY.md gespeichert
  • Satz zur Erinnerung in der CLAUDE.md ergänzt
  • Skill gedaechtnis-durchsicht gespeichert und nach dem Schrägstrich sichtbar
  • Nächste Durchsicht in der Agenda eingetragen