Claude Code in der Praxis — Cheat Sheet

Der Spickzettel zum Seminar Claude Code in der Praxis — die Ebenen, Modi und Kurzbefehle, die man im Alltag nachschlägt. Claude Code entwickelt sich schnell; maßgeblich bleibt die offizielle Dokumentation.

Oberflächen

Oberfläche	Stärke	Einsatz
Terminal-CLI	maximal direkt, skriptbar	Standard-Workflow, CI/Automatisierung
Desktop-App	eigenständig, ohne Terminal	Einstieg, parallele Sessions
VS-Code-Extension	Diffs & Kontext im Editor	Entwickeln mit sichtbarem Code

Alle drei sprechen denselben Agenten an und sind frei kombinierbar.

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude                      # Session im Projektordner starten

Nach der Installation ein neues Terminal öffnen — sonst fehlt claude im PATH. Windows hat einen eigenen Installer; WSL ist optional.

Modul: Einführung & Setup

Prompt oder Plan?

Einfacher Prompt	Plan-Modus
Button-Farbe ändern	Backend-Migration
Eine Datei, klarer Effekt	Viele Dateien, Reihenfolge zählt
Geringes Risiko	Änderung schwer umkehrbar
Sofort umsetzbar	Erst erkunden, dann freigeben

Im Zweifel planen — der Plan-Modus kostet wenig und spart viel. Er erkundet die Codebasis nur lesend und legt einen mehrstufigen Plan vor; geändert wird erst nach Freigabe.

Modul: Prompting, Planung & Architektur

Wo Anweisungen stehen

Ebene	Ort	Geltung
Managed Policy	OS-Systempfad	ganzes Team, erzwungen
User	`~/.claude/CLAUDE.md`	alle eigenen Projekte
Projekt	`./CLAUDE.md`	Team, versioniert
Lokal	`./CLAUDE.local.md`	nur du, `.gitignore`

Managed Policy überschreibt User- und Projektvorgaben.

Ein Skill ist eine SKILL.md mit Frontmatter — die description entscheidet, ob er überhaupt gefunden wird:

---
name: oop-pruefer
description: Prüft Klassen auf SOLID-Verstöße. Nutzen bei OOP-Review-Anfragen.
---
# Ablauf
1. Klassen einlesen
2. Verantwortlichkeiten prüfen …

Modul: Skills & Projektgedächtnis (CLAUDE.md)

Sub-Agenten

Sub-Agent	Zweck
Explore	Codebasis breit durchsuchen, nur lesen
Plan	Umsetzungsstrategie entwerfen
general-purpose	mehrstufige Recherche & Aufgaben

Delegation hält den Hauptkontext sauber. Eigene Agenten werden analog zu Skills als Markdown mit Frontmatter definiert (name, description, tools, model).

claude --worktree feature-login   # eigenes Verzeichnis, eigener Branch

Modul: Sub-Agenten & Agenten-Teams

MCP-Server

claude mcp add --transport http sentry <url>          # gehostet
claude mcp add playwright -- npx -y @playwright/mcp   # lokal als Subprozess

Server	Aufgabe	Beispiel
Jira / Atlassian	Tickets & Confluence	Bug als Issue anlegen
Linear	Issue-Tracking	Status auf „Done”
Notion	Doku & Datenbanken	Zusammenfassung anlegen

Anbindung meist per OAuth; offizielle Server bevorzugen. Nicht vertrauenswürdige Server sind eine neue Angriffsfläche — Serverantworten können Prompt-Injection enthalten, und schreibende Tools gehören nur bewusst erlaubt.

Modul: MCP in der Praxis

Automatisierung

> /loop 1h Analysiere offene PRs und fasse zusammen

Hooks greifen an Werkzeug-Ereignissen. Ein PreToolUse-Hook, der ein Exit-Signal setzt, blockiert den Aufruf:

#!/usr/bin/env bash
cmd=$(jq -r '.tool_input.command')
case "$cmd" in
  *"rm -rf"*) echo "blockiert" >&2; exit 2 ;;
esac

Modul: Automatisierung: Loops, Routinen & Hooks

Wo sich die Arbeit verschiebt

Früher zentral	Zunehmend zentral
Syntax & Boilerplate	Problem sauber definieren
Zeilen produzieren	Ergebnisse bewerten (Review)
Tiefe in einer Rolle	Breite über PM/Design/Eng

Nicht weniger Engineering — anderes Engineering. Der Mensch bleibt Reviewer und trifft die Entscheidungen.

Modul: Product Requirements & SDD

Typische Fallen

Spec und Code driften auseinander, weil nur der Code gepflegt wird. Dasselbe gilt für Architekturdiagramme.
Spec zu vage — „schnell”, „sicher” ohne messbare Grenze. Und nicht-funktionale Anforderungen (Last, Security) werden gern vergessen.
Alles auf einmal spezifizieren statt iterativ zu schärfen.
Debugging ohne Logs: Der Agent rät dann, statt zu analysieren.
Tests, die der Agent selbst aufweicht, statt den Code zu reparieren.
Flaky Tests (Timing) werden leicht als echter Fehler fehlgedeutet.
Zu große Diagramme werden unlesbar — je Sicht ein Diagramm. Mermaid rendert die CLI nicht selbst; dafür einen externen Viewer nutzen.
Zu weit gefasste Rechte — schreibende Tools nur bewusst erlauben, API-Token rotieren.

Zum Seminar Claude Code in der Praxis