Wie installiert man claude-mem mit 100.000 Sternen? In 3 Schritten ein Gedächtnis anbinden und Fallstricke der Testversion vermeiden

Claude Code vergisst nach jedem Neustart, was zuvor geändert wurde. Deshalb installieren viele claude-mem mit seinen 100.000 Sternen. Die Installation ist möglich – aber klicken Sie sich nicht einfach mit Enter durch den Installer. Der v15-Installer vom Oktober 2026 wählt standardmäßig den gehosteten CMEM-Pro-Observer aus. Nach 30 Tagen Testphase kostet er 30 US-Dollar pro Monat. Wer keine monatlichen Gebühren zahlen möchte, kann bei der Installation --provider claude angeben oder den Observer danach auf einen eigenen API-Schlüssel umstellen.

Das hier ist kein Werbetext nach dem Motto „einmal installieren, für immer merken“. Im Folgenden unterscheiden wir zwischen Herstellerangaben, einem einzelnen Drittanbieter-Test, meinem eigenen Test und offenen Fragen. Alle Daten wurden am 30.10.2026 geprüft.

Die wichtigsten Fakten zu claude-mem

Diese Tabelle hilft dir zu entscheiden, ob sich das Weiterlesen für dich lohnt.

Punkt	Erklärung	Was das für dich bedeutet
Popularität	GitHub-Repository `thedotmack/claude-mem`, 105.017 Stars, Apache-2.0-Lizenz (GitHub-API-Abfrage vom 30.10.2026)	Die Sterne zeigen nur, wie populär das Projekt ist. Ob es sich für dich eignet, musst du selbst entscheiden.
Version	Die neueste Version auf npm und als GitHub-Release ist jeweils 15.6.0 (29.10.2026); das README-Badge zeigt dagegen 15.7.0	Orientiere dich an der npm-Version und lass dich nicht vom Badge täuschen.
Standardmässig kostenpflichtig	Der Installer wählt standardmässig CMEM Pro: Nach 30 Tagen Testphase kostet es 30 $ pro Monat.	Wenn du kein Abo möchtest, wähle eine andere Variante.
Ohne monatliche Gebühr	Mit `--provider claude` dein eigenes Claude-Abo nutzen oder nach der Installation auf einen eigenen Schlüssel umstellen	Die Kosten gehen zulasten deines Abo-Kontingents oder API-Guthabens.
Nicht rein lokal	Das Observer-Modell liest die Inhalte deiner Tool-Aufrufe.	Bei sensiblen Repositories solltest du vorher genau abwägen.

📷 Platzhalter für einen Screenshot, bei der Bearbeitung ergänzen: GitHub-Repository-Startseite (thedotmack/claude-mem, mit sichtbarer Sternzahl und neuestem Release)

Was merkt sich claude-mem eigentlich?

Kurz gesagt: claude-mem ist eine lokal laufende Gedächtnisschicht – kein neues Chat-Modell und keine Cloud-Notizlösung. Es erfasst, was während einer Sitzung passiert, speichert eine komprimierte Fassung und stellt sie Claude bei der nächsten Sitzung wieder zur Verfügung.

Die Verarbeitung besteht aus fünf Schritten:

Hooks (Lebenszyklus-Hooks): Claude Code löst beim Sitzungsstart, beim Absenden einer Eingabeaufforderung, vor und nach Tool-Aufrufen sowie beim Anhalten und Beenden Ereignisse aus. An diesen Stellen setzt claude-mem seine Hooks ein.
Worker: Ein lokal mit Bun laufender HTTP-Dienst, der Hook-Ereignisse entgegennimmt. Der Standardport ist 37700 + (uid % 100) – also nicht unbedingt 37700.
Observer (Beobachtermodell): Der Worker übergibt die Rohdaten der Tool-Aufrufe an ein Modell, das sie zu strukturierten Beobachtungen verdichtet.
Observation (Beobachtungseintrag): Jeder Eintrag enthält Typ, Titel, Beschreibung und betroffene Dateien und wird in ~/.claude-mem/claude-mem.db (SQLite) gespeichert. Der Vektorindex liegt unter ~/.claude-mem/chroma/ (Chroma ist eine Vektordatenbank für die semantische Suche).
Einfügen beim nächsten SessionStart: Zu Beginn einer neuen Sitzung werden automatisch die jüngsten relevanten Beobachtungen des aktuellen Projekts eingefügt – standardmässig höchstens 50. Über MCP-Tools kann Claude bei Bedarf auch ältere Erinnerungen in drei Stufen abrufen: search → timeline → get_observations.

Wichtig: Erfasst wird nur, was die Hooks mitbekommen. Gedanken ausserhalb der Sitzung und Diskussionen, die nicht über Tool-Aufrufe laufen, landen nicht automatisch in der Datenbank. Ausserdem sind das native Memory von Claude Code (MEMORY.md) und claude-mem zwei getrennte Systeme. Sie laufen standardmässig parallel und sind nicht dasselbe.

Drei Voraussetzungen für die Installation von claude-mem

Wenn eine dieser Voraussetzungen nicht erfüllt ist, solltest du mit der Installation noch warten:

Claude Code ≥ 2.1.139: Bei älteren Versionen werden die args des Hooks ignoriert. Die Folge: Es wird stillschweigend nichts aufgezeichnet – und der Fehler ist schwer zu finden. Prüfe die Version mit claude --version und führe bei Bedarf claude update aus.
Node 20+: Das npm-Paket verlangt ^20.19.0 || >=22.12.0. Prüfe deine Version mit node -v. Bun (≥1.1.31) und uv installiert der Installer automatisch. In einem Test unter Ubuntu 26.04 belegten Bun, uv und Chroma zusammen rund 1,2 GB Speicherplatz.
Du bist damit einverstanden, dass der Observer Werkzeugaufrufe sieht: Unabhängig vom Installationsweg werden deine Werkzeugaufrufe, Eingabeaufforderungen und Inhalte für Zusammenfassungen an den gewählten Observer-Anbieter gesendet. Wenn dein Repository Schlüssel, Kundendaten oder unveröffentlichten Code enthält, solltest du den Observer zunächst nicht aktivieren.

Unter Windows benötigen die Hooks kein Git Bash. Nach der Installation musst du aber das Terminal oder die IDE neu starten, damit der neue PATH wirksam wird.

Welcher der drei Installationswege für claude-mem passt zu dir?

Weg	cmem-Konto erforderlich?	Wie wird bezahlt?	Wohin gehen die Inhalte?	Für wen geeignet?
A: Standard CMEM Pro	Ja, für die Testphase muss zudem eine Karte hinterlegt werden	Ab $30/Monat, 30 Tage Testphase	Von cmem.ai gehosteter Observer	Wer keinen Schlüssel einrichten möchte oder Cloud-Synchronisierung beziehungsweise mehrere Geräte braucht
B: `--provider claude`	Nein	Verbraucht das Kontingent des Claude-Abos	Anthropic	Wer bereits ein Claude-Abo hat
C: Nach Installation über B auf eigenen Schlüssel wechseln	Nein	Nutzungsbasierte Abrechnung durch den Anbieter	Dein konfigurierter Endpunkt, zum Beispiel APIYI apiyi.com	Wer Kosten kontrollieren möchte oder bereits API-Guthaben hat

Der Plugin-Marktplatz ist ein weiterer Einstiegspunkt und wird unten separat als Weg C‘ beschrieben. Für den dritten Weg musst du zunächst B wählen: openai-compatible ist kein möglicher Wert für --provider im Installer, sondern lässt sich erst nach der Installation manuell in den Einstellungen konfigurieren.

Weg A: CMEM Pro als Standard (Voreinstellung des claude-mem-Installers)

Führen Sie npx claude-mem install aus.
Was Sie sehen: Im ersten Schritt wählt der Installer erkannte Agents vor und installiert die Runtime. Im zweiten Schritt zeigt er einen Gerätecode im Format XXXX-XXXX an und öffnet den Browser für die OAuth-Autorisierung. Bleiben Sie bei der Anmeldung nicht hängen. Im dritten Schritt ist beim Memory-Provider CMEM Pro vorausgewählt. Nach der Auswahl öffnet sich die Checkout- oder Testseite.
Darauf sollten Sie bei den Bedingungen achten (auf der offiziellen Preisseite am 30.10.2026 geprüft):
Für die Testversion ist eine Kredit- oder Debitkarte erforderlich, eine Prepaid-Karte reicht nicht.
Die Abrechnung beginnt, sobald die Testphase endet oder das enthaltene Kontingent aufgebraucht ist – je nachdem, was zuerst eintritt.
Die Einstellung für automatische Upgrades kann das Abo von Pro auf Heavy (70 $/Monat) oder Max (100 $/Monat) hochstufen. Viele Anleitungen erwähnen nur „no card required“ und lassen diesen Schritt aus.
So erkennen Sie den Erfolg: Nach der Installation werden Version, Plugin dir, IDEs, Account, Cloud sync und Worker URL angezeigt. Prüfen Sie anschließend die fünf unten aufgeführten Punkte.

Weg B: `--provider claude` – claude-mem ohne monatliche Gebühr installieren

Führen Sie npx claude-mem install --provider claude aus.
Wenn Sie nur ein Memory-System behalten möchten, verwenden Sie stattdessen npx claude-mem install --provider claude --disable-auto-memory. Dieser Parameter setzt CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 und deaktiviert damit das native Auto-Memory von Claude Code.
Was Sie sehen: Skipping claude-mem login: --provider claude runs memory on your own Anthropic plan., Cloud sync: OFF (local), Auto-memory: left enabled (wenn Sie den Disable-Parameter nicht hinzugefügt haben). Der Installer fragt außerdem nach dem Observer-Modell: Wählen Sie Haiku, nicht Opus.
So erkennen Sie den Erfolg: Während der gesamten Installation erscheint weder eine cmem-Anmelde- noch eine Zahlungsseite, und npx claude-mem doctor zeigt überall ein Häkchen.

Im Quellcode sind nur die beiden Provider claude und host ohne Anmeldung nutzbar. In einem Test durch Dritte blieb --provider openrouter bei Waiting for OAuth login in the browser… stehen. Wenn Sie also einen Schlüssel eines Drittanbieters verwenden möchten, installieren Sie zuerst über Weg B und ändern danach die Konfiguration.

Weg C‘: Claude Code Plugin Marketplace

Geben Sie in Claude Code /plugin marketplace add thedotmack/claude-mem ein.
Geben Sie anschließend /plugin install claude-mem ein und starten Sie Claude Code neu.
Was Sie sehen werden: Während der ersten Sitzung wird der Launcher noch kompiliert. Daher sind möglicherweise noch keine Erinnerungen vorhanden. Um diese Lücke zu schließen, führen Sie einmalig npx claude-mem install --provider claude aus.
Verwenden Sie auf keinen Fall npm install -g claude-mem: Der Befehl installiert nur die SDK-Bibliothek, registriert keine Hooks und startet keinen Worker. Außerdem kann er den eigentlichen Launcher verdecken.

claude-mem nach der Installation prüfen: 5 Checks

Wichtig: Die erste Sitzung dient zum Sammeln von Informationen. Zu diesem Zeitpunkt gibt es noch keinen Verlauf, der als Kontext eingefügt werden könnte. Erinnerungen sehen Sie erst in der zweiten Sitzung. Wer schon in der ersten Sitzung erwartet, dass claude-mem sich an ihn erinnert, hält die Installation leicht für fehlgeschlagen.

#	Prüfpunkt	Befehl / Aktion	Erfolgskriterium
1	doctor	`npx claude-mem doctor`	Bun, uv, Plugin, Hook launcher, Worker, Claude Code version (2.1.139+) und Chroma sind alle mit ✓ markiert
2	status	`npx claude-mem status`	Der Worker ist funktionsfähig und die Portnummer wird angezeigt
3	viewer	`http://127.0.0.1:<PORT>/` im Browser öffnen; die Erinnerungen befinden sich unter `/viewer`	Die Seite lässt sich öffnen; nach einer Sitzung sind Einträge sichtbar
4	sqlite count	`sqlite3 ~/.claude-mem/claude-mem.db "select count(*) from observations;"`	Nach Ende der ersten Sitzung ist der Rückgabewert größer als 0
5	context inject	`curl "http://127.0.0.1:<PORT>/api/context/inject?project=<Projektname>"`	Der Rückgabewert enthält die Erinnerungen, die in die nächste Sitzung eingefügt werden

Den Port finden Sie in ~/.claude-mem/settings.json unter CLAUDE_MEM_WORKER_PORT. Sie können ihn auch mit curl http://127.0.0.1:<PORT>/api/health prüfen. In der doctor-Ausgabe macht die Zeile zum Hook Launcher am häufigsten Probleme. Wenn dort not on PATH oder is not the claude-mem hook launcher steht, beheben Sie das zuerst, bevor Sie die anderen Punkte prüfen.

📷 Platzhalter für einen Screenshot, bei der Bearbeitung ergänzen: Worker-Viewer-Seite (/viewer, mit der Liste der Beobachtungen)

Kosten von claude-mem: offiziell „96 % gespart“ versus „+4.226 Tokens“ in einem Drittanbietertest

Beide Zahlen können stimmen – sie beziehen sich nur auf unterschiedliche Dinge und lassen sich nicht direkt vergleichen.

Angabe des Projekts: Vier Observations benötigen rund 1.093 Tokens, die ursprünglichen Aufzeichnungen dagegen 26.447 Tokens. Daraus ergibt sich eine „Ersparnis von rund 96 %“. Die dreistufige MCP-Suche sei „etwa zehnmal sparsamer als die vollständige Injektion“. Das sind Schätzungen des Projektteams, keine unabhängige Prüfung.
Einzeltest eines Drittanbieters (ComputingForGeeks, 24.10.2026, claude-mem 15.0.2, Sonnet über OpenRouter): Bei derselben Anweisung „Reply with the single word ready“ wurden ohne claude-mem 28.489 Eingabe-Tokens verbraucht. Mit aktiviertem claude-mem waren es selbst bei leerem Speicher 32.715 Tokens – also 4.226 Tokens mehr (rund 14,8 %) und 0,010 US-Dollar höhere Kosten. Das war ein einzelner Test auf einem Rechner mit einem Projekt und lässt keinen direkten Schluss auf Ihre Rechnung zu.

Das Fazit vorweg: Die „Ersparnis“ bedeutet, dass die gespeicherten Erinnerungen kompakter sind als die ursprünglichen Aufzeichnungen. Das „Mehr“ bezeichnet den zusätzlichen festen Aufwand, der in jeder Sitzung anfällt. Je aktiver das Projekt und je mehr Einträge injiziert werden, desto größer ist dieser Aufwand. In den Issues #618 und #2469 aus dem ersten Halbjahr 2026 berichteten Nutzer, dass ihre Tokens schnell aufgebraucht waren. Diese Erfahrungen stammen aus älteren Versionen und beschreiben nicht zwangsläufig den Stand von 15.6.0. Sie zeigen aber: Speicher ist nie kostenlos.

5 Einstellungen zur Kostenkontrolle in claude-mem

CLAUDE_MEM_CONTEXT_OBSERVATIONS: Der Standardwert ist 50. Eine Senkung auf 10–20 reduziert direkt die Menge des eingefügten Kontexts.
CLAUDE_MEM_SEMANTIC_INJECT: Beim Standardwert false belassen. Ist die Option aktiviert, werden jeder Eingabeaufforderung relevante Erinnerungen hinzugefügt.
CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES: Beim Standardwert false belassen. Andernfalls werden Erinnerungen aller Hosts eingefügt.
CLAUDE_MEM_DISABLE_TOOL_HOOKS=1: Deaktiviert Observations auf Ebene einzelner Tool-Aufrufe und behält nur Zusammenfassungen auf Sitzungsebene. Das spart Tokens und Prozessaufwand.
CLAUDE_MEM_OPENAI_COMPAT_OBSERVATION_BATCH_SIZE: Der Standardwert ist 1. Erst wenn sich Ereignisse stauen, schrittweise erhöhen – nicht direkt auf 32 setzen.

Kostenvergleich der drei Optionen

Lösung	Abrechnung	Preis (US-Dollar)	Geeignet für
CMEM Pro	Abo	$30/Monat, 30 Tage Testphase (Heavy $70, Max $100)	Intensive Nutzung, Bedarf an Cloud-Synchronisierung
Claude-Abo	Verbrauch des Abo-Kontingents	Keine separate Abrechnung, konkurriert aber mit dem Programmieren um das Kontingent	Nutzer mit bestehendem Claude-Abo
APIYI `claude-haiku-5-5`	Nutzungsbasiert	Eingabe $0,1 / Ausgabe $0,5 / Cache-Lesezugriff $0,01 pro Million Tokens (pro Aufruf ≤100.000 Tokens; bei mehr als 100.000 Tokens Eingabe $0,5/1 Mio., gestaffelte Preise)	Nutzer mit geringer oder mittlerer Nutzung

Die Preisdaten stammen aus der Gesamtpreisliste von APIYI auf apiyi.com (Seite aktualisiert am 27.10.2026 um 14:50 Uhr UTC+8). Maßgeblich für Modelle und Preise ist die Modellliste der Plattform, für die tatsächliche Abrechnung die Konsole. Zum Vergleich: Auf derselben Plattform kostet claude-haiku-4-5-20251001 $1 für die Eingabe / $5 für die Ausgabe / $0,1 für Cache-Lesezugriffe, claude-sonnet-5-5 $2 / $10 / $0,1 und claude-opus-5-5 $4 / $20 / $0,2. Der Observer erledigt häufige, strukturierte Kleinaufgaben – dafür reicht ein Modell auf Haiku-Niveau aus. Nutzungsbasierte Abrechnung eignet sich für geringe und mittlere Nutzung; bei intensiver Nutzung lohnt es sich, den tatsächlichen Verbrauch einer Woche hochzurechnen und mit $30/Monat zu vergleichen.

Den Observer von claude-mem auf APIYI umstellen

Hier ist die vollständige Anleitung für Variante C. Sie eignet sich für Entwickler in China, die bereits API-Guthaben haben und kein separates Abo für die Speicherfunktion abschließen möchten. Bei APIYI lässt sich Guthaben in Renminbi aufladen; abgerechnet wird zu einem festen Wechselkurs von 1:7 (laut offizieller Preisseite).

Installiere claude-mem zunächst wie in Variante B: npx claude-mem install --provider claude.
Öffne ~/.claude-mem/settings.json und trage vier Schlüssel ein:
"CLAUDE_MEM_PROVIDER": "openai-compatible"
"CLAUDE_MEM_OPENAI_COMPAT_BASE_URL": "https://api.apiyi.com/v1"
"CLAUDE_MEM_OPENAI_COMPAT_MODEL": "claude-haiku-5-5"
"CLAUDE_MEM_OPENAI_COMPAT_API_KEY": "sk-dein-APIYI-Key"
Wenn du den API-Schlüssel nicht im Klartext in den Einstellungen speichern möchtest, kannst du ihn stattdessen in ~/.claude-mem/.env hinterlegen: OPENAI_COMPAT_API_KEY=sk-dein-APIYI-Key (Verzeichnisberechtigung 0700, Dateiberechtigung 0600).
Führe npx claude-mem restart aus. Die Zugangsdaten werden nur beim Start des Workers eingelesen – ohne Neustart wird die Änderung nicht wirksam.
So prüfst du, ob es funktioniert: npx claude-mem doctor zeigt openai-compatible als Provider an. Die nächste Observation aus einer neuen Sitzung erscheint im Viewer.

Zwei Stolperfallen solltest du vorher kennen. Erstens: Die Basis-URL muss /v1 enthalten und darf nicht mit einem Schrägstrich enden. Sonst entsteht ein doppelter Schrägstrich, der zu einem 404-Fehler führt. Die Unterschiede zwischen den drei Basis-URLs sind hier erklärt: help.apiyi.com/apiyi-base-url-v1-claude-gemini-endpoint-config-guide.html. Zweitens: Fehlt auch nur einer der vier Schlüssel, fällt claude-mem stillschweigend auf die Claude-Variante zurück. Nach außen sieht alles normal aus, die Kosten werden aber vom Abo abgezogen.

Praxistest der Schnittstelle (mit einem APIYI-Schlüssel am 30.10.2026 getestet):

GET /v1/models lieferte Status 200 und insgesamt 259 Modelle, darunter claude-haiku-5-5.
POST /v1/chat/completions mit claude-haiku-5-5 und response_format: {type: "json_object"} lieferte Status 200 und gültiges JSON. Die Anfrage dauerte rund 2,0 Sekunden und verbrauchte 59 Tokens.
Auch mit dem Feld reasoning: {enabled: false}, das claude-mem sendet, kam Status 200 zurück – kein 400-Fehler.
Der native Anthropic-Endpunkt /v1/messages lieferte ebenfalls Status 200.

Was der Test nicht belegt: Geprüft wurde nur, ob der APIYI-Endpunkt das von claude-mem benötigte Anfrageformat akzeptiert. Die vollständige Observation-Verarbeitung von claude-mem wurde lokal nicht durchgetestet. Ein erfolgreicher Schnittstellentest bedeutet also nicht, dass der gesamte Ablauf im Plugin verifiziert ist.

🚀 Tipp für den Einstieg: Erstelle zunächst in der APIYI-Konsole auf apiyi.com einen separaten API-Schlüssel nur für claude-mem. So kannst du nach einer Woche den Verbrauch dieses Schlüssels prüfen und beurteilen, ob die nutzungsbasierte Abrechnung günstiger ist als ein Abo. Wenn du auch Claude Code selbst anbinden möchtest, findest du hier eine Anleitung: help.apiyi.com/claude-code-apiyi-integration-tutorial.html.

Datenschutz bei claude-mem: Was lokal bleibt und was nach außen geht

Lokale Speicherung (alles unter ~/.claude-mem/, der Speicherort lässt sich mit CLAUDE_MEM_DATA_DIR ändern): claude-mem.db (Sessions, Beobachtungen, Zusammenfassungen, Eingabeaufforderungen), der Vektorindex chroma/, logs/, settings.json sowie das standardmäßig deaktivierte Screenshot-Verzeichnis media-v1/.

Diese Inhalte verlassen deinen Rechner:

Observer-Aufrufe: Inhalte von Tool-Aufrufen, Eingabeaufforderungen und Material für Zusammenfassungen werden an den von dir gewählten Anbieter gesendet. Bei Anthropic gehen sie an Anthropic, bei CMEM an cmem.ai und bei APIYI an APIYI.
Telemetrie ist standardmäßig aktiviert: Die Daten werden an PostHog gesendet. Dabei wird eine zufällige Installations-UUID verwendet; Fehlermeldungen werden bereinigt. Zum Deaktivieren führst du npx claude-mem telemetry disable aus oder setzt DO_NOT_TRACK=1. Am Ende der Installation wirst du ebenfalls danach gefragt.
Cloud-Synchronisierung muss aktiv eingeschaltet werden: Sie ist standardmäßig deaktiviert. Wenn du sie aktivierst, werden Beobachtungen, Sitzungszusammenfassungen und der vollständige Text der Eingabeaufforderungen auf cmem.ai hochgeladen.

Diese Kontrollmöglichkeiten hast du:

Inhalte, die du mit <private>...</private> umschließt, werden bereits auf Hook-Ebene entfernt und nicht in die Datenbank aufgenommen.
Die automatische Bereinigung sensibler Daten ist standardmäßig deaktiviert. Erst mit CLAUDE_MEM_REDACT_ENABLED=true werden 16 integrierte Muster für Schlüssel und andere sensible Daten aktiviert, darunter AWS, GitHub-PATs, OpenAI-/Anthropic-Schlüssel, JWT und PEM. Mit CLAUDE_MEM_REDACT_GENERIC_ENABLED=true kommen drei allgemeine Muster hinzu. Geh also nicht davon aus, dass sensible Daten automatisch für dich bereinigt werden.

Häufige Fehler bei claude-mem beheben

Symptom	Ursache	Lösung
Jeder Hook meldet `Executable not found in $PATH: "claude-mem"`	Der Launcher ist nicht im PATH	Mit `npx claude-mem install` neu installieren und Terminal, IDE und Claude Code neu starten
In der Sitzung erscheint `memory hooks are not active`	Der Launcher ist nicht aktiv	Wie oben vorgehen und anschließend mit `npx claude-mem doctor` die Zeile zum Hook-Launcher prüfen
Es wird nichts aufgezeichnet und keine Fehlermeldung angezeigt	Claude Code ist älter als Version 2.1.139	`claude update` ausführen
Der Befehl `claude-mem` wird von einem anderen Programm überschattet	Zuvor wurde `npm install -g claude-mem` ausgeführt	Mit `which -a claude-mem` suchen und anschließend `npm uninstall -g claude-mem` ausführen
Der Viewer lässt sich nicht öffnen	Der Port ist nicht 37700 oder der Worker läuft nicht	Den Port in den Einstellungen nachsehen und `curl http://127.0.0.1:<PORT>/health` ausführen
Der Port ist belegt	Ein anderer Prozess verwendet den Port	`export CLAUDE_MEM_WORKER_PORT=38000` setzen und den Worker neu starten
Benutzerdefinierter Endpunkt gibt 404 zurück	Die Basis-URL ist falsch	Für OpenAI-kompatible Endpunkte `/v1` verwenden, für native Anthropic-Endpunkte die Root-Domain; prüfen, ob die Modell-ID unter `/v1/models` aufgeführt ist
Trotz Schlüssel eines Drittanbieters wird weiterhin Claude verwendet	Die vier erforderlichen Einträge sind nicht vollständig gesetzt, sodass stillschweigend auf Claude zurückgegriffen wird	Die Einstellungen vervollständigen und `npx claude-mem restart` ausführen
Observation ist leer oder abgeschnitten	Ein kleines Modell hält die JSON-Struktur nicht ein oder stößt an das Ausgabelimit	`CLAUDE_MEM_OBSERVER_MAX_OUTPUT_TOKENS` erhöhen (Standard: 4096) oder ein zuverlässigeres Modell verwenden
Wiederholte Zeitüberschreitungen	Eine Streaming-Anfrage wird abgebrochen, wenn 90 Sekunden lang kein Token eintrifft	`CLAUDE_MEM_LLM_STREAM_IDLE_TIMEOUT_MS` erhöhen oder ein kleineres Modell verwenden
Der Hook beendet den Worker immer wieder	Plugin- und Worker-Version stimmen nicht überein (#3857, #3940; behoben)	`npx claude-mem update` und bei Bedarf `npx claude-mem@latest install` ausführen
Zwei Erinnerungssysteme stehen miteinander in Konflikt	Das native Auto-Memory und claude-mem laufen parallel	Bei der Neuinstallation `--disable-auto-memory` hinzufügen

Risiken von claude-mem und mögliche Kontosperrung

Bitte lies diesen Abschnitt vor der Installation vollständig durch.

Community-Projekt ohne offizielle Unterstützung: claude-mem ist ein Open-Source-Projekt der Community und kein offizielles Produkt von APIYI. APIYI unterstützt es nicht offiziell und bietet dafür kein SLA.
Daten werden extern übertragen: Inhalte aus Tool-Aufrufen werden an den von dir gewählten Observer gesendet. Aktiviere das Tool vorerst nicht in Repositories mit Schlüsseln, Kundendaten oder unveröffentlichtem Code.
Verbrauch von Kontingenten: Das Tool kann viele Tokens oder einen großen Teil deines Tarifkontingents verbrauchen. Teste es am besten zunächst eine Woche lang in einem kleinen Projekt und prüfe die Abrechnung, bevor du dich entscheidest.
Sicherheitskontrollen und Ratenbegrenzung: Häufig ausgelöste Hooks, gemeinsam genutzte Konten und Proxy-Schlüssel können Sicherheitskontrollen oder eine Ratenbegrenzung der Plattform auslösen. Teste das Tool am besten mit einem separaten Schlüssel, einem Zweitkonto und nur einem Projekt. Du trägst die Folgen selbst. Für APIYI bestätigt dieser Artikel lediglich, dass die Schnittstelle im Test funktioniert hat. Es gibt keine Garantie, dass keine Ratenbegrenzung erfolgt.
Reste nach der Deinstallation: Nach npx claude-mem uninstall bleibt ~/.claude-mem erhalten. Das Verzeichnis enthält die Datenbank und möglicherweise gespeicherte Schlüssel. Zum Entfernen musst du rm -rf ~/.claude-mem manuell ausführen. Außerdem belegen ~/.bun und ~/.cache/uv laut einem unabhängigen Test zusammen etwa 1,1 GB. Wenn keine anderen Projekte sie nutzen, kannst du auch diese Verzeichnisse löschen.

Häufige Fragen zu claude-mem (FAQ)

F1: Bedeutet die Zahl von 100.000 Sternen, dass claude-mem auf jeden Fall gut ist?

Nein. Die Zahl der Sterne zeigt nur, wie beliebt das Projekt ist. Token-Verbrauch, Datenschutzgrenzen und Versionsrhythmus sollten Sie selbst bewerten. Auch ob das Sternwachstum künstlich aufgebläht wurde, ist nicht unabhängig geprüft.

F2: Sind claude-mem und die integrierte Memory-Funktion von Claude Code dasselbe?

Nein. Die native Memory-Funktion nutzt MEMORY.md, während claude-mem eigene Hooks und eine Datenbank verwendet. Standardmässig laufen beide parallel. Wenn Sie nur eine Variante behalten möchten, fügen Sie bei der Installation `–disable-auto-memory` hinzu.

F3: Gibt es gleich nach der ersten Sitzung Erinnerungen?

Nein. In der ersten Sitzung werden Informationen gesammelt und komprimiert, erst in der zweiten werden sie in den Kontext eingefügt. Prüfen Sie das anhand von Abnahmepunkt 4 (sqlite count) und Punkt 5 (context inject).

F4: Kann ich claude-mem ohne hinterlegte Kreditkarte und ohne Abonnement nutzen?

Ja. Installieren Sie es mit `–provider claude`; dabei wird das Kontingent Ihres Claude-Tarifs genutzt. Alternativ können Sie nach der Installation für den Observer einen nutzungsbasiert abgerechneten API-Schlüssel von APIYI unter apiyi.com einrichten. Abgerechnet werden die tatsächlich verbrauchten Tokens. Neue Nutzer erhalten ausserdem ein kostenloses Testguthaben.

F5: Welches Modell eignet sich für den Observer?

Verwenden Sie ein Modell der Haiku-Klasse, zum Beispiel `claude-haiku-5-5`. Observations sind kleine, strukturierte Aufgaben, die häufig anfallen. Ein Spitzenmodell wie Opus wäre dafür teuer und würde womöglich einen grossen Teil des Ausgabebudgets für das Nachdenken verbrauchen.

F6: Kann ich ausschliesslich lokale Modelle verwenden?

Ja. Richten Sie `openai-compatible` auf Ollama, LM Studio oder vLLM. Ein kleines Modell muss allerdings zuverlässig die JSON-Struktur für Observations ausgeben können, sonst entstehen leere Einträge.

F7: Wie aktiviere ich Observations auf Chinesisch?

Setzen Sie in den Einstellungen `“CLAUDE_MEM_MODE“: „code–zh“` und starten Sie Claude Code neu. Der Modus ist integriert und muss nicht separat installiert werden.

claude-mem: Die wichtigsten Punkte

Funktionsweise: Hooks erfassen Tool-Aufrufe. Ein Observer komprimiert sie und speichert sie in SQLite. In der nächsten Sitzung werden sie als Kontext eingefügt.
Standardfalle: Der Installer von v15 wählt CMEM Pro vor. Für die Testphase ist eine Kreditkarte nötig, danach kostet es 30 US-Dollar pro Monat.
Ohne Monatsgebühr: Mit --provider claude installieren und anschließend bei Bedarf in den Einstellungen einen eigenen API-Schlüssel hinterlegen.
Kosten: Der Anbieter selbst spricht von „96 % Ersparnis“, ein unabhängiger Einzeltest von „+4.226 Tokens“. Die Angaben beruhen auf unterschiedlichen Messansätzen.
Datenschutz: Der Observer sendet Inhalte nach außen; Telemetrie ist standardmäßig aktiviert. Die Anonymisierung und die Cloud-Synchronisierung müssen manuell eingeschaltet werden.
Einstieg: Bei APIYI auf apiyi.com einen separaten API-Schlüssel erstellen und eine Woche lang claude-haiku-5-5 nutzungsabhängig abrechnen. Danach die Kosten prüfen.

Fazit: Sitzungsübergreifendes Gedächtnis mit claude-mem – für wen lohnt es sich?

Für diese 3 Gruppen lohnt sich die Installation:

Menschen, die dasselbe Projekt langfristig pflegen und Claude-Code-Sitzungen häufig schließen und neu öffnen.
Menschen, die oft Fragen beantworten müssen wie „Warum haben wir das damals geändert?“ oder „Wie wurde dieser Bug letztlich behoben?“
Menschen, die bereit sind, einmalig 10 Minuten in die Einrichtung zu investieren, und akzeptieren, dass der Observer die Inhalte von Tool-Aufrufen liest.

Für diese 3 Gruppen lohnt sie sich eher nicht:

Menschen, die nur einmalige Skripte ausführen und deren Projekte keine Kontinuität erfordern. CLAUDE.md und eigene Notizen sind günstiger.
Menschen, deren Code oder Daten den lokalen Rechner oder eine vorgeschriebene Compliance-Region nicht verlassen dürfen.
Nutzer von Rechnern mit sehr wenig Speicherplatz oder knappen CPU-Ressourcen sowie alle, die erwarten, dass Claude direkt nach der Installation „schlauer“ wird.

Wer claude-mem installieren möchte, geht am besten in dieser Reihenfolge vor: „Variante B → 5 Prüfpunkte → Anzahl der eingefügten Einträge reduzieren → bei Bedarf den Observer wechseln“. So lassen sich die meisten Fallstricke vermeiden. Wer die nutzungsabhängigen Kosten des Observers testen möchte, kann bei APIYI auf apiyi.com zunächst mit dem kostenlosen Guthaben ein kleines Projekt ausführen.

📚 Referenzen

claude-mem GitHub-Repository: Quellcode, Releases und Issues
Link: github.com/thedotmack/claude-mem
Inhalt: Sterne, Versionen und dokumentierte Issues wie #618, #2469, #3857 und #3940
Offizielle claude-mem-Dokumentation: Installation, Konfiguration und Fehlerbehebung
Link: docs.claude-mem.ai/installation
Inhalt: Systemanforderungen, Standardeinstellungen und Konfiguration eines OpenAI-kompatiblen Providers
CMEM-Preisseite: Bedingungen für CMEM Pro / Heavy / Max
Link: cmem.ai/pricing
Inhalt: 30-tägige Testphase, erforderliche Hinterlegung einer Kreditkarte und Beginn der Abrechnung (geprüft am 30.10.2026)
Unabhängiger Praxistest von ComputingForGeeks: Installation von Version 15.0.2 und Token-Overhead
Link: computingforgeeks.com/claude-mem-claude-code
Inhalt: Quelle für den Einzelmesswert von +4.226 Tokens (24.10.2026)
APIYI-Modelldokumentation: Modell- und Preisübersicht
Link: docs.apiyi.com/models
Inhalt: Maßgeblich für Modelle und Preise ist die Modellübersicht der Plattform

Autor: APIYI-Technikteam
Technischer Austausch: Bei Fragen zu Endpunkten oder Modellen während der Konfiguration kontaktieren Sie uns über die Startseite von APIYI. Weitere Hinweise zur Anbindung finden Sie im Dokumentationszentrum unter docs.apiyi.com.

Wie installiert man claude-mem mit 100.000 Sternen? In 3 Schritten ein Gedächtnis anbinden und Fallstricke der Testversion vermeiden