Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Dynamische Workflows befinden sich in der Forschungsvorschau. Sie erfordern Claude Code v2.1.154 oder später und sind auf allen bezahlten Plänen, mit Anthropic API-Zugriff und auf Amazon Bedrock, Google Cloud Vertex AI und Microsoft Foundry verfügbar. Aktivieren Sie sie auf Pro über die Zeile „Dynamic workflows” in /config.
Ein dynamischer Workflow ist ein JavaScript-Skript, das Subagenten im großen Maßstab orchestriert. Claude schreibt das Skript für die Aufgabe, die Sie beschreiben, und eine Laufzeit führt es im Hintergrund aus, während Ihre Sitzung reaktionsschnell bleibt. Greifen Sie zu einem Workflow, wenn eine Aufgabe mehr Agenten benötigt, als ein Gespräch koordinieren kann, oder wenn Sie die Orchestrierung als Skript codifizieren möchten, das Sie lesen und erneut ausführen können. Beispiele sind eine codebase-weite Fehlersuche, eine 500-Datei-Migration, eine Forschungsfrage, die Quellen gegeneinander überprüft, und ein schwieriger Plan, der aus mehreren unabhängigen Blickwinkeln entworfen werden sollte, bevor Sie sich auf einen einigen. Diese Seite behandelt, wie Sie:

​
Wann Sie einen Workflow verwenden

Subagenten, Skills und Workflows können alle eine mehrstufige Aufgabe ausführen. Der Unterschied liegt darin, wer den Plan hält:
SubagentenSkillsWorkflows
Was es istEin Worker-Claude, den Sie spawnenAnweisungen, die Claude befolgtEin Skript, das die Laufzeit ausführt
Wer entscheidet, was als nächstes ausgeführt wirdClaude, Zug um ZugClaude, nach der EingabeaufforderungDas Skript
Wo Zwischenergebnisse lebenClaudes KontextfensterClaudes KontextfensterSkriptvariablen
Was wiederholbar istDie Worker-DefinitionDie AnweisungenDie Orchestrierung selbst
SkalierungEin paar delegierte Aufgaben pro ZugGleich wie SubagentenDutzende bis Hunderte von Agenten pro Ausführung
UnterbrechungStartet den Zug neuStartet den Zug neuWiederaufnehmbar in derselben Sitzung
Ein Workflow verschiebt den Plan in Code. Bei Subagenten und Skills ist Claude der Orchestrator: Er entscheidet Zug um Zug, was als nächstes gespawnt werden soll, und jedes Ergebnis landet in Claudes Kontext. Ein Workflow-Skript hält die Schleife, die Verzweigung und die Zwischenergebnisse selbst, sodass Claudes Kontext nur die endgültige Antwort enthält. Das Verschieben des Plans in Code ermöglicht es einem Workflow auch, ein wiederholbares Qualitätsmuster anzuwenden, nicht nur mehr Agenten auszuführen: Er kann unabhängige Agenten die Ergebnisse des anderen gegnerisch überprüfen lassen, bevor sie gemeldet werden, oder einen Plan aus mehreren Blickwinkeln entwerfen und sie gegeneinander abwägen, sodass Sie ein vertrauenswürdigeres Ergebnis als einen einzelnen Durchgang erhalten.

​
Führen Sie einen gebündelten Workflow aus

Die schnellste Möglichkeit, einen Workflow in Aktion zu sehen, ist die Ausführung von /deep-research, dem integrierten Workflow, den Claude Code zum Untersuchen einer Frage über viele Quellen hinweg enthält. Sie sehen Agenten, die im Hintergrund eine Reihe von Phasen durcharbeiten, während Ihre Sitzung frei bleibt, und erhalten am Ende einen Bericht statt eines Zug-für-Zug-Transkripts.
1

Führen Sie den Workflow aus

Führen Sie /deep-research mit einer Frage aus, die Sie untersuchen möchten. Es verteilt Websuchen über mehrere Blickwinkel, ruft die gefundenen Quellen ab und überprüft sie gegenseitig, und synthetisiert einen zitierten Bericht.
/deep-research What changed in the Node.js permission model between v20 and v22?
2

Erlauben Sie Workflows

Claude Code fragt, ob der Workflow erlaubt werden soll. Wählen Sie Ja, um fortzufahren. Die genaue Eingabeaufforderung hängt von Ihrem Berechtigungsmodus ab. Siehe Genehmigen Sie den Plan, bevor er ausgeführt wird für die Optionen pro Modus.
3

Überwachen Sie den Fortschritt

Die Ausführung startet im Hintergrund. Führen Sie /workflows aus, verwenden Sie die Pfeiltasten, um die Ausführung auszuwählen, und drücken Sie Enter, um die Fortschrittsansicht zu öffnen:
/workflows
Die Ansicht zeigt jede Phase mit ihrer Agentenzahl, Gesamttoken und verstrichener Zeit. Führen Sie einen Drilldown in jede Phase durch, um ihre Agenten und die Ergebnisse der einzelnen Agenten anzuzeigen. Siehe Überwachen Sie die Ausführung für den vollständigen Satz von Steuerelementen.Sie können auch über das Aufgabenpanel unter dem Eingabefeld beobachten: Eine einzeilige Fortschrittsübersicht wird dort angezeigt, während die Ausführung läuft. Drücken Sie die Abwärts-Taste, um es zu fokussieren, dann Enter, um es zu erweitern.
4

Lesen Sie den Bericht

Wenn die Ausführung abgeschlossen ist, landet der Bericht in Ihrer Sitzung. Er zitiert die Quellen, aus denen jeder Anspruch stammt, wobei Ansprüche, die die Überprüfung nicht überlebt haben, bereits gefiltert sind.
Um einen Workflow für Ihre eigene Aufgabe auszuführen, lassen Sie Claude einen schreiben, und sobald eine Ausführung das tut, was Sie wollten, können Sie ihn speichern als Befehl Ihres eigenen.

​
Gebündelte Workflows

Claude Code enthält /deep-research als integrierten Workflow:
BefehlWas er tut
/deep-research <question>Verteilt Websuchen zu einer Frage über mehrere Blickwinkel, ruft die gefundenen Quellen ab und überprüft sie gegenseitig, stimmt über jeden Anspruch ab und gibt einen zitierten Bericht mit Ansprüchen zurück, die die Überprüfung nicht überlebt haben, gefiltert. Erfordert, dass das WebSearch-Tool verfügbar ist
Workflows, die Sie selbst speichern, werden auf die gleiche Weise zu Befehlen und erscheinen in der /-Autovervollständigung neben den gebündelten.

​
Überwachen Sie die Ausführung

Workflows werden im Hintergrund ausgeführt, sodass die Sitzung reaktionsschnell bleibt, während Agenten arbeiten. Führen Sie /workflows jederzeit aus, um laufende und abgeschlossene Workflows aufzulisten, und wählen Sie dann einen aus, um die Fortschrittsansicht zu öffnen. 
/workflows
Die Fortschrittsansicht zeigt jede Phase mit ihren Agentenzahlen, Gesamttoken und verstrichener Zeit. Die Fußzeile listet den Schlüssel für jede Aktion auf:
SchlüsselAktion
↑ / ↓Wählen Sie eine Phase oder einen Agenten aus
Enter oder →Führen Sie einen Drilldown in die ausgewählte Phase durch, dann in einen Agenten, um seine Eingabeaufforderung, aktuelle Toolaufrufe und Ergebnis zu lesen
EscGehen Sie eine Ebene zurück
j / kScrollen Sie innerhalb der Agent-Details, wenn sie überläuft
pUnterbrechen oder fortsetzen Sie die Ausführung
xBeenden Sie den ausgewählten Agenten, oder beenden Sie den gesamten Workflow, wenn der Fokus auf der Ausführung liegt
rStarten Sie den ausgewählten laufenden Agenten neu
sSpeichern Sie das Skript der Ausführung als Befehl

​
Lassen Sie Claude einen Workflow schreiben

Sie können Claude auf zwei Arten einen Workflow für Ihre Aufgabe schreiben lassen: Sie können auch einen Workflow-Befehl ausführen, der bereits vorhanden ist: ein gebündelter Workflow wie /deep-research oder einer, den Sie gespeichert haben.

​
Fordern Sie einen Workflow in Ihrer Eingabeaufforderung an

Um eine einzelne Aufgabe als Workflow auszuführen, ohne die Anstrengungsebene der Sitzung zu ändern, fügen Sie das Wort workflow überall in Ihrer Eingabeaufforderung ein. 
Run a workflow to audit every API endpoint under src/routes/ for missing auth checks
Claude Code hebt das Wort in Ihrer Eingabe hervor und Claude schreibt stattdessen ein Workflow-Skript für die Aufgabe, anstatt es Zug um Zug durchzuarbeiten. Wenn die Ausführung das tut, was Sie wollten, können Sie sie danach als Befehl speichern. Wenn Claude Code das Wort hervorhebt, obwohl Sie nicht beabsichtigt haben, einen auszulösen, drücken Sie alt+w, um ihn für diese Eingabeaufforderung zu ignorieren.

​
Lassen Sie Claude mit Ultracode entscheiden

Ultracode ist eine Claude Code-Einstellung, die xhigh Anstrengungsebene mit automatischer Workflow-Orchestrierung kombiniert. Wenn es aktiviert ist, plant Claude einen Workflow für jede wesentliche Aufgabe, anstatt auf Sie zu warten. 
/effort ultracode
Mit Ultracode aktiviert entscheidet Claude, wann eine Aufgabe einen Workflow rechtfertigt. Eine einzelne Anfrage kann sich in mehrere Workflows hintereinander verwandeln: einen zum Verstehen des Codes, einen zum Vornehmen der Änderung und einen zum Überprüfen. Dies gilt für jede Aufgabe in der Sitzung, sodass jede Anfrage mehr Token verwendet und länger dauert als bei niedrigeren Anstrengungsebenen. Ultracode dauert für die aktuelle Sitzung und wird zurückgesetzt, wenn Sie eine neue starten. Gehen Sie mit /effort high zurück, wenn Sie zur Routinearbeit zurückkehren. Es ist auf Modellen verfügbar, die xhigh Anstrengung unterstützen; auf anderen Modellen bietet das /effort-Menü es nicht an.

​
Genehmigen Sie den Plan, bevor er ausgeführt wird

In der CLI zeigt die Eingabeaufforderung pro Ausführung die geplanten Phasen und diese Optionen:
  • Ja, führen Sie es aus: Starten Sie die Ausführung
  • Ja, und fragen Sie nicht mehr nach <name> in <path>: Starten Sie, und überspringen Sie diese Eingabeaufforderung für diesen Workflow in diesem Projekt von nun an
  • Rohes Skript anzeigen: Lesen Sie das Skript, bevor Sie entscheiden
  • Nein: Abbrechen
Ctrl+G öffnet das Skript in Ihrem Editor. Tab ermöglicht es Ihnen, die Eingabeaufforderung vor dem Start der Ausführung anzupassen. Ob Sie diese Eingabeaufforderung sehen, hängt von Ihrem Berechtigungsmodus ab:
BerechtigungsmodusWann Sie aufgefordert werden
Standard, Bearbeitungen akzeptierenJede Ausführung, es sei denn, Sie haben Ja, und fragen Sie nicht mehr für diesen Workflow in diesem Projekt ausgewählt
AutomatischNur beim ersten Start. Jedes Ja zeichnet die Zustimmung in Ihren Benutzereinstellungen auf, und spätere Starts werden ohne Eingabeaufforderung gestartet. Vollständig übersprungen, wenn Ultracode aktiviert ist
Berechtigungen umgehen, claude -p, Agent SDKNie. Die Ausführung startet sofort
In der Desktop-App zeigt eine Genehmigungskarte den Workflow-Namen, die Phasenliste und eine Token-Nutzungswarnung mit den Aktionen Einmal, Immer und Ablehnen. Die Fortschrittsansicht wird im Seitenpanel „Hintergrundaufgaben” angezeigt. Ihr Berechtigungsmodus steuert nur die oben genannte Startaufforderung. Die Subagenten, die der Workflow spawnt, werden immer im acceptEdits-Modus ausgeführt und erben Ihre Tool-Zulassungsliste, unabhängig vom Modus Ihrer Sitzung. Dateibearbeitungen werden automatisch genehmigt. Shell-Befehle, Web-Abrufe und MCP-Tools, die nicht in Ihrer Zulassungsliste enthalten sind, können Sie während der Ausführung immer noch auffordern. Um dies bei einer langen Ausführung zu vermeiden, fügen Sie die Befehle, die die Agenten benötigen, vor dem Start zu Ihrer Zulassungsliste hinzu. In claude -p und dem Agent SDK gibt es niemanden zum Auffordern, daher folgen Toolaufrufe Ihren konfigurierten Berechtigungsregeln ohne interaktive Bestätigung.

​
Speichern Sie den Workflow zur Wiederverwendung

Wenn Claude einen Workflow für eine Aufgabe schreibt, die Sie wiederholen werden, können Sie das Skript dieser Ausführung als Befehl speichern. Ein Prozess wie eine Überprüfung, die Sie auf jedem Branch ausführen, führt dann jedes Mal die gleiche Orchestrierung aus. Führen Sie /workflows aus, wählen Sie die Ausführung aus, die Sie behalten möchten, und drücken Sie s. Im Speicherdialog wechselt Tab zwischen den beiden Speicherorten:
  • .claude/workflows/ in Ihrem Projekt: Geteilt mit jedem, der das Repo klont
  • ~/.claude/workflows/ in Ihrem Home-Verzeichnis: Verfügbar in jedem Projekt, nur für Sie sichtbar
Drücken Sie Enter zum Speichern. Der Workflow wird in zukünftigen Sitzungen von beiden Orten aus als /<name> ausgeführt. Wenn ein Projekt-Workflow und ein persönlicher Workflow denselben Namen teilen, wird der Projekt-Workflow ausgeführt.

​
Wie ein Workflow ausgeführt wird

Die Workflow-Laufzeit führt das Skript in einer isolierten Umgebung aus, getrennt von Ihrem Gespräch. Zwischenergebnisse bleiben in Skriptvariablen, anstatt in Claudes Kontext zu landen. Die Laufzeit verfolgt das Ergebnis jedes Agenten, während die Ausführung fortschreitet, was macht, dass eine Ausführung wiederaufnehmbar innerhalb derselben Sitzung ist.

​
Verhalten und Grenzen

Die Laufzeit wendet die folgenden Einschränkungen an:
EinschränkungWarum
Keine Benutzereingabe während der AusführungNur Agent-Berechtigungsaufforderungen können eine Ausführung unterbrechen. Für die Genehmigung zwischen Phasen führen Sie jede Phase als ihren eigenen Workflow aus
Kein direkter Dateisystem- oder Shell-Zugriff vom Workflow selbstAgenten lesen, schreiben und führen Befehle aus. Das Skript koordiniert die Agenten
Bis zu 16 gleichzeitige Agenten, weniger auf Maschinen mit begrenzten CPU-KernenBegrenzt die lokale Ressourcennutzung
1.000 Agenten insgesamt pro AusführungVerhindert Endlosschleifen

​
Verwalten Sie Ausführungen

Sobald eine Ausführung startet, verwalten Sie sie über die /workflows-Ansicht oder durch Erweitern der Fortschrittszeile im Aufgabenpanel unter dem Eingabefeld.

​
Fortsetzen nach einer Pause

Wenn Sie eine Ausführung beenden, können Sie sie fortsetzen: Agenten, die bereits abgeschlossen sind, geben ihre zwischengespeicherten Ergebnisse zurück, und der Rest wird live ausgeführt. Setzen Sie eine unterbrochene Ausführung von /workflows fort, indem Sie sie auswählen und p drücken, oder bitten Sie Claude, den Workflow mit dem gleichen Skript erneut zu starten. Die Wiederaufnahme funktioniert innerhalb derselben Claude Code-Sitzung. Wenn Sie Claude Code beenden, während ein Workflow ausgeführt wird, startet die nächste Sitzung den Workflow von vorne.

​
Kosten

Ein Workflow spawnt viele Agenten, sodass eine einzelne Ausführung bedeutend mehr Token verwenden kann als die Bearbeitung der gleichen Aufgabe in einem Gespräch. Ausführungen zählen zur Nutzung und zu Ratenlimits Ihres Plans wie jede andere Sitzung. Sie können einen laufenden Workflow jederzeit von /workflows aus beenden, ohne abgeschlossene Arbeiten zu verlieren. Jeder Agent in einem Workflow verwendet das Modell Ihrer Sitzung, es sei denn, das Skript leitet eine Phase zu einem anderen weiter. Um die Modellkosten zu kontrollieren:
  • Überprüfen Sie /model vor einer großen Ausführung, wenn Sie normalerweise zu einem kleineren Modell für Routinearbeit wechseln
  • Bitten Sie Claude, ein kleineres Modell für Phasen zu verwenden, die nicht das stärkste benötigen, wenn Sie die Aufgabe beschreiben

​
Schalten Sie Workflows aus

Workflows sind in der CLI, der Desktop-App, den IDE-Erweiterungen, nicht-interaktivem Modus mit claude -p und dem Agent SDK verfügbar. Die gleichen Deaktivierungseinstellungen gelten auf jeder Oberfläche. Um Workflows für sich selbst auszuschalten:
  • Schalten Sie „Dynamic workflows” in /config aus. Bleibt über Sitzungen hinweg erhalten.
  • Setzen Sie "disableWorkflows": true in ~/.claude/settings.json. Bleibt über Sitzungen hinweg erhalten.
  • Setzen Sie CLAUDE_CODE_DISABLE_WORKFLOWS=1. Wird beim Start gelesen, daher gilt es überall dort, wo Sie es setzen.
Um Workflows für Ihre gesamte Organisation auszuschalten, setzen Sie "disableWorkflows": true in verwalteten Einstellungen oder verwenden Sie den Umschalter auf der Seite Claude Code-Administratoreinstellungen. Wenn Workflows deaktiviert sind, sind die gebündelten Workflow-Befehle nicht verfügbar, das Schlüsselwort workflow löst keine Ausführung mehr aus, und ultracode wird aus dem /effort-Menü entfernt.

​
Verwandte Ressourcen