Sie haben mit Claude Code eine Web-App gebaut und wollen sie als echte App in den Apple App Store und den Google Play Store bringen? Capacitor ist dafür oft der pragmatischste Weg: Ihr bestehender Web-Code bleibt erhalten, bekommt aber native Projekte für iOS und Android sowie Zugriff auf Gerätefunktionen. Damit das Setup nicht im Chaos endet, lohnt sich eine klare Reihenfolge. Dieser Ratgeber zeigt, wie Sie Claude Code gezielt einsetzen, welche Dateien wirklich zählen und wo typische Stolperfallen liegen.
Wann Capacitor die richtige Wahl ist
Capacitor eignet sich besonders, wenn Ihre Anwendung bereits als React-, Vue-, Angular- oder Svelte-Projekt existiert und gut im mobilen Browser läuft. Die App wird lokal im Gerät ausgeliefert, nicht nur als ferngeladene Website, und kann über Plugins Kamera, Push oder Dateisystem nutzen. Das unterscheidet sie von einem reinen Wrapper und hilft bei Apples Guideline 4.2, die bloße Website-Kopien ohne App-Mehrwert ablehnt.
Weniger passend ist Capacitor, wenn Ihre App aufwendige Animationen, komplexe Hintergrundprozesse oder sehr viele native Bildschirme braucht. Dann lohnt ein Blick auf React Native mit Expo oder eine native Umsetzung. Lassen Sie Claude Code im Plan-Modus Ihre Codebasis analysieren und begründen, welche Variante zu Ihrem Projekt passt, bevor Sie eine einzige Abhängigkeit installieren.
Das Grundgerüst Schritt für Schritt
Der wichtigste Hebel ist eine gute CLAUDE.md. Halten Sie dort fest, welches Build-Tool Sie nutzen, wohin der Produktions-Build geschrieben wird und welche Befehle der Agent ausführen darf. So vermeiden Sie, dass Claude Code bei jedem Schritt neu rätselt.
- Lassen Sie Claude Code prüfen, ob der Produktions-Build fehlerfrei durchläuft und alle Pfade relativ aufgelöst werden.
- Installieren Sie die Capacitor-Pakete und erzeugen Sie mit dem Init-Befehl die Datei capacitor.config.ts mit App-ID und App-Namen.
- Tragen Sie als webDir exakt den Ordner ein, in den Ihr Build schreibt, zum Beispiel dist oder build.
- Fügen Sie die Plattformen iOS und Android hinzu und führen Sie nach jedem Web-Build den Sync-Befehl aus.
- Öffnen Sie die nativen Projekte in Xcode und Android Studio und testen Sie auf echten Geräten, nicht nur im Simulator.
Typische Fehler und wie Claude Code sie findet
Der Klassiker ist ein weißer Bildschirm nach dem Start. Meist liegt es an absoluten Pfaden, an einem Router im History-Modus ohne passende Konfiguration oder an Umgebungsvariablen, die nur im Dev-Server existieren. Bitten Sie Claude Code, die Konsole des WebViews auszuwerten: Unter iOS über Safari-Webinspektor, unter Android über die Chrome-Remote-Debugging-Seite. Den Fehlertext geben Sie dem Agenten direkt als Kontext.
Ebenso häufig sind fehlende Berechtigungstexte. Wer ein Kamera-Plugin einbindet, muss in der Info.plist eine verständliche Begründung hinterlegen, sonst stürzt die App ab oder wird im Review abgelehnt. Ein Hook in Claude Code, der nach jeder Plugin-Installation an diese Einträge erinnert, spart später Ärger. Auch die App-ID sollte von Anfang an final sein, denn ein späterer Wechsel betrifft Zertifikate, Store-Einträge und Push-Konfiguration.
Vom lauffähigen Projekt zur Store-Einreichung
Ein funktionierender Build auf dem eigenen Gerät ist erst die halbe Strecke. Danach folgen App-Icons und Splash-Screens in allen Größen, Signierung, ein Apple-Developer-Konto für 99 USD pro Jahr und ein Google-Play-Konto für einmalig 25 USD. Neue private Play-Konten müssen zudem einen geschlossenen Test mit mindestens 12 Testern über 14 Tage absolvieren, bevor die App öffentlich wird.
Viele Teams schaffen das Grundgerüst mit Claude Code in wenigen Stunden, verlieren dann aber Tage bei Zertifikaten, Datenschutzangaben und Review-Rückfragen. Hier setzt appsubmitter an: Wir richten Signierung, fastlane und CI in Ihrem eigenen Store-Konto ein und begleiten die Einreichung. Wenn Sie zusätzlich Unterstützung beim Code selbst wünschen, übernehmen die AI Code Engineers von neooutput das komplette Ship-to-Store-Paket. In einem kostenlosen 15-Minuten-Erstgespräch klären wir, welcher Weg für Ihr Projekt sinnvoll ist.
Häufige Fragen
Kann Claude Code ein Capacitor-Projekt komplett allein einrichten?
Claude Code kann Abhängigkeiten installieren, Konfigurationsdateien schreiben und Build-Fehler analysieren. Für den iOS-Build brauchen Sie aber einen Mac mit Xcode, und Signierung sowie Store-Konten erfordern Ihre Zugangsdaten. Die Kombination aus Agent und menschlicher Prüfung funktioniert am besten.
Wird eine Capacitor-App von Apple als Website-Wrapper abgelehnt?
Nicht automatisch. Entscheidend ist, ob die App echten Mehrwert bietet, etwa Offline-Funktionen, native Navigation oder Gerätefunktionen. Eine reine Kopie Ihrer Website ohne App-Charakter riskiert dagegen eine Ablehnung nach Guideline 4.2.
Muss ich nach jeder Code-Änderung neu einreichen?
Änderungen am nativen Teil oder an Berechtigungen erfordern immer einen neuen Build und ein Review. Kleinere Web-Anpassungen lassen sich unter bestimmten Bedingungen per Live Update ausliefern, solange sich der Zweck der App nicht ändert.