Semantica Claude Code 2026: Langzeitgedächtnis konfigurieren

Haben Sie schon einmal zwei Tage lang Architekturdetails mit Claude Code abgestimmt, das Terminal geschlossen und beim Neustart festgestellt, dass es wieder ein „fremdes KI" ohne jedes Projektwissen geworden ist? Jedes Mal Verzeichnisstruktur, Tech-Stack und Team-Konventionen neu erklären — das ist kein Modellproblem, sondern das Ergebnis eines nie gelösten Kontext-Persistenz-Problems.

Semantica ist ein 2026 speziell für Claude Code entwickeltes Langzeitgedächtnis-Framework. Es ermöglicht Claude Code, über mehrere Sessions hinweg Codebasis-Verständnis, Projektpräferenzen und Nutzergewohnheiten zu behalten. Dieser Leitfaden führt von „Was ist Semantica" bis „Wie konfiguriere ich es" — mit Fallstricken und Cloud Mac Empfehlungen.

1. Was ist Semantica

Semantica ist eine persistente Gedächtnis-Middleware für KI-Coding-Assistenten. Im Q1 2026 open-source veröffentlicht, gewann sie schnell in der Claude-Code-Community an Bedeutung. Statt auf das Kontextfenster zu vertrauen, pflegt Semantica eine strukturierte Gedächtnisdatenbank außerhalb des Modells und injiziert beim Sitzungsstart semantisch relevante Fragmente automatisch.

Architektur: Memory Store (Postgres+pgvector), Memory Manager (Schreiben, Deduplizierung, Merge, Ablauf), Retrieval Engine (semantische Suche und Prompt-Injektion).

2. Das Gedächtnisproblem von Claude Code

CLAUDE.md ist ein statischer Workaround — Vollständigladen, keine automatischen Updates, keine Personalisierung, Single-Node. Semantica löst alle vier Probleme: semantisches Retrieval, Auto-Write, Multi-User-Namespaces und Team-Gedächtnissync via gemeinsamem Memory Store.

3. Das Drei-Schichten-Modell

Kurzzeitgedächtnis: Aktuelles Sitzungs-Kontextfenster. Arbeitsgedächtnis: Temporärer Task-Kontext (task_context-Tabelle). Langzeitgedächtnis: Persistente Projektkenntnisse und Nutzerpräferenzen (Codebasis-Wissen, Architekturentscheidungen, Nutzereinstellungen, Bug-Historie, Task-Fortschritt).

4. Integration mit Claude Code

npm install -g @semantica/cli
cd /your/project && semantica init

Empfohlene Konfiguration (Postgres + pgvector):

docker run -d --name semantica-db \
  -e POSTGRES_PASSWORD=yourpassword \
  -e POSTGRES_DB=semantica \
  -p 5432:5432 pgvector/pgvector:pg16

Hooks in ~/.claude/settings.json eintragen:

{
  "hooks": {
    "PreToolUse": [{"matcher": ".*","hooks": [{"type": "command","command": "semantica inject --session-id $CLAUDE_SESSION_ID"}]}],
    "Stop": [{"hooks": [{"type": "command","command": "semantica consolidate --session-id $CLAUDE_SESSION_ID --auto-extract"}]}]
  }
}

5. Best Practices

1. Erinnerungen mit Tags versehen für bessere Retrieval-Präzision
2. Separate Namespaces pro Projekt verwenden
3. Regelmäßig Erinnerungen komprimieren (semantica compact)
4. Wichtige Architekturentscheidungen manuell per semantica add hinzufügen
5. max_tokens auf 1500–2000 begrenzen zum Schutz des Kontextfensters

6. Häufige Fallstricke

7. Semantica vs. Mem0 vs. Zep

8. Vorteile auf Cloud Mac

Vuncloud Cloud Mac läuft 24/7 — kein Memory-Store-Ausfall durch Shutdown. Mehrere Nodes teilen eine Postgres-Instanz für automatische Team-Gedächtnissynchronisation. Feste IP, einmal konfiguriert dauerhaft gültig. 1TB/2TB Zusatzspeicher entkoppelt die Datenbank von der Systemdisk.

FAQ

Unterschied Semantica vs. CLAUDE.md?

CLAUDE.md: statisch, vollständiges Laden jeder Session. Semantica: dynamisch, semantisch relevante Fragmente — effizienter und personalisierter. Beide können kombiniert werden.

Ist Semantica kostenlos?

Core SDK Open-Source und gratis. Self-Hosting mit Postgres/pgvector vollständig kostenlos.

Gehen Erinnerungen beim Neustart verloren?

Mit Semantica nicht — persistente Datenbank, automatische Injektion beim nächsten Start.

Fazit

Semantica löst Claude Codes „Amnesie" durch externe Persistenz, semantisches Retrieval und Hook-Integration ohne Codeänderungen. Empfehlung: Postgres + pgvector als Basis, Cloud Mac für optimale Persistenz im Team.

Framework-Versionen und APIs gemäß offizieller Semantica-Dokumentation. Letzte Aktualisierung: 11. August 2026.