Claude-Code-Tutorial: Dein erstes Projekt am Wochenende (2026)

Um Claude Code zu nutzen, startest du ihn in einem Projektordner, beschreibst das gewünschte Ergebnis in normaler Sprache, lässt ihn planen, gibst seine Änderungen frei oder prüfst sie und kontrollierst das Ergebnis selbst, bevor du weitermachst. Dieses Tutorial zeigt diese Schleife an einem kleinen, echten Projekt, das du an einem Wochenende fertig bekommst: einer einseitigen Website für ein lokales Geschäft. Du siehst genau, was du eintippst, wie Berechtigungen und der Plan-Modus funktionieren und wie du einen Schritt rückgängig machst, der schiefgegangen ist.

Das Beispielunternehmen ist erfunden: Muddy Paws Grooming, ein Hundesalon. Setz dein eigenes Unternehmen ein oder das einer Freundin, dann hast du am Ende des Wochenendes etwas wirklich Nützliches.

Was du vor dem Start brauchst

• Claude Code, installiert und angemeldet. Falls das noch nicht erledigt ist, folge zuerst der Installationsanleitung für Mac und Windows.
• Einen bezahlten Claude-Plan, denn der kostenlose Plan enthält Claude Code nicht.
• Die Angaben zum Unternehmen: Name, Angebot, drei Leistungen mit Preisen, Öffnungszeiten, Einzugsgebiet, Telefonnummer, einen Buchungslink, falls es einen gibt, und zwei oder drei echte Kundenbewertungen.
• Ein paar konzentrierte Sitzungen: eine am Samstag zum Bauen, eine am Sonntag für den Feinschliff.

Im Folgenden nutze ich die Terminal-Version. Der Code-Tab der Desktop-App hat dieselben Steuerelemente, die Auswahl für den Berechtigungsmodus sitzt dort neben dem Senden-Button.

Samstagvormittag: das Projekt einrichten

Schritt 1: Ordner anlegen und eine Sitzung starten

Jedes Projekt bekommt einen eigenen Ordner. Claude Code kann alles in dem Ordner lesen, in dem du ihn startest. Ein aufgeräumter Ordner hält ihn deshalb fokussiert und deine anderen Dateien außer Reichweite.

Auf dem Mac:

$ mkdir -p ~/claude-projects/muddy-paws
$ cd ~/claude-projects/muddy-paws
$ claude
$ 

Unter Windows, in PowerShell:

PS> mkdir -Force "$HOME\claude-projects\muddy-paws"
PS> cd "$HOME\claude-projects\muddy-paws"
PS> claude
PS> 

In der Desktop-App öffnest du den Code-Tab, wählst Lokal (Local), klickst auf Ordner auswählen (Select folder) und legst dort denselben Ordner an.

Schritt 2: Wähle, wie viel Kontrolle du willst

Claude Code hat Berechtigungsmodi: Einstellungen, die festlegen, welche Aktionen er ausführen darf, ohne dich zu fragen. Mit Shift+Tab schaltest du durch, die Zeile unter dem Eingabefeld zeigt den aktuellen Modus, und aktuelle Versionen starten neue Terminal-Sitzungen im Auto-Modus.

Wenn Claude Code um Erlaubnis fragt, genehmigt Yes genau diese eine Aktion. Yes, and don't ask again speichert eine Regel, damit dieser Befehl in diesem Projekt künftig ohne Nachfrage läuft, und No lehnt ab (Esc macht dasselbe). Ist Yes oder No markiert, drückst du Tab und hängst eine Notiz an, etwa „Nein, nimm stattdessen die Fotos aus dem Ordner images“, und Claude passt sich an.

Schritt 3: Schreib das Briefing im Plan-Modus

Drück Shift+Tab, bis die Statuszeile ⏸ plan mode on zeigt, oder tipp /plan an den Anfang deiner Nachricht. Füg dann ein Briefing wie dieses ein, mit deinen eigenen Angaben:

Ich möchte eine einseitige Website für Muddy Paws Grooming, einen Hundesalon in [ORT].

Zielgruppe: vielbeschäftigte Hundebesitzer aus der Nähe, die meistens am Handy buchen.
Ziel: Sie sollen auf „Termin buchen“ ([BUCHUNGSLINK]) tippen oder [TELEFONNUMMER] anrufen.

Abschnitte, in dieser Reihenfolge:
1. Überschrift, die sagt, was wir machen und wo, mit dem Buchungsbutton
2. Drei Leistungen mit Preisen: [LEISTUNG UND PREIS] x3
3. Öffnungszeiten und Adresse
4. Zwei Kundenbewertungen: [ECHTE BEWERTUNGEN EINFÜGEN]
5. Kontakt: Telefon, E-Mail und ein Link zur Karte

Stil: freundlich und aufgeräumt, viel Weißraum, große Schrift, am Handy leicht zu bedienen.
Vorgaben: eine Datei index.html und eine Datei styles.css. Keine Frameworks. Keine Fotos, die ich nicht freigegeben habe.
Fertig heißt: Ich kann index.html im Browser öffnen, alles oben Genannte ist da und am Handy gut lesbar.

Bevor du irgendetwas schreibst, stell mir bis zu fünf Fragen zu dem, was noch fehlt, und schlag dann einen Plan vor.

Claude liest den leeren Ordner, stellt seine Fragen (manchmal als Multiple Choice) und legt dann einen Plan vor: welche Dateien er anlegt, was in jeden Abschnitt kommt und was er noch von dir braucht. Um den Plan direkt zu ändern, drückst du Ctrl+G und öffnest ihn in deinem Texteditor.

Samstagnachmittag: bauen, anschauen, reagieren

Schritt 4: Gib den Bau Schritt für Schritt frei

Claude legt jetzt index.html an, dann styles.css. Vor jeder Datei zeigt er dir, was er schreiben will, und wartet auf deine Antwort. Gib frei, wenn es zum Plan passt, und schau bei jedem Befehl genauer hin, der Dateien löscht oder über den Ordner hinausgreift.

Wenn er fertig ist, öffnest du die Seite per Doppelklick auf index.html im Finder oder Datei-Explorer, oder du tippst auf dem Mac ! open index.html in Claude Code. Das ! am Anfang führt einen Befehl selbst aus, ohne den Umweg über Claude.

Schritt 5: Gib Feedback wie ein Kunde

Hier entsteht der größte Teil des Nutzens. Reagier so, wie es ein pingeliger Kunde tun würde: kurz, konkret, eine Sache nach der anderen.

Wenn du @ und einen Dateinamen tippst, etwa @brand.txt, verweist du Claude genau auf diese Datei, und er liest sie, bevor er handelt. Um ein Problem zu zeigen, statt es zu beschreiben, machst du einen Screenshot und fügst ihn in Claude Code ein: in den meisten Terminals mit Ctrl+V, in iTerm2 mit Cmd+V und unter Windows mit Alt+V.

Du musst nicht schweigend warten, während er arbeitet. Tipp eine Korrektur und drück Enter, dann liest Claude sie, sobald sein aktueller Schritt fertig ist. Oder drück Esc, um ihn sofort zu stoppen.

Schritt 6: Mach eine Änderung rückgängig, die dir nicht gefällt

Früher oder später macht eine Änderung etwas schlechter. Du hast drei Wege zurück:

1. Fragen. „Mach die letzte Änderung rückgängig“ reicht in einfachen Fällen.
2. Zurückspulen. Drück zweimal Esc bei leerem Eingabefeld oder tipp /rewind, wähl die Nachricht von vor dem Fehler und dann Restore code and conversation (Code und Gespräch zurücksetzen), Restore code (der Chat bleibt, die Dateien werden zurückgesetzt) oder Restore conversation (die Dateien bleiben, der Chat wird zurückgespult).
3. Zu einer gespeicherten Version zurückgehen, wenn du git nutzt, ein kostenloses Tool, das benannte Schnappschüsse eines Projekts speichert.

Für ein richtiges Sicherheitsnetz bittest du einfach darum. Auf den meisten Macs ist git schon vorhanden, unter Windows installierst du zuerst Git for Windows.

Mach aus diesem Ordner ein git-Repository und speichere die aktuelle Version mit einer klaren Beschreibung dessen, was funktioniert.

Sonntag: alles stabil machen

Schritt 7: Halte fest, worauf ihr euch geeinigt habt

Inzwischen hast du Entscheidungen zu Farben, Ton und „immer die Handybreite prüfen“ getroffen. Speichere sie, damit du sie nie wiederholen musst:

Erstelle für dieses Projekt eine Datei CLAUDE.md mit den Angaben zum Unternehmen, den Stilregeln, auf die wir uns geeinigt haben, und der Regel, die Seite in Handybreite zu prüfen, bevor du sagst, dass du fertig bist.

CLAUDE.md ist eine einfache Textdatei, die Claude Code zu Beginn jeder Sitzung in diesem Ordner liest. Änderungen, die du mitten in einer Sitzung machst, wirken nach /clear oder in der nächsten Sitzung. Die Anleitung zur CLAUDE.md-Datei zeigt mit Vorlagen, was hineingehört.

Schritt 8: Lass dir eine Prüfung mit Belegen geben

Prüfe die Seite wie ein pingeliger Kunde. Kontrolliere, dass jeder Abschnitt aus meinem Briefing da ist, dass jeder Link und die Telefonnummer funktionieren, dass der Text in Handybreite lesbar ist, dass Bilder einen Alt-Text haben und dass kein Name, kein Preis und keine Uhrzeit von meinem Briefing abweicht. Behebe, was du kannst, und liste dann auf, was du geändert hast und was du noch von mir brauchst.

Dann prüfst du selbst: Klick jeden Link an, zieh das Browserfenster auf Handybreite zusammen und lies jeden Preis laut gegen deine Preisliste. Wenn du in Schritt 6 git eingerichtet hast, zeigt /diff, was sich seit der letzten gespeicherten Version geändert hat.

Schritt 9: Entscheide, wo die Seite online geht

Veröffentlichen ist ein eigener Job: ein Domainname, kostenloses Hosting und ein paar Einstellungen, damit Suchmaschinen die Seite finden. Die Anleitung Website mit KI erstellen erklärt das Veröffentlichen mit Claude Code und Vercel, und die Schritt-für-Schritt-Anleitung zum Vibe Coding einer Website ergänzt eine Launch-Checkliste für eine Business-Landingpage.

10 Tipps, mit denen du Claude Code gut nutzt

1. Ein Ergebnis pro Nachricht. „Mach den Buchungsbutton am Handy so breit wie den Bildschirm“ schlägt einen Absatz mit fünf Wünschen.
2. Zeigen statt beschreiben. Mit @styles.css liest Claude die richtige Datei, statt sie erst zu suchen.
3. Lass dich interviewen. Bei allem, was größer als eine Kleinigkeit ist, schließt du mit „Stell mir Fragen, bis du alles hast, was du brauchst“.
4. Plane, wenn du es nicht in einem Satz sagen kannst. Bei kleinen Korrekturen lässt du das Planen weg, dort kostet es nur zusätzliche Schritte.
5. Stopp früh. Drück Esc, sobald er in die falsche Richtung läuft, denn Warten macht das Aufräumen nur größer.
6. Zweimal daneben, Neustart. Wenn du dieselbe Sache zweimal korrigiert hast, führ /clear aus und schreib mit dem Gelernten einen besseren ersten Prompt.
7. Eine Aufgabe pro Sitzung. Nutze /clear zwischen Jobs, die nichts miteinander zu tun haben, und führ vorher /rename aus, wenn du das alte Gespräch später mit /resume wiederfinden willst.
8. Frag nach Belegen, nicht nach Beruhigung. „Liste die Dateien auf, die du geändert hast“ oder „Zeig mir, woher diese Zahl kommt“ schlägt „Bist du fertig?“.
9. Nebenfragen bleiben nebenbei. /btw beantwortet eine kurze Frage, ohne sie ins Hauptgespräch aufzunehmen.
10. Lass dich vom Tool unterrichten. /powerup startet kurze interaktive Lektionen, die Referenz zum interaktiven Modus listet jedes Tastenkürzel auf, und unser Claude-Code-Spickzettel hält die nützlichen auf einer Seite fest.

Dein nächster Schritt

Such dir für nächstes Wochenende ein zweites kleines Projekt, am besten etwas, wofür du sonst bezahlen würdest oder das du immer wieder aufschiebst, und fahr dieselbe Schleife: Briefing im Plan-Modus, Bauen im Manual-Modus, Prüfung mit Belegen, und was du gelernt hast, kommt in die CLAUDE.md. Unsere Liste mit Projektideen für Claude Code hat Optionen von einer Stunde bis zu einem Wochenende. Wenn du dich lieber durch den ganzen Weg führen lässt: Der Claude-Code-Kurs geht von der Einrichtung bis zu einer veröffentlichten Landingpage, einem KI-Video und einem Rechnungs-Agenten.