Wie wir Claude Code für unser Nuxt 4 + Rust Monorepo nutzen

Unser Stack und Warum Claude Code Passt

Bei Open Soft ist unser Hauptprodukt eine Website, die als Monorepo aufgebaut ist: ein Nuxt 4 Frontend mit TypeScript und ein Rust/Axum Backend-API mit PostgreSQL. Die Codebasis umfasst zwei Sprachen, zwei Build-Systeme, gemeinsame Datenverträge, Datenbankmigrationen, i18n-Dateien für 10 Sprachen und Deployment-Infrastruktur.

Wir haben Claude Code Mitte 2025 eingeführt und es ist unser meistgenutztes Entwicklungstool geworden. Nicht weil es Code für uns schreibt — sondern weil es über unsere gesamte Codebasis auf eine Weise nachdenkt, die kein anderes Tool kann. Wenn Sie Claude Code sagen „füge ein published_at-Feld zu articles hinzu“, liest es die Rust-Migration, aktualisiert die SQL-Queries im Handler, modifiziert die TypeScript-Typen im Frontend, passt die Nuxt-Seitenkomponente an, aktualisiert alle 10 Locale-Dateien und führt den Build zur Verifizierung aus.

CLAUDE.md: Dem Agenten Ihre Konventionen Beibringen

Die Grundlage effektiver Claude Code-Nutzung ist die CLAUDE.md-Datei. Claude Code liest diese projektweite Anweisungsdatei zu Beginn jeder Sitzung.

Unsere CLAUDE.md enthält:

• Commit-Konventionen: Jeder Commit muss mit TASK-XXX: beginnen
• Architekturübersicht: Monorepo-Struktur
• Code-Stil-Regeln: TypeScript strict, kein any, nur Composition API
• i18n-Regeln: Alle 10 Locales synchron halten, Schlüssel alphabetisch sortiert
• Sicherheitsregeln: Keine Secrets in Commits, parametrisiertes SQL

Multi-File-Refactoring: Der Killer-Anwendungsfall

Aufgabe: SEO-Felder zum Articles-System hinzufügen. Ohne Claude Code: 10 Schritte, 12+ Dateien, 45-60 Minuten. Mit Claude Code: Ein Befehl, 5 Minuten, eine agentische Schleife.

Migration-Schreiben

Datenbankmigrationen sind besonders gut für Claude Code geeignet, da sie das Verständnis des aktuellen Schemas, des gewünschten Endzustands und des sicheren Transformationspfads erfordern.

Testgenerierung

Wir verwenden Claude Code ausgiebig für die Generierung von Test-Fixtures und SQL-Seed-Daten.

Code-Review mit Claude Code

Vor dem Öffnen eines Merge Requests führen wir Claude Code als Reviewer aus. Es erfasst etwa 30% der Probleme, die sonst im menschlichen Code-Review gefunden würden.

Hooks: Qualitäts-Gates Automatisieren

Pre-Commit-Hook: Führt cargo fmt --check und cargo clippy aus. Post-Edit-Hook: Verifiziert, dass alle 10 Locale-Dateien identische Schlüsselsätze haben.

MCP-Server: Claude Codes Fähigkeiten Erweitern

1. Datenbank-MCP-Server: Ermöglicht direkte PostgreSQL-Abfragen.
2. Deployment-Status-MCP-Server: Verbindung zur CI/CD-Pipeline.

Tipps für Große Codebasen mit 1M Kontext

Lassen Sie Claude Code erkunden. Beschreiben Sie, was Sie wollen, und lassen Sie Claude Code die relevanten Dateien finden.

CLAUDE.md für stabilen Kontext nutzen. Informationen, die sich zwischen Sitzungen nicht ändern, gehören in CLAUDE.md.

Mega-Aufgaben in Phasen aufteilen. Auch mit 1M Token profitieren große Aufgaben von Phasenaufteilung.

Der agentischen Schleife vertrauen. Nicht mittendrin unterbrechen. Konvergieren lassen.

Fallstricke und Lösungen

Fallstrick: Über-Engineering. Lösung: KISS in CLAUDE.md. Fallstrick: Veralteter Kontext in langen Sitzungen. Lösung: Neue Sitzung für jede Hauptaufgabe. Fallstrick: Aggressive Dateiänderungen. Lösung: Diff sorgfältig prüfen.

FAQ

Was kostet Claude Code im täglichen Einsatz?

Für unser 4-Entwickler-Team etwa $200-300/Monat. Der Max-Plan für $20/Monat pro Entwickler ist eine planbarere Alternative.

Funktioniert Claude Code offline?

Nein. Internetverbindung erforderlich.

Kann Claude Code unseren Build kaputtmachen?

Ja, aber es erkennt die meisten Probleme selbst. ~90% der Builds gelingen beim ersten Versuch.

Ist Claude Code für Solo-Entwickler geeignet?

Absolut. Es dient als zweites Augenpaar für Code-Reviews und als Kraftmultiplikator für mühsame Aufgaben.

Fazit

Claude Code ist kein Zauberstab. Es ist ein Kraftmultiplikator für Cross-Stack-Reasoning, Konventionsdurchsetzung und mühsame Multi-File-Änderungen. Die Kombination aus CLAUDE.md, Hooks und MCP-Servern macht es zum fähigsten KI-Entwicklungstool, das wir für Monorepo-Arbeit verwendet haben.

Die wichtigste Erkenntnis nach 9 Monaten täglicher Nutzung: Claude Code ist am wertvollsten nicht für das Schreiben neuen Codes, sondern für die Wartung bestehenden Codes — Refactoring, Migrationen, Tests und Reviews.