Zum Hauptinhalt springen
Dynamische Workflows sind auf allen bezahlten Plänen, mit Anthropic API-Zugriff und auf Amazon Bedrock, Google Cloud’s Agent Platform 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 viele Subagenten auf einmal 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.

Wann sollte man einen Workflow verwenden

Subagenten, Skills, Agent-Teams und Workflows können alle eine mehrstufige Aufgabe ausführen. Der Unterschied liegt darin, wer den Plan hält: Ein Workflow verlagert den Plan in Code. Bei Subagenten, Skills und Agent-Teams ist Claude der Orchestrator: Er entscheidet Zug um Zug, was als Nächstes erzeugt oder zugewiesen werden soll, und jedes Ergebnis geht in ein Kontextfenster. Ein Workflow-Skript hält die Schleife, die Verzweigung und die Zwischenergebnisse selbst, sodass Claudes Kontext nur die endgültige Antwort enthält. Die Verlagerung 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 gegenseitig die Ergebnisse des anderen gegnerisch überprüfen lassen, bevor sie gemeldet werden, oder einen Plan aus mehreren Blickwinkeln entwerfen und diese gegeneinander abwägen, sodass Sie ein vertrauenswürdigeres Ergebnis erhalten als bei einem einzelnen Durchgang.

Einen mitgelieferten Workflow ausführen

Am schnellsten sehen Sie einen Workflow in Aktion, wenn Sie /deep-research ausführen, den integrierten Workflow, den Claude Code für die Untersuchung einer Frage über viele Quellen hinweg mitbringt. Sie sehen, wie Agenten im Hintergrund eine Reihe von Phasen durchlaufen, während Ihre Sitzung frei bleibt, und erhalten am Ende einen einzigen Bericht statt eines Transkripts Turn für Turn.
1

Workflow ausführen

Führen Sie /deep-research mit einer Frage aus, die untersucht werden soll. Der Workflow verteilt Websuchen auf mehrere Blickwinkel, ruft die gefundenen Quellen ab, gleicht sie miteinander ab und fasst die Ergebnisse zu einem Bericht mit Quellenangaben zusammen.
2

Workflows zulassen

Claude Code fragt, ob der Workflow zugelassen werden soll. Wählen Sie Yes, um fortzufahren. Die genaue Abfrage hängt von Ihrem Berechtigungsmodus ab. Unter Den Plan vor der Ausführung genehmigen finden Sie die Optionen für jeden Modus.
3

Fortschritt verfolgen

Die Ausführung startet im Hintergrund. Führen Sie /workflows aus, um die Fortschrittsansicht zu öffnen:
Wenn /workflows stattdessen eine Liste von Ausführungen anzeigt, wählen Sie die gerade gestartete Ausführung aus und drücken Sie Enter. Die Ansicht zeigt jede Phase mit ihrer Anzahl an Agenten. Öffnen Sie eine beliebige Phase, um ihre Agenten und deren jeweilige Ergebnisse zu sehen. Unter Die Ausführung verfolgen finden Sie alle verfügbaren Steuerelemente.Sie können den Fortschritt auch im Aufgabenbereich unterhalb des Eingabefelds verfolgen: Dort erscheint während der Ausführung eine einzeilige Fortschrittsübersicht. Drücken Sie die Pfeiltaste nach unten, um sie zu fokussieren, und dann Enter, um sie zu erweitern.
4

Bericht lesen

Wenn die Ausführung abgeschlossen ist, erscheint der Bericht in Ihrer Sitzung. Er nennt für jede Aussage die Quellen, aus denen sie stammt, wobei Aussagen, die dem Abgleich nicht standgehalten haben, bereits herausgefiltert sind.Wenn die Prüf-Agenten eine Aussage nicht überprüfen können, etwa nach einem Rate-Limit oder einem API-Fehler, führt der Bericht diese Aussage als nicht verifiziert auf, statt sie als widerlegt zu werten.
Um einen Workflow für Ihre eigene Aufgabe auszuführen, lassen Sie Claude einen schreiben. Sobald eine Ausführung das gewünschte Ergebnis liefert, können Sie sie als eigenen Befehl speichern.

Mitgelieferte Workflows

Claude Code enthält /deep-research als integrierten Workflow: Workflows, die Sie selbst speichern, werden auf die gleiche Weise zu Befehlen und erscheinen in der /-Autovervollständigung neben den mitgelieferten.

Die Ausführung verfolgen

Workflows laufen im Hintergrund, sodass die Sitzung reaktionsfähig bleibt, während Agenten arbeiten. Führen Sie jederzeit /workflows aus, um laufende und abgeschlossene Workflows aufzulisten, und wählen Sie dann einen aus, um seine Fortschrittsansicht zu öffnen. Wenn die Sitzung nur eine Ausführung hat, überspringt /workflows die Liste und öffnet diese Ausführung direkt. Um einen laufenden Workflow aus der Liste heraus zu stoppen, ohne ihn zu öffnen, wählen Sie ihn aus und drücken Sie x. Die Fortschrittsansicht zeigt jede Phase mit ihrer Anzahl an Agenten. Die Fußzeile listet die Taste für jede Aktion auf: Die Agentendetails zeigen den Prompt des Agenten, seine letzten Tool-Aufrufe und sein Ergebnis. Für jeden Aufruf wird sein Status angezeigt, etwa ob er noch läuft oder fehlgeschlagen ist. Wenn der Agent eine eigene Aufgabenliste führt, zeigen die Details auch diese an, jeweils mit dem Status jeder Aufgabe. Drücken Sie Enter, um die Details zu erweitern. Prompt und Ergebnis werden dann vollständig angezeigt, und jeder aufgeführte Aufruf zeigt seine Eingabe sowie den Anfang seines Ergebnisses.

Claude einen Workflow schreiben lassen

Sie können Claude auf zwei Arten einen Workflow für Ihre Aufgabe schreiben lassen: Sie können auch einen bereits vorhandenen Workflow-Befehl ausführen: einen mitgelieferten Workflow wie /deep-research oder einen, den Sie gespeichert haben.

Einen Workflow im Prompt anfordern

Um eine einzelne Aufgabe als Workflow auszuführen, ohne die Effort-Stufe der Sitzung zu ändern, nehmen Sie das Schlüsselwort ultracode in Ihren Prompt auf. Eine Anfrage in Ihren eigenen Worten, zum Beispiel „use a workflow“ oder „run a workflow“, funktioniert ebenfalls: Claude behandelt eine direkte Anfrage als dieselbe ausdrückliche Zustimmung.
Claude Code hebt das Schlüsselwort in Ihrer Eingabe hervor, und Claude schreibt ein Workflow-Skript für die Aufgabe, anstatt sie Turn für Turn abzuarbeiten. Das Schlüsselwort bestimmt nur, wie Claude die Arbeit strukturiert: Die Tool-Aufrufe der Agenten durchlaufen dieselben Berechtigungsprüfungen und dasselbe Sandboxing wie jeder andere Tool-Aufruf in der Sitzung. Wenn der Lauf das tut, was Sie wollten, können Sie ihn anschließend als Befehl speichern. Wenn Sie bereits einen auf andere Weise erstellten Orchestrator haben, etwa einen Ordner mit Subagenten-Prompts oder einen Skill, der Arbeit aufteilt, können Sie Claude darauf verweisen und einen Workflow anfordern, der dasselbe tut.

Das Schlüsselwort verwerfen oder deaktivieren

Wenn Sie keinen Workflow starten wollten, drücken Sie unter macOS Option+W bzw. unter Windows und Linux Alt+W, um die Hervorhebung für diesen Prompt zu verwerfen, oder drücken Sie die Rücktaste, während der Cursor direkt hinter dem hervorgehobenen Schlüsselwort steht. Um zu verhindern, dass das Schlüsselwort überhaupt etwas auslöst, deaktivieren Sie Ultracode keyword trigger in /config.

Wo das Schlüsselwort funktioniert

Das Schlüsselwort gilt nur in einem Prompt, den Sie selbst eingeben, als ausdrückliche Zustimmung: im interaktiven Prompt, in einem Panel einer IDE-Erweiterung, in einem Remote Control-Client oder in einer Agent SDK-Anwendung, die den origin Ihrer Tastatureingabe als { kind: "human" } kennzeichnet. Es startet keinen Workflow, wenn es die Sitzung auf anderem Weg erreicht:
  • ein mit -p übergebener Prompt
  • ein Prompt, den eine Agent SDK-Anwendung sendet, ohne ihn als menschliche Eingabe zu kennzeichnen
  • der Prompt einer geplanten Aufgabe
  • eine Webhook-Payload oder ein Pull-Request-Kommentar, der in die Konversation weitergeleitet wird

Claude mit ultracode entscheiden lassen

Ultracode ist eine Einstellung von Claude Code, die die automatische Workflow-Orchestrierung für die Sitzung aktiviert, unabhängig davon, mit welcher Effort-Stufe die Sitzung läuft. Wenn sie aktiviert ist, plant Claude für jede substanzielle Aufgabe einen Workflow, anstatt darauf zu warten, dass Sie danach fragen. Aktivieren Sie sie im Prompt von Claude Code:
Um eine Sitzung mit bereits aktiviertem ultracode zu starten, starten Sie mit claude --effort ultracode, wodurch auch die Effort-Stufe auf xhigh gesetzt wird. Um ultracode über den /effort-Schieberegler zu aktivieren, drücken Sie Tab, um den Schalter Ultracode umzulegen, und dann Enter, um die Änderung anzuwenden. Unter Effort-Stufe anpassen finden Sie die Wege, auf denen sich ultracode aktivieren lässt. Wenn ultracode aktiviert ist, entscheidet Claude, wann eine Aufgabe einen Workflow rechtfertigt. Eine einzelne Anfrage kann zu mehreren aufeinanderfolgenden Workflows werden: einer, um den Code zu verstehen, einer, um die Änderung vorzunehmen, und einer, um sie zu überprüfen. Dies gilt für jede Aufgabe in der Sitzung, sodass jede Anfrage mehr Token verbraucht und länger dauert als dieselbe Anfrage ohne Workflow. Bei einem Abonnement werden diese Token auf Ihre Nutzungslimits angerechnet, sodass eine Sitzung mit aktiviertem ultracode ein Sitzungs- oder Wochenlimit früher erreicht als dieselbe Arbeit mit deaktiviertem ultracode. Mit der Aktivierung von ultracode stimmen Sie bereits großen Läufen zu, daher gelten diese Prüfungen nicht, solange es aktiviert ist: /effort ultracode gilt für die aktuelle Sitzung; damit jede Sitzung damit startet, setzen Sie die Einstellung ultracode. Deaktivieren Sie es mit /effort ultracode off, wenn Sie zur alltäglichen Arbeit zurückkehren. Der /effort-Schieberegler bietet den Schalter nur an, wenn ultracode verfügbar ist. Vor v2.1.284 setzte /effort ultracode die Sitzung auf xhigh, und /effort ultracode off schlug mit Invalid argument fehl.

Den Plan vor der Ausführung genehmigen

In der CLI zeigt die Abfrage pro Lauf die geplanten Phasen und diese Optionen:
  • Yes, run it: startet den Lauf
  • Yes, and don’t ask again for <name> in <path>: startet den Lauf und überspringt diese Abfrage für diesen Workflow in diesem Projekt von nun an. Claude Code bietet diese Option an, wenn Sie einen mitgelieferten, gespeicherten oder Plugin-Workflow über seinen Namen ausführen, nicht jedoch für ein Skript, das Claude für die aktuelle Aufgabe geschrieben hat.
  • View raw script: Sie können das Skript lesen, bevor Sie sich entscheiden
  • No: bricht ab
Ctrl+G öffnet das Skript in Ihrem Editor. Wenn Yes, run it oder No ausgewählt ist, drücken Sie Tab, um Ihrer Antwort einen Kommentar hinzuzufügen. Ob Sie diese Abfrage sehen, hängt von Ihrem Berechtigungsmodus ab: In claude -p und im Agent SDK zeigt Claude Code diese Abfrage nie an. Es führt den Workflow-Tool-Aufruf durch dieselbe Berechtigungsauswertung wie den Rest der Sitzung, sodass deny-Regeln, ask-Regeln und der dontAsk-Modus für den Start genauso gelten wie für jeden Tool-Aufruf. Um den Workflow in diesen Läufen starten zu lassen, verwenden Sie eine dieser Möglichkeiten:
  • Berechtigungsregel: Fügen Sie Workflow zu Ihren allow-Regeln hinzu, um jeden Workflow zu genehmigen, oder Workflow(<name>), um einen gespeicherten Workflow über seinen Namen zu genehmigen.
  • Automatischer Berechtigungsmodus: Führen Sie im Auto-Modus aus, in dem der Klassifikator den Aufruf prüft und genehmigen kann.
  • Modus „Berechtigungen umgehen“: Führen Sie im Modus „Berechtigungen umgehen“ aus.
  • Ein Hook: Geben Sie für den Aufruf aus einem PreToolUse-Hook "allow" zurück. Im Plan-Modus startet der Workflow nicht allein aufgrund der Genehmigung durch den Hook; verwenden Sie dort stattdessen eine Berechtigungsregel oder die Genehmigung durch Ihren Host.
  • Ihr Host: Ein --permission-prompt-tool oder beim Agent SDK ein canUseTool-Callback genehmigt ihn.
In der Desktop-App zeigt eine Genehmigungskarte den Workflow-Namen, die Phasenliste und einen Hinweis zur Token-Nutzung mit den Aktionen Once, Always und Deny. Die Fortschrittsansicht erscheint im Seitenbereich Background tasks. Die Subagenten, die der Workflow startet, verwenden Ihre Berechtigungsregeln, und Claude Code wählt ihren Berechtigungsmodus nach den Regeln unter In welchem Berechtigungsmodus ein Subagent läuft. Um Abfragen bei einem langen Lauf zu vermeiden, fügen Sie die Tools, die die Agenten benötigen, vor dem Start zu Ihren allow-Regeln hinzu.

Den Workflow zur Wiederverwendung speichern

Wenn Claude einen Workflow für eine Aufgabe schreibt, die Sie wiederholen werden, können Sie das Skript dieses Laufs als Befehl speichern. Ein Prozess wie ein Review, das Sie auf jedem Branch ausführen, läuft dann jedes Mal mit derselben Orchestrierung. Führen Sie /workflows aus, wählen Sie den Lauf aus, den Sie behalten möchten, und drücken Sie s. Im Speicherdialog wechselt Tab zwischen den beiden Speicherorten:
  • .claude/workflows/ in Ihrem Projekt: wird mit allen geteilt, die das Repository klonen
  • ~/.claude/workflows/ in Ihrem Home-Verzeichnis: in jedem Projekt verfügbar, nur für Sie sichtbar. Wenn Sie CLAUDE_CONFIG_DIR gesetzt haben, ist dieser Speicherort das Verzeichnis workflows/ unter diesem Pfad.
Der Speicherdialog zeigt den aufgelösten Pfad für den persönlichen Speicherort an. Drücken Sie Enter, um zu speichern. Der Workflow läuft in künftigen Sitzungen von beiden Speicherorten aus als /<name>. Claude Code prüft den Speicherort vor dem Schreiben auf Symlinks und zeigt einen Fehler an, anstatt über einen Symlink zu schreiben:
  • Projektspeicherort: Claude Code verweigert den Vorgang, wenn .claude, .claude/workflows oder die Zieldatei ein Symlink ist.
  • Persönlicher Speicherort: Claude Code verweigert den Vorgang nur, wenn die Zieldatei selbst ein Symlink ist, sodass ein von einem Dotfiles-Tool verwaltetes ~/.claude-Verzeichnis weiterhin funktioniert.
In einem Monorepo mit mehreren .claude/-Verzeichnissen können Sie Workflows neben dem Paket ablegen, für das sie gelten. Beim Speichern am Projektspeicherort wird in das nächstgelegene bereits vorhandene .claude/workflows/-Verzeichnis zwischen Ihrem Arbeitsverzeichnis und dem Stammverzeichnis des Repositorys geschrieben, oder in das Stammverzeichnis des Repositorys, falls noch keines existiert. Projekt-Workflows werden außerdem aus jedem .claude/workflows/ entlang dieses Pfads geladen, und wenn mehr als eines denselben Namen definiert, führt Claude Code denjenigen aus, der dem Arbeitsverzeichnis am nächsten liegt. Wenn ein Projekt-Workflow und ein persönlicher Workflow denselben Namen haben, wird der Projekt-Workflow ausgeführt.

Einen Workflow in einem Plugin verteilen

Um einen Workflow teams- oder repositoryübergreifend zu teilen, nehmen Sie ihn in ein Plugin auf. Legen Sie das Skript in einem workflows/-Verzeichnis im Stammverzeichnis des Plugins ab, oder verweisen Sie mit dem Manifest-Feld workflows auf einen anderen Speicherort. Plugin-Workflows erhalten den Plugin-Namen als Namensraum. Ein Plugin namens acme-tools, das ein Skript enthält, dessen meta.name release-audit lautet, wird als /acme-tools:release-audit ausgeführt.

Eingaben an einen gespeicherten Workflow übergeben

Ein gespeicherter Workflow kann Eingaben über den Parameter args entgegennehmen. Das Skript liest ihn als globale Variable namens args. Verwenden Sie dies, um beim Aufruf eine Forschungsfrage, eine Liste von Zielpfaden oder ein Konfigurationsobjekt zu übergeben, anstatt das Skript für jeden Lauf zu bearbeiten. Der folgende Prompt führt einen gespeicherten Workflow mit einer Liste von Issue-Nummern aus:
Claude übergibt die Liste als strukturierte Daten, sodass das Skript Array- und Objektmethoden direkt auf args aufrufen kann, ohne sie vorher zu parsen. Wenn args weggelassen wird, ist die globale Variable innerhalb des Skripts undefined.

Beispiel-Workflow-Eingabeaufforderungen

Ein Workflow passt am besten, wenn die Aufgabe größer ist, als ein Agent in den Kontext passen kann, oder wenn der gleiche Schritt über viele Elemente hinweg ausgeführt werden muss. Die folgenden Eingabeaufforderungen zeigen häufige Formen. Jede fordert Claude auf, einen Workflow für diese Aufgabe zu schreiben und auszuführen; Sie schreiben das Skript nicht selbst.

Viele Dateien für das gleiche Problem überprüfen

Fan out one agent per file, then collect and verify the findings.

Weiter beheben, bis eine Überprüfung besteht

Führen Sie eine Überprüfung aus, beheben Sie, was fehlgeschlagen ist, und wiederholen Sie, bis es besteht oder keine Fortschritte mehr macht.

Viele Dateien parallel migrieren

Entdecken Sie die zu migrierenden Dateien, transformieren Sie jede in einer isolierten Kopie, damit Bearbeitungen nicht in Konflikt geraten, und überprüfen Sie jedes Ergebnis.

Überprüfen Sie jede geänderte Datei und schreiben Sie eine Zusammenfassung

Führen Sie einen Reviewer pro Datei aus, dann übergeben Sie alle Ergebnisse an einen Agenten, der sie ordnet und dedupliziert.

Recherchieren Sie ein Thema über viele Quellen

Verteilen Sie Leser über Changelogs, Issues und Dokumentation, dann synthetisieren Sie. Der gebündelte /deep-research-Workflow tut dies; Sie können auch eine engere Version beschreiben.

Finden Sie Probleme, bis die Liste nicht mehr wächst

Suchen Sie in Runden weiter und stoppen Sie, wenn neue Runden nichts Neues finden.

Wie das gespeicherte Skript aussieht

Wenn Sie einen Workflow speichern, enthält die Datei in .claude/workflows/ einen meta-Block gefolgt von einem Skript-Body, der Subagenten orchestriert. Sie müssen ihn normalerweise nicht bearbeiten, aber hier ist die Form eines kleinen, damit Sie erkennen können, was Claude generiert hat:
Der Body ist einfaches JavaScript mit Top-Level-await. agent() spawnt einen Subagenten, pipeline() führt einen pro Element in einer Liste aus, und parallel() führt eine Reihe von Agenten-Aufgaben gleichzeitig aus und wartet auf alle. Ein agent()-Aufruf wird zu null aufgelöst, wenn Sie ihn während der Ausführung stoppen oder er auf einen nicht wiederherstellbaren API-Fehler trifft. pipeline() behält jeden null-Wert im Ergebnis-Array, weshalb das Beispiel mit .filter(Boolean) endet, um diese Einträge zu entfernen, einschließlich des Platzes eines Agenten, der bei jedem Versuch hängen geblieben ist. In Auto-Modus zählt die Eingabeaufforderung, die Ihr Skript an agent() übergibt, nicht als eine Anfrage von Ihnen, wenn der Klassifizierer die Aktionen dieses Subagenten überprüft, da Claude Code sie als Text markiert, den das Skript berechnet hat. Wenn Sie einen schema bei einem agent()-Aufruf übergeben, gibt der Subagent stattdessen JSON zurück, das der Form entspricht. Claude Code überprüft das Schema, bevor der Subagent startet: Wenn es beweisen kann, dass das Schema sich selbst widerspricht, schlägt der Aufruf mit einem Fehler fehl, der den Widerspruch benennt, und der Subagent startet nie. Ein Widerspruch, den es beweisen kann, ist ein required-Schlüssel, den additionalProperties: false ausschließt. Wenn die Ausgabe des Subagenten nach fünf Versuchen immer noch die Validierung nicht besteht, schlägt der Aufruf mit einem Fehler fehl, der den letzten Validierungsfehler enthält. Um die Versuchsanzahl zu ändern, setzen Sie MAX_STRUCTURED_OUTPUT_RETRIES.

Ein gespeichertes Skript bearbeiten

Um einen Workflow zu ändern, den Sie gespeichert haben, bearbeiten Sie seine .js-Datei oder bitten Sie Claude, die Änderung vorzunehmen. Bevor Sie bearbeiten oder fragen, führen Sie die /workflow-authoring gebündelte Fähigkeit aus, um die Skript-Schreib-Referenz zu laden, von der Claude arbeitet. Die Fähigkeit erfordert Claude Code v2.1.248 oder später. Um die bearbeitete Version in der aktuellen Sitzung auszuführen, führen Sie /reload-skills aus, um die Workflow-Verzeichnisse neu zu lesen, und führen Sie dann /<name> erneut aus. Claude Code wendet diese Regeln auf jeden Teil der Datei an, wenn es das Skript lädt und ausführt:
  • meta-Block: Behalten Sie export const meta als erste Anweisung bei, und halten Sie es ein einfaches Objekt-Literal mit einem name und einer description. Wenn es etwas anderes als Literalwerte enthält, wie eine Variable, einen Funktionsaufruf oder einen Spread, lässt Claude Code /<name> aus der /-Autovervollständigung fallen.
  • Body: Neben agent(), pipeline() und parallel() können Sie phase() aufrufen, um die folgenden Agenten unter einem Titel in der Fortschrittsansicht zu gruppieren, log() aufrufen, um eine Nachricht über den Phasen anzuzeigen, und das globale args lesen. Wenn der Body einen Syntaxfehler hat, meldet Claude Code ihn, wenn Sie den Workflow ausführen.
  • phases: Wenn Sie sie in meta auflisten, geben Sie jedem Eintrag genau den Titel an, den Sie an phase() übergeben. Ein phase()-Titel ohne Eintrag erhält seine eigene Fortschrittsgruppe.
  • Zeitstempel und Zufälligkeit: Claude Code lässt Date.now(), Math.random() und ein argumentloses new Date() innerhalb des Skripts werfen, damit ein neu gestarteter Lauf die gleichen agent()-Aufrufe wiederholt. Übergeben Sie stattdessen einen Zeitstempel durch args.
Sie können auch das Skript eines einzelnen Laufs bearbeiten, anstatt die gespeicherte Kopie. Nach einer Pause fortsetzen behandelt, welche Agenten erneut ausgeführt werden, wenn Sie ein bearbeitetes Skript neu starten. Für die Eingaben des Workflow-Tools siehe seinen Eintrag in der Agent SDK-Referenz.

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. Sofern Claude eine Ausführung nicht über den Pfad einer Skriptdatei startet, schreibt Claude Code das Skript der Ausführung in eine Datei unter dem Verzeichnis Ihrer Sitzung in ~/.claude/projects/. Claude erhält den Pfad des Skripts, wenn die Ausführung startet, sodass Sie danach fragen können. Sie können diese Datei öffnen, um die Orchestrierung zu lesen, die Claude geschrieben hat, einen Diff mit dem Skript einer vorherigen Ausführung erstellen oder sie bearbeiten und Claude bitten, von der bearbeiteten Version neu zu starten. Claude kann einen Workflow nur aus einer Skriptdatei starten, die die Sitzung bereits lesen darf. Um ein Skript auszuführen, das sich außerhalb Ihres Arbeitsverzeichnisses befindet, fügen Sie zunächst sein Verzeichnis mit /add-dir oder einer Read-Erlaubnisregel hinzu. Die Laufzeit verfolgt das Ergebnis jedes Agenten, während die Ausführung fortschreitet, was macht, dass eine Ausführung wiederaufnehmbar innerhalb derselben Sitzung ist.

Prompt Caching in einem Fan-out

Agenten in derselben Ausführung können den Prompt Cache voneinander lesen. Zwei Agenten, die mit demselben Modell, Aufwandsniveau, Agententyp, Tools, Ausgabeschema und Arbeitsverzeichnis ausgeführt werden, erstellen dasselbe Tools-und-System-Prompt-Präfix, sodass ein Agent, der nach der Antwort eines übereinstimmenden Geschwisteragenten startet, den Cache dieses Geschwisteragenten bei seiner ersten Anfrage liest. Die Anfragen eines Workflow-Agenten fallen außerhalb des Cache-TTL-Buckets des Hauptgesprächs, sodass sein Cache standardmäßig fünf Minuten lang gültig bleibt, auch bei einem Claude-Abonnement. Um ihn eine Stunde lang zu behalten, setzen Sie subagentPromptCacheTtl auf 1h. Die API berechnet 1-Stunden-Cache-Schreibvorgänge mit einem höheren Satz ab. Wenn ein Fan-out mehrere übereinstimmende Agenten gleichzeitig startet, hält Claude Code alle außer dem ersten an, bis die Antwort des ersten Agenten beginnt, und gibt dann die gehaltenen Agenten zusammen frei, sodass ihre ersten Anfragen das gemeinsame Präfix lesen, anstatt dass jeder es ungecacht verarbeitet. Claude Code begrenzt die Wartezeit auf CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Millisekunden, standardmäßig 5000. Setzen Sie es auf 0, um die Wartezeit zu deaktivieren.

Verhalten und Grenzen

Die Laufzeit wendet die folgenden Einschränkungen an:

Läufe verwalten

Sobald ein Lauf gestartet ist, verwalten Sie ihn über die Ansicht /workflows oder indem Sie seine Fortschrittszeile im Aufgabenbereich unter dem Eingabefeld aufklappen. Wenn Sie einen Lauf stoppen, bleibt er im Aufgabenbereich, solange noch Prozesse seiner Agenten laufen. Wenn Sie ihn erneut stoppen, sendet Claude Code erneut ein Signal an diese Prozesse.

Nach einer Pause fortsetzen

Setzen Sie einen pausierten Lauf in /workflows fort, indem Sie ihn auswählen und p drücken. Bei einem Lauf, den Sie gestoppt haben, bitten Sie Claude, den Workflow mit demselben Skript neu zu starten. Wenn Agenten aus dem gestoppten Lauf noch nicht beendet sind, verweigert Claude Code den Neustart, bis sie beendet sind, damit keine zweite Kopie dieser Agenten parallel zu ihnen laufen kann.

Welche Agenten erneut ausgeführt werden

Claude Code spielt den Lauf in der Reihenfolge ab, in der die Agenten starten, und jeder Agent gibt entweder sein gespeichertes Ergebnis zurück oder wird erneut ausgeführt:
  • Abgeschlossen: gibt sein gespeichertes Ergebnis zurück. Der erste Agent, dessen Prompt sich vom vorherigen Lauf unterscheidet, weil Sie das Skript bearbeitet haben oder ein früherer Agent etwas anderes zurückgegeben hat, wird erneut ausgeführt, ebenso jeder Agent danach, auch bereits abgeschlossene. Vor v2.1.305 konnten abgeschlossene Agenten auch dann erneut ausgeführt werden, wenn Sie ein unverändertes Skript neu starteten, dessen pipeline()-Elemente oder parallel()-Aufgaben jeweils mehr als einen Agenten ausführten. Um diese erneuten Ausführungen bei neuen Läufen zu verhindern, aktualisieren Sie Claude Code.
  • Lief noch, als Sie gestoppt haben: beginnt von vorn. Das Stoppen des gesamten Laufs zählt keinen Agenten als fehlgeschlagen.
  • Am Nutzungslimit fehlgeschlagen ab v2.1.318: wird erneut ausgeführt, und abgeschlossene Agenten geben ihre gespeicherten Ergebnisse zurück. Wenn Ihr Skript nach dem Fehlschlag einen weiteren Agenten aufgerufen hat und dieser Agent ein Ergebnis zurückgegeben hat, wird auch jeder Agent erneut ausgeführt, den das Skript nach dem fehlgeschlagenen startet.
  • Fehlgeschlagen: wird erneut ausgeführt, ebenso jeder Agent, den das Skript danach startet, auch bereits abgeschlossene. Das Stoppen eines einzelnen Agenten, indem Sie ihn in /workflows auswählen und x drücken, zählt als Fehlschlag.
Der letzte Fall bedeutet, dass ein Agent mit dem Status Fehlgeschlagen mitten in einem Fan-out bereits abgeschlossene Arbeit erneut ausführt. Wenn ein Skript A, B, C und D in dieser Reihenfolge startet und B den Status Fehlgeschlagen hat, gibt ein Neustart A aus dem Cache zurück und führt B, C und D erneut aus. Wenn Sie ein Skript, das A, B, C und D gestartet hat, so bearbeiten, dass es A, C, B und D startet, ist der zweite gestartete Agent jetzt C, wo der vorherige Lauf B gestartet hat. Ein Neustart gibt A aus dem Cache zurück und führt C, B und D erneut aus.

Fortsetzen, nachdem Sie die Sitzung verlassen haben

Wenn Sie Ihre Sitzung in den Hintergrund verschieben oder Claude Code beenden, während ein Workflow-Lauf ausgeführt wird, wird der Lauf nicht eigenständig fortgesetzt. Der Lauf wird erst fortgesetzt, wenn Claude ihn mit einem Workflow-Aufruf neu startet, der den Lauf aus seinen gespeicherten Ergebnissen abspielt.
  • Sie haben die Sitzung in den Hintergrund verschoben oder Move to background and exit gewählt: Wenn der Lauf nicht fortgesetzt wurde, wenn Sie die Hintergrundsitzung prüfen, bitten Sie Claude dort, den Workflow neu zu starten. Abhängig von Ihrem Berechtigungsmodus bittet Claude Code Sie zuerst, den Neustart zu genehmigen. Wenn die Sitzung in der Agentenansicht unter Needs input angezeigt wird, verbinden Sie sich mit ihr, um die Genehmigungsabfrage zu beantworten.
  • Der Neustart in der Hintergrundsitzung ist mit nothing to resume fehlgeschlagen: Bitten Sie Claude, den Workflow als neuen Lauf von vorn zu starten. Wenn Claude den Lauf über den Pfad einer Skriptdatei außerhalb von ~/.claude/projects/ gestartet hat, etwa einer Datei in Ihrem Arbeitsverzeichnis, kann Claude ihn in der Hintergrundsitzung nicht neu starten.
  • Sie haben Exit and stop tasks gewählt, oder Move to background and exit wurde nicht angeboten: Der Lauf wurde mit der Sitzung gestoppt, und Claude Code bewahrt die gespeicherten Ergebnisse des Laufs im Verzeichnis dieser Sitzung unter ~/.claude/projects/ auf. Setzen Sie die Sitzung mit claude --resume in Ihrer Shell fort und bitten Sie Claude dann, den Workflow neu zu starten. In einer neuen Sitzung hat Claude keinen früheren Lauf, den es neu starten könnte, und startet den Workflow von vorn.
In einer Cloud-Sitzung speichert Claude Code die Ergebnisse des Laufs außerdem mit dem Konversationsverlauf der Sitzung, der erhalten bleibt, wenn die VM der Sitzung freigegeben wird. Wenn Sie eine solche Sitzung wieder öffnen und Claude bitten, den Workflow neu zu starten, geben abgeschlossene Agenten weiterhin ihre gespeicherten Ergebnisse zurück. Sowohl in lokalen als auch in Cloud-Sitzungen gilt: Wenn Claude einen früheren Lauf neu startet und Claude Code die gespeicherten Ergebnisse dieses Laufs überhaupt nicht finden kann, schlägt der Neustart mit einem nothing to resume-Fehler fehl, anstatt den Lauf eigenständig von vorn zu beginnen. Bitten Sie Claude, den Workflow als neuen Lauf von vorn zu starten.

Wenn ein Lauf Ihr Nutzungslimit erreicht

Wenn ein Agent Ihr claude.ai-Nutzungslimit erreicht, wird der Lauf pausiert, anstatt diesen Agenten fehlschlagen zu lassen. Die Agenten, die das Limit erreicht haben, warten auf das Zurücksetzen, und es starten keine neuen Agenten. Kurz nachdem das Limit zurückgesetzt wurde, werden die wartenden Agenten erneut ausgeführt, und der Lauf wird eigenständig fortgesetzt. Erfordert Claude Code v2.1.271 oder neuer bzw. v2.1.319 oder neuer im Code-Tab der Desktop-App. In früheren Versionen schlagen die betroffenen Agenten fehl. Während der Lauf wartet, zeigen seine Fortschrittszeile im Aufgabenbereich und die Kopfzeile von /workflows an, wann das Limit zurückgesetzt wird. Im Code-Tab zeigt der Lauf eine Zeile wie Paused at usage limit · continues after 3:45 PM if the app stays open an. Lassen Sie die App geöffnet. Der Lauf wird nur pausiert, wenn alle folgenden Bedingungen erfüllt sind; ist eine nicht erfüllt, schlägt der betroffene Agent stattdessen fehl:
  • Die Sitzung ist mit einem claude.ai-Abonnement ohne nutzungsbasierte Abrechnung angemeldet und ist einer dieser Sitzungstypen:
  • autoContinueAtUsageLimit ist aktiviert, dieselbe Einstellung, mit der die Sitzung selbst auf das Zurücksetzen eines Nutzungslimits warten kann. Wenn Sie sie während einer Wartezeit deaktivieren, endet die Wartezeit, und die wartenden Agenten schlagen fehl.
  • Im Code-Tab ist das Kontrollkästchen Auto-continue when limits reset auf einer Sitzungslimit-Karte aktiviert, wie es standardmäßig der Fall ist. Wenn Sie es deaktivieren, werden Läufe in Ihren Code-Tab-Sitzungen nicht mehr pausiert, es sei denn, verwaltete Einstellungen setzen autoContinueAtUsageLimit auf true.
  • Das Limit wird innerhalb von 24 Stunden zurückgesetzt. Ein wöchentliches Limit kann später zurückgesetzt werden.
  • Der Lauf hat noch nicht zweimal gewartet. Wenn er das Limit ein drittes Mal erreicht, schlägt der Agent fehl.
Um einen Lauf abzuschließen, dessen Agenten am Limit fehlgeschlagen sind, bitten Sie Claude nach dem Zurücksetzen des Limits, den Workflow neu zu starten.

Wenn ein Agent hängen bleibt und neu startet

Ein Agent, dessen Ausgabe lange genug ausbleibt, beginnt mit demselben Prompt von vorn. In /workflows erhält sein Name das Suffix (retry 1), und seine Details zeigen attempt 2 (stalled). Der Neustart erfolgt automatisch, Sie müssen also nichts tun. Der neue Versuch startet ohne das Transkript des hängengebliebenen Versuchs. Dateien, die der hängengebliebene Versuch bereits geändert hat, bleiben geändert, und die Token, die er verbraucht hat, bleiben in der Gesamtsumme des Laufs. Das Stall-Fenster ist die Zeitspanne, die Claude Code auf eine Ausgabe eines Agenten wartet, bevor es den Versuch beendet. Zeit, die der Agent mit dem Warten auf seine eigenen Tool-Aufrufe oder auf das Zurücksetzen eines Nutzungslimits verbringt, zählt nicht zum Stall-Fenster. Ein Agent startet höchstens fünfmal neu, einschließlich aller Neustarts, die Sie mit r anfordern. Wenn auch der sechste Versuch hängen bleibt, schlägt der agent()-Aufruf fehl, und der Anfang der Fehlermeldung nennt den Grund:
  • agent stalled on all 6 attempts: Jeder Versuch hat das gesamte Fenster ohne Ausgabe verbracht. Wenn die Arbeit des Agenten ihn so lange still hält, verlängern Sie das Fenster
  • agent lost its reply on all 6 attempts: Der Antwort-Stream jedes Versuchs ist verstummt, und Claude Code hat das Warten darauf aufgegeben. Eine Verlängerung des Stall-Fensters hilft nicht, da ein Streaming-Idle-Watchdog die Antwort zuerst beendet hat und CLAUDE_STREAM_IDLE_TIMEOUT_MS den Timeout dieses Watchdogs festlegt
  • agent abandoned after 6 attempts: Die Versuche endeten auf unterschiedliche Weise, die die Fehlermeldung der Reihe nach auflistet
So geben Sie einem Agenten mehr Zeit, eine Ausgabe zu erzeugen, bevor das Fenster endet:
  • Ein Agent: Übergeben Sie stallMs in Millisekunden an seinen agent()-Aufruf, etwa agent(prompt, { stallMs: 1800000 }) für 30 Minuten
  • Alle Agenten: Setzen Sie CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS, was auch für Subagenten außerhalb von Workflows gilt
Ob der Lauf nach dem Fehlschlag fortgesetzt wird, hängt davon ab, wie Ihr Skript den Agenten aufgerufen hat:
  • Innerhalb von parallel() oder pipeline(): Der Lauf wird mit null anstelle des Ergebnisses des Agenten fortgesetzt
  • Direkt mit await aufgerufen: Der Lauf endet mit dem Fehler
Um es erneut zu versuchen, bitten Sie Claude, den Workflow neu zu starten. Nach einer Pause fortsetzen beschreibt, was erneut ausgeführt wird.

Kosten

Ein Workflow startet viele Agenten, daher kann ein einzelner Lauf deutlich mehr Token verbrauchen, als dieselbe Aufgabe in der Konversation zu bearbeiten. Läufe werden auf die Nutzung und die Rate-Limits Ihres Plans angerechnet. Um den Verbrauch abzuschätzen, bevor Sie sich auf eine große Aufgabe festlegen, führen Sie den Workflow zuerst auf einem kleinen Ausschnitt aus: ein Verzeichnis statt des gesamten Repositorys oder eine eng gefasste Frage statt einer breiten. Die Ansicht /workflows zeigt den Token-Verbrauch jedes Agenten während des Laufs, und Sie können den Lauf dort jederzeit stoppen, in der Regel ohne abgeschlossene Arbeit zu verlieren. Nach einer Pause fortsetzen beschreibt, was ein gestoppter Lauf behält. Die Agenten-Obergrenzen der Laufzeitumgebung begrenzen, wie viele Agenten ein einzelner Lauf starten kann, was die Kosten eines außer Kontrolle geratenen Skripts begrenzt. Um Läufe auf weniger Agenten zu beschränken, wählen Sie die Größenrichtlinie small. Claude Code kennzeichnet außerdem einen Lauf, der ungewöhnlich groß wird. Wenn ein Workflow mehr als 25 Agenten einplant oder seine prognostizierte Token-Gesamtzahl 1,5 Millionen überschreitet, zeigt seine Fortschrittszeile im Aufgabenbereich unter dem Eingabefeld eine Large workflow-Warnung. Die Warnung verweist Sie auf /workflows, wo Sie den Lauf stoppen können. Die Warnung ist nur ein Hinweis: Sie pausiert oder begrenzt den Lauf nicht. Zwei Einstellungen ändern, wann Sie sie sehen:
  • Wenn Sie selbst eine Größenrichtlinie wählen, ersetzt deren Agentenanzahl den Schwellenwert von 25 Agenten. Die integrierte Standardrichtlinie belässt den Schwellenwert bei 25.
  • Sitzungen mit aktiviertem ultracode zeigen die Warnung nicht, da Sie durch das Aktivieren von ultracode bereits große Läufe zulassen.
Claude Code wählt das Modell jedes Workflow-Agenten in derselben Reihenfolge wie bei Subagenten. Ein Modell, das das Skript für eine Phase angibt, zählt in dieser Reihenfolge als das Modell pro Aufruf. Wenn nichts anderes eines zuweist, läuft der Agent auf dem Modell Ihrer Sitzung. So steuern Sie die Modellkosten:
  • Prüfen Sie /model vor einem großen Lauf, wenn Sie für Standardarbeiten normalerweise zu einem kleineren Modell wechseln
  • Bitten Sie Claude bei der Beschreibung der Aufgabe, für Phasen, die nicht das stärkste Modell benötigen, ein kleineres Modell zu verwenden
Wenn die availableModels-Allowlist Ihrer Organisation ein Modell blockiert, das das Skript für einen Agenten anfordert, läuft dieser Agent stattdessen auf einem Ersatzmodell, nach denselben Ersetzungsregeln wie bei Subagenten.

Eine Größenrichtlinie festlegen

Eine Größenrichtlinie teilt Claude mit, wie viele Agenten es anstreben soll, wenn es einen dynamischen Workflow schreibt. Claude Code übermittelt die Richtlinie an Claude als Empfehlung, nicht als Obergrenze, sodass ein Prompt, der eine andere Größenordnung verlangt, sie weiterhin überschreibt. Jeder Wert entspricht einer Agentenanzahl: Der Standardwert ist medium, oder small, wenn Sie mit einem Pro-Plan und Claude Code v2.1.271 oder neuer angemeldet sind. Bis Sie einen Wert wählen, kennzeichnet die /config-Zeile den Wert als Standard, und die Zeile Running in background des Workflows nennt die geltende Größe. Um die Richtlinie zu ändern, wählen Sie in /config einen Wert für die Einstellung Dynamic workflow size oder führen Sie /config workflowSizeGuideline=small aus. Sie können auch den workflowSizeGuideline-Schlüssel in einer beliebigen Einstellungsdatei festlegen; dieser Wert hat Vorrang vor /config, und Claude Code blendet die /config-Zeile aus, solange eine Einstellungsdatei einen Wert vorgibt. Änderungen werden mit dem nächsten Prompt wirksam. Die Agenten-Obergrenzen der Laufzeitumgebung gelten unabhängig von der Einstellung weiterhin.

Workflows deaktivieren

Workflows sind in der CLI, der Desktop-App, den IDE-Erweiterungen, im nicht interaktiven Modus mit claude -p und im Agent SDK verfügbar. Auf allen Oberflächen gelten dieselben Einstellungen zum Deaktivieren. So deaktivieren Sie Workflows für sich selbst:
  • Schalten Sie Dynamic workflows in /config aus. Bleibt sitzungsübergreifend erhalten.
  • Setzen Sie "disableWorkflows": true in ~/.claude/settings.json. Bleibt sitzungsübergreifend erhalten.
  • Setzen Sie CLAUDE_CODE_DISABLE_WORKFLOWS=1. Wird beim Start gelesen und gilt daher überall dort, wo Sie es setzen.
Um Workflows für Ihre gesamte Organisation zu deaktivieren, setzen Sie "disableWorkflows": true in den verwalteten Einstellungen oder verwenden Sie den Schalter auf der Seite Claude Code admin settings. Wenn Workflows deaktiviert sind:
  • /workflows, die Workflow-Befehle und der Skill /workflow-authoring sind nicht verfügbar
  • Das Schlüsselwort ultracode löst keinen Lauf mehr aus, und der Schalter Ultracode wird aus /effort entfernt
Ein bereits laufender Lauf wird fortgesetzt. Das Deaktivieren von Workflows macht auch ultracode nicht verfügbar. Es gibt keine verwaltete Einstellung, die nur ultracode ausschließt: Überall, wo es verfügbar ist, können Benutzer es mit /effort ultracode aktivieren. Eine Effort-Obergrenze senkt die Effort-Stufe, mit der eine Sitzung mit aktiviertem ultracode läuft, deaktiviert ultracode jedoch nicht.