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

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.

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.