Markdown-Ausgabe

AI-translated from English; not yet reviewed by a fluent editor.

# Eine Claude Code-Aufgabe von Opus an Haiku delegieren und das Ergebnis prüfen

> Ein dokumentierter Claude Code-Ablauf für eine begrenzte Codeänderung: von einem Opus-Hauptagenten an einen Haiku-Projektunteragenten delegieren, tatsächliches Modell und Diff prüfen und Nutzung ohne unterstellte Ersparnis einordnen.

By BIG CHANGE Editorial

Published: 2026-10-20T10:17:38.691Z
Updated: 2026-10-20T10:17:38.691Z
Canonical: https://bigchange.ai/blog/claude-code-opus-haiku-subagent-coding-guide

![Conceptual charcoal illustration of a reviewer using a laptop trackpad beside a generic two-column code diff with one orange changed section.](https://bigchange.ai/api/media/file/opus-haiku-diff-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code kann einem Projektunteragenten ein eigenes Modell und eigene Werkzeuge geben, während die Hauptunterhaltung Planung und Prüfung übernimmt. Für eine autorisierte Repository-Änderung kann ein Opus-Hauptagent damit einen begrenzten Implementierungsschritt an Haiku übergeben. Das nützliche Ergebnis ist eine geprüfte Codeänderung samt Nachweis der ausgeführten Modelle. Eine günstigere Modelleinstellung allein belegt keine Ersparnis.

## Die große Veränderung

- **Was sich geändert hat:** Eine Projektagentendatei kann `model: haiku` für einen benannten Codebearbeiter anfordern, während die Hauptsitzung Opus verwendet.
- **Warum das wichtig ist:** Der Hauptagent kann eine kleinere Aufgabe prüfen. Ob der Diff die ursprüngliche Abnahmeprüfung erfüllt, entscheidet weiterhin der Entwickler.
- **Worauf zu achten ist:** Modellüberschreibungen, Organisationsrichtlinien, Berechtigungen, Prüfung und Wiederholungen können das tatsächliche Modell und die Gesamtnutzung verändern. Prüfen Sie dies vor einer Aussage über Kostenvorteile.

## Mit einer bereits verantworteten Aufgabe beginnen

Sie benötigen ein eigenes Git-Repository, Änderungsberechtigung, Claude Code-Zugang zu beiden Modellfamilien und eine autorisierte Änderung, die klein genug für eine Bewertung anhand des Diffs ist. Notieren Sie Ausgangscommit, betroffene Dateien oder Verhaltensweisen, den bestehenden Abnahmebefehl und die Bedeutung eines bestandenen Ergebnisses. Verwenden Sie einen sauberen Arbeitsstand. Der Befehl muss aus Ihrem Projekt kommen; dieser Leitfaden kann keinen aussagekräftigen Test für ein unbekanntes Repository liefern.

Prüfen Sie `claude --version`, Anbieter und Abrechnung sowie wirksame Modelleinschränkungen vor dem Start. In der Anthropic-API werden die aktuellen Aliase `opus` und `haiku` auf Opus 5.5 (`claude-opus-5-5`) und Haiku 5.5 (`claude-haiku-5-5`) aufgelöst; dieses Paar benötigt Claude Code v2.1.293 oder neuer. Andere Anbieter können dieselben Aliase früheren Generationen zuordnen. Die Richtlinie `availableModels` einer Organisation kann eine Auswahl sperren oder ersetzen. Verwenden Sie `/model` in der Hauptsitzung und notieren Sie das genau angezeigte Hauptmodell. Legen Sie das genehmigte Budget fest und prüfen Sie tatsächliche Konto- oder Anbietersteuerungen; eine Anweisung an das Modell ist keine garantierte Ausgabenobergrenze. [Anthropics Modellkonfiguration](https://code.claude.com/docs/en/model-config) dokumentiert die aktuellen Zuordnungen und Einschränkungen.

## 1. Einen Haiku-Projektbearbeiter definieren

Erstellen Sie im Projekt eine eindeutig benannte Datei wie `.claude/agents/bounded-code-worker.md`, prüfen Sie sie und starten Sie den Opus-Hauptagenten mit `claude --model opus` oder wählen Sie Opus über `/model`. Dieses Beispiel ist eine Agentendefinition, keine Testaufgabe:

```markdown
---
name: bounded-code-worker
description: Implements one explicitly bounded, authorized repository change and reports the diff and checks for parent review.
model: haiku
tools: Read, Glob, Grep, Edit, Bash
permissionMode: default
---
```

Fügen Sie diese natürlichsprachliche Systemanweisung unmittelbar nach dem abschließenden `---` in die Agentendatei ein: Implementieren Sie ausschließlich Aufgabe und Dateiumfang des Hauptagenten. Prüfen Sie vor Änderungen den relevanten Code und den angegebenen Abnahmetest. Fehlen Aufgabe, Berechtigung oder eine erforderliche Eingabe, stoppen Sie und melden Sie die Lücke. Nehmen Sie die kleinste passende Änderung vor. Führen Sie bei Erlaubnis die ursprüngliche Prüfung aus und nennen Sie den genauen Befehl und das Ergebnis. Geben Sie geänderte Dateien, Zweck des Diffs, verbleibende Fehler und ungeprüfte Arbeit zurück. Ohne ausdrückliche Befugnis keine Commits, Veröffentlichung, Bereitstellung oder Aufgabenerweiterung.

Die Liste `tools` stellt Werkzeuge bereit; sie beschränkt Lesezugriffe oder Shellbefehle **nicht** auf die angegebenen Pfade. Prüfen Sie vor der Delegation die wirksamen Projekt- und Organisationsrechte, besonders den Shellzugriff. Lassen Sie den Hauptagenten für dieses Verfahren im Berechtigungsmodus Manual/default: Laut Anthropic überschreibt ein Hauptagent in `acceptEdits`, `auto` oder `bypassPermissions` die Einstellung `permissionMode` des Unteragenten. Ist dies die erste Datei in einem neuen Agentenverzeichnis, starten Sie Claude Code neu, wenn der Agent nicht erscheint. [Das Unteragentenhandbuch](https://code.claude.com/docs/en/sub-agents) beschreibt diese Steuerungen.

Die optionale Einstellung `isolation: worktree` gibt dem Bearbeiter einen separaten Arbeitsstand. Dokumentierter Ausgangspunkt ist der Standardbranch des Repositorys; er kann vom aktuellen Commit des Hauptagenten abweichen. Vergleichen Sie diese Ausgangsrevision mit der notierten Aufgabenbasis, bevor Sie Änderungen verwenden oder vergleichen. Für die ursprüngliche Abnahmeprüfung ist weiterhin ein sauberer, autorisierter Arbeitsstand nötig.

## 2. Delegieren, prüfen und dann annehmen oder ablehnen

Geben Sie dem Hauptagenten eine Anweisung zur wirklichen Aufgabe mit Ihrer Dateigrenze und Ihrem Prüfbefehl:

> Planen Sie diese autorisierte Änderung kurz. Delegieren Sie nur die angegebene Implementierung an `bounded-code-worker`. Behalten Sie ursprüngliche Abnahmekriterien und Abschlussprüfung bei sich. Zeigen Sie mir nach der Rückkehr den genauen Diff und das Prüfergebnis. Nehmen Sie die Änderung nicht an und erweitern Sie sie nicht vor meiner Prüfung.

Öffnen Sie während der Ausführung `/tasks` und notieren Sie das in der Zeile angezeigte Modell. Das ist die Laufzeitprüfung; das Wort `haiku` in Agentendatei oder Anweisung ist nur eine Anforderung. Claude Code v2.1.242 oder neuer zeigt dort das laufende Modell. Eine abgeschlossene Hintergrundaufgabe bleibt etwa 30 Sekunden in `/tasks`; prüfen Sie sie daher zeitnah und bewahren Sie das Protokoll auf. Verpassen Sie die Zeile, markieren Sie die Modellprüfung als unvollständig, statt das Modell aus der Datei abzuleiten.

Lesen Sie den tatsächlichen Diff, prüfen Sie jede geänderte Datei und führen Sie den **ursprünglichen** Abnahmebefehl selbst im eigenen Arbeitsstand aus. Ergänzen Sie gezielte Kontrollen, wenn die Änderung sie rechtfertigt. Akzeptieren Sie das Ergebnis nur, wenn Verhalten, Umfang und Prüfungen zur Aufgabe passen. Stoppt der Bearbeiter früh oder liefert Teilarbeit, prüfen Sie seine Änderungen vor Fortsetzung oder Reparatur. Bei einem separaten Worktree prüfen Sie die Änderungen vor Übernahme in den Hauptarbeitsstand.

Einen verwandten Ansatz für die Prüfung eines Repository-Fehlers mit einem KI-Assistenten finden Sie in unserem [Leitfaden zu Reparatur und Prüfung mit AI Goal](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide). Dieser Ablauf richtet die hier verwendete Opus-zu-Haiku-Delegation nicht ein.

Wenn `/tasks` ein anderes Modell oder einen Ersetzungshinweis anzeigt, prüfen Sie das Modellargument des Aufrufs, die Agentenmetadaten, `CLAUDE_CODE_SUBAGENT_MODEL` und die verwaltete Modellliste. Im aktuellen Claude Code hat das Aufrufmodell Vorrang vor den Metadaten, dann dem Umgebungsstandard und dann dem Hauptmodell; vor v2.1.251 hatte die Umgebungseinstellung Vorrang. `CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1` (v2.1.257+) kann die Definition überschreiben; der Hook `agent.spawn` eines installierten Mods kann das Aufrufmodell ersetzen. Korrigieren Sie die tatsächliche Überschreibungsquelle oder stoppen Sie. Bezeichnen Sie ein Nicht-Haiku-Ergebnis nicht als Haiku.

## 3. Nutzung aufzeichnen, ohne eine Ersparnis zu erfinden

Erfassen Sie Werte aus `/usage` rund um diese kontrollierte Sitzung. Notieren Sie je Modell Eingabe-, Ausgabe- und Cachetokens, angezeigte Kostenschätzung, Anbieter oder Tarif, akzeptierten Diff, ursprüngliches Prüfergebnis und nötige Prüfung oder Nacharbeit. Der Block Session fasst die gesamte Sitzung je Modell zusammen; er ist keine genaue Rechnung für diesen benannten Bearbeiter. Tarifzuordnungsprozente sind eine ungefähre lokale Tages- oder Wochenhistorie, keine Messung dieser Aufgabe. Bei einem API-Konto ist Claude Console die maßgebliche Abrechnungsquelle. Bei einem Abonnement ist die Dollar-Schätzung der Sitzung keine zusätzliche Rechnung. Kennzeichnen Sie eine Anzeige des zuletzt bekannten Nutzungsstands als veraltet.

Um eine finanzielle Ersparnis durch Delegation bei **dieser** Aufgabe zu behaupten, vergleichen Sie sie mit einem separat autorisierten Einmodelllauf ab derselben sauberen Ausgangsrevision mit derselben Aufgabe und denselben Abnahmekriterien. Zählen Sie Planung und Prüfung des Hauptagenten, Unteragentenaufrufe, Wiederholungen und Nacharbeit; vergleichen Sie nur akzeptierte Ergebnisse. Ein Laufpaar bleibt eine aufgabenspezifische Beobachtung. Ohne Vergleichsbasis berichten Sie den geprüften Modellweg und das Codeergebnis; die Ersparnis ist unbekannt. [Anthropics Kostenleitfaden](https://code.claude.com/docs/en/costs) erklärt Nutzungsanzeige und Abrechnungsgrenzen.

Dieses Verfahren beruht auf aktueller Dokumentation, nicht auf einem Claude Code-Lauf von BIG CHANGE oder einer gemessenen Aufgabe. Senden Sie keinen Code oder Geheimnisse, die Ihre Organisation nicht für den konfigurierten Anbieter freigegeben hat. Dieser Weg nutzt die native Opus- und Haiku-Auswahl von Claude Code; ein anderer Modellanbieter bräuchte einen separat beschriebenen Gateway- oder Orchestrierungsablauf und eigene Prüfungen.

## Quellen und weiterführende Informationen

- [Anthropic: Eigene Unteragenten erstellen](https://code.claude.com/docs/en/sub-agents) — Projektagentendateien, Modellpriorität, `/tasks`, Berechtigungen und Worktree-Verhalten. Aktuelles Handbuch geprüft am 20. Oktober 2026; es dokumentiert die Funktion, nicht das Ergebnis des nicht ausgeführten Beispiels.
- [Anthropic: Modellkonfiguration](https://code.claude.com/docs/en/model-config) — aktuelle Aliase, Anbieterunterschiede, Versionsanforderungen und verwaltete Modellsteuerungen. Bestätigen Sie installierte Version und Anbieter bei der Nutzung.
- [Anthropic: Kosten wirksam verwalten](https://code.claude.com/docs/en/costs) — `/usage`: Felder, Schätzungen und Abonnement- gegenüber API-Abrechnung. Dies belegt keine Ersparnis bei dieser Aufgabe.
- [Anthropic: Berechtigungen konfigurieren](https://code.claude.com/docs/en/permissions) — wirksame Werkzeugberechtigungen, die vor Ausführung eines codeändernden Bearbeiters geprüft werden müssen.

## Sources

- [Eigene Unteragenten erstellen — Claude Code-Dokumentation](https://code.claude.com/docs/en/sub-agents) — Primäres Produkthandbuch für Projektagentendateien, Metadaten, Modellpriorität und Überschreibungen, /tasks-Ablesung, Berechtigungsvererbung und Worktree-Verhalten. Es verifiziert weder die nicht ausgeführte Aufgabe noch eine Ersparnis.
- [Modellkonfiguration — Claude Code-Dokumentation](https://code.claude.com/docs/en/model-config) — Primärquelle für aktuelle Opus- und Haiku-Aliase und IDs auf der Anthropic-API, andere Anbieterzuordnungen, Mindestversionen und verwaltete availableModels-Einschränkungen. Leser müssen die tatsächliche lokale Auflösung prüfen.
- [Kosten wirksam verwalten — Claude Code-Dokumentation](https://code.claude.com/docs/en/costs) — Erklärt /usage-Sitzungstokens und Schätzfelder, lokale Tarifzuordnung, veraltete Anzeigen, Abonnement- und API-Abrechnung und Console als Abrechnungsinstanz. Ergibt keine präzise Rechnung für einen benannten Bearbeiter oder eine gemessene Aufgabenersparnis.
- [Berechtigungen konfigurieren — Claude Code-Dokumentation](https://code.claude.com/docs/en/permissions) — Erklärt die wirksamen Shell- und Dateiberechtigungen für codeändernde Bearbeiter. Eine Unteragenten-Werkzeugliste allein ist keine Dateisystem-Pfadgrenze.