Claude Code: Vom Setup bis zum produktionsreifen Workflow

Im Netz gibt es viele Fragment-Tutorials zu Claude Code: mal nur npm install, mal ein Diff-Screenshot, mal MCP und Permissions in einem Satz. Für den Go-Live fehlt nicht „noch ein Shortcut“, sondern ein kompletter Pfad vom CLI-Setup bis zur grünen CI-Pipeline.

Dieser Text ist das Cloud Mac AI Stack · L6 Säulen-Handbuch (L6-Q01): Claude Code als End-to-End-Coding-Agent — von Installation und erstem Pilot über tägliche Delegation und MCP bis zum Produktions-Workflow mit GitHub Runner. Entscheidungs- und Permission-Schwellen: L3 Einführungsentscheidung; MCP Schritt für Schritt: MCP-Tutorial — hier nur die Hauptlinie.

Wissensgerüst dieses Handbuchs

Das ist nicht die vollständige offizielle Feature-Liste, sondern der Hauptbaum von L6-Q01 — jeder Zweig entspricht einem Abschnitt (Anker in Klammern). Unter den Abschnittstiteln stehen Gerüst-Verweise, die zur Tabelle passen. Hooks, Sub-Agents, Enterprise-Management usw. bleiben späteren Themen oder der Doku vorbehalten.

Vom Setup bis Produktions-Workflow · Juni 2026

Hauptlinie (Claude Code Komplett-Handbuch)
├── Umgebungswahl (#prereq)
│   ├── macOS / Linux — offizielle Grenzen
│   ├── Lokaler Mac mini / MacBook vs Cloud Mac
│   └── Node 18+ · Netzwerk · Anthropic-Konto / API Key
├── Installations-Abnahme (#install)
│   ├── npm install -g @anthropic-ai/claude-code
│   ├── claude doctor · claude login
│   └── 5 Abnahmeschritte (Repo-Root · /help · kein 401)
├── Erster Tag (#first-day)
│   ├── Kleine Delegation + alle Tests grün
│   ├── git diff — Änderungsumfang prüfen
│   └── Review-Gewohnheit (Grenzverletzung → L3-Entscheidung)
├── Projektgrenzen (#claude-md)
│   ├── CLAUDE.md Minimal-Template (Install / Test / Verbote)
│   └── Ausführbare Befehle vor Prosa
├── Tagesrhythmus (#daily)
│   ├── Drei Delegationsstufen (hoch / kooperativ / niedrig)
│   └── Vier-Schritte-Zyklus (Delegieren → Beobachten → Review → Merge)
├── Verbindungsschicht (#mcp)
│   ├── ~/.claude.json · mcpServers
│   ├── GitHub / CodeGraph / Fetch — typische Kombination
│   └── /mcp Abnahme (Details → MCP-Install-Tutorial)
├── CI-Fact-Kette (#ci)
│   ├── Diff (Claude Code) vs Fact (Runner)
│   ├── Feature-Branch → self-hosted Runner → grüner PR
│   └── Secrets vom Agent-Shell getrennt
├── Produktions-Checkliste (#production)
│   ├── CLAUDE.md / Permissions / MCP / Secrets / CI / Review / Kosten
│   └── Pilot vs Produktion — Vergleichstabelle
└── Stack-Position (#stack-map)
    ├── L0–L5 im Cloud Mac AI Stack
    └── Links: L3-Entscheidung · MCP-Tutorial · Runner Execution Engine

Umgebung: Mac oder Cloud Mac?

Wissensgerüst · #prereq · Umgebungswahl

Claude Code unterstützt offiziell macOS und Linux. Für reines Web/Backend reicht ein Linux-Cloud-Server; sobald xcodebuild, iOS-Simulator oder macOS-spezifische Toolchains ins Spiel kommen, brauchen Sie macOS.

• Lokaler Mac mini / MacBook — 24 GB RAM ist stabiler (bei Chrome + Docker + Claude Code parallel wird 16 GB schnell zum Swap), siehe M4/M5-Auswahl
• Cloud Mac — ohne vorherigen Hardwarekauf oder für isolierte Dev-/CI-Umgebung, siehe Kaufen oder mieten
• Nicht empfohlen — Produktions-Secrets, unisolierter Agent und CI-Runner auf demselben Haupt-Laptop (Runner-Isolation)

Software-Voraussetzungen: Node.js 18+, Netzwerk zur Anthropic API, Anthropic-Konto (Claude Pro/Max/Team) oder API Key.

Installation und Login (5 Abnahmeschritte)

Wissensgerüst · #install · Installations-Abnahme

Die folgenden Befehle laufen im macOS-Terminal (auf Cloud Mac identisch):

# 1. CLI global installieren
npm install -g @anthropic-ai/claude-code

# 2. Umgebungs-Check (Node-Version, PATH …)
claude doctor

# 3. Login (Browser-OAuth oder API Key)
claude login

Erster Tag: erste Delegation durchspielen

Wissensgerüst · #first-day · Erster Tag

Installation heißt noch nicht „beherrschen“. Am ersten Tag nur ein Ziel: kleine Änderung + alle Tests grün — Intuition für Agent-Verhalten aufbauen.

1. CLAUDE.md im Repo-Root anlegen oder vervollständigen (nächster Abschnitt)
2. claude starten, Delegation z. B.: „README um Abschnitt ‚Lokale Entwicklung‘ ergänzen — nur README, keine anderen Dateien“
3. Beobachten: liest der Agent zuerst, ändert dann, führt er Ihre Validierungsbefehle aus?
4. Mit git diff den Änderungsumfang prüfen — keine Grenzüberschreitung
5. Vor dem Merge Tests selbst noch einmal laufen lassen (nicht blind „Agent sagt grün“ vertrauen)

Ziel Tag eins ist nicht Geschwindigkeit, sondern Review-Gewohnheit. Wenn der Agent ständig falsche Verzeichnisse ändert oder riskante Shell-Befehle ausführt: zurück zu Permission-Entscheidung, nicht sofort ins Produktions-Repo.

CLAUDE.md: Projektgrenzen

Wissensgerüst · #claude-md · Projektgrenzen

CLAUDE.md ist das „README for Agent“ — stärker auf ausführbare Befehle und Verbote als auf Marketing-Prosa. In Produktions-Repos praktisch Pflicht.

# Projekt: my-saas

## Installation
pnpm install

## Tests (nach Code-Änderung vollständig)
pnpm test
pnpm lint

## Nicht ändern
- .env, secrets/ nicht anfassen
- Keine major Dependency-Upgrades ohne explizite Anweisung
- Billing-Änderungen immer mit passenden Tests

## Verzeichnis-Konvention
- src/app — Next.js-Seiten
- packages/api — Backend-Logik

Mit vollständigem CLAUDE.md sinken typischerweise Fehl-Datei-Rate und Test-Schleifen-Runden — in unserem Workstation-Test etwa 20 % weniger Zeit gegenüber leerem Template.

Täglicher Entwicklungs-Workflow

Wissensgerüst · #daily · Tagesrhythmus

Nach dem Pilot in den Alltagsmodus. Aufgaben in drei Stufen statt „alles an den Agent“:

Vier-Schritte-Zyklus im Alltag:

1. Delegieren — Umfang, Abnahmekriterien, verbotene Pfade klar benennen
2. Beobachten — welche Dateien gelesen, welche Shell-Befehle ausgeführt
3. Review — git diff + eigene Tests (wie in CLAUDE.md)
4. Merge — PR + Code Review; nicht direkt auf main vom Agent committen lassen

Abgrenzung zu Cursor: Cursor für Editor-Completion und kleine Diffs; Claude Code für Multi-File + Shell + Test-Schleifen. Beides kann parallel existieren — ein Tool deckt nicht alles ab.

MCP anbinden (Verbindungsschicht)

Wissensgerüst · #mcp · Verbindungsschicht

Wenn der Agent GitHub Issues, Code-Graph oder API-Docs braucht, reicht Repo-internes grep nicht — dann MCP (Model Context Protocol), quasi ein standardisierter Steckplatz für Claude Code.

• Konfiguration — Abschnitt mcpServers in ~/.claude.json
• Typische Kombination — GitHub MCP (Issue/PR), CodeGraph MCP (Impact), Fetch MCP (Dokumentation)
• Abnahme — in Claude Code /mcp eingeben; mcp__github__* Tools sichtbar

Schrittweise Installation: MCP-Tutorial (15 Min.); Permission-Modell: MCP Minimalrechte. MCP ist Kernbestandteil des Produktions-Workflows, aber nicht am Tag eins komplett — erst Basis-Flow ohne MCP, dann GitHub MCP.

CI: Claude Code + Runner

Wissensgerüst · #ci · CI-Fact-Kette

Lokal grüne Tests nach Agent-Änderung sind noch kein Produktions-Niveau — Sie brauchen eine vom Dev-Rechner isolierte CI-Fact-Kette. Stack-Merksatz:

Claude Code produziert Diff, GitHub Runner produziert Fact.

Empfohlener Ablauf:

1. Entwickler ändert mit Claude Code auf Cloud Mac / lokalem Mac, pusht Feature-Branch
2. Self-hosted Runner (vom Agent getrennt) führt xcodebuild test / pnpm test usw. aus
3. PR nur bei grüner CI + menschlichem Review mergen
4. Produktions-Secrets nur auf Runner oder im Secret-Manager — nicht in der Agent-Shell

Runner-Registrierung und Isolation: Execution Engine · Warteschlange und TCO · Ein Job, ein Workspace.

Bei Ollama + Claude Code + Runner auf einem Host: Speicher planen, Swap vermeiden — paralleles Scheduling.

Produktions-Checkliste (vor Go-Live)

Wissensgerüst · #production · Produktions-Checkliste

Von „läuft“ zu „deploybar“ — diese Tabelle durchgehen:

Stack-Gesamtkarte

Wissensgerüst · #stack-map · Stack-Position

Einordnung im Cloud Mac AI Stack:

• L0 Basis — Warum Cloud Mac
• L1 Execution — GitHub Runner (Fact-Schicht)
• L2 Inference — Ollama Private Inference (optional, lokale Embeddings/kleine Modelle)
• L3 Coding — dieses Handbuch · Claude Code Komplett (Diff-Hauptlinie)
• L4 Connect — MCP Triple Connect
• L5 Automation — OpenHands Agent-Plattform

Stack-Gesamtarchitektur + fünf Module Anbindungsreihenfolge steht in der Säulen-Karte L6-Q02 · Claude Code Kernarchitektur & Stack-Gesamtkarte — dieses Handbuch ist der Praxis-Teil „Coding Agent“.

FAQ

Wissensgerüst · #faq · Ergänzende Antworten

Braucht man zwingend einen Mac für Claude Code? Offiziell macOS und Linux. Für iOS/macOS-Builds Mac nötig — lokal oder Cloud Mac.

Abo oder API Key? Pilot: Pro/Max-Abo am einfachsten; Team oder CI oft API Key mit Nutzungskontrolle. Kosten: Modell-Kosten.

Ist MCP in Produktion Pflicht? Kleine Repos können ohne; sobald GitHub Issues oder Cross-Service-Docs nötig sind, fast Standard.

Agent hat kaputt gemacht? git checkout -- . oder git stash; kleine Commits, häufige Branches — nicht mehrere Delegationen auf schmutzigem Working Tree.

• L3-Entscheidung: Wann Agent offiziell anbinden
• Claude Code MCP-Install-Tutorial
• Mac mini Workstation — Praxistest
• GitHub Runner Execution Engine