Claude Code — Harness Tutorial

Stand: März 2026. Aus der täglichen Praxis mit Claude Code; Flags, Preise und Bugs können sich seitdem geändert haben. Siehe auch: Claude Code Referenz.

Pipeline-Rolle: Richtung geben (Wave 1 Scout) Claude Code entscheidet wo es lang geht. Die anderen Harnesses bauen.

1. Quick Start

cd ~/Projekte/MeinProjekt
claude                        # interaktive Session starten
# oder direkt in Plan Mode:
claude --plan                 # Architektur-Modus, kein Code wird geschrieben

Erste 3 Befehle in jeder Session:

> /status                    # Was ist offen? Welche Tasks?
> git status                 # Sauberer Working Tree?
> Lies BACKLOG.md            # Was steht an?

Dann Plan Mode aktivieren für Architektur-Entscheidungen:

> Plan Mode: Wie baue ich Feature X?

2. Typischer Workflow

Reihenfolge einhalten — nicht improvisieren:

Plan Mode — Erst denken, dann bauen. Architektur skizzieren lassen.
Subagents spawnen — Recherche parallel delegieren (run_in_background: true).
Entscheidung treffen — Du entscheidest zwischen Optionen, Claude Code schlägt vor.
Tasksheet schreiben — Ergebnis als Briefing fuer das naechste Harness exportieren.

Beispiel-Flow:

> Plan: Ich brauche ein Dashboard fuer AgentArena. Was sind meine Optionen?
[Plan Mode Output lesen]
> Spawne einen Subagent um FastAPI vs Flask zu vergleichen.
[Ergebnis abwarten]
> Entscheidung: FastAPI. Schreib ein Tasksheet fuer Hermes.

Tasksheet-Template liegt in ~/Projekte/harness-tasksheets/.

3. Starken nutzen

Orchestrierung: Claude Code ist der einzige Harness der Subagents sauber koordiniert. Parallel-Spawning nutzen wann immer Teilaufgaben unabhaengig sind.

> Spawne 3 Subagents parallel:
  - Agent 1: Lies src/api.py und fasse die Endpunkte zusammen
  - Agent 2: Recherchiere FastAPI WebSocket Best Practices
  - Agent 3: Pruefe ob tests/ aktuell sind

Codebase-Analyse: Grosse Codebases (100+ Dateien) — Claude Code liest schneller und vollstaendiger als alle anderen Harnesses.

CLAUDE.md als Verhaltenssteuerung: Projektspezifische Regeln in ~/Projekte/MeinProjekt/CLAUDE.md schreiben. Claude Code haelt sich daran.

Skills und Slash-Commands: /research, /status, /plan — nutzen statt manuell briefe formulieren.

4. Schwachen kompensieren

Kosten: Opus kostet ~$15/1M Tokens. Jede unnoetige Aktion verbrennt Geld. - Nie Opus fuer Recherche nutzen — Sonnet-Subagent reicht - Nie cat grosse_datei.py — Read-Tool mit Limit nutzen - Explorationen begrenzen: nach 1 fehlgeschlagenen Ansatz STOPP, den Owner fragen

Over-Engineering: Claude Code neigt dazu mehr zu bauen als beauftragt. - Scope explizit eingrenzen: "Nur Funktion X, nicht das ganze Modul" - Nach Plan Mode pruefen: Ist das was geplant wurde was ich wollte?

Session Hoarding: Lange Sessions akkumulieren Context. Nach ~45 Minuten: - /compact ausfuehren oder neue Session starten - Wichtige Entscheidungen in Dateien schreiben, nicht im Chat lassen

Nicht fuer Implementierung: Claude Code plant und orchestriert. Implementierung gehoert in Hermes oder OpenCode.

5. Handoff-Muster

Von Claude Code zu OpenCode (Reality-Check):

# Architektur-Doc exportieren
> Schreib ARCHITECTURE.md mit dem Plan den wir gerade erarbeitet haben
# Dann OpenCode briefen:
opencode run "Lies ARCHITECTURE.md und erstelle einen Gegenentwurf"

Von Claude Code zu Hermes (Implementierung):

# Tasksheet ausfullen
> Schreib ein Tasksheet fuer Hermes: Feature X, Scope Y, Output-Pfad Z
# Datei speichern als:
~/Projekte/harness-tasksheets/task-feature-x.md
# Hermes starten mit:
hermes chat
> [Tasksheet einfuegen]

Kontext-Export fuer jedes Harness: - Entscheidungen → ARCHITECTURE.md oder DECISIONS.md - Offene Tasks → BACKLOG.md - Naechster Schritt → Tasksheet in harness-tasksheets/

6. Kosten-Tipps

Wellenmodus respektieren: Claude Code ist Wave 1 Scout. Nicht Wave 2 (Implementierung) oder Wave 3 (Polishing) ubernehmen.

Wave 1: Claude Code → Plan, Architektur, Briefing
Wave 2: OpenCode + Hermes → Implementierung, Reality-Check
Wave 3: Codex → Polishing, Docs, Ship

Sonnet-Subagents statt Opus direkt:

# Teuer:
> Recherchiere WebSocket-Patterns in Python
# Guenstig:
> Spawne Sonnet-Subagent: Recherchiere WebSocket-Patterns in Python

Max 2 aktive Sessions: Mehr als 2 parallele Claude Code Sessions = Context-Chaos und doppelte Kosten.

Lesen vor Spawn: Immer erst relevante Dateien lesen bevor ein Subagent gestartet wird. Verhindert dass der Subagent Dinge nochmal herausfindet die schon bekannt sind.

Plan Mode vor allem anderen: Plan Mode generiert keinen Code, kostet aber fast gleich viel. Trotzdem sinnvoll weil ein schlechter Plan = viel mehr Tokens fuer Korrekturen.

Faustregeln: - Kurze Analyse: <$0.05 - Vollstaendige Codebase-Analyse: ~$0.20-0.50 - Subagent-Wave mit 3 Agents: ~$0.10-0.30 - Session ohne Fokus (>1h): $1-3+ → abbrechen