Erste Schritte mit der Claude CLI und LocalWP – und wie Sie es von Anfang an richtig machen
Sönke Schäfer, Datenschäfer, SeSoft GmbH · März 2026
Warum KI-gestützte Plugin-Entwicklung?
Sie kennen das: Eine gute Idee für ein WordPress-Plugin, aber die Umsetzung dauert Wochen oder Monate. Mit Claude Code – der Kommandozeilen-Version von Anthropics KI-Assistent Claude – ändert sich das grundlegend. Statt Code Zeile für Zeile selbst zu schreiben, beschreiben Sie Ihr Ziel, und Claude Code setzt es um. Direkt in Ihrem Projektverzeichnis, direkt in Ihren Dateien.
Aber Vorsicht: Wer einfach drauflos promptet, verschenkt enormes Potenzial. Claude Code hat ein ausgeklügeltes Memory-System, das – einmal richtig eingerichtet – dafür sorgt, dass die KI Ihr Projekt versteht wie ein erfahrener Entwickler, der schon Monate im Team arbeitet.
Dieser Beitrag zeigt Ihnen Schritt für Schritt, wie Sie Claude Code mit LocalWP einrichten, das Memory-System optimal nutzen und von Anfang an eine Projektstruktur schaffen, die auch bei wachsender Komplexität funktioniert.
Was ist Claude Code?
Claude Code ist ein Kommandozeilen-Tool von Anthropic, das Sie direkt im Terminal starten. Anders als der Chat auf claude.ai arbeitet Claude Code direkt in Ihrem Dateisystem: Es liest Ihre Projektdateien, erstellt neue Dateien, führt Befehle aus und bearbeitet bestehenden Code – alles gesteuert durch natürliche Sprache.
Für die WordPress-Plugin-Entwicklung bedeutet das konkret:
- Dateien erstellen und bearbeiten: PHP-Klassen, JavaScript, CSS, SQL-Migrationen
- WP-CLI-Befehle ausführen: Plugins aktivieren, Datenbanken anlegen, Caches leeren
- Datenbank-Schema implementieren: CREATE TABLE Statements schreiben und ausführen
- Git-Operationen: Commits erstellen, Branches verwalten, Diffs anzeigen
Gut zu wissen: Claude Code startet jede Session ohne Erinnerung an die letzte. Das Memory-System (CLAUDE.md-Dateien) ist der Schlüssel, damit Claude Ihr Projekt trotzdem versteht. Dazu gleich mehr.
Die Entwicklungsumgebung: LocalWP + Claude Code
LocalWP installieren
LocalWP (localwp.com) ist die einfachste Möglichkeit, eine vollständige WordPress-Umgebung lokal zu betreiben. Erstellen Sie eine neue Site mit PHP 8.2+, MariaDB 10.6+ und dem Webserver Ihrer Wahl. Nach der Installation finden Sie Ihr Plugin-Verzeichnis unter einem Pfad wie:
~/Local Sites/sesoft/app/public/wp-content/plugins/
Claude Code installieren
Claude Code benötigt Node.js (Version 18+). Die Installation erfolgt über npm:
npm install -g @anthropic-ai/claude-code
# Danach im Plugin-Verzeichnis starten:
cd ~/Local\ Sites/sesoft/app/public/wp-content/plugins/mein-plugin
claude
Beim ersten Start werden Sie nach Ihrem API-Key gefragt. Diesen erhalten Sie unter console.anthropic.com.
⚠ Kosten im Blick behalten: Claude Code nutzt die Anthropic API und verbraucht Tokens. Für ein typisches Plugin-Projekt können Kosten von ca. 5–20 € pro aktivem Entwicklungstag entstehen. Setzen Sie unbedingt ein Budget-Limit in Ihrem Anthropic-Dashboard.
Erster Kontakt: Der /init-Befehl
Sobald Claude Code läuft, geben Sie /init ein. Dieser Befehl analysiert Ihr Projektverzeichnis und generiert eine erste CLAUDE.md-Datei mit erkanntem Tech-Stack und Konventionen. Das ist Ihr Startpunkt – nicht das Endergebnis. Löschen Sie, was offensichtlich ist, und ergänzen Sie projektspezifische Regeln.
Das Memory-System: So merkt sich Claude Ihr Projekt
Hier liegt der entscheidende Unterschied zwischen «es funktioniert irgendwie» und «es funktioniert richtig gut». Claude Code besitzt zwei Gedächtnissysteme, die zusammenarbeiten.
CLAUDE.md-Dateien: Ihr Projektgedächtnis
CLAUDE.md-Dateien sind einfache Markdown-Dateien, die Claude zu Beginn jeder Session automatisch liest. Sie funktionieren in einer dreistufigen Hierarchie:
| Ebene | Datei | Zweck |
|---|---|---|
| Global | ~/.claude/CLAUDE.md | Persönliche Präferenzen, gilt für alle Projekte |
| Projekt | ./CLAUDE.md | Projektübersicht, wird ins Git committed |
| Lokal | ./.claude/CLAUDE.md | Persönliche Notizen, wird gitignored |
Dazu kommt der Ordner .claude/rules/, in dem Sie thematisch getrennte Regel-Dateien ablegen. Jede .md-Datei darin wird automatisch geladen – ohne weitere Konfiguration. Optional können Sie Regeln sogar auf bestimmte Dateipfade beschränken.
Auto Memory: Claude lernt mit
Das zweite System ist Auto Memory. Claude notiert sich selbst Erkenntnisse aus Ihrer Zusammenarbeit: Build-Befehle, die funktioniert haben, Debugging-Lösungen, Code-Style-Präferenzen. Diese Notizen werden automatisch in künftigen Sessions geladen. Sie können sie jederzeit einsehen und bearbeiten:
# Im Claude Code Terminal:
/memory
Die 5 goldenen Regeln für CLAUDE.md-Dateien
Regel 1: Schlank halten – maximal 200 Zeilen
Jede Zeile in Ihrer CLAUDE.md verbraucht Tokens im Kontextfenster – dem begrenzten «Arbeitsspeicher» für die aktuelle Aufgabe. Je mehr davon für Hintergrundwissen draufgeht, desto weniger bleibt für die eigentliche Arbeit.
Faustregel: Wenn Sie es nicht in jeder einzelnen Session brauchen, gehört es nicht in die CLAUDE.md. Lagern Sie Details in einen docs/-Ordner aus und verweisen Sie bei Bedarf mit @docs/dateiname.md darauf.
Regel 2: Spezifisch statt generisch
Vage Anweisungen wie «Schreibe sauberen Code» sind verschwendete Tokens. Claude weiß bereits, was guter Code ist. Schreiben Sie konkrete, überprüfbare Regeln:
| ✗ Zu vage | ✓ Konkret und prüfbar |
|---|---|
| Halte dich an WP-Standards | Nutze $wpdb->prepare() für alle Queries |
| Schreibe gute Kommentare | PHPDoc-Blöcke für alle public-Methoden |
| Teste deinen Code | Führe phpcs --standard=WordPress aus |
Regel 3: Struktur durch Markdown
Claude versteht Markdown-Struktur hervorragend. Nutzen Sie Überschriften, Listen und Hervorhebungen. Gut strukturierte Dateien werden nachweislich zuverlässiger befolgt als Fließtext.
Regel 4: Referenzieren statt duplizieren
Haben Sie bereits eine README.md oder ein Architekturdokument? Verweisen Sie darauf statt den Inhalt zu kopieren. Claude liest referenzierte Dateien bei Bedarf selbst – mit @docs/architecture.md.
Regel 5: Regeln aufteilen mit .claude/rules/
Für größere Projekte legen Sie thematisch getrennte Dateien in .claude/rules/ ab. Jede wird automatisch geladen. Sie können Regeln sogar auf bestimmte Pfade einschränken:
# Datei: .claude/rules/api-integration.md
---
paths: includes/api/**/*.php
---
# API-Regeln
- Alle API-Calls über die zentrale Wrapper-Klasse
- Jeder API-Call wird als Note geloggt
- Rate-Limiting beachten
Praxis: Die optimale Projektstruktur
So strukturieren Sie ein WordPress-Plugin-Projekt für optimale Zusammenarbeit mit Claude Code:
mein-plugin/
├── CLAUDE.md # Projekt-Übersicht (50–80 Zeilen)
├── .claude/
│ ├── CLAUDE.md # Lokale Notizen (gitignored)
│ └── rules/
│ ├── wordpress.md # WP Coding Standards
│ ├── database.md # DB-Konventionen
│ └── api-integration.md # API-Regeln
├── docs/
│ ├── architecture.md # Detailliertes DB-Schema
│ ├── api-spec.md # API-Dokumentation
│ └── roadmap.md # [ ] Aufgaben mit Checkboxen
├── includes/
│ ├── class-plugin.php
│ ├── class-database.php
│ └── api/
├── assets/
├── templates/
└── mein-plugin.php # Plugin-Hauptdatei
Beispiel: Die Projekt-CLAUDE.md
# Mein CRM Plugin
B2B-CRM für den deutschen Markt. Verwaltet Firmendaten
mit Kontakten, Aufgaben und Notizen.
## Stack
- WordPress Plugin, PHP 8.2, MariaDB 10.6
- LocalWP als Entwicklungsumgebung
- Keine externen PHP-Abhängigkeiten
## Befehle
- Lint: phpcs --standard=WordPress includes/
- DB-Reset: wp db query < sql/schema.sql
- Aktivieren: wp plugin activate mein-crm
## Konventionen
- Deutsche Feldnamen (firma, strasse, telefon)
- Tabellenpräfix: {$wpdb->prefix}crm_
- Soft-Delete via deleted_at in allen Tabellen
- $wpdb->prepare() für alle Queries
- INT statt BIGINT für PKs (Access-ODBC)
## Dokumentation
- DB-Schema: @docs/architecture.md
- API-Specs: @docs/api-spec.md
- Roadmap: @docs/roadmap.md
Praxis-Tipp: Nutzen Sie Markdown-Checkboxen
[ ]in Ihrerdocs/roadmap.md. Claude Code kann diese für Sie abhaken, wenn ein Feature fertig ist. So behalten Sie den Überblick ohne separates Projektmanagement-Tool.
Die globale CLAUDE.md: Einmal schreiben, überall nutzen
Die Datei ~/.claude/CLAUDE.md gilt für alle Projekte. Hier definieren Sie Präferenzen, die sich nie ändern:
# Globale Präferenzen
## Umgebung
- Lokale WP-Entwicklung mit LocalWP
- MariaDB (nicht MySQL) beachten
- PHP 8.2 als Mindestversion
## Coding-Stil
- Deutsche Kommentare wo sinnvoll
- WordPress Coding Standards
- Immer $wpdb->prepare() verwenden
## Kommunikation
- Antworte auf Deutsch
- Erkläre Änderungen kurz vor Umsetzung
- Frage bei Unklarheiten nach
Diese 15–20 Zeilen sparen Ihnen in jedem neuen Plugin-Projekt das erneute Erklären Ihrer Grundpräferenzen.
Der empfohlene Entwicklungs-Workflow
Mit dem Memory-System und der richtigen Struktur sieht ein typischer Workflow so aus:
- Projekt planen: Erstellen Sie ein Konzeptdokument. Beschreiben Sie Datenbankstruktur, Features und Zielgruppe.
- Plugin-Verzeichnis anlegen: Erstellen Sie das Verzeichnis in LocalWP und starten Sie Claude Code mit
/init. - CLAUDE.md verfeinern: Bearbeiten Sie die generierte Datei. Entfernen Sie Offensichtliches, ergänzen Sie Ihr Konzept als Referenz.
- docs/-Ordner befüllen: Legen Sie Ihr Konzept als
docs/architecture.mdab. Erstellen Sie eine Roadmap mit Checkboxen. - Iterativ entwickeln: Arbeiten Sie Feature für Feature. Claude liest Ihre Roadmap und weiß, was ansteht.
- /clear zwischen Features: Starten Sie für jedes neue Feature eine frische Session. Claude lädt die CLAUDE.md automatisch neu.
⚠ /compact vs. /clear: Verwenden Sie
/clearfür neue Aufgaben – das gibt einen frischen Kontext./compactkomprimiert den bisherigen Verlauf und ist nur sinnvoll, wenn Sie an derselben Aufgabe weiterarbeiten, aber der Kontext zu groß wird.
Tipps für Fortgeschrittene
Sessions dokumentieren
Bevor Sie eine längere Session beenden, lassen Sie Claude eine Zusammenfassung schreiben: «Fasse den aktuellen Stand in docs/session-log.md zusammen.» So haben Sie beim nächsten Mal einen Anknüpfungspunkt.
ODBC-Kompatibilität dokumentieren
Wenn Sie wie viele KMU auch Microsoft Access für Datenauswertungen nutzen, dokumentieren Sie ODBC-Einschränkungen in Ihrer .claude/rules/database.md: INT statt BIGINT, keine UNSIGNED-Attribute, etc. So vermeidet Claude von vornherein Kompatibilitätsprobleme.
Kosten kontrollieren
Drei einfache Maßnahmen helfen, die API-Kosten im Griff zu behalten:
- Schlanke CLAUDE.md-Dateien = weniger Token-Verbrauch pro Session
/clearzwischen Aufgaben statt endlose Sessions weiterlaufen lassen- Detaillierte Dokumentation in
docs/statt in der CLAUDE.md vorhalten – wird nur bei Bedarf geladen
Checkliste: Plugin-Projekt in 10 Minuten startklar
- LocalWP-Site erstellen und Plugin-Verzeichnis anlegen
claudeim Plugin-Verzeichnis starten/initausführen – erste CLAUDE.md wird generiert- CLAUDE.md auf 50–80 Zeilen kürzen und verfeinern
.claude/rules/anlegen mitwordpress.mdunddatabase.mddocs/befüllen:architecture.md+roadmap.md- Globale
~/.claude/CLAUDE.mdanlegen oder prüfen (einmalig) - Erstes Feature aus der Roadmap umsetzen lassen – los geht’s!
Fazit
Claude Code ist kein magisches Tool, das auf Knopfdruck perfekte Plugins produziert. Aber mit der richtigen Vorbereitung – einer durchdachten CLAUDE.md, einer sauberen Projektstruktur und ausgelagerter Dokumentation – wird es zu einem außerordentlich leistungsfähigen Entwicklungspartner.
Der Schlüssel liegt darin, Claude Code so zu behandeln, wie Sie einen neuen Entwickler im Team behandeln würden: Geben Sie klare Regeln vor, stellen Sie die nötige Dokumentation bereit, und vertrauen Sie darauf, dass gute Instruktionen zu guten Ergebnissen führen.
Fragen zur Einrichtung oder zu konkreten Plugin-Projekten? Melden Sie sich gerne – als Datenschäfer helfe ich Ihnen, Ordnung in Ihre Daten zu bringen.
© 2026 sesoft.de · Alle Rechte vorbehalten.
