Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Claude Code – Das Praxis-Handbuch & Workflow-Guide¶

Claude Code ist das agentische Command-Line-Tool von Anthropic, das entwickelt wurde, um direkt im Terminal als intelligenter Paarprogrammierer zu agieren. Es liest und editiert Codebestandteile, führt Tests und Terminalbefehle aus, orchestriert MCP-Server (Model Context Protocol) und unterstützt komplexe Softwarearchitekturen über strukturierte Workflows.

Dieses Praxis-Handbuch fasst alle Konzepte, Befehle, Shortcuts, Konfigurationen und Best Practices zusammen – strukturiert nach den Anforderungen des täglichen Entwicklungseinsatzes.

🚀 1. Einführung & Architekturgrundlagen¶

Was ist Claude Code?¶

Claude Code erweitert das klassische Terminal um ein autonomes Sprachmodell (wie Claude 3.7 Sonnet). Im Gegensatz zu reinen Chat-Oberflächen besitzt Claude Code direkten Zugriff auf Ihr Dateisystem und Ihre Entwicklungs-Tools (über Shell-Execution).

graph TD
    User(["Entwickler / Terminal"]) -->|"CLI Input / Prompt"| CC[Claude Code CLI]
    CC -->|Projektregeln| CLMD[CLAUDE.md]
    CC -->|Erweiterte Skills| SKILLS["Skills & Tools"]
    CC -->|Protokoll-Anbindung| MCP[MCP Server]
    CC -->|Lifecycle Hooks| HOOKS["Pre-/Post-Tool Hooks"]
    CC -->|Sub-Tasks| SUB[Subagenten]
    CC -->|Model Execution| API["Anthropic Claude API / Models"]

Vibe Coding vs. Agentic Engineering¶

In der modernen KI-gestützten Softwareentwicklung unterscheidet man zwei wesentliche Arbeitsweisen:

• Vibe Coding: Schnelles, intuitives Prototyping mit generativ erzeugtem Code ohne tiefe Kontrolle aller Zeilen. Ideal für Experimente und Proofs of Concept.
• Agentic Engineering: Ein strukturierter, qualitätsgesicherter Prozess, bei dem der Agent durch dedizierte Regeln (CLAUDE.md), automatisierte Tests, Linters und Hooks in geordnete Bahnen gelenkt wird.

Was ist ein Coding Agent?¶

Ein Coding Agent arbeitet in einer sogenannten Agentic Loop (agentischen Schleife):

1. Beobachtung (Observe): Liest den Prompt, Projektregeln (CLAUDE.md) und Dateien.
2. Entscheidung (Think): Wählen des nächsten Handlungsschritts (Werkzeugaufruf oder Antwort).
3. Aktion (Act): Ausführen von Datei-Edits, Shell-Befehlen oder Testläufen.
4. Bewertung (Evaluate): Auswertung der Ausgabe/Fehlermeldungen und Wiederholung der Schleife.

Nutzungsvarianten (Ways to use Claude)¶

Claude steht in verschiedenen Umgebungen zur Verfügung: * Claude CLI: Die primäre Terminal-Oberfläche für maximale Performance und Skripte. * Desktop App: Visuelle Benutzeroberfläche mit graphischen Zusatzfenstern. * Editor Extensions: Integrationen für VS Code, JetBrains IDEs und Neovim. * Community Tools: Drittanbieter-Skripte und Orchestrierungswerkzeuge.

Setup & Authentifizierung¶

# Globale Installation via npm
npm install -g @anthropic-ai/claude-code

# Navigieren in Ihr Projektverzeichnis
cd /path/to/project

# Erstmaliger Start & Authentifizierung
claude

🧩 2. Kernkomponenten & Architektursäulen¶

Claude Code basiert auf mehreren aufeinander abgestimmten Bausteinen. Die folgende Tabelle bietet eine Übersicht der Kernkonzepte:

Modellauswahl (When to use what model?)¶

• Claude 3.7 Sonnet / Sonnet: Das Standardmodell. Bietet das beste Verhältnis aus Coding-Kompetenz, Denkfähigkeit (Reasoning) und Geschwindigkeit.
• Claude 3.5 / 3.7 Opus (Opusplan): Für hochkomplexe Architektur-Entscheidungen, tiefes Refactoring und diffizile Bugfixes. In Opusplan plant Opus die Schritte, während Sonnet die Ausführung übernimmt.
• Claude Haiku: Extrem schnelles Modell für einfache Aufgaben wie Log-Analyse, Skript-Generierung oder Tagging.

⌨️ 3. Befehle, Cheatsheet & Shortcuts¶

CLI Start-Parameter & Flags¶

# Standard: Interaktive TUI-Session starten
claude

# Einmalige Prompt-Ausführung mit direkter Beendung (-p / --print)
claude -p "Erstelle einen Unit-Test für auth.py"

# Vorherige Session im aktuellen Ordner fortsetzen (-c / --continue)
claude -c

# Eine spezifische alte Session wiederaufnehmen (-r / --resume)
claude -r <session-id>

# Zusätzliches Verzeichnis in den Kontext aufnehmen (--add-dir)
claude --add-dir ../shared-libraries

Shortcuts & Tasten-Prefixes¶

In-Session Slash-Commands¶

🔄 4. Claude Workflows & Session-Management¶

Berechtigungsmodi (Permission Modes)¶

Claude Code unterstützt unterschiedliche Sicherheitsstufen für die Ausführung von Shell-Befehlen und Dateimodifikationen:

1. Interactive Approval (Standard): Vor jedem potenziell schreibenden Zugriff oder Shell-Befehl wird eine Bestätigung vom Entwickler eingeholt.
2. Auto-Approve / Unattended: Gefahrlose Lesebefehle und gewählte Routinen werden automatisch ohne Rückfrage ausgeführt.
3. ReadOnly / Sandboxed: Schreibzugriffe auf das Dateisystem werden blockiert.

Plan-Modus (/plan)¶

Der Plan-Modus verhindert vorschnelle oder ungewollte Änderungen in produktiven Repositories.

sequenceDiagram
    autonumber
    actor Dev as Entwickler:in
    participant CC as Claude Code
    participant FS as Dateisystem / Git

    Dev->>CC: /plan "Refaktoriere DB-Zugriff"
    CC->>FS: Liest Quellcode & Schemata
    FS-->>CC: Dateiinhalte & Struktur
    CC->>Dev: Detaillierter Ausführungsplan
    Dev->>CC: "Plan bestätigt, starte Schritte 1-3"
    CC->>FS: Führt Code-Änderungen durch
    CC->>Dev: Fertigstellungsmeldung & Diffs

Session-Wiederherstellung & Rückgängigmachen¶

• Rückgängigmachen (/rewind): Ermöglicht das Zurücksetzen von Änderungen auf einen vorherigen Stand im Arbeitsprozess.
• Sitzungen fortsetzen (claude -r): Unterbrochene Sessions können mit claude -r <id> jederzeit exakt an der Stelle fortgeführt werden, an der sie gestoppt wurden.

🛠️ 5. Projektsteuerung & Erweiterungen¶

CLAUDE.md – Das zentrale Regelwerk¶

Die Datei CLAUDE.md bildet die Leitplanke für Claude Code im jeweiligen Repository. Sie sollte präzise, kurz und direkt verständlich formuliert sein.

Empfohlener Aufbau einer CLAUDE.md¶

# Projekt-Regeln & Standards

## Build & Test Befehle
- Ausführen des Builds: `npm run build`
- Unit Tests: `npm test`
- Linter: `npm run lint`

## Code-Style Guidelines
- Sprachstandard: TypeScript (strict mode enabled).
- Keine `any`-Typen verwenden.
- Fehlerbehandlung: Nutzen von expliziten Result-Typen oder Try/Catch mit strukturierter Protokollierung.

## Git & Formatting
- Commit-Format: Conventional Commits (`feat:`, `fix:`, `docs:`).
- Code-Formatierung: Prettier mit 2 Leerzeichen Einrückung.

Skills – Wiederverwendbare Funktionspakete¶

Skills sind benutzerdefinierte Instruktionen und Prozeduren, die unter .claude/skills/<skill-name>/SKILL.md abgelegt werden.

---
name: security-audit
description: Analysiert geänderte Dateien auf OWASP-Sicherheitslücken.
---

# Security Audit Skill

1. Führe `git diff` aus, um die neuesten Änderungen zu ermitteln.
2. Überprüfe den Code auf typische Schwachstellen (SQL Injection, XSS, Hardcoded Credentials).
3. Generiere einen zusammenfassenden Audit-Bericht in Markdown.

Hooks – Event-gesteuerte Automatisierung¶

Hooks ermöglichen die automatische Ausführung von Skripten zu bestimmten Lifecycle-Zeitpunkten von Claude Code:

💰 6. Kontext- & Kostenmanagement¶

Token-Effizienz mit /compact und /clear¶

Claude Code verwaltet den Arbeitskontext im Token-Fenster. Um Kosten zu minimieren und die Genauigkeit hochzuhalten:

• /compact: Fasst lange Gesprächsverläufe zusammen und entfernt alte Tool-Ausgaben. Sollte regelmäßig bei längeren Sessions verwendet werden.
• /clear: Setzt den Kontext vollständig zurück. Empfohlen beim Themenwechsel.

Extended Thinking & Effort Levels¶

Bei Modellen wie Claude 3.7 Sonnet kann das Denk-Level (Effort) angepasst werden: * Niedriger Effort: Für schnelle, unkomplizierte Fragen und kleine Fixes. * Hoher Effort: Für komplexe algorithmische Aufgaben und Systemarchitektur.

Prompt Caching¶

Claude Code nutzt automatisches Prompt Caching für CLAUDE.md, System-Prompts und Tool-Definitionen. Dadurch reduzieren sich die API-Kosten bei wiederholten Interaktionen um bis zu 90 %.

⚡ 7. Fortgeschrittene Features & Skalierung¶

Model Context Protocol (MCP) Integration¶

Über das Model Context Protocol lässt sich Claude Code mit externen Datenquellen und Werkzeugen verbinden (z. B. PostgreSQL, GitHub, Slack).

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

Skalierung im Team & CI/CD¶

• Headless Mode: Ausführen von Claude Code in unüberwachten CI/CD-Pipelines (claude -p "Analysiere PR" --headless).
• Git Worktrees: Parallele Bearbeitung mehrerer Features in separaten Git Worktrees ohne Wechsel des Hauptzweigs.
• Agent Teams: Aufteilung von Großprojekten auf mehrere spezialisierte Subagenten (z. B. Docs-Agent, Test-Agent).

🔗 8. Verwandte Themen & Weiterführende Links¶

• Zurück zur KI-Coding Übersicht
• Antigravity CLI 2 Handbuch
• Vibe Coding & Engineering

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).