🎓 Workshop-Hub ▶︎ Folien Lab-GuideCheat-Sheet

🚀 Lab-Guide: Deine erste Live-Webseite mit Lead-Formular

Ziel: Am Ende hast du eine echte Webseite im Internet – mit einem Lead-Formular, dessen Einträge live bei dir ankommen. Gebaut, hochgeladen und online gestellt zusammen mit Claude Code.

Dauer: ca. 90 Minuten · Vorwissen: keins nötig · Motto: Claude macht die Technik, du gibst die Richtung.


🧭 Die Reise im Überblick

1. Accounts   →  2. Verbinden   →  3. Bauen   →  4. Online stellen   →  5. Lead-Formular
  GitHub          GitHub-Token       Webseite      Cloudflare Pages       + dein Secret
  Cloudflare      an Claude          mit Claude     (deine Live-URL!)      (Leads live sehen!)

Drei goldene Regeln für heute:

  1. Sprich mit Claude wie mit einem Kollegen. Ganze Sätze, sag das Ziel.
  2. Wenn etwas hakt: frag Claude. Kopiere die Fehlermeldung einfach hinein.
  3. Nichts kaputtmachbar. Du arbeitest in deinem eigenen Spielprojekt.

Phase 0 – Bereit? (2 Min)

Auf deinem Rechner ist bereits installiert (von der IT vorbereitet):

Du brauchst außerdem:

Claude Code starten: Öffne das Terminal / die Eingabeaufforderung, tippe claude und drücke Enter. Du siehst eine Eingabezeile – hier sprichst du mit Claude. (Beenden: /exit.)

Erster Test – sag einfach Hallo. Tippe in Claude Code:

Hi! Ich mache gerade einen Workshop und baue gleich meine erste Webseite.
Erklär mir in 2 Sätzen, was du als Nächstes für mich tun kannst.

Wenn Claude antwortet: 🎉 Du bist startklar.


Phase 1 – GitHub-Account anlegen (8 Min)

Was ist GitHub? Ein Online-Lager für Code (wie eine Dropbox für Projekte). Cloudflare holt sich später deine Webseite von dort.

  1. Gehe auf https://github.com/signup
  2. E-Mail eingeben → Passwort → Benutzername wählen (z. B. vorname-medumio)
  3. E-Mail bestätigen (Code aus dem Postfach eingeben)
  4. Bei „How will you use GitHub?“ → Free-Plan reicht

Geschafft, wenn du auf github.com eingeloggt bist und dein Profil siehst.


Phase 2 – Cloudflare-Account anlegen (8 Min)

Was ist Cloudflare? Der Dienst, der deine Webseite ins Internet stellt (kostenlos, schnell). Wir nutzen davon Cloudflare Pages.

  1. Gehe auf https://dash.cloudflare.com/sign-up
  2. E-Mail + Passwort → Account erstellen
  3. E-Mail bestätigen (Link im Postfach anklicken)

Geschafft, wenn du das Cloudflare-Dashboard siehst.

💡 Du musst hier nichts weiter einrichten – wir kommen in Phase 5 zurück.


Phase 3 – Claude mit GitHub verbinden (dein erster API-Token!) (10 Min)

Damit Claude Code Code für dich hochladen darf, braucht es einen Zugangsschlüssel zu deinem GitHub – einen API-Token (= ein Passwort für Programme).

3a. Token bei GitHub erstellen

  1. Eingeloggt bei GitHub: oben rechts auf dein ProfilbildSettings
  2. Ganz unten links: Developer settings
  3. Personal access tokensTokens (classic)Generate new token (classic)
  4. Note: claude-code-workshop
  5. Expiration: 30 days
  6. Scopes: Häkchen bei repo und bei workflow setzen
  7. Unten: Generate token
  8. ⚠️ Den langen Token jetzt kopieren (ghp_…) – er wird nur einmal angezeigt!

🔐 Merke: Ein Token ist wie ein Passwort. Niemals in eine E-Mail, einen Chat oder direkt in den Code schreiben. Heute behandeln wir ihn wie einen Hausschlüssel.

3b. Token an Claude / Git übergeben

Tippe in Claude Code:

Ich möchte mich bei GitHub anmelden, damit du später meinen Code hochladen kannst.
Führe mich durch die GitHub-Anmeldung. Ich habe einen Personal Access Token bereit.
Mein GitHub-Benutzername ist: <DEIN-BENUTZERNAME>

Claude startet die Anmeldung (gh auth login) und sagt dir, wo du den Token einfügst. Folge seinen Anweisungen.

Geschafft, wenn Claude bestätigt: „Du bist bei GitHub angemeldet.“


Phase 4 – Deine Webseite bauen (15 Min)

Jetzt der schöne Teil. Beschreibe Claude deine Wunschseite. Je konkreter, desto besser. Nutze diese Vorlage und passe sie an dein Thema an:

Bau mir eine moderne, einseitige Landingpage als einzelne index.html-Datei
(mit eingebettetem CSS, ohne Build-Tools).

Thema: <z. B. "kostenloser 7-Tage-Energie-Guide" / dein eigenes Thema>
Stil: hochwertig, vertrauenswürdig, freundlich; eine klare Hauptfarbe.

Inhalt:
- Kopfzeile mit Logo-Text
- Hero-Bereich: starke Überschrift + kurzer Untertitel + Vertrauens-Hinweise
- rechts daneben eine Karte mit einem Lead-Formular (Vorname + E-Mail + Button)
- darunter 3 Vorteils-Kacheln
- schlichter Footer

Das Formular soll später per JavaScript an /api/lead gesendet werden.
Leg das Projekt in einem neuen Ordner "meine-webseite" an.

Claude legt den Ordner und die index.html an. Schau dir gern an, was er schreibt – du musst es nicht verstehen, aber es ist spannend zu sehen.

Sofort ansehen – sag einfach:

Zeig mir die Seite in einer Vorschau im Browser.

Gefällt dir was nicht? Sag es in normaler Sprache:

Mach die Hauptfarbe wärmer (Richtung Orange) und die Überschrift mutiger.
Tausch die mittlere Vorteils-Kachel gegen das Thema "Schlaf".

Geschafft, wenn dir deine Seite in der Vorschau gefällt.


Phase 5 – Online stellen: dein erstes Deployment 🎉 (20 Min)

5a. Code zu GitHub hochladen (Claude macht das)

Tippe:

Mach aus dem Ordner "meine-webseite" ein Git-Repository und lade es zu meinem GitHub hoch.
Erstelle dafür ein neues, öffentliches Repository namens "meine-webseite".

Claude erstellt das Repo und pusht den Code. Danach gibt er dir einen Link – öffne ihn, deine Dateien sind jetzt auf GitHub. ✅

5b. Cloudflare Pages mit GitHub verbinden

Jetzt im Browser (Cloudflare-Dashboard):

  1. Links im Menü: Compute (Workers & Pages)Pages (oder „Create application“ → Reiter „Pages“)
  2. Connect to Git anklicken
  3. GitHub auswählen → Authorize (Cloudflare darf auf deine Repos schauen)
  4. Wähle das Repository meine-webseiteBegin setup
  5. Build settings:
    • Framework preset: None
    • Build command: (leer lassen)
    • Build output directory: / (Schrägstrich – also das Hauptverzeichnis)
  6. Save and Deploy

Cloudflare baut jetzt ein paar Sekunden … und zeigt dir eine Live-URL an, z. B. https://meine-webseite-xyz.pages.dev.

  1. Klick die URL an. 🎉🎉🎉 Deine Seite ist im Internet!

🥳 Großer Moment – das ist dein erstes Deployment. Schick den Link gern in den Workshop-Chat und schau dir die Seiten der anderen an.

Geschafft, wenn deine Seite öffentlich unter einer .pages.dev-Adresse erreichbar ist.


Phase 6 – Das Lead-Formular zum Leben erwecken (15 Min)

Aktuell ist das Formular nur Deko. Jetzt bauen wir die Funktion dahinter – eine kleine Cloudflare-Funktion, die Einträge entgegennimmt. Und wir nutzen unseren ersten Secret.

6a. Einen Live-Briefkasten für Leads holen (kein Account nötig)

  1. Öffne https://webhook.site
  2. Du bekommst sofort eine eigene URL (oben, „Your unique URL“). Kopiere sie.
  3. Lass den Tab offen – hier siehst du gleich jeden Lead live eintrudeln.

6b. Die Funktion einbauen (Claude macht das)

Tippe in Claude Code:

Bau in mein Projekt "meine-webseite" eine Cloudflare Pages Function unter
functions/api/lead.js ein. Sie soll POST-Anfragen vom Formular annehmen (JSON mit name + email),
die E-Mail kurz prüfen und eine freundliche Erfolgsmeldung zurückgeben.

Wenn die Umgebungsvariable LEAD_WEBHOOK_URL gesetzt ist, soll die Funktion den Lead
zusätzlich als JSON an diese URL weiterleiten.

Stell sicher, dass das Formular in index.html den Eintrag per fetch an /api/lead schickt
und die Antwort als Erfolgs- oder Fehlermeldung anzeigt.
Danach committe alles und pushe es zu GitHub.

Sobald Claude gepusht hat, deployt Cloudflare automatisch neu (weil es mit dem Repo verbunden ist). Nach ~1 Minute ist die neue Version live.

6c. Dein Secret in Cloudflare hinterlegen

Damit die Weiterleitung funktioniert, geben wir Cloudflare deine webhook.site-URL – als Secret, nicht im Code:

  1. Cloudflare-Dashboard → dein Pages-Projekt meine-webseite
  2. SettingsEnvironment variables (Variablen & Geheimnisse)
  3. Add variable
    • Variable name: LEAD_WEBHOOK_URL
    • Value: (deine kopierte webhook.site-URL einfügen)
    • Encrypt anklicken → so wird daraus ein echtes Secret 🔐
  4. Save
  5. Damit das Secret greift: oben Deployments → beim letzten Deployment ⋯ → Retry deployment (oder warte aufs nächste automatische Deployment)

🔐 Das ist der Unterschied: Eine normale Variable ist sichtbar. Ein Secret ist verschlüsselt – perfekt für Tokens, Passwörter, private URLs.


Phase 7 – Der Moment der Wahrheit 🥁 (5 Min)

  1. Öffne deine Live-URL (…pages.dev)
  2. Trag im Formular einen Vornamen und eine E-Mail ein → Absenden
  3. Du siehst eine freundliche Dankeschön-Meldung
  4. Wechsle zum webhook.site-Tab → dein Lead ist live eingetroffen! 📨🎉

🏆 Du hast es geschafft: eigene Webseite, online gestellt, mit funktionierendem Lead-Formular und sicherem Secret. Das ist – im Kleinen – genau das Prinzip hinter jedem Medumio-Funnel.


🎁 Bonus-Aufgaben (wenn du schneller bist)

Sag Claude einfach, was du willst:


🆘 Wenn etwas klemmt

Der wichtigste Trick: Kopiere die Fehlermeldung in Claude und schreib dazu:

Das ging schief – hier die Meldung: <Fehlermeldung einfügen>. Was bedeutet das und wie behebe ich es?

Häufige Fälle stehen im Dokument 04_Troubleshooting.md – oder ruf eine:n Helfer:in im Raum.

Du brauchst diese Links nochmal: