Claude Code

Voraussetzungen

Verwenden Sie Claude Code CLI (claude) in Ihrem lokalen Terminal. Laufzeiten und Voraussetzungen:

• Konkrete Schnittstelle: Claude Code CLI (claude).
• Laufzeitanforderung: Node.js-Version 22.22.0 oder höher für den eigenständigen Skill-Runner.
• Konto: Gültiges XMemo-Konto unter https://xmemo.dev.
• Alternative MCP-Voraussetzung: Unterstützung für Streamable HTTP-Transport mit Bearer-Token in der lokalen Umgebung.

Installation / Einrichtung

Der empfohlene Pfad installiert den eigenständigen XMemo-Skill über den vom Eigentümer ausgewählten Prompt in das Skills-Verzeichnis von Claude Code. Bitten Sie Ihren Agenten in Claude Code, die Installation auszuführen:

• Prompt: Install the standalone XMemo Skill into your skills directory: run the installer from https://xmemo.dev/skill/install (on Windows, https://xmemo.dev/skill/install.ps1) with XMEMO_SKILL_DIR set to your skills directory plus /xmemo-memory. Run the doctor command it prints to verify the installation, then reload your skills and follow the Skill's first-run steps. Follow your normal safety checks and do not use elevated privileges.
• Standardinstallationspfad: ~/.claude/skills/xmemo-memory.
• Alternativer Pfad: Registrieren Sie direktes Streamable HTTP MCP über claude mcp add oder .mcp.json mit https://xmemo.dev/mcp.

Anmeldedaten festlegen

Konfigurieren Sie vor dem Ausführen von Befehlen Ihren Pfad zur Speicherung von Anmeldedaten. Bevorzugen Sie das Festlegen von XMEMO_KEY über einen Secret-Store oder die lokale Shell-Umgebung. Wenn Sie interaktives Geräte-Login mit --allow-plaintext verwenden, beachten Sie, dass dieses Flag Anmeldedaten unverschlüsselt auf diesem Computer speichert:

export XMEMO_KEY='<your-xmemo-token>'
# Interactive alternative (stores credential unencrypted on this machine):
# node ~/.claude/skills/xmemo-memory/scripts/xmemo-skill.mjs login --allow-plaintext

XMEMO_AGENT_INSTANCE_ID generieren / bestätigen

Erzeugen Sie einen nicht-geheimen Wert pro lokaler Claude Code-Installation, speichern Sie ihn außerhalb von Git und verwenden Sie ihn über Sitzungen hinweg wieder, damit die Instanzzuordnung stabil bleibt.

export XMEMO_AGENT_INSTANCE_ID='<stable-local-instance-id>'
# Persist and reuse this value for the same local install

Bestehenden Konfigurationsblock beibehalten

Verwenden Sie für direkte MCP-Umgebungen den geprüften Claude Code-Konfigurationsblock. Behalten Sie die Variablenreferenz für Authorization bei; ersetzen Sie den Token-Platzhalter niemals durch ein echtes Geheimnis:

{
  "mcpServers": {
    "xmemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${XMEMO_KEY}"
      }
    }
  }
}

Client neu starten

Starten Sie Claude Code nach dem Ändern von Umgebungsvariablen, Konfigurationsdateien oder der Installation des Skills neu, damit alle Komponenten sauber in den Speicher geladen werden.

Mit einem echten Recall-Aufruf testen

Führen Sie die erste Anfrage schreibgeschützt aus, um die Konnektivität vor dem Schreiben von Daten zu überprüfen. Diese Prüfung ändert den Speicherzustand nicht.

recall({ query: "connection check", limit: 1 })

Erwartete Antwort (wörtliche Form)

Ein erfolgreicher Aufruf gibt die unten stehende öffentliche bewertete Textform zurück; Referenz und Inhalt sind echte Werte aus dem autorisierten Speicherbereich.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Erste nützliche Aufgabe: Synthetischer Speicherlebenszyklus

Überprüfen Sie Speicherpersistenz, zustandslosen Sitzungsübergang, quellenbezogenen Recall und Korrektur:

• 1. Synthetischen Fakt speichern: node scripts/xmemo-skill.mjs remember --content "Demo project timestamps use UTC." --path "projects/demo-onboarding/conventions" (oder MCP remember-Tool).
• 2. Zustandsloser Übergang: Öffnen Sie eine neue Claude Code-Terminal-Sitzung, um die Persistenz über Sitzungen hinweg zu überprüfen.
• 3. Recall mit Quellenzuordnung: node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" (oder MCP recall-Tool). Überprüfen Sie Reference und Location in der zurückgegebenen Ausgabe.
• 4. Speicher korrigieren: node scripts/xmemo-skill.mjs update --id <active-memory-id> --content "Demo project timestamps use UTC with ISO 8601 formatting." (oder MCP update_memory-Tool).
• 5. Optionale Bereinigung: node scripts/xmemo-skill.mjs forget --id <active-memory-id> --confirm (oder MCP forget-Tool).

Funktionen und Profil-Tools

Claude Code hat Zugriff auf profilqualifizierte Tools, die im MCP-Dokumentationsvertrag für claude-plugin- und claude-public-Profile definiert sind:

• Kern-Speicher-Tools: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
• Projekt- und Kontext-Tools: get_mcp_identity, get_project_context, project, todo, update_state.
• Sitzungskontinuität: create_restart_snapshot, restore_restart_snapshot, record_event, create_pending_decision, resolve_decision.

Einschränkungen und Grenzen

Betriebliche Grenzen und Einschränkungen für Claude Code:

• Arbeitsbereichsgrenze: Der Speicherzugriff ist strikt auf den Arbeitsbereich des autorisierten Benutzers beschränkt.
• Desktop-Trennung: Die Claude Code CLI-Konfiguration ist unabhängig von den Claude Desktop Cowork-Einstellungen.
• Claude auf claude.ai und Claude Desktop: Verbinden Sie sich über den benutzerdefinierten Connector mit OAuth; siehe [Claude (claude.ai)](/docs/mcp/claude).
• Umgang mit Geheimnissen: Übertragen Sie niemals Klartext-Tokens in Git und fügen Sie Geheimnisse nicht in eingecheckte Konfigurationsdateien ein.

Häufige Fehler

Beheben Sie häufige Verbindungs- und Autorisierungsprobleme mit diesen Schritten:

• 401 invalid_token — XMEMO_KEY fehlt, ist abgelaufen oder ungültig: Überprüfen Sie das Umgebungstoken oder führen Sie das Geräte-Login erneut aus.
• 403 insufficient_scope — Dem Token fehlt der Bereich memory:read oder memory:write: Stellen Sie ein Token mit den erforderlichen Berechtigungen aus.
• Falsches Installationsziel — Überprüfen Sie, ob XMEMO_SKILL_DIR auf ~/.claude/skills/xmemo-memory gesetzt war.
• Skill-Neuladen erforderlich — Beenden Sie Claude Code (/exit) und starten Sie es neu, um In-Memory-Skills neu zu laden.

Aktualisierung und Entfernung

Verfahren zum Aktualisieren oder Deinstallieren der Integration:

• Aktualisierung: Führen Sie den Installations-Prompt erneut aus, um das neueste Skill-Paket-Release abzurufen.
• Entfernung: Löschen Sie ~/.claude/skills/xmemo-memory oder führen Sie claude mcp remove xmemo aus, um die direkte MCP-Konfiguration zu entfernen.