Claude Code Dynamic Workflows: orchestrare molti agenti

Trova altri materiali sulla configurazione degli strumenti nella documentazione di Ailoot.

Cosa sono i Dynamic Workflows e perché Anthropic li ha lanciati il 28 maggio?#

In precedenza, il formato stesso limitava la scalabilità: una chat = un piano = una finestra di contesto. I subagenti erano utili, ma la decisione su «cosa eseguire dopo» restava a Claude nella conversazione principale e ogni risultato intermedio consumava quella stessa finestra di contesto. Questo diventava un collo di bottiglia per un’attività che coinvolgeva 500 file o dieci ipotesi indipendenti.

I Dynamic Workflows spostano il piano nel codice. Claude formula l’attività come script di orchestrazione, il runtime esegue lo script in un ambiente isolato e i risultati intermedi restano nelle variabili dello script anziché nel tuo contesto. La sessione rimane reattiva mentre gli agenti lavorano in background.

Cosa cambia concretamente rispetto al vecchio approccio: gli agenti indipendenti mettono in discussione i risultati degli altri e arriva fino a te solo ciò che supera il confronto incrociato. «Dinamico» nel nome si riferisce proprio a questo: ogni esecuzione viene scritta per l’attività specifica. Non esiste un elenco di processi predefinito.

In cosa differisce un Workflow da un subagente e da una Skill: 3 tipi di orchestrazione#

Per scegliere tra un workflow, un subagente e una Skill, mi pongo due domande: chi gestisce il piano e dove si trovano i risultati intermedi?

Il cambiamento principale è che il piano passa nel codice. Con i subagenti e le Skill, Claude è sempre l’orchestratore: decide durante il processo cosa avviare dopo e ogni risultato torna nella finestra di contesto. Un Workflow mantiene per sé il ciclo, le diramazioni e i risultati intermedi; solo la risposta finale arriva a Claude.

Puoi eseguire lo stesso piano in modo che agenti indipendenti lo esaminino da prospettive diverse, mentre lo script riunisce ciò che regge. Non puoi farlo in una normale interazione in un’unica chat: Claude non dispone di un punto di sintesi indipendente.

Ecco come scelgo: per un’attività di routine con più passaggi, usa subagenti o una Skill. Per un’attività che non rientra in una sola conversazione o per un processo che vuoi rieseguire su richiesta, usa un workflow. Ho descritto nel dettaglio tutte e quattro le primitive nella guida principale Skills, Subagents, MCP, or Plugins.

3 modi per avviare un Workflow in Claude Code#

Metodo 1. La parola chiave workflow in un prompt. L’opzione più semplice; non modifica le impostazioni della sessione. Basta inserire la parola workflow in qualsiasi prompt e Claude Code la evidenzierà mentre scrivi e genererà uno script di orchestrazione invece di una normale conversazione.

Run a workflow to audit every API endpoint under src/routes/ for missing auth checks

Se Claude Code evidenzia la parola ma non volevi avviare un workflow, alt+w disattiva il trigger per quel prompt.

Metodo 2. Modalità /effort ultracode. Attiva il massimo livello di impegno del modello (xhigh) e permette inoltre a Claude di decidere autonomamente quando un’attività richiede un workflow.

/effort ultracode

In questa modalità, una richiesta può articolarsi in più workflow consecutivi: uno per capire il codice, un altro per apportare una modifica e un terzo per controllare il risultato. Ogni esecuzione usa più token e richiede più tempo rispetto a un livello di impegno normale. La modalità si applica solo alla sessione corrente e si reimposta quando ne apri una nuova. Quando torni alle attività di routine, /effort high disattiva ultracode.

Metodo 3. Il comando integrato /deep-research. Un workflow Anthropic già pronto per la ricerca sul web. Il metodo è descritto nella sezione successiva.

Per tutti e tre i metodi, Claude Code chiede conferma alla prima esecuzione e mostra un elenco di fasi. Le opzioni di risposta sono Yes, run it, Yes, and don't ask again for <name> (memorizza la tua approvazione), View raw script (apre il codice con Ctrl+G) e No. In modalità Auto, la conferma è necessaria solo per la prima esecuzione; le successive procedono senza chiedere. Con claude -p e Agent SDK non viene richiesta alcuna conferma: le autorizzazioni dei subagenti vengono allora ereditate dalla allowlist condivisa.

Il workflow /deep-research già pronto: un esempio della prima esecuzione#

Il modo più rapido per provare i Dynamic Workflows è eseguirne uno già pronto anziché scriverne uno tuo. Anthropic include in Claude Code il workflow integrato /deep-research. Esplora una domanda da diverse prospettive indipendenti, recupera fonti, vota su ogni affermazione e lascia nel rapporto solo quelle che superano la verifica incrociata.

1. Esegui il comando

   In una sessione Claude Code, inserisci /deep-research e formula la domanda con un prompt dettagliato. Più precisa è la formulazione, meno fasi lo script sprecherà ad avviare.

2. Consenti il workflow

   Apparirà una finestra di dialogo con le fasi e i pulsanti Yes / View raw script / No. L’approvazione viene salvata per il progetto se scegli un’opzione con don't ask again.

3. Segui i progressi con /workflows

   L’esecuzione passa in background, lasciando libera la sessione. Il comando /workflows mostra un elenco delle esecuzioni in corso e completate. Usa i tasti freccia per selezionare una fase, Enter per espanderla e vedere i suoi agenti, j/k per scorrere i dettagli, p per mettere in pausa, x per interrompere l’esecuzione, r per riavviare un agente e s per salvare lo script.

4. Leggi il rapporto

   Al termine dell’esecuzione, nella sessione appare il rapporto con i link. Le affermazioni che non hanno superato la verifica incrociata vengono filtrate automaticamente.

A differenza di una normale chat con una sola ricerca sul web, /deep-research parallelizza autonomamente le query e risolve i conflitti tra le fonti. Lo uso per esplorare un argomento prima di scrivere una guida: è un modo pratico per farsi un’idea del consumo di token prima di aumentare la scala del workflow.

Ultracode: la modalità in cui Claude decide quando avviare un Workflow#

Ultracode combina due elementi: il massimo livello di impegno nel ragionamento e l’autorizzazione per Claude ad avviare workflow autonomamente. Per impostazione predefinita, anche /effort xhigh esegue una normale conversazione: Claude ragiona più a lungo, ma continua a mantenere i passaggi nel proprio contesto. Ultracode autorizza Claude a trasformare autonomamente un’attività in un workflow non appena si rende conto che una sola sessione non sarà sufficiente.

/effort ultracode

Quando la modalità è attiva, una richiesta può avviare due o tre workflow di seguito: uno esamina la base di codice, un altro apporta una modifica e un terzo è un’esecuzione separata che cerca di smentirla. È lo stesso schema «diversi tentativi indipendenti ⇒ sintesi finale», ma senza che tu debba avviare manualmente ogni fase.

Il costo è evidente: ogni richiesta richiede più tempo e costa di più rispetto a /effort high. In background, più esecuzioni procedono con i propri limiti e Anthropic stessa sconsiglia di usare ultracode come modalità predefinita. Si applica solo alla sessione corrente e si reimposta in quella successiva.

Quando torni alle attività di routine, /effort high disattiva ultracode e la sessione torna a essere una normale chat con subagenti. Sui modelli che non supportano xhigh, l’opzione ultracode semplicemente non compare in /effort.

Limiti, token e problemi alla prima esecuzione#

Il runtime impone questi limiti tecnici rigidi:

• Fino a 16 agenti in esecuzione contemporaneamente. Meno sui computer con pochi core. È un limite imposto dalle risorse locali.
• 1.000 agenti per esecuzione. Una protezione contro i cicli incontrollati: se uno script inizia ad avviare agenti senza fine, il runtime lo arresta.
• Non puoi attendere l’input dell’utente durante un’esecuzione. Solo le autorizzazioni degli strumenti possono metterla in pausa. Se hai bisogno di approvare il lavoro tra una fase e l’altra, suddividilo in workflow separati.
• Lo script non ha accesso diretto ai file né alla shell dei comandi. La lettura, la scrittura e l’esecuzione dei comandi spettano agli agenti che avvia. Lo script si limita a coordinarli.
• È richiesto Claude Code v2.1.154 o successivo. È disponibile per Pro, Max, Team ed Enterprise (Pro si abilita tramite /config), nonché su Claude API, Amazon Bedrock, Vertex AI e Microsoft Foundry.

L’avvertenza principale riguarda i costi.

Ogni agente di un’esecuzione usa il modello della sessione, a meno che lo script non indirizzi una fase a un altro modello. Prima di un’esecuzione ampia, controlla /model: se sei abituato a passare a un modello più economico per le attività di routine, ultracode e /deep-research possono far salire il conto se salti questo controllo. Puoi chiedere esplicitamente a Claude nel prompt di «usare un modello più economico per le fasi che non richiedono la massima capacità»: è un modo valido per gestire i costi.

Se un’esecuzione prende una brutta piega, apri /workflows, selezionala e premi x. Gli agenti che hanno già terminato conservano i propri risultati. Puoi riprendere l’esecuzione interrotta da lì con p oppure chiedere a Claude di riavviare lo script dallo stesso punto: gli agenti memorizzati nella cache restituiscono i loro risultati, mentre gli altri continuano a lavorare. Questo funziona all’interno di una sessione: quando esci da Claude Code, la sessione successiva avvia il workflow da zero.

Se prevedi esecuzioni lunghe, inizia a gestire il consumo con la guida Come non esaurire i limiti di Claude Code e la Second Brain: con la struttura di progetto giusta, il workflow non caricherà l’intero repository in ogni agente.

Come salvare un Workflow in un progetto#

Se Claude ha creato un workflow per un’attività ricorrente (per esempio, esaminare ogni branch o svolgere un audit di sicurezza regolare), puoi salvare lo script e non dover più descrivere l’attività a parole ogni volta.

1. Apri /workflows

   Il comando mostra un elenco delle esecuzioni recenti. Usa i tasti freccia per selezionare quella che ti serve.

2. Premi s

   Apparirà una finestra di dialogo per il salvataggio. Tab cambia la posizione di archiviazione.

3. Scegli una cartella

   .claude/workflows/ si trova nel progetto ed è visibile a tutti coloro che hanno clonato il repository. ~/.claude/workflows/ si trova nella tua cartella home, è disponibile in tutti i tuoi progetti ed è visibile solo a te.

4. Richiamalo come comando

   /[script_name] avvia il workflow con lo stesso script della prima esecuzione. Se esistono workflow con lo stesso nome nelle cartelle del progetto e della home, prevale quello del progetto.

Questo crea uno schema interessante: una persona del team mette a punto un workflow, lo aggiunge a .claude/workflows/ con un commit e ogni membro successivo del team esegue la stessa orchestrazione con un comando. Lo script è JavaScript leggibile, quindi puoi esaminarlo, modificarlo e inviarne una nuova versione con un commit.

La prima volta che esegui un workflow salvato in un progetto, Claude Code mostrerà comunque una finestra di autorizzazione, quindi salvare lo script non equivale ad approvarlo automaticamente. L’approvazione viene concessa separatamente con Yes, and don't ask again.

Per quali attività vale davvero la pena usare i Workflow?#

Anthropic indica esplicitamente gli scenari per cui è stato creato il runtime:

• Audit che coinvolgono l’intera base di codice—verificare ogni endpoint, file e funzione rispetto a una checklist. Per esempio, cercare controlli di autenticazione mancanti, trovare logica duplicata o verificare la sicurezza rispetto alle regole OWASP. Viene avviato un agente separato per ogni ramo della checklist.
• Migrazioni estese—passare a un altro framework, abbandonare un’API deprecata o trasferire migliaia di file in un altro linguaggio. Il workflow tiene traccia dei progressi, gli agenti lavorano sui file in parallelo e gli agenti di verifica incrociata cercano eventuali omissioni.
• Ricerca con verifica incrociata—una domanda che richiede fonti da prospettive diverse e una valutazione di quali affermazioni reggeranno al confronto incrociato. È lo scenario di base per cui è stato creato il comando integrato /deep-research.
• Un piano complesso che vuoi abbozzare da diverse prospettive indipendenti—il workflow produce diverse bozze di piano indipendenti, agenti avversari le esaminano e viene fornita una sintesi. È il caso in cui «il costo di un errore è elevato e un solo tentativo non basta».

Per un’attività come «correggere un bug» o «aggiungere una funzione», i Dynamic Workflows sono meno convenienti di una sessione normale: il consumo di token non giustifica il tempo impiegato. La documentazione di Anthropic lo dice chiaramente: «inizia con un’attività circoscritta per farti un’idea del consumo». La mia regola: se ci sono meno di 5 sottoattività indipendenti o meno di 50 file, una normale chat con un paio di subagenti basta e costa meno.

Se guidi un team con un piano Enterprise, un amministratore potrebbe aver disattivato i Workflow tramite le impostazioni gestite o l’interruttore nella pagina di amministrazione di Claude Code. Prima di considerare i Workflow una «soluzione per tutto», controlla che siano effettivamente abilitati: /config → la voce Dynamic workflows.

Trova altri materiali su come lavorare con gli strumenti nella documentazione di Ailoot.