Erste Hilfe immer zuerst: Kopiere die Fehlermeldung in Claude Code und frag: „Das ging schief – hier die Meldung: … Was bedeutet das und wie behebe ich es?“ Claude löst die meisten dieser Fälle selbst.
claude startet nicht / „command not found“
→ Claude Code ist nicht installiert oder nicht im Pfad. Helfer:in / IT. (Sollte vorab erledigt sein.)
Claude reagiert nicht / hängt
→ Esc drücken (stoppt die aktuelle Aktion). Notfalls Terminal schließen und claude neu starten.
Token weg / nicht kopiert → Kein Problem: einfach einen neuen erstellen (Phase 3a). Der alte kann gelöscht werden.
„Authentication failed“ beim Hochladen
→ Token hat falsche Rechte. Neuen Token mit Scopes repo und workflow erstellen.
→ Oder falscher Benutzername. Claude sagen: „Melde mich neu bei GitHub an.“
gh: command not found
→ GitHub CLI fehlt. Helfer:in / IT. (Sollte vorab installiert sein.)
Repository existiert schon / Name vergeben
→ Claude bitten: „Nimm stattdessen den Namen meine-webseite-2.“
Cloudflare findet mein Repo nicht
→ Bei „Connect to Git“ Zugriff erteilen: GitHub fragt nach Repos. „All repositories“ wählen
oder gezielt meine-webseite freigeben. Danach erscheint es in der Liste.
Seite ist live, aber leer / weißer Bildschirm → Fast immer falsche Build-Einstellung. Prüfen:
/
→ In Cloudflare unter Settings → Build korrigieren, dann Retry deployment.404 / „Nothing is here yet“
→ index.html liegt nicht im Hauptverzeichnis des Repos. Claude bitten:
„Stell sicher, dass index.html im Wurzelverzeichnis des Repos liegt, dann neu pushen.“
Deployment schlägt fehl (rote Meldung) → Die Fehlerzeile aus dem Cloudflare-Log kopieren und Claude geben.
Dankesmeldung kommt, aber Lead erscheint NICHT auf webhook.site → Häufigster Fall! Reihenfolge prüfen:
LEAD_WEBHOOK_URL in Cloudflare gesetzt und mit „Encrypt“?Formular sendet nicht / nichts passiert beim Klick → Claude bitten: „Prüfe, ob das Formular per fetch an /api/lead sendet und Fehler im Browser in der Konsole anzeigt.“ Evtl. Browser-Konsole (F12) öffnen und Meldung an Claude geben.
Fehler „405 Method Not Allowed“ bei /api/lead
→ Die Funktion behandelt nur GET, nicht POST – oder Datei liegt am falschen Ort.
Pfad muss exakt sein: functions/api/lead.js. Claude bitten, das zu prüfen.
„500“-Fehler nach dem Absenden → In Cloudflare: Pages-Projekt → Functions → Real-time Logs öffnen, Eintrag ansehen, Meldung an Claude geben.
Ich bin abgehängt, alle sind weiter → Kein Stress. Helfer:in winken, oder zu zweit an einen Rechner („Pair-Bauen“). Ziel des Tages ist Verstehen + ein Erfolgserlebnis, kein Wettrennen.
Ich habe aus Versehen etwas „kaputt“ gemacht → Es ist dein Spielprojekt – nichts ist endgültig. Claude bitten: „Mach die letzte Änderung rückgängig“ oder „Stell die funktionierende Version wieder her.“
Meine Seite soll anders aussehen → Einfach in normaler Sprache sagen, was anders sein soll. Beliebig oft.