OpenCode — Harness Tutorial

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

Pipeline-Rolle: Reality-Check (Wave 2, Gegenentwurf) OpenCode prueft ob der Plan von Claude Code Sinn ergibt — und baut schnell erste Strukturen.

1. Quick Start

cd ~/Projekte/MeinProjekt     # WICHTIG: im Projektordner starten, nicht woanders

opencode                      # interaktive TUI-Session
# oder one-shot:
opencode run "Erstelle eine index.html fuer das Dashboard"

Erste Schritte nach dem Start:

> Lies ARCHITECTURE.md        # Was hat Claude Code geplant?
> Lies harness-tasksheets/task-aktuell.md   # Was ist mein Auftrag?
> Erstelle einen Gegenentwurf zu Abschnitt 2

TUI-Navigation: - Tab — zwischen Panels wechseln - Ctrl+C — Session beenden - /model — Modell wechseln (MiniMax fuer guenstige Runs)

2. Typischer Workflow

OpenCode ist kein Planer — es ist ein Prufer und schneller Builder.

Vorarbeit lesen — Was hat Claude Code in ARCHITECTURE.md entschieden?
Gegenentwurf erstellen — Alternativen aufzeigen, Annahmen hinterfragen.
Scope-Check — Stimmt das Tasksheet? Ist der Output-Pfad klar?
Bauen — Dateistruktur anlegen, HTML-Skeleton, Python-Geruest.
Ergebnis dokumentieren — Was wurde gebaut, was wurde weggelassen, warum.

Beispiel Reality-Check Session:

opencode run "Lies ARCHITECTURE.md. Identifiziere die 3 groessten Risiken im Plan."

Beispiel Schnell-Build:

opencode run "
Erstelle folgende Dateistruktur fuer ein FastAPI-Dashboard:
- src/main.py (FastAPI App mit /health Endpunkt)
- src/templates/index.html (Bootstrap 5, leeres Dashboard-Layout)
- requirements.txt (fastapi, uvicorn, jinja2)
Scope: NUR diese 3 Dateien, kein extra Code.
"

3. Starken nutzen

Schnelles Planen: OpenCode liefert in <30 Sekunden einen Gegenplan. Ideal wenn Claude Code Bedenken hat die validiert werden muessen.

Parallele Recherche: Mehrere opencode-Instanzen parallel starten:

opencode run "Recherchiere FastAPI WebSocket" &
opencode run "Recherchiere Svelte vs React fuer Dashboards" &
wait

Saubere Dateistruktur: OpenCode legt Dateien ordentlich an. HTML + Python zusammen — besser als Hermes darin.

Guenstig fuer Drafts: Mit MiniMax (~$0.10/1M) kostet ein komplettes HTML-Skeleton fast nichts. Lieber einen Draft wegwerfen als ihn teuer planen.

One-shot gut geeignet fuer: - README-Drafts generieren - requirements.txt aus Codebase ableiten - Dateistruktur anlegen - Bestehenden Code in andere Sprache uebersetzen

4. Schwachen kompensieren

Scope-Drift: OpenCode fragt NICHT zurueck. Es baut was es fuer richtig haelt. Ohne explizites Briefing entsteht oft das Falsche.

Schlecht:

> Bau ein Dashboard

Gut:

> Bau ein Dashboard. Scope: NUR src/templates/index.html.
  Bootstrap 5. Kein JavaScript ausser was Bootstrap mitbringt.
  Kein Backend, keine API-Calls. Nur HTML-Skeleton.
  Output-Pfad: src/templates/index.html

Website statt Dashboard: OpenCode neigt dazu bei "Dashboard" eine Marketing-Website zu bauen. Immer explizit sagen: "Admin-Dashboard, nicht Landing Page."

Feedback-Annahme schwach: Wenn OpenCode etwas falsch gebaut hat: - NICHT: "Das ist falsch, mach nochmal" - BESSER: Session beenden, neues Briefing mit explizitem Korrektiv

opencode run "
Vorher wurde index.html als Landing Page gebaut — das war falsch.
Jetzt: Admin-Dashboard fuer Monitoring. Keine Hero-Section, kein Marketing.
Nur: Navbar, Sidebar mit 3 Links, Main-Content-Area mit Platzhalter-Cards.
"

Kein Gedaechtnis zwischen Sessions: Jeder opencode run startet frisch. Kontext muss immer mitgegeben werden.

5. Handoff-Muster

Von Claude Code zu OpenCode:

# Claude Code schreibt ARCHITECTURE.md
# Dann:
opencode run "Lies ARCHITECTURE.md und erstelle einen Reality-Check: Was koennte schiefgehen?"

Von OpenCode zu Hermes (Implementierung):

# OpenCode hat Dateistruktur angelegt und Plan validiert
# Jetzt Hermes mit dem Ergebnis briefen:
hermes chat
> Lies src/main.py und src/templates/index.html.
  OpenCode hat das Geruest gebaut. Deine Aufgabe: Implementiere Endpunkt /api/status
  der JSON zurueckgibt: {"status": "ok", "agents": []}.
  Nur diese eine Funktion.

Was OpenCode an Hermes uebergibt: - Dateistruktur (angelegt, nicht implementiert) - Plan-Validierung als Kommentar in DECISIONS.md - Liste der bewusst weggelassenen Features

6. Kosten-Tipps

MiniMax nutzen: OpenCode unterstuetzt Modellwechsel. MiniMax ist ~150x guenstiger als Opus. Fuer Drafts und Reality-Checks vollig ausreichend.

/model minimax/minimax-text-01

Kurzes aber vollstaendiges Briefing: Ein schlechtes Briefing fuehrt zu einem falschen Output — das kostet einen Re-Run. Re-Run = doppelte Tokens. Lieber 2 Minuten laenger briefen als zweimal zahlen.

One-shot statt TUI fuer einfache Tasks:

# Guenestiger als TUI-Session:
opencode run "Erstelle requirements.txt fuer src/*.py"

Scope eingrenzen spart Tokens: Je groesser der Scope, desto mehr generiert OpenCode. 3 Dateien zu erzeugen kostet weniger als 10.

Falscher Scope = verschwendete Tokens: Wenn OpenCode eine Website statt ein Dashboard baut, sind alle generierten Tokens umsonst. Briefing-Zeit ist billiger als Re-Run-Kosten.

Faustregeln: - Reality-Check (ARCHITECTURE.md lesen + Feedback): ~$0.01-0.02 - HTML-Skeleton generieren: ~$0.02-0.05 - Vollstaendiges Dateigeruest (5-10 Dateien): ~$0.05-0.15 - Re-Run wegen schlechtem Briefing: gleiche Kosten nochmal