# Claude Code – Einstieg & Setup

*Von Klaus – Stand Juli 2026*

Diese Anleitung hat zwei Teile: **Teil A** machst du selbst (5 Minuten). **Teil B** gibst du Claude Code mit dem Satz: *„Mach das Setup wie in dieser Anleitung."* – Claude Code erledigt den Rest.

---

## Teil A: Das machst du selbst

1. **Claude Pro abonnieren** (20 $/Monat, ca. 20 €) auf https://claude.ai – Claude Code ist im Pro-Abo enthalten. Deine einzige Ausgabe, alles andere ist kostenlos.

2. **Claude Code installieren** (der native Installer ist der empfohlene Weg, Node.js wird dafür nicht benötigt):

   **Windows (PowerShell):**
   ```powershell
   irm https://claude.ai/install.ps1 | iex
   ```
   Zusätzlich **Git für Windows** installieren (https://git-scm.com/downloads/win) – wird von Claude Code empfohlen und du brauchst Git ohnehin.

   **macOS / Linux / WSL:**
   ```bash
   curl -fsSL https://claude.ai/install.sh | bash
   ```

   Alternativ per npm (dann wird Node.js 22+ benötigt): `npm install -g @anthropic-ai/claude-code`

   Wer lieber eine grafische Oberfläche statt Terminal mag: Es gibt auch eine **Desktop-App** (Download auf https://claude.com/download). Die Terminal-Version ist aber der Standard und diese Anleitung geht davon aus.

3. **Node.js installieren:** https://nodejs.org (LTS-Version). Nicht für Claude Code selbst nötig, aber für fast alle Web-Projekte (React, Astro, Convex …).

4. **Starten:** Projektordner anlegen, Terminal darin öffnen, `claude` eingeben, im Browser einloggen. Installation prüfen mit `claude --version`, bei Problemen: `claude doctor`.

5. Diesen Ordner (bzw. diese Datei samt `vorlagen/`-Ordner) in den Projektordner legen und Claude Code sagen: **„Mach das Setup wie in dieser Anleitung."**

---

## Teil B: Setup-Anweisungen (für Claude Code)

Claude Code, führe folgendes Setup durch. Frage bei jedem Schritt nach Bestätigung, erkläre kurz, was du tust, und überspringe, was schon vorhanden ist. Im Ordner `vorlagen/` liegen Vorlagen für CLAUDE.md, .gitignore und .env.example – nutze sie als Ausgangspunkt.

### 1. Grundwerkzeuge

- Prüfe, ob **Git** installiert ist. Falls nicht: installieren und konfigurieren (Name, E-Mail beim Nutzer erfragen).
- Installiere die **GitHub CLI** (`gh`) und führe `gh auth login` durch. GitHub ist der zentrale Codespeicher: jedes Projekt bekommt ein eigenes privates Repo, jeder funktionierende Stand wird committet und gepusht.
- Installiere die CLIs der Dienste, sobald sie gebraucht werden: `wrangler` (Cloudflare), `vercel`, `npx convex` (Convex). Sobald diese eingeloggt sind, kannst du selbstständig Ressourcen anlegen: Datenbanken, API-Tokens, Deployments – der Nutzer muss das nicht manuell im Browser tun.

### 2. Projektvorlage

Lege für das erste Projekt an:

- **CLAUDE.md** auf Basis von `vorlagen/CLAUDE.vorlage.md`: Projektbeschreibung, Stack, Arbeitsregeln. Erfrage die Projektidee beim Nutzer und fülle die Datei entsprechend.
- **.env.example** (Basis: `vorlagen/env.example.vorlage`) mit Platzhaltern für alle benötigten Keys, plus `.gitignore` (Basis: `vorlagen/gitignore.vorlage`) mit `.env` darin.
- **Git-Repo** initialisieren, erstes Commit, privates GitHub-Repo erstellen und pushen.

### 3. Stack-Empfehlungen (je nach Projekttyp)

| Projekttyp | Stack |
|---|---|
| Interaktive Web-App / Tool | React + Vite + Tailwind CSS v4 |
| Website mit vielen Seiten / SEO | Astro + Tailwind CSS v4 |
| Datenbank & Backend | Convex (Echtzeit eingebaut, Free Tier, lokal einfach: `npx convex dev`) |
| Login / Nutzerverwaltung | Better Auth (Open Source) oder Clerk |
| Hosting | Cloudflare Pages oder Vercel (beide kostenlos, Auto-Deploy via GitHub) |
| Hintergrund-Jobs / Workflows | Inngest (erst wenn nötig) |
| Mobile App (iOS/Android) | React Native + Expo (Test aufs eigene Handy via Expo Go, kostenlos) |
| Browser-Spiel | Phaser (2D) oder Three.js (3D) |
| Größeres Spiel | Godot (kostenlos, du kannst GDScript schreiben) |
| Dateispeicher | Cloudflare R2 |

Alle genannten Dienste haben kostenlose Tiers, die für den Einstieg reichen. Kosten entstehen erst bei App-Store-Veröffentlichung (Google Play 25 $ einmalig, Apple 99 $/Jahr) oder deutlich wachsender Nutzung.

### 4. Arbeitsregeln (in jede CLAUDE.md übernehmen)

- Bei größeren Aufgaben: erst Plan vorlegen, dann umsetzen.
- Kleine Schritte; nach jedem funktionierenden Feature Commit vorschlagen.
- Geschäftslogik (Berechnungen, Regeln) ins Backend, nie ins Frontend.
- Keine Daten oder Fakten erfinden – bei Unklarheit nachfragen.
- Secrets nur in `.env`, niemals in den Code oder ins Repo.
- Nach größeren Features: Code per Subagent reviewen lassen (Fehler, Sicherheit, Logik).

### 5. Zum Abschluss

Erkläre dem Nutzer kurz die wichtigsten Befehle (`claude`, Plan-Modus via Shift+Tab, `/help`, `claude doctor`) und schlage als Einstieg eine kleine erste Aufgabe in seinem Projekt vor.

---

## Kurzreferenz für den Alltag

Siehe **KURZREFERENZ.md** im selben Ordner – die fünf Regeln, die du wirklich brauchst.

Bei Fragen: Klaus fragen.