← Notizen

Websites mit Claude Code und Codex bauen — Skills von der Planung bis zur Bereitstellung

Auf dieser Seite

Bei einer kleinen Firmenwebsite beginnen Sie damit, Texte und Seitenstruktur festzulegen, die Oberfläche zu bauen und den Weg zur Kontaktaufnahme im Browser zu prüfen. Für eine Web-App mit Anmeldung oder Bezahlung planen Sie zuerst auch Berechtigungen, Datenspeicherung und den Umgang mit Fehlern. Über die Art der Website lässt sich konkreter festlegen, welche Skills Sie brauchen und woran Sie das Ergebnis messen.

Die Empfehlungen für die einzelnen Phasen basieren auf den offiziellen Skill-Quellen von Anthropic, OpenAI und Vercel, geprüft am 19. November 2026. In den Beispielen übernehmen Agenten in Claude Code und Codex CLI einzelne Aufgaben. Anthropic Skills · OpenAI Build Web Apps · Vercel Agent Skills

Skills passend zur Website auswählen

Vorhaben Zuerst klären Typische Abfolge
Firmenwebsite, Portfolio oder Blog Zielgruppe, wichtigste Aktion, öffentliche Seiten und Pflege der Inhalte Seitentexte → Umsetzung → Browserprüfung → Bereitstellung prüfen
Web-App für Buchung, Zahlung oder Verwaltung Nutzerberechtigungen, zu speichernde Daten, Erfolgs- und Fehlerbehandlung sowie Betriebsprotokolle Oberflächen und Zustände entwerfen → Oberfläche und Server umsetzen → Normal- und Fehlerfälle testen → Vorschau → Produktion prüfen

Falls es bereits ein Repository gibt, prüfen Sie zuerst dessen Framework und Bereitstellungsverfahren. Einen Beitrag und einen Kontaktlink können Sie zum Beispiel innerhalb des vorhandenen Astro-Blogs ergänzen. Wählen Sie Performance-Skills für React und Next.js oder Zahlungs-Skills, wenn Sie die jeweilige Technik oder Funktion tatsächlich brauchen.

Phase Empfohlener Skill oder Leitfaden Aufgabe und Prüfung
Planung und Texte Projektinterne Anleitung website-copywriting Zielgruppe und zentrale Aktion festlegen und Überschrift, Beschreibung und Kontakttext schreiben. Auf dem ersten Bildschirm prüfen, ob verständlich ist, wem der Dienst was bietet.
Oberflächenentwurf Projektinterne Anleitung frontend-architecture-design Seitenpfade, Zuständigkeiten für Komponenten und Zustände sowie Erfolgs- und Fehleransichten festlegen. Bei Buchungen auch Mehrfachklicks beim Absenden und Wiederholungen nach einem Speicherfehler einplanen.
Oberfläche umsetzen frontend-design für Claude Code oder frontend-app-builder für Codex Abgestimmte Texte und Struktur mit den vorhandenen Projektkomponenten umsetzen. Prüfen, ob Überschrift, Aktionsschaltfläche und Inhalt auch auf schmalen Bildschirmen in der vorgesehenen Reihenfolge lesbar sind.
Im Browser prüfen webapp-testing für Claude Code, frontend-testing-debugging für Codex In der mobilen Ansicht Kontaktlink, Formularfehler und Konsole kontrollieren. Geprüfte URL, Bildschirmgröße, konkrete Schritte und Ergebnis festhalten.
Barrierefreiheit prüfen web-design-guidelines von Vercel Beschriftungen, Kontrast und Fokus im Code prüfen. Im Browser die Tab-Reihenfolge und den sichtbaren Fokus kontrollieren. Automatische Ergebnisse und manuelle Prüfungen dokumentieren.
React-Performance react-best-practices aus Build Web Apps In React- oder Next.js-Projekten aufeinanderfolgende Datenanfragen und das initiale Bundle untersuchen. Vor und nach der Änderung unter denselben Bedingungen messen und erst dann die Wirkung bewerten.
Bereitstellung deployments-cicd für Vercel oder Projektanleitung Vorschau- oder Staging-URL beim verwendeten Hoster kontrollieren und die freigegebene Version bereitstellen. Endgültige URL und Version für einen Rollback festhalten.

Die ersten beiden Zeilen zeigen Rollen, für die Sie eigene Vorgaben im Projekt anlegen können. Öffentliche Skills installieren Sie über die vom jeweiligen Anbieter genannten Wege. In Claude Code enthält example-skills im offiziellen Anthropic-Marketplace Skills für Umsetzung und Tests. In Codex bündelt das Plugin Build Web Apps Skills für Oberflächen, Tests und React-Optimierung. Den Vercel-Skill verwenden Sie bei einer Bereitstellung auf Vercel. Für GitHub Pages richten Sie sich nach den Actions und dem Vorschauverfahren des Repositorys. Claude-Code-Installationsanleitung · Inhalt von OpenAI Build Web Apps

Skills für eine kleine Website aufeinander abstimmen

Ein kurzer Auftrag genügt. Wenn Sie Informationen zum Dienst, die Seitenstruktur und die zu prüfenden Aktionen gemeinsam angeben, gelten für Planung, Umsetzung und Tests dieselben Kriterien.

Beispielprompt Erstelle eine Seite für ein fiktives Fotostudio. Die Besucher möchten wissen, wo fotografiert wird und wie sie sich beraten lassen können. Zeige die Vorstellung und die Beratung auf einer Seite. Verlinke den Kontaktlink im ersten Bildschirm mit dem Beratungsabschnitt. Halte die Reihenfolge Vorstellung, Kontaktlink, Beratung ein. Berücksichtige eine schmale Ansicht mit 360px und die Bedienung per Tastatur. Prüfe nach der Umsetzung bei 360px und 1280px, ob es horizontalen Überlauf gibt. Erreiche den Kontaktlink mit Tab und öffne den Beratungsabschnitt mit Enter. Halte das Ergebnis jedes Schritts und die ungeprüften Punkte fest.

Übergeben Sie die Vorstellung und den Kontaktlink an die Umsetzung. Verwenden Sie Bildschirmbreiten und Tastaturbedingungen als Prüfkriterien. Wenn der Test fehlschlägt, geben Sie dem Agenten für die Umsetzung die betroffene Breite und die fehlgeschlagene Aktion. Wiederholen Sie nach der Korrektur den Test unter denselben Bedingungen. Prüfen Sie bei der Barrierefreiheit zusätzlich Kontrast, die von Screenreadern ausgegebenen Namen und die Fokusposition nach einem Seitenwechsel.

Übung — den Weg zur Kontaktaufnahme mit Playwright prüfen

Die Übung enthält eine Seite im Testskript und prüft sie im Browser bei zwei Breiten. Bereiten Sie in einem neuen Verzeichnis Node.js 22 und Chrome vor. Führen Sie npm init -y aus und installieren Sie die Abhängigkeit mit npm install --save-dev playwright-core@1.64.1. Speichern Sie den folgenden Code als website-check.mjs und starten Sie ihn unter macOS mit node website-check.mjs. Wenn Chrome an einem anderen Ort installiert ist, setzen Sie CHROME_PATH auf den Pfad zur ausführbaren Datei. Playwright-Optionen zum Browserstart

Die Seite bei zwei Bildschirmbreiten öffnen und auf horizontalen Überlauf prüfen. Mit Tab zum Kontaktlink und mit Enter zum Beratungsabschnitt gelangen. Fehlgeschlagene Bedingungen korrigieren und unter denselben Bedingungen erneut testen.

import assert from 'node:assert/strict';
import { chromium } from 'playwright-core';

const html = `<!doctype html>
<html lang="ko">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>봄 사진 스튜디오</title>
<style>
  body { margin: 0; font: 1rem/1.6 system-ui; }
  main { max-width: 42rem; margin: auto; padding: 1rem; }
  section { min-height: 74vh; }
</style>
<main>
  <section>
    <h1>봄 사진 스튜디오</h1>
    <p>프로필 사진과 가족사진을 촬영합니다.</p>
    <a href="#contact">문의하기</a>
  </section>
  <section id="contact">
    <h2>상담 안내</h2>
    <p>촬영 목적과 희망 일정을 준비해 주세요.</p>
  </section>
</main>
</html>`;

const browser = await chromium.launch({
  executablePath: process.env.CHROME_PATH
    ?? '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
});

try {
  for (const width of [360, 1280]) {
    const page = await browser.newPage({ viewport: { width, height: 700 } });
    try {
      await page.setContent(html);
      const overflow = await page.evaluate(
        () => document.documentElement.scrollWidth > window.innerWidth,
      );
      assert.equal(overflow, false, `가로 넘침: ${width}px`);

      await page.keyboard.press('Tab');
      const focused = await page.evaluate(
        () => document.activeElement?.getAttribute('href'),
      );
      assert.equal(focused, '#contact', `문의 링크 포커스: ${width}px`);
      await page.keyboard.press('Enter');
      await page.waitForURL(/#contact$/);
      const heading = await page.getByRole('heading', { name: '상담 안내' }).boundingBox();
      assert.ok(heading && heading.y >= 0 && heading.y + heading.height <= 700);
      console.log(`PASS ${width}px: no overflow, keyboard link reaches contact`);
    } finally {
      await page.close();
    }
  }
} finally {
  await browser.close();
}

Das Ergebnis ist unten zu sehen. Jedes PASS bedeutet, dass nichts horizontal überläuft, der Kontaktlink per Tastatur erreichbar ist und die Überschrift des Beratungsabschnitts im sichtbaren Bereich erscheint.

PASS 360px: no overflow, keyboard link reaches contact
PASS 1280px: no overflow, keyboard link reaches contact

Starten Sie im eigentlichen Projekt einen lokalen Server und rufen Sie die implementierte Seite mit page.goto() auf, statt einen HTML-String zu verwenden. Für ein Kontaktformular ergänzen Sie eigene Prüfungen für leere Pflichtfelder, erhaltene Eingaben nach einem Sendefehler und die Erfolgsmeldung. Als das Linkziel auf ein anderes URL-Fragment gesetzt wurde, schlug die Linkprüfung bei 360px fehl. Das Beispiel prüft eine HTML-Übungsseite bei zwei Breiten in Chrome.

Prüfungen nach der Bereitstellung

Rufen Sie die wichtigsten Seiten und den Kontaktweg unter der Vorschau- und Produktions-URL erneut auf. Prüfen Sie die Serverantworten und statischen Ressourcen. Kontrollieren Sie bei Seiten, die in der Suche erscheinen sollen, Titel, Beschreibung, kanonische URL, interne Links und Sitemap. Ob die Suchmaschine die Seite tatsächlich gefunden und indexiert hat, prüfen Sie separat in der Search Console. Googles SEO-Leitfaden

Diskussion

Auf GitHub ansehen ↗