Claude Code meistern

Ein Agent ist nur so gut wie das, was du ihm gibst

Ein Modell antwortet aus dem, was es sieht. Gib ihm die richtigen Fakten, das passende Maß an Denkarbeit, einen Weg, sein Ergebnis zu belegen, und klare Grenzen, dann liefert es. Fehlt eines davon, rät es mit voller Überzeugung.

Vier Fragen ziehen sich durch den ganzen Workshop:

• Kontext. Hat der Agent die richtigen Fakten?
• Denkaufwand. Lohnt sich für diese Aufgabe ein größeres Modell oder mehr Aufwand?
• Belege. Was beweist, dass das Ergebnis stimmt?
• Autonomie. Verdienen deine Prüfungen und Grenzen, dass du dich zurückziehst?

Du lernst, sie mit Claude Code zu beantworten, in vier Stufen. Jede Stufe ist ein Gürtel, und jeder Gürtel endet mit etwas, das läuft.

Vier Gürtel

• Weißer Gürtel, Grundlagen. Was ein Modell ist, was die Harness drumherum tut, dein erstes Gespräch mit Claude Code.
• Blauer Gürtel, CLASH bauen. Von der Spezifikation zur laufenden App: erst planen, in kleinen Schritten arbeiten, Claude die Seite ansehen lassen, wie ein Fremder reviewen.
• Brauner Gürtel, Kontext steuern. Eine CLAUDE.md aus echten Regeln schreiben, eine Gewohnheit als Skill verpacken, mit Subagents prüfen, aus einer Story eine Spezifikation machen, Regeln auf Pfade begrenzen.
• Schwarzer Gürtel, orchestrieren und loslassen. Tests als Maßstab, Agent Teams und Dynamic Workflows, Hooks, der Browser als Prüfung, Worktrees und CI, das Agent SDK, geplante und Hintergrundarbeit, dein eigener MCP-Server.

Eine echte App

Du baust CLASH, eine Karten-App für spontane Treffen in Berlin. Ein Clash ist eine Aktivität an einem Ort zu einer Zeit. Leute treten bei, Gastgeber nehmen an oder lehnen ab, Benachrichtigungen folgen. Du startest mit einer Spezifikation und einem leeren Repository. CLASH ist online und kostenlos nutzbar, du kannst es also ausprobieren, bevor du es selbst baust.

Echter Code hat echte Fehler: eine Server Action, die die Ownership nicht prüft, eine Karte, die auf dem Server abstürzt, ein Avatar, der jede Seite ausbremst. Du findest sie und behebst sie mit Belegen.

Am Ende hast du:

• CLASH, selbst gebaut mit Claude Code und verglichen mit der Referenz
• eine CLAUDE.md aus echten Regeln, einen wiederverwendbaren Skill und einen Satz Hooks
• ein Autorisierungs-Audit, auf drei Wegen ausgeführt, mit gemergtem Fix
• eine Browser-Testsuite und eine gemessene Performance-Korrektur
• das Audit in der CI, einen Worktree-Ablauf und ein kleines Agent-SDK-Programm
• Claude Code, das arbeitet, ohne dass jemand an der Tastatur sitzt: ein Output Style, ein Ziel, ein Loop, eine Background Session und eine Routine
• deinen eigenen MCP-Server für CLASH und eine zweite App, die ihre Vorträge darüber als Clashes veröffentlicht

So läuft es ab

Der Trainer erklärt eine Idee, zeigt sie live, und dann machst du sie selbst auf deinem Rechner. Jede Aufgabe hat einen Reset-Branch, also bleibt niemand hängen und niemand wartet auf die Gruppe. Folien, Aufgabendateien und Musterlösungen behältst du.

Für wen

Für alle, die programmieren und Claude Code gut nutzen wollen. Grundkenntnisse in einer gängigen Programmiersprache reichen, dazu die Grundlagen von git. Die App, die du baust, CLASH, ist in TypeScript geschrieben. Du musst TypeScript nicht kennen: Wenn du Code in einer anderen Sprache lesen kannst, kommst du mit, und Claude Code erklärt dir, was neu ist. Erfahrung mit Claude Code brauchst du nicht.

Was du brauchst

Einen Laptop mit Node.js 20.19 oder neuer, git und der GitHub CLI. Einen Claude-Account mit Zugang zu Claude Code: Pro reicht, ein höherer Tarif gibt der Agent-Team-Aufgabe mehr Luft. Einen GitHub-Account. Die vollständige Setup-Checkliste findest du auf deiner Workshop-Seite, sobald du angemeldet bist.

Weißer Gürtel: Grundlagen

Du lernst, was ein Modell ist, was die Harness drumherum tut und wie du ein Gespräch auf Kurs hältst.

1. Wie ein Modell funktioniert. Tokens, Wahrscheinlichkeiten, kein Gedächtnis, ein begrenztes Kontextfenster: warum ein Sprachmodell rät und Claude Code ihm Dateien vorlegt.
2. Die Harness und dein erstes Gespräch. Was Claude Code um das Modell legt: Loop, Prompt, Tools, Permissions. Dann startest du es in einem Projekt und fragst nach einer Datei.
   Aufgabe: Claude Code einrichten und die erste Frage stellen.

Blauer Gürtel: CLASH bauen

Du gehst in kleinen Schritten von der Spezifikation zur laufenden App.

3. Plane, bevor du baust. Schreib ein Briefing mit Ziel, Regeln und Definition of Done und prüfe im Plan Mode eine Änderung, bevor Claude eine Datei anfasst.
   Aufgabe: Die App aufsetzen und ihr Datenmodell planen.
4. Kleine Schritte und der Sicherheitsmoment. Arbeite in Schritten, die du prüfen kannst, nimm einen mit /rewind zurück und sieh, warum jede Server Action einen eigenen Ownership-Check braucht.
   Aufgabe: Login und Clashes in kleinen Schritten bauen.
5. Lass Claude das Ergebnis sehen. Nutze ein Muster wieder, indem du darauf zeigst, gib Claude den Fehler oder die Live-Seite und ergänze Quality Gates in CLAUDE.md.
   Aufgabe: Venues, Karte und Benachrichtigungen bauen.
6. Parallele Jobs, Memory und Review. Bündle unabhängige Jobs, lass Arbeit im Hintergrund laufen, speichere eine Regel, reviewe deinen Diff wie ein Fremder und liefere aus.
   Aufgabe: Die App fertigstellen, prüfen und ausliefern.

Brauner Gürtel: Kontext steuern

Du entscheidest, was Claude weiß, wann es das lädt und wer die Arbeit prüft.

7. Kontext und CLAUDE.md. Lies /context, schreibe eine CLAUDE.md aus sechs echten CLASH-Regeln und prüfe einen Plan im Plan Mode, bevor Code entsteht.
   Aufgabe: Eine CLAUDE.md aus echten Regeln schreiben und einen Plan prüfen.
8. Skills und Plugins. Schreibe einen Skill für ein Rezept, das du wiederholst, prüfe, was Skills im Kontext kosten, und verpacke ihn als Plugin zum Teilen.
   Aufgabe: Den Skill clash-feature schreiben und Venue-Favoriten damit liefern.
9. Subagents für Audits. Gib ein Audit an einen schreibgeschützten Subagent, damit dein Kontext kaum wächst, und unterscheide einen frischen Subagent von einem Fork.
   Aufgabe: Die Server Actions mit einem schreibgeschützten Subagent prüfen.
10. Von der Story zur Spezifikation. Mach aus einer vagen Story per Example Mapping eine feste Spezifikation, mit einem Skill, der dich erst interviewt, bevor er etwas entwirft.
    Aufgabe: Den Skill discover bauen und eine feste Spec speichern.
11. Pfadbezogene Regeln. Begrenze eine Regel per paths: auf app/actions/** und prüfe in /context, dass sie nur beim passenden Lesen geladen wird.
    Aufgabe: Eine pfadbezogene Regel für Server Actions schreiben.

Schwarzer Gürtel: orchestrieren und loslassen

Du setzt Tests, Teams, Hooks und einen Browser als Prüfungen ein und trittst dann bewusst zurück.

12. Der testgetriebene Inner Loop. Steuere Code Regel für Regel anhand einer gespeicherten Spezifikation und verpacke den Red-Green-Zyklus als Skill, der sich selbst stoppt.
    Aufgabe: Die Kapazitätsregeln mit einem TDD-Skill steuern.
13. Agent-Teams und Dynamic Workflows. Beschreibe ein Agent-Team und einen Dynamic Workflow in einfachen Worten, lies das erzeugte Script und wähle die passende Methode.
    Aufgabe: Das Ownership-Audit als Team und als Workflow ausführen.
14. Hooks und Sicherheit. Mach aus einer wiederholten Regel einen Hook, der blockiert, warnt oder einen Turn offen hält, und lerne, wo Claudes Zugriff auf deine Dateien endet.
    Aufgabe: Vier Hooks für Claude Code bauen.
15. Der Browser schließt den Kreis. Lass Claude per MCP einen echten Browser steuern, schreibe den Test erst nach dem funktionierenden Ablauf und belege einen Fix mit Messwerten.
    Aufgabe: Den Join-Flow testen und die Avatar-Datenlast beheben.
16. Worktrees, Batch und CI. Führe Agents parallel in getrennten Worktrees aus, erkenne, wann /batch passt, und lass dasselbe Audit bei jedem Pull Request in der CI laufen.
    Aufgabe: Zwei Worktrees nutzen und jeden Pull Request prüfen.
17. Das Agent SDK. Betreibe den Agent Loop von Claude Code in deinem eigenen Programm, mit schreibgeschützten Tools, einem Hook und einem Turn-Limit.
    Aufgabe: Den Agent Loop in einem eigenen Programm betreiben.
18. Abschlussprojekt. Liefere ein Feature im Referenzprojekt CLASH als Pull Request aus und setze dabei jedes Tool des Workshops zusammen ein.
    Aufgabe: Ein Feature mit jedem Tool des Workshops ausliefern.
19. Niemand an der Tastatur. Lege einen Output Style fest, begrenze einen Run mit /goal, wiederhole eine Prüfung, starte ein Audit im Hintergrund und sieh eine Cloud-Routine.
    Aufgabe: Claude Code laufen lassen, ohne dass jemand an der Tastatur sitzt.
20. Baue deinen eigenen MCP-Server. Entwirf einen MCP-Server mit vier Tools für die CLASH-Datenbank, vertraue ihm gezielt und rufe ihn aus einer zweiten App auf.
    Aufgabe: Einen MCP-Server für CLASH entwerfen.