In 10 Minuten zum Gedächtnis

Diese Anleitung führt dich von null zum ersten Projekt, an das sich dein Claude-Code-Agent dauerhaft erinnert.

Voraussetzungen: Node.js 18+ · Claude Code · ein Recallbase-Konto

Der schnellste WegEin Prompt – Claude erledigt den Rest

Du hast Claude Code schon? Füge deinen API-Key ein, kopiere den fertigen Prompt in eine Claude-Session – der Agent installiert Client, Konfiguration und Hooks selbst und verifiziert das Setup:

Richte Recallbase (persistentes Gedächtnis für Claude Code) auf diesem Rechner ein.
Lade https://recallbase.de/install.md und folge den Anweisungen dort exakt.
Mein API-Key: brain_DEIN_KEY

Schritt 1Konto anlegen & API-Key sichern

Registriere deine Organisation kostenlos unter recallbase.de/signup. Am Ende bekommst du deinen API-Key einmalig angezeigt – speichere ihn im Passwort-Manager. Weitere Keys (einer pro Rechner) erstellst du jederzeit im Konto.

Schritt 2Client installieren

Lade den Recallbase-Client und entpacke ihn in dein Claude-Verzeichnis:

Windows (PowerShell)

Expand-Archive recallbase-client.zip "$env:USERPROFILE\.claude\brain-helper\dist" -Force

macOS / Linux

mkdir -p ~/.claude/brain-helper/dist
unzip recallbase-client.zip -d ~/.claude/brain-helper/dist

Schritt 3Konfiguration anlegen

Erstelle die Datei ~/.claude/brain-config.json (Windows: %USERPROFILE%\.claude\brain-config.json):

{
  "apiUrl": "https://api.recallbase.de/api",
  "apiKey": "brain_DEIN_KEY",
  "clientName": "MEIN-RECHNER"
}

clientName ist frei wählbar und unterscheidet deine Rechner (z.B. LAPTOP, BUERO-PC).

Schritt 4Agenten verbinden – ein Befehl

Der Client trägt alles selbst ein – manuelles Editieren von Config-Dateien entfällt:

macOS / Linux

node ~/.claude/brain-helper/dist/index.js setup

Windows (PowerShell)

node "$env:USERPROFILE\.claude\brain-helper\dist\index.js" setup

setup registriert die drei Claude-Code-Hooks in ~/.claude/settings.json (bestehende Hooks bleiben erhalten) und trägt zusätzlich den MCP-Server recallbase bei allen erkannten anderen Agenten ein – Codex CLI, Gemini CLI und OpenCode, sofern deren Config existiert. Der Befehl ist idempotent: mehrfach ausführen schadet nicht.

{
  "hooks": {
    "SessionStart": [{ "hooks": [{ "type": "command",
      "command": "node \"C:\\Users\\DEIN-BENUTZER\\.claude\\brain-helper\\dist\\index.js\" session-start",
      "timeout": 15 }] }],
    "Stop": [{ "hooks": [{ "type": "command",
      "command": "node \"C:\\Users\\DEIN-BENUTZER\\.claude\\brain-helper\\dist\\index.js\" turn-end",
      "timeout": 10 }] }],
    "SessionEnd": [{ "hooks": [{ "type": "command",
      "command": "node \"C:\\Users\\DEIN-BENUTZER\\.claude\\brain-helper\\dist\\index.js\" session-end",
      "timeout": 10 }] }]
  }
}

Schritt 5Erstes Projekt verbinden

Wechsle in deinen Projektordner und führe einmalig aus:

cd mein-projekt
node ~/.claude/brain-helper/dist/index.js init

Das legt das Projekt in Recallbase an und verknüpft es mit dem Ordner. Optional mit eigenem Namen: init Mein Projektname. Falls Schritt 4 übersprungen wurde: init trägt die Claude-Code-Hooks automatisch nach.

Schritt 6Loslegen

Starte Claude Code im Projektordner. Du siehst beim Start einen <brain-context>-Block – dein Agent kennt ab jetzt Historie, letzte Entscheidungen und bestätigtes Wissen. Ab der zweiten Session merkst du den Unterschied: kein Briefing, kein „wo waren wir?".

Andere AgentenCodex, Gemini CLI, OpenCode, Cursor …

Recallbase spricht MCP (Model Context Protocol) – damit funktioniert das Gedächtnis mit jedem MCP-fähigen Agenten, nicht nur mit Claude Code. Schritte 1–3 und 5 sind identisch (Konto, Client, Config, init). Der setup-Befehl aus Schritt 4 registriert den MCP-Server automatisch bei allen erkannten Agenten (Codex: ~/.codex/config.toml, Gemini: ~/.gemini/settings.json, OpenCode: opencode.json im Projektordner – setup dort ausführen). Wer manuell eintragen will:

Codex CLI (~/.codex/config.toml)

[mcp_servers.recallbase]
command = "node"
args = ["/PFAD/ZU/.claude/brain-helper/dist/index.js", "mcp"]

Gemini CLI (~/.gemini/settings.json)

{ "mcpServers": { "recallbase": {
    "command": "node",
    "args": ["/PFAD/ZU/.claude/brain-helper/dist/index.js", "mcp"] } } }

OpenCode (opencode.json)

{ "mcp": { "recallbase": {
    "type": "local",
    "command": ["node", "/PFAD/ZU/.claude/brain-helper/dist/index.js", "mcp"] } } }

Claude Code (Alternative zu den Hooks)

claude mcp add recallbase -- node ~/.claude/brain-helper/dist/index.js mcp

Der Server stellt vier Tools bereit: memory_context (Gedächtnis laden), memory_search (Volltext + semantisch), memory_save_session, memory_add_knowledge. Damit dein Agent sie automatisch nutzt, ergänze in seiner Instruktionsdatei (AGENTS.md / GEMINI.md):

## Gedächtnis (Recallbase)
Rufe zu Beginn jeder Session das Tool memory_context auf und wende den
Kontext an. Speichere am Ende eine strukturierte Zusammenfassung über
memory_save_session. Bei "hatten wir das schonmal?": memory_search nutzen.

Befehls-Referenz

Fehlerbehebung

• Kein <brain-context> beim Start: Log prüfen unter ~/.claude/brain-helper/log.txt. Häufigste Ursache: Pfad in settings.json stimmt nicht.
• 401 im Log: API-Key falsch oder gelöscht – neuen Key im Konto erzeugen.
• „Kein Projekt für dieses Verzeichnis": init im Projektordner ausführen (Schritt 5).
• „Read-Only – Projekt gesperrt": Ein Teammitglied arbeitet gerade im selben Projekt. Der Lock löst sich automatisch, wenn dessen Session endet.

Team einladen

Im Konto erstellst du Einladungscodes (Pro-Plan). Neue Mitglieder treten über recallbase.de/join bei, richten Client + Hooks nach dieser Anleitung ein – und sehen sofort die gemeinsamen Projekte. Jedes Mitglied erhöht dein Abo automatisch um 19 €/Monat.