Skip to content

README.de.md

Latest commit

 

History

History
431 lines (316 loc) · 18.2 KB

README.de.md

File metadata and controls

431 lines (316 loc) · 18.2 KB
Raw

🌐 Dies ist eine automatisierte Übersetzung. Korrekturen aus der Community sind willkommen!


Claude-Mem
Vercel OSS Program

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

Persistentes Speicherkomprimierungssystem, entwickelt für Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Schnellstart • Wie es funktioniert • Suchwerkzeuge • Dokumentation • Konfiguration • Fehlerbehebung • Lizenz

Claude-Mem bewahrt nahtlos Kontext über Sitzungen hinweg, indem es automatisch Beobachtungen zur Tool-Nutzung erfasst, semantische Zusammenfassungen generiert und diese für zukünftige Sitzungen verfügbar macht. Dies ermöglicht es Claude, die Kontinuität des Wissens über Projekte aufrechtzuerhalten, auch nachdem Sitzungen beendet wurden oder die Verbindung wiederhergestellt wird.

Schnellstart

Installation mit einem einzigen Befehl:

npx claude-mem install

Oder Installation für OpenCode:

npx claude-mem install --ide opencode

Oder Installation für Antigravity CLI (Einrichtungsanleitung):

npx claude-mem install --ide antigravity

Oder Installation über den Plugin-Marketplace innerhalb von Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Starten Sie Claude Code neu. Kontext aus vorherigen Sitzungen wird automatisch in neuen Sitzungen angezeigt.

Hinweis: Claude-Mem ist auch auf npm veröffentlicht, aber npm install -g claude-mem installiert nur das SDK/die Bibliothek — es registriert weder die Plugin-Hooks noch richtet es den Worker-Dienst ein. Installieren Sie immer über npx claude-mem install oder die oben genannten /plugin-Befehle.

🦞 OpenClaw Gateway

Installieren Sie claude-mem als persistentes Speicher-Plugin auf OpenClaw-Gateways mit einem einzigen Befehl:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Der Installer übernimmt Abhängigkeiten, Plugin-Einrichtung, KI-Anbieter-Konfiguration, Worker-Start und optionale Echtzeit-Beobachtungs-Feeds zu Telegram, Discord, Slack und mehr. Details finden Sie im OpenClaw-Integrationsleitfaden.

Hauptmerkmale:

  • 🧠 Persistenter Speicher - Kontext bleibt über Sitzungen hinweg erhalten
  • 📊 Progressive Offenlegung - Schichtweiser Speicherabruf mit Sichtbarkeit der Token-Kosten
  • 🔍 Skill-basierte Suche - Durchsuchen Sie Ihre Projekthistorie mit dem mem-search Skill
  • 🖥️ Web-Viewer-UI - Echtzeit-Speicherstream unter der beim Start ausgegebenen Worker-URL
  • 💻 Claude Desktop Skill - Durchsuchen Sie den Speicher aus Claude Desktop-Konversationen
  • 🔒 Datenschutzkontrolle - Verwenden Sie <private>-Tags, um sensible Inhalte von der Speicherung auszuschließen
  • ⚙️ Kontextkonfiguration - Feinkörnige Kontrolle darüber, welcher Kontext eingefügt wird
  • 🤖 Automatischer Betrieb - Keine manuelle Intervention erforderlich
  • 🔗 Zitate - Referenzieren Sie vergangene Beobachtungen mit IDs über die Worker-API oder sehen Sie alle im Web-Viewer

Dokumentation

📚 Vollständige Dokumentation anzeigen - Auf der offiziellen Website durchsuchen

Erste Schritte

Best Practices

Architektur

Konfiguration & Entwicklung

Wie es funktioniert

Kernkomponenten:

  1. 5 Lifecycle-Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 Hook-Skripte)
  2. Smart Install - Gecachter Abhängigkeitsprüfer (Pre-Hook-Skript, kein Lifecycle-Hook)
  3. Worker Service - Lokale HTTP-API mit Web-Viewer-UI und Such-Endpunkten, verwaltet von Bun
  4. SQLite-Datenbank - Speichert Sitzungen, Beobachtungen, Zusammenfassungen
  5. mem-search Skill - Natürlichsprachliche Abfragen mit progressiver Offenlegung
  6. Chroma-Vektordatenbank - Hybride semantische + Stichwortsuche für intelligenten Kontextabruf

Siehe Architekturübersicht für Details.

MCP-Suchwerkzeuge

Claude-Mem bietet intelligente Speichersuche durch 4 MCP-Tools nach einem token-effizienten 3-Schichten-Workflow-Muster:

Der 3-Schichten-Workflow:

  1. search - Kompakten Index mit IDs abrufen (~50-100 Token/Ergebnis)
  2. timeline - Chronologischen Kontext um interessante Ergebnisse herum abrufen
  3. get_observations - Vollständige Details NUR für gefilterte IDs abrufen (~500-1.000 Token/Ergebnis)

Funktionsweise:

  • Claude nutzt MCP-Tools, um Ihren Speicher zu durchsuchen
  • Beginnen Sie mit search, um einen Index der Ergebnisse zu erhalten
  • Verwenden Sie timeline, um zu sehen, was um bestimmte Beobachtungen herum geschah
  • Verwenden Sie get_observations, um vollständige Details für relevante IDs abzurufen
  • ~10-fache Token-Ersparnis durch Filtern vor dem Abrufen der Details

Verfügbare MCP-Tools:

  1. search - Speicherindex mit Volltextabfragen durchsuchen, gefiltert nach Typ/Datum/Projekt
  2. timeline - Chronologischen Kontext um eine bestimmte Beobachtung oder Abfrage herum abrufen
  3. get_observations - Vollständige Beobachtungsdetails anhand von IDs abrufen (immer mehrere IDs gebündelt abrufen)

Beispielverwendung:

// Schritt 1: Nach Index suchen
search(query="authentication bug", type="bugfix", limit=10)

// Schritt 2: Index überprüfen, relevante IDs identifizieren (z. B. #123, #456)

// Schritt 3: Vollständige Details abrufen
get_observations(ids=[123, 456])

Siehe Suchwerkzeuge-Anleitung für detaillierte Beispiele.

Release-Branches

Stabile Releases werden von main ausgeliefert und auf npm veröffentlicht. core-dev und community-edge sind aus dem Quellcode betriebene Branches für frühe Zuverlässigkeitskorrekturen und Community-Integrationen. Siehe Release-Branches für den Branch-Ablauf und Anweisungen zum Ausführen der nicht-stabilen Versionen.

Systemanforderungen

  • Node.js: 20.0.0 oder höher
  • Claude Code: Neueste Version mit Plugin-Unterstützung
  • Bun: JavaScript-Laufzeitumgebung und Prozessmanager (wird automatisch installiert, falls fehlend)
  • uv: Python-Paketmanager für Vektorsuche (wird automatisch installiert, falls fehlend)
  • SQLite 3: Für persistente Speicherung (enthalten)

Hinweise zur Einrichtung unter Windows

Wenn folgender Fehler angezeigt wird:

npm : The term 'npm' is not recognized as the name of a cmdlet

Stellen Sie sicher, dass Node.js und npm installiert und zu Ihrem PATH hinzugefügt wurden. Laden Sie den neuesten Node.js-Installer von https://nodejs.org herunter und starten Sie Ihr Terminal nach der Installation neu.

Konfiguration

Einstellungen werden in ~/.claude-mem/settings.json verwaltet (wird beim ersten Start automatisch mit Standardwerten erstellt). Konfigurieren Sie KI-Modell, Worker-Port, Datenverzeichnis, Log-Level und Kontext-Injektionseinstellungen.

Siehe die Konfigurationsanleitung für alle verfügbaren Einstellungen und Beispiele.

Modus- & Sprachkonfiguration

Claude-Mem unterstützt mehrere Workflow-Modi und Sprachen über die Einstellung CLAUDE_MEM_MODE.

Diese Option steuert sowohl:

  • Das Workflow-Verhalten (z. B. code, chill, investigation)
  • Die Sprache, die in generierten Beobachtungen verwendet wird

Konfiguration

Bearbeiten Sie Ihre Einstellungsdatei unter ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Modi sind in plugin/modes/ definiert. Um alle lokal verfügbaren Modi anzuzeigen:

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

Verfügbare Modi

Modus Beschreibung
code Standardmodus (Englisch)
code--zh Modus für vereinfachtes Chinesisch
code--ja Modus für Japanisch

Sprachspezifische Modi folgen dem Muster code--[lang], wobei [lang] der ISO-639-1-Sprachcode ist (z. B. zh für Chinesisch, ja für Japanisch, es für Spanisch).

Hinweis: code--zh (vereinfachtes Chinesisch) ist bereits integriert — es ist keine zusätzliche Installation oder Plugin-Aktualisierung erforderlich.

Nach der Änderung des Modus

Starten Sie Claude Code neu, um die neue Moduskonfiguration anzuwenden.

Entwicklung

Siehe die Entwicklungsanleitung für Build-Anweisungen, Tests und Beitrags-Workflow.

Fehlerbehebung

Wenn Sie Probleme haben, beschreiben Sie das Problem Claude, und der troubleshoot Skill wird automatisch diagnostizieren und Lösungen bereitstellen.

Siehe die Fehlerbehebungsanleitung für häufige Probleme und Lösungen.

Fehlerberichte

Erstellen Sie umfassende Fehlerberichte mit dem automatisierten Generator:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

Mitwirken

Beiträge sind willkommen! Bitte:

  1. Forken Sie das Repository
  2. Erstellen Sie einen Feature-Branch
  3. Nehmen Sie Ihre Änderungen mit Tests vor
  4. Aktualisieren Sie die Dokumentation
  5. Reichen Sie einen Pull Request ein

Claude-Mem wird aus drei Branches ausgeliefert: main (stabil), core-dev und community-edge. Nur main wird auf npm veröffentlicht; die anderen werden aus dem Quellcode ausgeführt. Siehe Release-Branches für die Strategie und Anweisungen zur lokalen Ausführung.

Siehe Entwicklungsanleitung für den Beitrags-Workflow.

Lizenz

Claude-Mem ist unter der Apache License 2.0 lizenziert.

Wir haben uns für Apache-2.0 entschieden, weil dauerhafter agentenbasierter Speicher leicht in Entwicklertools, lokale Agenten, MCP-Server, Unternehmenssysteme, Robotik-Stacks und produktive Agenten-Harnesses eingebettet werden können sollte.

Siehe die Datei LICENSE für vollständige Details. Siehe docs/license.md und docs/ip-boundary.md für den Lizenzumfang und die Grenze zwischen offen und kommerziell.

Hinweis zu Ragtime: Das Verzeichnis ragtime/ ist unter der Apache License 2.0 lizenziert. Siehe ragtime/LICENSE für Details.

Support

Erstellt mit Claude Agent SDK | Funktioniert mit Claude Code | Gemacht mit TypeScript

Was ist mit CMEM?

CMEM ist ein Token, der von einem Drittanbieter erstellt, aber offiziell vom Schöpfer von Claude-Mem (Alex Newman, @thedotmack) unterstützt wird. Der Token dient als Community-Katalysator für Wachstum und als Vehikel, um CMEM zu den Entwicklern und Wissensarbeitern zu bringen, die ihn am dringendsten benötigen.

Offizielle BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3