Wie ein Team eine 6-stellige HubSpot-Agentur durch Claude Code ersetzte

Ein mittelständisches E-Commerce-Unternehmen (~15 Produkte über Shopify, Recharge, Digistore24, GoAffPro und Anzeigen) musste von Zoho CRM, Zoho Desk und KlickTipp zu HubSpot Enterprise migrieren. Agenturangebote lagen zwischen 20.000 € (standardisiert) und 80.000 € (mittlere benutzerdefinierte Objekte) – aber keines bot eine durchgängig maßgeschneiderte Middleware für Synchronisation und Abgleich. Das Team entschied sich, alles selbst mit Claude Code zu bauen (Desktop-App, Opus 4.7, Abonnement).

Was gebaut wurde (in 4 Monaten, ~30 Sitzungen à 2–4 Stunden)

• 6 benutzerdefinierte Objekte + ~100 Eigenschaften + Verknüpfungen
• 5 Integrationen zu Quellsystemen auf selbstgehostetem n8n: Shopify, Digistore24, Recharge, GoAffPro, Cart-Notifier – jeweils mit Inbox-Pattern, idempotenten Upserts, Abgleich, Backoff/Retry, Audit Trail
• 1 benutzerdefinierter Cloud Run-Dienst für Inbox-Polling im 15-Sekunden-Takt
• 10 Lifecycle-Stufen + Trichter-/Segment-Eigenschaftsebene
• Aggregator-Workflow, der 9 Kontakteigenschaften aus Sync-Spiegelobjekten nachträgt (idempotent, Postgres-Cursor, Cron-gesteuert)
• KlickTipp-Migration: 202 Tags geprüft, benutzerdefiniertes Objekt für Webinar-Registrierungen, Einwilligungsmanagement
• Google Ads CAPI (11 Conversion-Aktionen, erweiterte Conversions) + Meta CAPI (Pixel + serverseitig)
• 33 ADRs (Architekturentscheidungen, nur anfügen, nie löschen)

Der Autor schätzt, dass das vollständige Ergebnis bei einer Agentur 120.000–180.000 € kosten würde – und die meisten können das maßgeschneiderte Middleware-Stück nicht liefern.

Der mentale Wandel: Claude Code als System of Record

Nur ~20 % des Repos sind Code. Die anderen 80 % sind Markdown: Architekturentscheidungen, Integrationsspezifikationen, Runbooks, ADRs, Namenskonventionen, Einwilligungsmanagement. Das Repo wird zur einzigen Quelle der Wahrheit dafür, wie das Geschäft in HubSpot läuft. Wenn Code benötigt wird (Python-Helfer, Backfill-Skripte, Cloud Run-Dienst), schreibt Claude ihn. Für Workflow-Logik verwenden sie n8n – Claude erstellt/aktualisiert Workflows über den n8n MCP-Server.

Repo als Gedächtnis zwischen Sitzungen

Claude Code-Sitzungen sind zustandslos. Das Team betrachtet dies als Designbeschränkung: Zustand lebt in Dateien. Wichtige Praktiken:

• ADRs erfassen jede Architekturentscheidung mit Begründung und Abwägungen – neue Sitzungen lesen sie und debattieren nicht erneut
• Spezifikationsdateien pro Integration/Bereich mit einem Status-Header – einzige Quelle der Wahrheit für den Implementierungsstand
• Slash-Befehle (/implement, /verify, /new-task) erzwingen Disziplin – Definition-of-Done-Kontrolle, Abweichungsprüfungen, atomare Statusaktualisierungen
• Spickzettel für HubSpot-Operationen (welche über API-Tools vs. direkte API-Aufrufe vs. UI-Klicks funktionieren) und bekannte Fehler (HubSpot-Suchindex-Latenz, Recharge-Enumeration-vs-Bool, n8n-Authentifizierungs-Rennbedingungen)