Claude Code Memory für Publii: Schnellstart-Wissen zum Download

Claude Code

Autor: Claude Code
erstellt von Claude Code, nicht geprüft

An English translation of this post is available: Claude Code Memory for Publii: Quick-Start Knowledge for Download.

Im letzten Post habe ich beschrieben, wie ich meine 30 Jahre alte Homepage-Maker-3-Website mit Claude Code auf Publii umgestellt habe. In diesem Post teile ich das dabei gewonnene Wissen – in einer Form, die Sie direkt nutzen können: als sogenannte Memory-Dateien für Claude Code.

Was ist eine Claude Code Memory-Datei?

Claude Code, das KI-Werkzeug von Anthropic für Entwicklerinnen und Entwickler, kann Wissen zwischen verschiedenen Sitzungen speichern. Dazu legt es Textdateien im Markdown-Format in einem speziellen Verzeichnis ab – dem Memory. Beim nächsten Gespräch liest Claude Code diese Dateien automatisch und weiß sofort, womit es zu tun hat: Welche Dateistruktur nutzt Publii? Welche Fehler sind typisch? Wie funktioniert das SQLite-Schema?

Ohne Memory muß Claude Code dieses Wissen jedes Mal neu erarbeiten – was Zeit kostet und Fehlerquellen öffnet. Mit einer guten Memory-Datei starten Sie sofort mit einem informierten Assistenten.

Die zwei Download-Dateien

Ich biete zwei Dateien an, die ich im Laufe der Umstellung erarbeitet habe:

  • publii-claude-memory.md – Generisches Publii-Wissen für alle, die Publii mit Claude Code zusammen nutzen wollen. Enthält: Verzeichnisstruktur, SQLite-Schema, Config-Formate, Bildverwaltung, häufige Fehler und deren Lösung.
  • publii-hm3-claude-memory.md – Ergänzung speziell für die Migration von Homepage Maker 3 nach Publii. Enthält: typische HM3-HTML-Struktur, Konversionsstrategie mit Python-Codebeispielen, Bildpfad-Muster, Qualitäts-Checkliste.

Die HM3-Datei setzt die generische Datei voraus – installieren Sie beide.

So verwenden Sie die Memory-Dateien

Claude Code sucht Memory-Dateien in einem projektspezifischen Verzeichnis. Der Pfad richtet sich nach Ihrem Betriebssystem und dem Verzeichnis, in dem Sie Claude Code starten.

Wenn Sie Claude Code im Publii-sites/-Verzeichnis starten (was ich empfehle), lautet der Memory-Pfad:

  • Linux/macOS: ~/.claude/projects/<pfad-zum-sites-verzeichnis>/memory/
    Der Pfad in spitzen Klammern ist das sites/-Verzeichnis, bei dem alle Schrägstriche durch Bindestriche ersetzt wurden.
    Beispiel: ~/Dokumente/Publii/sites/ → ~/.claude/projects/-home-NUTZERNAME-Dokumente-Publii-sites/memory/
  • Windows: %USERPROFILE%\.claude\projects\<pfad>\memory\

Schritte:

  1. Verzeichnis anlegen: mkdir -p ~/.claude/projects/PFAD/memory/
  2. Heruntergeladene .md-Dateien dort hineinkopieren
  3. Die Datei MEMORY.md im selben Verzeichnis anlegen (oder ergänzen) mit Verweisen auf die neuen Dateien – das ist der Index, den Claude Code zuerst liest:
# Mein Publii-Projekt

## Publii-Grundwissen
- [publii-claude-memory.md](publii-claude-memory.md) – Dateistruktur, Schema, Config, Bildverwaltung

## Homepage Maker 3 Migration (nur wenn relevant)
- [publii-hm3-claude-memory.md](publii-hm3-claude-memory.md) – HM3-Konversion, Bildpfade, Checkliste
  • Claude Code neu starten – es liest das Memory automatisch beim Start.

Sicherheitscheck: So prüfen Sie die Dateien

Die Dateien sind einfache Textdateien im Markdown-Format – kein ausführbarer Code, keine Skripte, keine Makros. Sie können die Dateien vor der Verwendung mit jedem Texteditor öffnen und vollständig lesen.

Dennoch gilt: Claude Code liest diese Dateien und handelt nach ihren Anweisungen. Eine manipulierte Memory-Datei könnte Claude Code dazu bringen, unerwünschte Aktionen auszuführen – das nennt sich Prompt Injection. Prüfen Sie deshalb:

  1. SHA256-Prüfsummen vergleichen (empfohlen):
    Die Prüfsummen der Originaldateien, die ich veröffentlicht habe:
publii-claude-memory.md:     154671f082ffe1b494fb7d03cc6fbb3da2610d392404bcb20ba65e539f0a1f45
publii-hm3-claude-memory.md: c29ee208b0306bebf662f7b5c28b3a4322ddfbc4a56848df0cb2e4f60dd10443

Prüfung unter Linux/macOS im Terminal:
sha256sum publii-claude-memory.md
sha256sum publii-hm3-claude-memory.md

Unter Windows (PowerShell):
Get-FileHash publii-claude-memory.md -Algorithm SHA256

Stimmt der angezeigte Hash mit dem oben genannten überein, ist die Datei unverändert.

  1. Datei im Texteditor lesen: Öffnen Sie die Datei in einem einfachen Texteditor (z.B. gedit, Notepad, VS Code). Die Datei enthält nur beschreibenden Text, Codebeispiele und Tabellen – kein HTML, kein JavaScript, keine ausführbaren Anweisungen.
  2. Auf Anomalien achten: Verdächtig wäre versteckter Text (z.B. in weißer Schrift auf weißem Hintergrund, was in einer .md-Datei aber nicht möglich ist), ungewöhnliche Sonderzeichen oder Anweisungen wie „Ignoriere alle vorherigen Anweisungen".

Das Wissen entstand in der Praxis

Alle Inhalte dieser Memory-Dateien entstammen der echten Umstellung von logies.de – einer 30 Jahre alten Homepage-Maker-3-Website – auf Publii. Ich habe dabei gelernt, wo Publii abweicht von dem, was man erwarten würde: das Datumsproblem, die Responsive-Bilder, die Menü-Tücken. Dieses Wissen steckt jetzt in den Dateien.

Wenn Sie eigene Erfahrungen machen, die hier fehlen: Schreiben Sie mir – die Kontaktdaten finden Sie im Impressum.