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

Die install.md ist maschinenlesbar geschrieben: Sie weist den Agenten an, bestehende settings.json-Inhalte zu erhalten, bei vorhandener Konfiguration nachzufragen und das Setup am Ende zu verifizieren. Wer lieber selbst Hand anlegt: die manuellen Schritte stehen unten.

Schritt 1Konto anlegen & API-Key sichern

Registriere deine Organisation unter recallbase.de/signup (Einladungscode nötig – hier anfragen). 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:

⬇ recallbase-client.zip (28 KB)

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 4Hooks in Claude Code eintragen

Ergänze in ~/.claude/settings.json den hooks-Block (ersetze DEIN-BENUTZER durch deinen Benutzernamen bzw. nutze unter macOS/Linux /Users/… / /home/…):

{
  "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 }] }]
  }
}

Was die Hooks tun: SessionStart lädt Projekt-Historie und Wissen in den Kontext. Stop sichert nach jedem Arbeitsschritt Fortschritt und Transcript (Crash-sicher). SessionEnd schließt die Session sauber ab. Alle Hooks schlucken Fehler – Claude funktioniert auch, wenn die API mal nicht erreichbar ist.

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.

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?".

Empfohlen: Lade die Brain-Befehle für Claude herunter und speichere sie als ~/.claude/commands/brain.md. Dann kann Claude per /brain suchen, Sessions zusammenfassen und Wissen destillieren.

Befehls-Referenz

Befehl	Zweck
`init [name]`	Projekt anlegen und mit aktuellem Ordner verknüpfen
`search <begriffe>`	Volltextsuche im aktuellen Projekt (`--all` für alle, `--semantic` für Bedeutungssuche)
`sessions --count 50`	Session-Historie des Projekts anzeigen
`distill list / fetch / done`	Abgestürzte Sessions nachträglich zusammenfassen
`knowledge-add`	Dauerhaftes Wissen in den Graph schreiben
`version` / `update`	Client-Version anzeigen / aktualisieren

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.