Dynamische Workflows

Nutzen Sie die Dynamischen Workflows von Claude Code, um Dutzende bis Hunderte von Hintergrund-Sub-Agenten zu orchestrieren – für repoweite Reviews, Migrationen und Recherchen – funktioniert über QCode

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Subagenten ermöglichen bereits das „Aussenden eines Klons“, um parallel eine Sache zu untersuchen. Aber wenn eine Aufgabe so groß ist, dass ein „ganzes Team“ nötig wird – zum Beispiel ein ganzes Repository durchgehen und für jedes Modul ein Review schreiben –, reicht ein einzelner Subagent nicht aus. Hier kommen Dynamische Workflows ins Spiel.

Dynamische Workflows ermöglichen es Claude Code, Dutzende bis Hunderte von Hintergrund-Sub-Agenten auf einen Schlag zu orchestrieren, wobei jeder einen Teil der Arbeit übernimmt und parallel läuft, während Sie Ihren eigenen Aufgaben nachgehen. Es läuft auf dem Modell, mit dem Claude Code aktuell konfiguriert ist – solange Sie Claude Code auf QCode richten, funktionieren Workflows sofort out of the box.

Welches Problem es löst¶

Gewöhnliche Subagenten eignen sich hervorragend für „einige, kontrollierte“ parallele Aufgaben: 2–3 Klons ausschicken, um jeweils die API, das Schema und die Testabdeckung zu prüfen. Aber manche Aufgaben sind von Natur aus hochparallel:

• Ein pro-Datei-Sicherheits-/Qualitäts-Review über ein Repo mit 200 Dateien
• Stapelweise Migration eines alten API-Aufrufs auf einen neuen Stil in der gesamten Codebase
• Zu einem Thema Dutzende von Verzeichnissen einzeln recherchieren und zusammenfassen

Der Reihe nach müssten Sie warten, bis Claude sie einzeln abarbeitet; Dutzende von Subagenten von Hand zu starten bedeutet, dass Sie die Aufgaben selbst aufteilen und den Fortschritt überwachen müssen. Dynamische Workflows übergeben die gesamte „Aufteilen → Verteilen → Im Hintergrund ausführen → Zusammenfassen“-Schleife an Claude Code, der selbstständig orchestriert.

Wie man es auslöst¶

Dynamische Workflows erfordern keine zusätzliche Installation, und die Auslösung ist leichtgewichtig:

• Nehmen Sie das Schlüsselwort ultracode in Ihren Prompt auf; oder
• Fordern Sie einfach auf, „einen Workflow auszuführen“.

Sobald Claude Code die Absicht erkennt, plant es, wie viele Hintergrund-Sub-Agenten entsandt werden und was jeder davon übernimmt, und startet sie parallel.

> ultracode review every submodule under src/, focusing on error handling
> and input validation. Have each module output a short report, then roll
> everything up into one overview.

Oder in natürlicher Sprache:

> Run a workflow for me: scan the whole repo for every call to the old
> httpClient, estimate the effort to migrate to the new fetch wrapper, and
> summarize grouped by directory.

Ausführungen mit /workflows anzeigen¶

Die Sub-Agenten, die ein Workflow entsendet, laufen weiterhin im Hintergrund – sie blockieren Ihre Haupt-Session nicht, sodass Sie weiterhin andere Fragen stellen und Code schreiben können. Um zu sehen, welche Workflows aktuell laufen und wie weit sie fortgeschritten sind, verwenden Sie:

/workflows

Es listet die laufenden und abgeschlossenen Workflow-Ausführungen auf, sodass Sie den Gesamtfortschritt verfolgen und die Ausgabe jedes Sub-Agenten überprüfen können.

Hintergrundausführung bedeutet, dass große Aufgaben Ihre Interaktion nicht mehr blockieren. Erteilen Sie die Anweisung, gehen Sie einer anderen Tätigkeit nach und kehren Sie zurück, um die Ergebnisse mit /workflows abzuholen.

Wann ein Workflow statt eines einzelnen Subagenten¶

Beide verfolgen dieselbe Idee der „parallelen Delegation“ in unterschiedlichen Maßstäben, und die Entscheidung ist einfach: Es kommt auf den Parallelumfang an und darauf, ob Sie es im Hintergrund laufen lassen müssen.

Faustregel:

• Nur einige wenige Teilaufgaben und Sie möchten sofortige Ergebnisse → verwenden Sie Subagenten.
• Dutzende oder Hunderte von Teilaufgaben, die im Hintergrund laufen können → verwenden Sie Dynamische Workflows.

Dynamische Workflows sind im Grunde die „skalierte“ Version von Subagenten. Machen Sie sich zunächst mit dem Subagenten-Konzept vertraut, und Workflows werden sich natürlich anfühlen.

Verwendung über QCode¶

Dynamic Workflows laufen auf dem Modell, mit dem Claude Code gerade verbunden ist, und sind an keinen bestimmten Anbieter gebunden. Das heißt: Sobald Sie Claude Code auf QCode richten, durchläuft jeder Hintergrund-Sub-Agent, den ein Workflow startet, die QCode-Endpunkte – derselbe API-Key mit dem Präfix cr_ funktioniert überall.

Minimale Einrichtung (Anthropic-Protokoll):

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

# Users in China should prefer the asia endpoint
# export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"

Die BASE_URL darf keinen Schrägstrich am Ende haben. Ein direkter Aufruf dieser Adresse gibt 401 zurück, was normal ist – es bedeutet, dass der Pfad korrekt ist und nur die Authentifizierung fehlt.

Nach der Konfiguration starten Sie Claude Code wie gewohnt und lösen einen Workflow mit ultracode aus. Die vollständige Endpunkt-Referenz, die drei Domains (api / asia / us) und die Pfade der jeweiligen Protokolle finden Sie unter Endpunkte und API-Formate.

Jeder Hintergrund-Sub-Agent in einem Workflow wird nach dem von Ihnen gewählten Modell auf QCode abgerechnet. Ein großer Workflow startet viele Sub-Agenten gleichzeitig, der Token-Verbrauch steigt entsprechend – vor einem großen Durchlauf lohnt es sich, mit einem Flaggschiff-Modell (z. B. claude-opus-5, $5/$25 pro Million Tokens, 1M Kontext) einen kleinen Pilotlauf durchzuführen, die Ausgabequalität zu prüfen und erst danach vollständig auszurollen.

Praxisbeispiele¶

Beispiel 1: Code-Review über das gesamte Repository¶

Lassen Sie den Workflow pro Hauptmodul im Repository ein Review erstellen – mit einheitlichem Fokus und einheitlicher Ausgabe, das dann zusammengeführt wird:

> ultracode do an independent code review of every sub-package under packages/.
> Each review should cover: error handling, edge cases, any unhandled Promises,
> naming consistency. Each sub-package outputs a bullet list of no more than 20
> lines, then roll everything up into one master table sorted by severity.

Nach dem Start können Sie andere Aufgaben erledigen, den Fortschritt später mit /workflows prüfen und die zusammengeführte Tabelle begutachten, sobald alle Sub-Agenten fertig sind.

Beispiel 2: Großangelegte API-Migrationsanalyse¶

Bevor Sie etwas anfassen, nutzen Sie einen Workflow, um die Auswirkungen abzuschätzen:

> Run a workflow for me: find everywhere in the codebase that uses axios
> directly, group by directory, estimate the effort and risk of switching to
> the in-project httpClient wrapper, and output a table of
> "directory / occurrences / migration difficulty / caveats".

Mit dem vollständigen Bild können Sie die Migrationsreihenfolge anhand echter Daten festlegen statt nach Bauchgefühl.

Tipps und Hinweise¶

• Klein anfangen, dann skalieren: Begrenzen Sie den Workflow beim ersten Durchlauf auf ein einzelnes Verzeichnis oder Paket, prüfen Sie, ob Ausgabeformat und Qualität Ihren Erwartungen entsprechen, und erweitern Sie ihn dann auf das gesamte Repository.
• Ausgabeformat standardisieren: Formulieren Sie im Prompt klar, was jeder Sub-Agent ausgeben soll, wie lang und in welcher Sortierung – das spart beim Zusammenführen viel Aufwand.
• Hintergrund heißt nicht unbeaufsichtigt: Während ein Workflow läuft, können Sie anderen Aufgaben nachgehen, aber denken Sie daran, später mit /workflows den Abschluss zu prüfen.
• Zu Bildern: Dynamic Workflows verarbeiten Text- und Code-Aufgaben. Wenn Sie möchten, dass Claude Code Bilder liest (Screenshots, Architekturdiagramme, Fehler-Screenshots), ist das die Vision-Input-Funktion und hat nichts mit Workflows zu tun; wenn Sie Bilder erzeugen möchten, nutzen Sie gpt-image-2 Bildgenerierung.
• Um Workflows in CI-Skripte einzubinden, kombinieren Sie den Headless-Modus mit strukturierter Ausgabe – siehe Automatisierung und CI/CD.

Auslöser und wichtige Einstellungen¶

Stand 2026-10-15 gilt laut der offiziellen Claude-Code-Dokumentation zu dynamischen Workflows:

Wählen Sie in /workflows einen Lauf aus und drücken Sie s, um sein Skript als eigenen Befehl zu speichern: Im .claude/workflows/ des Projekts wird es mit dem Repository geteilt, in ~/.claude/workflows/ bleibt es privat.

Workflows über QCode ausführen: Hinweise¶

• Parallelität und Ratenlimits: Ein Workflow kann standardmäßig 16 Agenten gleichzeitig laufen lassen, ein QCode-Privatplan oder ein Nutzungspaket erlaubt dagegen 5 gleichzeitige Anfragen pro API-Key (Ultimate: 10; siehe FAQ). Kommt es bei einem großen Lauf zur Ratenbegrenzung (häufig 429) oder zu einzelnen Agentenfehlern, senken Sie zuerst CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS auf einen zur Parallelität Ihres Tarifs passenden Wert und versuchen es erneut.
• Kosten: Die Tokens jedes Agenten werden für das gewählte Modell berechnet; QCode rechnet pro Token ab, die Preise je Modell stehen unter qcode.cc/models. Laut Dokumentation erscheint im Aufgabenfenster eine Large-workflow-Warnung, wenn ein Lauf mehr als 25 Agenten einplant oder die Prognose über 1,5 Millionen Tokens liegt; sie ist nur ein Hinweis und hält den Lauf nicht an. Am sichersten ist ein Probelauf an einem Verzeichnis oder einer engen Frage.
• Modell: Ohne andere Angabe verwenden Agenten das aktuelle Modell der Sitzung. Für einfache Stufen können Sie bei der Aufgabenbeschreibung ein leichteres Modell wie claude-haiku-5-5 verlangen.

Häufige Fehler und Fehlersuche¶

FAQ¶

Kann ich nach dem Verlassen der Sitzung weitermachen?¶

In derselben Sitzung ja: Lassen Sie Claude denselben Workflow neu starten; abgeschlossene Agenten liefern ihr gespeichertes Ergebnis, fehlgeschlagene und danach gestartete laufen erneut. Nach dem Beenden bringt claude --resume die Sitzung zurück, und der Lauf lässt sich wiederholen; eine neu gestartete Sitzung kennt den früheren Lauf nicht.

Wie viele Agenten kann ein Lauf höchstens starten?¶

Offiziell sind es 1.000 Agenten pro Lauf, standardmäßig 16 gleichzeitig. Das sind Grenzen von Claude Code selbst; das Parallelitätslimit von QCode gilt davon getrennt, wie oben beschrieben.

Wird ein Workflow teuer?¶

Er verbraucht mehr Tokens, als dieselbe Arbeit Schritt für Schritt im Gespräch zu erledigen. Probieren Sie zuerst einen kleinen Ausschnitt, sehen Sie in /workflows den Token-Verbrauch jedes Agenten und stoppen Sie den Lauf bei Bedarf jederzeit.

Befolgen die Agenten im Workflow meine Berechtigungseinstellungen?¶

Ja. Die Dokumentation sagt, dass die Tool-Aufrufe der Agenten dieselben Berechtigungsprüfungen und dieselbe Sandbox durchlaufen wie jeder Tool-Aufruf Ihrer Sitzung; das Schlüsselwort ultracode bestimmt nur, wie die Arbeit organisiert wird.

Wie lasse ich mein Team einen Workflow wiederverwenden?¶

Wählen Sie den Lauf in /workflows, drücken Sie s und speichern Sie ihn im .claude/workflows/ des Projekts, dann ist er über das Repository für alle verfügbar.

Möchten Sie große Workflows mit einem Flaggschiff-Modell ausführen, ohne die Kosten aus den Augen zu verlieren? Werfen Sie einen Blick auf die QCode-Preise – ein API-Key funktioniert über alle Endpunkte hinweg.

Enterprise →