Migration von Drupal zu TYPO3: Eine Schritt-für-Schritt-Anleitung
Development
Claude Code bringt agentisches KI-Coding in die TYPO3 Entwicklung. Dieser Leitfaden zeigt Ihnen, wie Sie Ihre TYPO3 Expertise mit KI-Unterstützung kombinieren können, um Erweiterungen schneller zu erstellen und dabei die Codequalität und die architektonische Integrität zu wahren.
Die Entwicklung von TYPO3 extension erfordert tiefes Wissen über Extbase, Fluid, TCA Konfigurationen und TypoScript. Claude Code ersetzt dieses Fachwissen nicht, sondern verstärkt es. Betrachten Sie Claude Code als einen hochqualifizierten Assistenten, der sich um Boilerplate-Code kümmert, Kodierungsstandards einhält und sich wiederholende Aufgaben beschleunigt, während Sie sich auf Architektur und Geschäftslogik konzentrieren.
Die Realität ist einfach: KI + Ihr TYPO3-Wissen = Bessere Produktivität. Claude Code glänzt bei der Strukturierung und Musterimplementierung, aber Sie müssen immer noch verstehen, was Sie bauen, Ausgaben validieren und architektonische Entscheidungen treffen. Dieser Leitfaden zeigt Ihnen, wie Sie beides effektiv nutzen können.
Claude Code verstehen
Was ist Claude Code?
Claude Code ist das agentische Befehlszeilen-Codierungstool von Anthropic aus der Claude 4 Modellfamilie. Im Gegensatz zu Autovervollständigungstools arbeitet es autonom über Ihren gesamten Codebestand, plant und führt Änderungen an mehreren Dateien aus und integriert sich in Git-Workflows.
- Agentisches Verhalten: Plant und führt Änderungen mit minimaler Aufsicht durch
- Volles Verständnis des Codebestands: Analysiert die Projektstruktur, bevor Änderungen vorgenommen werden
- Operationen mit mehreren Dateien: Bearbeitet mehrere Dateien und hält dabei die Konsistenz aufrecht
- Git Integration: Erstellt kontextbezogene Commits und verwaltet Branches
- TYPO3 Mustererkennung: Versteht Erweiterungskonventionen, TCA Syntax, Extbase Muster und TypoScript
| Aspekt | Manuelle Entwicklung | Claude Code + Ihre Expertise |
| Geschwindigkeit | Methodisch, vollständige Kontrolle | Schnelles Gerüst, erfordert Validierung |
| Code-Qualität | Hängt vollständig von Ihren Fähigkeiten ab | Konsistente Muster, benötigt Überprüfung von Randfällen |
| Lernen | Tiefes Verständnis von Grund auf | Schnellere Ergebnisse, kann Wissenslücken verbergen |
| Komplexe Logik | Präzise Implementierung | Benötigt klare Spezifikationen und Überprüfung |
| Wartung | Volle Verantwortung für jede Zeile | Gute Eingaben = wartbarer Code |
| Kosten | Nur Ihre Zeit | API-Kosten + Überprüfungszeit |
Wichtige Erkenntnis: Claude Code funktioniert am besten, wenn Sie TYPO3 gut genug verstehen, um effektive Eingaben zu schreiben, Ausgaben zu validieren und Fehler zu erkennen. Es ist ein Produktivitätsmultiplikator, kein Ersatz für Fähigkeiten.
Voraussetzungen & Einrichtung
Systemanforderungen
Checkliste:
- [ ] Node.js 18.0 oder höher
- [ ] Anthropic API-Konto
- [ ] TYPO3 Composer-basierte Installation
- [ ] Git konfiguriert
- [ ] Terminalzugang
- [ ] IDE (VS Code oder PhpStorm empfohlen)
Claude Code installieren
Schnelle Installation:
# Global installieren
npm install -g @anthropic-ai/claude-code
# Authentifizieren
claude-code auth
# Oder API-Schlüssel manuell festlegen
export ANTHROPIC_API_KEY="your-api-key"IDE Integrationssetup
Claude Code integriert sich in beliebte IDEs für einen nahtlosen Arbeitsablauf.
Allgemeine Integrationsvorteile:
- Kontextbezogene Vorschläge basierend auf der aktuellen Datei
- Inline Vorschauen vor der Annahme von Änderungen
- Diff Ansichten zum Vergleichen von KI-generiertem Code
- Schneller Zugriff über Tastenkombinationen
- Integriertes Git Staging von Änderungen
- Sofortige Syntaxvalidierung
Einrichtungsressourcen:
- VS Code: Installieren Sie die “Claude Code” extension aus dem Marketplace → Offizielle VS Code Extension
- PhpStorm: Konfigurieren Sie über Externe Tools oder verwenden Sie das integrierte Terminal → JetBrains Integrationsanleitung
- Andere IDEs: Terminalbasierte Nutzung funktioniert universell
Kickstart: Erstellen Sie Ihre erste TYPO3 Extension
Der Single Prompt Ansatz
Effektive Nutzung von Claude Code beginnt mit umfassenden Eingaben. Integrieren Sie den Zweck der Erweiterung, das Datenmodell, die Funktionen und die technischen Anforderungen in einen Gesprächseinstieg.
Erstellen Sie eine TYPO3-Erweiterung namens "news_comments".
Zweck: Frontend-Kommentarsystem für Nachrichtenartikel mit Moderation.
Datenmodell:
- Kommentartabelle mit Feldern: Autor, E-Mail, Inhalt, news_uid,
Status (ausstehend/genehmigt/abgelehnt), erstellt_am
- Beziehung zu ext:news
Funktionen:
- Frontend-Kommentarformular-Plugin
- Backend-Moderationsmodul
- E-Mail-Benachrichtigungen
Technisch:
- Extbase/Fluid-Muster
- PSR-12-Standards
- Einschließlich TypoScript, TCA, composer.jsonnews_comments/
├── Klassen/
│ ├── Controller/ (Kommentar, Moderation)
│ ├── Domain/Modell/ (Kommentar)
│ ├── Domain/Repository/ (KommentarRepository)
│ └── Service/ (Benachrichtigungsdienst)
├── Konfiguration/
│ ├── TCA/ (Kommentar-Konfiguration)
│ ├── TypoScript/ (Setup, Konstanten)
│ └── Backend/ (Modulregistrierung)
├── Ressourcen/Privat/Vorlagen/
├── composer.json
├── ext_emconf.php
├── ext_localconf.php
└── ext_tables.sqlGenerierungszeit: ~3 MinutenManuelles Äquivalent: 3-4 Stunden
Schnelle Überprüfung & Verfeinerung
Validierungscheckliste:
- [ ] Namespace stimmt mit composer.json überein
- [ ] TCA-Konfiguration vorhanden
- [ ] Datenbankschema vollständig
- [ ] TypoScript-Plugin registriert
- [ ] Templates enthalten ViewHelper-Importe
Folgeaufforderungen für Anpassungen:
"Fügen Sie ein Bewertungsfeld (1-5 Sterne) zu Kommentaren mit Frontend-Anzeige hinzu""Erstellen Sie eine HTML-E-Mail-Vorlage für Admin-Benachrichtigungen"“Fügen Sie deutsche und französische Lokalisierungsdateien hinzu”
Profi-Tipp: Claude Code behält den Gesprächskontext bei. Verweisen Sie auf Dateien nach Namen für schnelle Änderungen, ohne die Struktur erneut zu erklären.
Installation
# In Ihrem TYPO3-Projekt installieren
composer require mycompany/news-comments:@dev
./vendor/bin/typo3 extension:activate news_comments
./vendor/bin/typo3 database:updateschema
./vendor/bin/typo3 cache:flushErzeugen von TYPO3 Code: Praxisbeispiele
Beispiel 1: Benutzerdefiniertes Inhaltselement
Szenario: Testimonial Inhaltselement mit Autoreninformationen, Zitat und Bewertung.
Aufforderung:
Erstellen Sie ein TYPO3 Testimonial Inhaltselement in der “site_package”extension. Felder: author_name, author_role, company, testimonial_text, rating (1-5 Sterne), author_image (FAL). Inklusive Backend Vorschau, responsives Frontend Template, TypoScript Setup. Verwenden Sie den tt_content Ansatz.
Generiert:
- TCA Override für tt_content
- TypoScript FLUIDTEMPLATE Konfiguration
- Fluid-Template mit Sternebewertung
- PageTSconfig für den Inhaltsassistenten
Zeit: ~2 Minuten | Manuell: 1,5 Stunden
Beispiel 2: Produktkatalog mit Varianten
Szenario: E-Commerce Produkte mit Größen/Farbvarianten und Lagerverfolgung.
Aufforderung:
Erstellen Sie die “product_catalog”extension. Modelle: Product (title, price, sku), ProductVariant (size, color, stock), ProductImage (FAL). Backend: Listenmodul mit Filtern, Inline-Bearbeitung, Lagerindikatoren. Frontend: Produktliste, Einzelansicht mit Variantenauswahl.
Generiert:
- 3 Extbase Modelle mit Beziehungen
- Repository mit benutzerdefinierten Abfragen
- Backend Modul mit Filterung
- Frontend Controller und Templates
- Vollständige TCA mit Inline Datensätzen
Zeit: ~5 Minuten | Manuell: 10-12 Stunden
Beispiel 3: Migration einer Legacy Extension
Szenario: Aktualisierung einer alten extension auf modernes TYPO3 mit API Ersetzungen.
Aufforderung:
Migrieren Sie die “events_calendar”extension zu modernem TYPO3. Beheben: Alte Namensräume (Tx_Präfix), veraltete BackendUtility Aufrufe, TCA Syntax für Assistenten, $GLOBALS['TYPO3_DB'] Abfragen. Aktualisieren auf PSR-4, QueryBuilder, modernes TCA, ordnungsgemäße Plugin Registrierung.
Generierte Updates:
- Namensraum Konvertierungen in 8 Dateien
- TCA Modernisierung (Assistent → renderType)
- Datenbankabfragen zu Doctrine DBAL
- Ordnungsgemäße Plugin Registrierung
- composer.json mit PSR-4 Autoloading
Zeit: ~15 Minuten | Manuell: 1-2 Tage
T3AB (TYPO3 AI Builder) ist eine Erweiterung, die KI-gestützte Entwicklung direkt im TYPO3 Backend bietet. Während Claude Code von der Befehlszeile aus arbeitet, bietet T3AB visuelle Schnittstellen für die Inhaltserstellung.
Kernfähigkeiten:
- KI-gestützte Inhaltsblockerstellung
- Visueller TYPO3 Core Formular-Builder
- Erweiterungsgerüst über Backend-UI
- Kompatibel mit modernen TYPO3 Versionen
Funktionsvergleich
| Funktion | Claude Code | T3AB |
| Umgebung | Befehlszeilen-Tool | TYPO3-Backend-Modul |
| Einrichtung | npm + API-Schlüssel | Erweiterungsinstallation |
| Zugriff auf den gesamten Code | ✓ | - |
| Visuelle Schnittstelle | - | ✓ |
| Arbeit mit mehreren Erweiterungen | ✓ | - |
| Inhaltsblock-Builder | Code-basiert | ✓ Visueller Builder |
| Git-Integration | ✓ Native | Manuell |
Verwenden Sie Claude Code für:
- Komplexe Erweiterungen mit benutzerdefinierter Logik
- Refactoring von Multi-Erweiterungen
- Migrierungen von Legacy-Code
- Automatisierte Test-Workflows
- Volle Kontrolle über generierten Code
Verwenden Sie T3AB für:
- Schnelle Erstellung von Inhaltsblöcken
- Visuelles Formularerstellen
- Ausschließlich Backend-Workflows
- Schulung von nicht-technischen Teammitgliedern
- Schnelles Prototyping von Inhaltselementen
Kombinierter Ansatz: Claude Code übernimmt die Kernarchitektur der Erweiterung und die Geschäftslogik, während T3AB Content-Teams befähigt, visuelle Inhaltsblöcke zu erstellen, ohne das TYPO3-Backend zu verlassen.
Fortgeschrittene Techniken
Multi Datei Operationen
- Refaktorieren von Namespaces in gesamten Projekten
- Veraltete APIs in mehreren Erweiterungen gleichzeitig aktualisieren
- Kodierkonventionen projektweit standardisieren
Beispiel: „Aktualisieren Sie alle Erweiterungen in packages/, um moderne TYPO3 APIs zu verwenden, und erstellen Sie einen zusammenfassenden Bericht“
Integration von Best Practices
- Automatische Anwendung der PSR-12 Kodierstandards
- Durchsetzung der TYPO3 Kodierungsrichtlinien
- Erzeugen von ordnungsgemäßen PHPDoc Blöcken
Beispiel: „Erweiterung auf PSR-12 Konformität prüfen und alle Verstöße beheben“
Automatisierung des Git Workflows
- Erzeugen von kontextbezogenen Commit Nachrichten
- Erstellen von Feature Branches mit Beschreibungen
- Vorbereiten der Dokumentation für Pull Requests
Beispiel: „Feature Branch für Kommentarsystem erstellen, Änderungen committen und PR Beschreibung generieren“
Leistungsoptimierung
- Identifizieren von N+1 Abfrageproblemen
- Vorschlagen von Datenbankindizierungen
- Empfehlen von Caching Strategien
Beispiel: „ProductRepository analysieren und Leistungsoptimierungen für Abfrageeffizienz vorschlagen“
Beste Praktiken & Tipps
Effektives Prompting
| Do ✓ | Don't ✗ |
| Vollständige Datenmodelle angeben | Vage Beschreibungen geben |
| PSR Standards erwähnen | Architektonische Anforderungen überspringen |
| Beispielstrukturen einbeziehen | Annehmen, dass Claude Ihre Konventionen kennt |
| Dokumentation anfordern | Undokumentierten Code generieren |
| Schrittweise testen | Gesamte Systeme in einem Prompt erstellen |
| Abhängigkeiten angeben | Bestehende Erweiterungen ignorieren |
Profi-Tipp: Beginnen Sie mit dem Projektkontext:
"TYPO3 Projekt mit ext:news und ext:powermail. Benutzerdefinierte Erweiterungen verwenden den ‘MyCompany’ Anbieter. Folgen Sie PSR-12. Denken Sie an diesen Kontext"
Sicherheitsüberprüfungs Checkliste
- [ ] Eingabesäuberung bei allen Formularen
- [ ] Richtiges Fluid Escaping
- [ ] QueryBuilder mit Parameterbindung
- [ ] Dateiupload Validierung
- [ ] XSS Schutz in Vorlagen
- [ ] CSRF Tokens in Formularen
- [ ] Zugriffskontrolle in Controllern
Warnung: Überprüfen Sie immer von KI generierten Code auf Sicherheitslücken, bevor Sie ihn bereitstellen.
# Überprüfen Sie die Node.js-Version
node --version # Sollte 18+ sein
# Bei Bedarf neu installieren
npm install -g @anthropic-ai/claude-code
# Authentifizierung überprüfen
claude-code authTCA Fehler: Verwenden Sie Claude Code zum Debuggen: „Überprüfen Sie die TCA-Konfiguration für das Kommentarmodell. Ich erhalte den Fehler 'Unbekannter Feldtyp'“
Extension erscheint nicht:
- Überprüfen Sie, ob composer.json "type": „typo3-cms-extension“ enthält
- Führen Sie composer dump-autoload aus
- Leeren Sie die Caches: ./vendor/bin/typo3 cache:flush
Kontextbeschränkungen: Teilen Sie große Aufgaben in kleinere Aufforderungen auf: „Konzentrieren Sie sich nur auf das Verzeichnis Classes/Controller/ für diese Umstrukturierung“
Fazit
Claude Code transformiert die TYPO3-Entwicklung, indem es sich um Boilerplate kümmert und Standards einhält, sodass Sie sich auf Architektur und Geschäftslogik konzentrieren können. Der Schlüssel liegt darin, Ihre TYPO3-Expertise mit KI-Unterstützung zu kombinieren, nicht das eine durch das andere zu ersetzen.
Denken Sie daran: Effektive Nutzung erfordert das Verständnis, was gebaut werden soll, wie man klar auffordert und wann man kritisch überprüft. Ihr TYPO3-Wissen bleibt entscheidend für architektonische Entscheidungen, Sicherheitsüberprüfungen und Qualitätsvalidierung.
Als Nächstes in der Serie: Wir werden Cursor erkunden, den AI-first-Code-Editor mit Inline-Vervollständigung und Codebase-Chat, und seine IDE-native Erfahrung mit dem Kommandozeilenansatz von Claude Code vergleichen.
FAQs
Ja, es benötigt eine API-Verbindung zu den Servern von Anthropic für alle Operationen.
Ja, Claude Code ist hervorragend im Refactoring, Debugging und Modernisieren bestehender Codebasen.
Absolut. Claude Code verstärkt Ihr Wissen, ersetzt es aber nicht. Sie benötigen TYPO3-Expertise, um effektive Eingaben zu schreiben und Ausgaben zu validieren.
Claude Code verwendet die API von Anthropic mit nutzungsbasierter Preisgestaltung. Überprüfen Sie deren Preisseite für aktuelle Tarife basierend auf dem Tokenverbrauch.
Überprüfen Sie immer die Ausgaben. Verwenden Sie Folgeeingaben, um Probleme zu beheben: "Der TCA hat einen Syntaxfehler in Zeile 45. Korrigieren Sie die Feldtypdeklaration."
Ja, es funktioniert mit standardmäßigen Git-Workflows. Jeder Entwickler nutzt es unabhängig und führt die Änderungen über die Versionskontrolle zusammen.
Wolfgang Weber
Brand & Communication LeadWolfgang Weber gestaltet TYPO3 mit Leidenschaft und Expertise. Als langjähriger TYPO3-Enthusiast hat er zu zahlreichen Projekten beigetragen, die Websites schneller und sicherer machen. Abseits von TYPO3 findet man ihn…
More From Author