Baue deine Website mit Claude Code
Dies ist ein Prozess, keine Vorlage. Er lehrt jemanden, wie man eine Website baut, auf die man stolz sein kann – nach eigenem Geschmack, mit eigenen Inhalten, auf dem passenden Stack – mit Claude Code als Bauhelfer. Du lieferst den Rahmen und die Schritte; sie liefern die Vision.
Alles beruht auf einem Perspektivwechsel: Die Person ist die Regisseurin, Claude die Crew. Sie entscheidet, wie es sich anfühlen und wann es gut genug ist; Claude erstellt das Grundgerüst, schreibt, gestaltet, prüft und veröffentlicht. Deine Aufgabe bei der Anwendung dieser Fertigkeit ist es, den Geschmack aus ihnen herauszuholen, ihn in Anweisungen zu verwandeln, die Claude ausführen kann, schnell etwas Live zu bekommen und dann zu iterieren.
Die eine Regel, die alles bestimmt: Hol dir zuerst eine echte, hässliche, live Website, und verbessere sie dann in kleinen, sichtbaren Schritten. Eine Website, die am ersten Tag live ist und 50 Mal überarbeitet wurde, schlägt jedes Meisterwerk, das nie veröffentlicht wird.
Die Denkweise (sprich dies früh laut aus)
- Du führst Regie, Claude baut. Die Person muss nie Code schreiben – oder auch nur die Fachbegriffe kennen. Sie beschreibt Gefühle („wärmer“, „das wirkt beengt“, „zu corporate“) und zeigt darauf; Claude übersetzt es in Pixel.
- Erst live, dann schön. Stelle eine leere Hülle bereit, bevor du stylst, damit du die Pipeline einmal debuggen kannst, während es noch nichts zu zerstören gibt.
- Geschmack in Dateien codieren. Sobald ihnen ein Look gefällt, schreib ihn als Designsystem auf, das sowohl sie als auch Claude in jeder Sitzung lesen – das verhindert, dass die Website abdrifft.
- Kleine, sichtbare Schritte. Eine zusammenhängende Änderung nach der anderen; anschauen; committen. Große unsichtbare Änderungen sind der Tod einer Website.
- Den Kreislauf schließen. Früh veröffentlichen, vor echte Menschen bringen, und deren Feedback direkt als nächste Aufgabenliste an Claude zurückgeben.
- Bei Hindernissen: Claude fragen. Jeder Schritt unten – Konten erstellen, einen roten Terminalfehler beheben, ein verwirrender Host-Bildschirm – ist etwas, das du an Claude zurückgeben kannst, anstatt es allein zu lösen. „Ich habe das noch nie gemacht, führe mich Schritt für Schritt“ und „Hier ist ein Screenshot von dem, was ich sehe“ sind die beiden nützlichsten Sätze, die die Person sagen kann.
So verwendest du diese Fertigkeit
Arbeite die Phasen grob in der Reihenfolge ab, aber sie sind kein starres Wasserfallmodell – Phase 4 (die Iterationsschleife) ist der Motor, der kontinuierlich läuft und die anderen Phasen unterfüttert:
Phase 0 → 1 Rahmen setzen und live bringen · Phase 2 → 3 zu deinem machen und befüllen · Phase 5 → 6 unvergesslich machen und zuhören · Phase 4 läuft die ganze Zeit.
Jede Phase gibt dir das Ziel, die Schritte, einen Copy-Paste-Prompt für die Person, um ihn Claude zu geben, und die eine Falle, die am häufigsten alles zunichtemacht. Tiefergehendes Material findest du in den Referenzdateien – zieh sie heran, wenn eine Phase ernst wird.
Erlaubnis zum Aufhören. Eine ruhige Einseiten-Website – ihr Name, eine Zeile über sie, ein Link – ist eine echte, fertige Website. Wenn sie nach Phase 4 fertig sind, sind sie fertig. Die Phasen 5–6 sind für den Fall, dass sie mehr wollen, nicht eine Hürde, die sie nehmen müssen.
Bevor du beginnst (Claude kann bei all dem helfen)
Die Person braucht vier kostenlose Dinge, bevor Phase 1 losgeht. Alles davon kann eingerichtet werden, indem man Claude bittet, sie Schritt für Schritt zu führen – geh nicht davon aus, dass sie etwas davon schon gemacht haben:
- Claude Code, installiert und geöffnet in einem Ordner für das Projekt.
- Node.js + npm (für die meisten modernen Stacks) – Claude kann mit
node -vprüfen und installieren. - Ein GitHub-Konto (kostenlos) – wo der Code lebt und auf das der Host wartet.
- Ein Hosting-Konto – Vercel, Netlify oder Cloudflare Pages (kostenlose Stufen sind großzügig; manche verlangen auch bei kostenlosen eine Karte – keine Gebühr für eine normale persönliche Website).
Wenn irgendetwas davon unbekannt ist, sollte der allererste Prompt lauten:
Ich habe noch nie ein Programmierprojekt eingerichtet. Überprüfe, ob Node, npm und git auf meinem Rechner installiert sind, und führe mich Schritt für Schritt – einen Schritt nach dem anderen – durch die Installation von allem, was fehlt, und das Erstellen kostenloser GitHub- und [Vercel/Netlify]-Konten. Sag mir genau, worauf ich klicken soll, und warte bei jedem Schritt auf mich.
Schnellstart (eine live Website an einem Nachmittag)
Wenn die Person sofort Schwung haben will:
- Das Geschmacksbriefing erstellen. Stelle die fünf Fragen aus Phase 0; schreibe die Antworten in ein kurzes
BRIEF.md. (~15 Min.) - Eine leere Hülle einrichten + bereitstellen. Wähle einen Stack + einen Push-to-Deploy-Host (wenn unsicher, sag Next.js + Vercel und mach weiter), generiere den Starter mit der offiziellen CLI, pushe zu GitHub, verbinde den Host und bestätige, dass die leere Website unter einer echten URL live ist. (~30 Min., beim ersten Mal länger – Kontoerstellungen und das Verbinden von GitHub mit dem Host fügen ~20–30 Min. hinzu)
- Die Schutzdatei hinzufügen. Erstelle
AGENTS.md, die Claude anweist, die installierte Framework-Dokumentation zu lesen, bevor er Code schreibt (Phase 1). (~2 Min.) - Nur den Hero-Bereich bauen. Ein Bildschirm: ihr Name, eine Zeile über sie, ein Call-to-Action, Farben aus dem Briefing. Im Browser ansehen. (~20 Min.)
- Anpassen und committen. „mach die Überschrift größer“, „wärmerer Hintergrund“, commit, push – es ist live. (~15 Min.)
Sie haben jetzt eine echte Website unter einer echten URL. Alles danach ist Verbesserung – der einfache Teil. (Die Zeitangaben gehen davon aus, dass die oben genannten Konten bereits existieren; die Ersteinrichtung dauert länger, und das ist normal, kein Scheitern.)
Phase 0 – Den Rahmen setzen: Geschmack und Umfang
Ziel: In der Lage sein, in einfachen Worten und Bildern zu beschreiben, wie sich die Website anfühlen soll und welche Seiten sie braucht – bevor eine einzige Komponente gebaut wird.
Schritte
- Befrage die Person. Entwerfe noch nicht; extrahiere. Stelle diese fünf:
- Für wen ist es, und was sollen sie tun oder fühlen? (dich einstellen, dies kaufen, deine Texte lesen, „mich ernst nehmen“, „sehen, dass ich lustig bin“)
- Nenne die Stimmung in 2–3 Wörtern. („warm und redaktionell“, „sauber und technisch“, „laut und verspielt“, „ruhig und teuer“, „dunkel und brutalistisch“). Dränge auf Gefühle, nicht auf Funktionen.
- Zeig mir, was du liebst. URLs von 2–3 Websites, und Screenshots, Moodboards oder jedes Bild, das das Gefühl einfängt – der Geschmack der meisten Menschen ist visuell, nicht verbal, lass sie also Bilder einfügen. Und eine Seite, die sie hassen. Struktur und Stimmung stehlen, niemals Inhalt.
- Was ist die eine Sache, die diese Website unbedingt können muss? (die Texte, die Bilder, die Arbeitsproben, schnell sein)
- Welche Seiten/Abschnitte brauchst du wirklich? Widerstehe Scope Creep – die meisten persönlichen Websites sind Startseite + ein oder zwei weitere.
- Schreibe die Antworten in ein
BRIEF.mdim Stammverzeichnis des Repositorys – der Nordstern, den du und Claude immer prüfen. Wenn sie Bilder gegeben haben, notiere, was von jedem zu übernehmen ist.
Prompt zum Übergeben an Claude
Bevor wir etwas bauen, interviewe mich zu der Website, die ich haben möchte. Frage mich nacheinander: für wen sie ist und was Besucher fühlen oder tun sollen; die Stimmung in 2–3 Wörtern; Seiten, die ich liebe (ich werde Links UND Screenshots/Moodboard-Bilder einfügen – reagiere auch auf die Bilder) plus eine, die ich hasse; die eine Sache, die diese Seite unbedingt können muss; und welche Seiten ich wirklich brauche. Schreibe dann meine Antworten als meinen Nordstern in eine BRIEF.md. Schreibe noch keinen Site-Code.
Die Falle: Mit dem Bauen zu beginnen, bevor jemand das Gefühl beschreiben kann. Wenn sie die Stimmung nicht benennen oder kein Bild davon zeigen können, fällt Claude auf eine generische SaaS-Vorlage zurück, und jede spätere Korrektur kämpft gegen diese Schwerkraft. Hol dir zuerst das Gefühl – in Worten oder Bildern.
Phase 1 – Grundlagen: Eine leere Website live bekommen und absichern
Ziel: Eine leere, aber echte Website, bereits auf einer echten URL bereitgestellt mit eingerichteter automatischer Bereitstellung – damit jede spätere Änderung automatisch veröffentlicht wird – plus eine Schutzvorrichtung, die Claude auf dem Boden der Tatsachen hält.
Du musst nicht wissen, wie man irgendetwas davon macht. Claude gibt dir die genauen Klicks und Befehle und wartet, während du sie ausführst. Wenn ein Bildschirm dich verwirrt, mach einen Screenshot und füge ihn ein – das ist der ganze Arbeitsablauf, kein Scheitern.
Schritte
- Wähle Stack und Host im Voraus (Tabelle unten). Bevorzuge einen Host vom gleichen Anbieter wie das Framework, damit die Standardwerte einfach funktionieren. Jede Variante ist in Ordnung; die schlechteste Entscheidung ist, einen Tag mit der Auswahl zu verbringen.
- Erstelle das Grundgerüst mit der offiziellen CLI des Frameworks, nicht von Hand.
- Stelle die leere Vorlage zuerst bereit. Pushe zu GitHub, verbinde den Host, bestätige, dass die leere Website live ist, bevor du Code anfasst – so debuggt man die Pipeline, während nichts anderes kaputtgehen kann.
- Eine benutzerdefinierte Domain frühzeitig zuweisen, wenn sie eine haben (es ist die echte Adresse; die kostenlose
*.host.app-URL ist temporär). DNS – die Einstellung, die einen Domainnamen auf die Website verweist – kann ein paar Stunden brauchen, um zu wirken, also beginne früh damit. Noch keine Domain? Die Host-URL ist ein guter Anfang; eine kaufen kannst du später. - Die Ground-Truth-Schutzvorrichtung hinzufügen. Schreibe eine
AGENTS.md(und eine einzeiligeCLAUDE.md, die nur@AGENTS.mdsagt), die jedem KI-Agenten mitteilt, dass das installierte Framework neuer sein könnte als seine Trainingsdaten, und die echte Dokumentation innode_modules/<framework>/dist/docszu lesen, bevor Code geschrieben wird. Diese eine Datei verhindert eine ganze Klasse von Fehlern durch halluzinierte APIs. - Geheimnisse von Anfang an aus Git heraushalten. Eine
.gitignoresollte Umgebungsdateien und Build-Ausgaben ausschließen; niemals API-Schlüssel oder private Adressen committen – bewahre sie in den Umgebungseinstellungen des Hosts auf. Bitte Claude, dies bei der Einrichtung des Repos zu erledigen. - Die bereitstellungsrelevanten Fakten notieren, die Claude nicht ableiten kann: Produktions-URL, Host, welcher Branch automatisch bereitgestellt wird, der genaue Repository-Slug, alle Fallstricke. In einer Notizen-/Gedächtnisdatei speichern – die Live-Domain ist meist nicht aus dem Code ersichtlich.
- Lokale Vorschau + einen Gesundheitscheck einrichten: eine Ausführungskonfiguration (oder dokumentierter
dev-Befehl + Port) und eine einzeilige Prüfung, dass die lokale URL HTTP 200 zurückgibt, damit du testen kannst, bevor du pushst.
Entscheidungstabelle – eine Variante wählen und weitermachen
| Wenn die Seite… ist | Sinnvoller Standard-Stack | Host |
|---|---|---|
| Ein Portfolio / Persönliche Seite / Lebenslauf | Next.js oder Astro | Vercel / Netlify |
| Hauptsächlich Text / ein Blog | Astro oder Next.js | Vercel / Netlify |
| Eine einzelne Landing-/Marketing-Seite | Astro oder Vite + React | Netlify / Cloudflare Pages |
| Etwas, das du als einfache Dateien bearbeiten willst | Reines HTML + CSS (ohne Build-Schritt) | Netlify / CF / GitHub Pages |
| „Ich weiß nicht, mach es einfach“ | Next.js + Vercel | Vercel |
(Die letzte Zeile wählt Next.js + Vercel nur, weil es der am meisten dokumentierte Pfad ist, auf den Claude sich stützen kann – jede Variante oben ist gleichermaßen legitim.)
Prompt zum Übergeben an Claude
Erstelle mit dem offiziellen Tool eine brandneue [Next.js / Astro / reine HTML+CSS]-Website, lasse den Starter unberührt, und führe mich dann durch: git init + erster Commit (mit einer .gitignore, die Umgebungs-/Geheimnisdateien ausschließt), Erstellen eines GitHub-Repositorys und Verbinden von [Vercel / Netlify], sodass jeder Push auf main automatisch bereitgestellt wird. Bestätige, dass die leere Website unter einer echten URL live ist, bevor wir Code schreiben. Erstelle dann eine AGENTS.md, die jedem KI-Agenten mitteilt, dass das installierte Framework neuer sein könnte als seine Trainingsdaten und die Dokumentation in node_modules/[framework]/dist/docs LESEN soll, bevor Code geschrieben wird, plus eine CLAUDE.md, die nur `@AGENTS.md` enthält. Speichere schließlich meine Produktions-URL, Host, Bereitstellungs-Branch und Repository in einer Notizdatei. Gib mir genaue Klicks und warte bei jedem Schritt auf mich.
Die Falle: Die gesamte Website zu bauen, bevor sie einmal bereitgestellt wird (dann debuggt man Code und Pipeline gleichzeitig) oder sich auf die Erinnerung des Modells an ein sich schnell veränderndes Framework zu verlassen, anstatt es an die installierte Dokumentation zu binden.
→ Medien, Größenbeschränkungen, Codierungsbefehle, Überprüfung der Produktion: references/PLAYBOOK.md.
Phase 2 – Die Designsprache kodifizieren
Ziel: Ein geschriebenes, maschinenlesbares Designsystem – Farbe, Schriftart, Abstände, Bewegung, Stimme – das sowohl die Person als auch Claude in jeder Sitzung lesen, damit jede neue Seite markenkonform bleibt, anstatt in fünf leicht unterschiedliche Looks abzudriften.
Mach dies nachdem du eine Seite hast, die dir wirklich gefällt, nicht vorher. Du extrahierst das System aus etwas Gutem; du erfindest es nicht im luftleeren Raum.
Schritte
- Benenne zuerst die Stimmung in Worten, leite dann jede Regel daraus ab. Zwei kurze Phrasen; wenn zwei Stimmungen in Spannung stehen, wird diese Spannung zu einer Regel. (Ein echter Build hatte die Phrasen „warme redaktionelle Ruhe + verspielte Pixel-Handwerkskunst“ – aber eine „ruhige und teure“ oder „laute und brutale“ Site würde ihre eigenen nennen und sehr unterschiedliche Regeln ableiten.)
- Farbe bewusst und konsistent einsetzen. Eine zurückhaltende Palette – oft ein einzelner Akzent – hält die Hierarchie lesbar und ist der sichere Standard. Aber wenn der Geschmack maximalistisch, retro oder brutalistisch ist, ist ein Mehrfarben-System eine legitime Wahl. Die Regel ist nicht „genau ein Akzent“; es ist, dass jede Farbe eine definierte Rolle hat und überall gleich verwendet wird.
- Farbe als rollenbasierte Tokens, nicht als Hex-Codes im Markup verteilt. Drücke weichen Text und Rahmen als eine Tintenfarbe mit reduzierter Deckkraft aus, anstatt fünf fast identische Grautöne zu erfinden.
- Schriftarten nach Rolle kombinieren, nicht nach Name (Text/Benutzeroberfläche, Überschriften/„Stimme“, Mono, Auszeichnung). Verweise auf die Rolle, damit die tatsächliche Schriftart später ohne Umschreiben geändert werden kann.
- Einen Rhythmus für Abstände und eine Hierarchie für z-index festlegen und „erfinde keine neuen Werte“ schreiben.
- Eine Bewegungsphilosophie darlegen, die zur Stimmung passt: günstige Umgebungsschleifen in CSS, interaktives Feedback in einer JS-Bibliothek; sperre nicht essenzielle Bewegung hinter
prefers-reduced-motion. - Eine zugängliche Baseline setzen (es ist Teil der Qualität, kein Zusatz): Text-Hauptkontrast ≥ 4,5:1, echte Überschriftenreihenfolge, sichtbare Fokus-Zustände, semantische Landmarken, Alternativtext bei bedeutungsvollen Bildern. Eine fette/dunkle Palette ist genau der Punkt, an dem der Kontrast leise versagt.
- Stimme und Ton als Design aufschreiben – Text ist Teil des Looks (Groß-/Kleinschreibung? verspielt? einfache Worte? kein Corporate-Gefüllsel?).
- In zwei verbindlichen Dateien kodifizieren: einem Prosa-
DESIGN_SYSTEM.md(Prinzipien + Komponenten-Rezepte + eine Build-Checkliste) und einertokens-Datei (die Rohwerte). Markiere es als nur für die Zukunft gültig – extrahiert aus bestehenden Seiten, kein Migrationsziel –, damit Claude nicht „hilfreich“ funktionierenden Code umbaut. - In den Kontext einbinden: Verweise dar…
[Fortsetzung folgt – der Rest wird entsprechend übersetzt.]
Referenzdateien
references/PLAYBOOK.md– Tiefergehende Details zu Medien, Größenbeschränkungen, Bereitstellungs-Checks.- Weitere Referenzen werden bei Bedarf hinzugefügt.