So verwenden Sie Claude Code effektiv: Die Erfahrung eines Entwicklers beim Aufbau einer vollständigen SaaS-App

Ein Entwickler, der seit 2021 SaaS-Produkte veröffentlicht, hat kürzlich eine vollständige Anwendung namens codefluent.app mit Claude Code erstellt. Die entscheidende Erkenntnis ist, dass der effektive Einsatz des Tools detaillierte technische Spezifikationen erfordert, nicht vage Anweisungen wie "Bau mir eine App". Der Entwickler betont, dass er alle Architekturentscheidungen selbst trifft, während er Claude Code nutzt, um klare Spezifikationen schnell in funktionierenden Code zu übersetzen.

Projektdetails und Tech-Stack

Das Projekt ist codefluent (codefluent.app), eine Spaced-Repetition-App zum Erlernen von Programmier-Syntax. Die gesamte Landing Page wurde mit Claude Code erstellt, indem Abschnitte beschrieben und die gewünschte visuelle Richtung referenziert wurde, was zu responsivem, sauberem Tailwind-Markup führte.

Tech-Stack:

• SvelteKit-Monolith
• PostgreSQL + Drizzle ORM
• Better Auth
• OpenRouter für LLM-Funktionalität
• Stripe
• CodeMirror 6
• Tailwind v4
• Railway

Arbeitsmethode: Detaillierte Spezifikationen

Der Entwickler verwendet keine vagen Anweisungen. Stattdessen beginnt jede Funktion mit dem Ausformulieren exakter Anforderungen: Schema, Authentifizierungsstrategie, Komponentenhierarchie, API-Struktur und Randfälle. Claude Code liest dann die bestehende Codebasis, erkennt Muster und Konventionen und schreibt passenden Code.

Beispiel-Anweisung:

"Füge eine daily_stats-Tabelle mit den Spalten userId, date, cardsStudied, correctCount, streakCount hinzu. Erstelle eine Service-Funktion, die bei Abschluss einer Übung ein Upsert durchführt. Erhöhe die Serie, wenn der Benutzer gestern geübt hat, setze sie auf 1 zurück, wenn nicht. Füge einen Server-Endpunkt hinzu, der die letzten 30 Tage Statistik für den angemeldeten Benutzer zurückgibt."

Der Entwickler überprüft jede Zeile des generierten Codes, fängt Randfälle ab, optimiert Details und veröffentlicht sie. Der Punkt ist, dass Architekturentscheidungen – welche Tabellen existieren, wie Authentifizierungs-Scoping funktioniert, Geschäftsregeln – vom Entwickler getroffen werden, nicht von der KI.

Was gut funktioniert hat

• Datenbankoperationen: Das Beschreiben von Schemaänderungen und Einschränkungen führte in Sekunden zu funktionierenden Drizzle-Migrationen.
• Stripe-Integration: Die Spezifikation des Checkout-Flows und Webhook-Lebenszyklus generierte den gesamten Verbindungscode und sparte mindestens einen ganzen Arbeitstag.
• /simplify-Befehl: Dieser Befehl überprüft Code auf Wiederverwendbarkeit, Qualität und Effizienz und erkennt technische Schulden, die der Entwickler möglicherweise übersehen hätte.
• Konsistenz: Sobald Muster für Routen und Service-Strukturen etabliert waren, hielt Claude Code sie mit minimaler Abweichung ein.

Herausforderungen und Hinweise

• Over-Engineering: Claude Code neigt dazu, Abstraktionen und Hilfsfunktionen auch für Einmal-Anwendungsfälle zu erstellen. Der Entwickler musste aktiv mit "einfacher, mach einfach die direkte Sache" gegensteuern.
• Authentifizierungskomplexität: Better Auth mit SvelteKits SSR-Session-Handling war knifflig. Generierte Muster funktionierten manchmal isoliert, brachen aber mit Server-Side-Rendering, was erforderte, dass der Entwickler den Authentifizierungsfluss verstand, um Probleme zu erkennen.
• KI-Bewertungssystem: Die App nutzt LLMs, um Code-Erklärungen zu bewerten. Eine konsistente Bewertung zu erreichen, ohne zu nachsichtig oder zu streng zu sein, erforderte umfangreiche manuelle Prompt-Iteration, die nicht an die KI delegiert werden konnte.

Wesentliche Erkenntnis

Claude Code ersetzt nicht das Wissen darüber, was man baut. Der Unterschied zwischen guten Ergebnissen und einem Chaos hängt von Ihrer Fähigkeit ab, klare Spezifikationen zu schreiben und schlechte Entscheidungen in der Ausgabe zu erkennen. Wenn Sie bereits Projekte veröffentlicht haben, wissen Sie bereits, worauf Sie achten müssen. Wenn nicht, ist das die eigentliche Fähigkeit, die entwickelt werden muss – nicht Prompt-Techniken.