claude· 6 min di lettura

Subagent forking in Claude Code: quando conviene e quando no

Di Marco Masut

Il subagent forking è la creazione di un subagent che eredita l'intera conversazione e la prompt cache della sessione che lo ha generato, invece di partire da un contesto vuoto. Il changelog ufficiale di Claude Code lo registra come attivo di default nella versione 2.1.232, pubblicata il 13 agosto 2026, con il valore subagent_type: "fork" e una seconda modifica che viaggia insieme: nelle sessioni interattive gli agenti generati che non sono teammate partono in background di default.

Chi delega lavoro a un subagent conosce bene il problema che questa riga risolve. Un subagent nasce con la testa vuota, e quindi va istruito: gli si spiega il progetto, gli si dice quali file guardare, gli si ripete la convenzione che nella conversazione principale era ovvia da mezz'ora. Quella spiegazione è lavoro che il modello aveva già fatto una volta, e rifarla è il costo nascosto della delega.

Cosa cambia con il subagent forking attivo di default

Cambia il punto di partenza della delega, che è la cosa che pesa di più. Con il subagent forking il subagent parte da dove era arrivata la conversazione, e quello che la sessione principale ha capito nelle ultime due ore non va riassunto per essere trasmesso. Il changelog di Claude Code 2.1.232 è preciso sui due pezzi che eredita: la conversazione completa e la prompt cache.

Il secondo pezzo è quello che i conti li fa quadrare. Ereditare tutta la conversazione vuol dire portarsi dietro molti token di input, e se quei token andassero ripagati per intero a ogni fork la funzione sarebbe un lusso da usare con il contagocce. Eredita invece anche la cache, ed è la stessa logica che il changelog di Claude Code documenta per i fan-out dei workflow, dove gli agenti fratelli vengono sfalsati in modo che i successivi leggano il prefisso di prompt già in cache invece di ripagarlo. Chi tiene d'occhio quanto costa in token un agente di coding sa che la differenza tra leggere una cache e ricostruire un contesto è quasi tutta la bolletta.

La partenza in background è la parte che si nota subito nell'uso quotidiano. Il pannello degli agenti nella 2.1.232 nasconde immediatamente i subagent completati e lascia un rimando a /tasks nel piede, e anche /code-review ai livelli di sforzo high, xhigh e max gira ora in un agente di background come già facevano gli altri livelli. Sono dettagli di interfaccia che descrivono un'abitudine: il lavoro delegato non si guarda mentre succede, si va a recuperare quando è finito.

Quando un subagent che parte da zero è ancora la scelta giusta

Quando il contesto della sessione principale è più un disturbo che un aiuto. Un subagent vuoto è la scelta giusta ogni volta che il compito delegato deve essere valutato senza pregiudizi: una revisione del codice appena scritto, un secondo parere su un'ipotesi, la verifica di un fatto. Se l'agente che controlla eredita la conversazione in cui è stata costruita la cosa da controllare, eredita anche le ragioni per cui sembrava una buona idea, e un revisore che conosce le tue giustificazioni è un revisore che vale meno.

Il secondo caso è la ricerca che produce spazzatura. La documentazione ufficiale sui subagent mette questo come motivo principale per delegare: un compito laterale che inonderebbe la conversazione di risultati di ricerca, log e contenuti di file che nessuno rileggerà. Lì il contesto serve poco, e il valore sta nel fatto che il rumore muore in una finestra separata.

Poi c'è il criterio noioso e decisivo, che è la lunghezza. Forkare una conversazione da quattro ore per farle cercare una stringa in tre file significa ereditare quattro ore di contesto per un compito che ne aveva bisogno di zero. Il fork non è gratis in attenzione: più contesto porti dentro, più cose ci sono che possono distrarre l'agente dal compito unico che gli hai dato.

Perché è sparito il consiglio di creare subagent personalizzati

Nella stessa versione 2.1.232 Claude Code ha rimosso il suggerimento di avvio che invitava a creare subagent personalizzati e il richiamo corrispondente dentro il tour di /powerup. Messo accanto al fork attivo di default, è la riga più interessante del rilascio, perché le due cose raccontano la stessa decisione: il modo normale di dare contesto a un agente non è più scrivere un file con le istruzioni giuste, è passargli la conversazione che quel contesto ce l'ha già.

Questo non manda in pensione i subagent personalizzati, che restano la cosa giusta per i lavori ricorrenti con istruzioni stabili. Ridimensiona però l'idea che ne servano molti, che è la posizione che ho già sostenuto scrivendo di quanti subagent servono davvero in Claude Code: la delega peggiora quando duecento descrizioni competono sulle stesse parole, e un fork non ha bisogno di essere scelto fra duecento candidati.

Le routine che scrivono su questo blog sono un caso dove la differenza si vede a occhio. Girano come sessioni cloud schedulate, documentate in automazione-blog/cloud-agent/, e prima di scrivere una riga leggono tre file di regole in .claude/skills/articolo/ più le notizie del giorno. È mezz'ora di contesto costruito che un subagent nuovo non avrebbe, e che dovrebbe ricostruire aprendo gli stessi file: esattamente il lavoro che il fork evita. La cosa che invece non conviene forkare, in quella pipeline, è il controllo finale, per il motivo detto sopra.

Cosa fare adesso, in concreto

Tre cose, in ordine di quanto costano.

  1. Aggiorna a Claude Code 2.1.232, la versione del 13 agosto 2026 che porta il fork di default. La 2.1.231, uscita lo stesso giorno, corregge il sign-in OAuth degli MCP che falliva per disallineamento della redirect URI sui server con client OAuth pre-registrato, come Slack: se hai un MCP che non fa più login, la causa probabile è quella.
  2. Decidi la regola di delega una volta e scrivila nel CLAUDE.md del progetto, invece di deciderla ogni volta. La mia è a due voci: fork quando il compito continua il lavoro in corso, subagent vuoto quando il compito deve giudicarlo.
  3. Prendi l'abitudine a /tasks. Con gli agenti che partono in background di default, il posto dove si vede cosa sta girando non è più la conversazione, e un agente dimenticato in background è lavoro che nessuno legge.

C'è un'ultima riga della 2.1.232 che vale la pena guardare, anche se non riguarda i subagent: si può scrivere @ nel prompt per menzionare un'altra sessione di Claude per nome, e a quel punto è Claude a usare SendMessage per raggiungerla. Chi sta già facendo parlare fra loro più sessioni di Claude Code guadagna la scorciatoia che mancava, e chi non lo fa ha in mano il pezzo che rende quel coordinamento comodo invece che laborioso.

La direzione di questo rilascio è chiara, ed è la stessa che conviene tenere presente a chi sta mettendo un agente AI dentro un processo di lavoro: il contesto sta diventando la cosa che si passa, non la cosa che si riscrive. È una decisione che non prende il modello ma l'agent harness che gli sta attorno, e vale la pena sapere quali di queste scelte sta prendendo per te. Il fork attivo di default è una scelta di default sensata, e come tutte le scelte di default va conosciuta, perché il giorno in cui serve un giudizio indipendente il valore giusto è ancora l'altro.

Domande frequenti

Che cos'è il subagent forking in Claude Code?

Il subagent forking di Claude Code è la creazione di un subagent che eredita l'intera conversazione della sessione che lo ha generato, invece di partire da un contesto vuoto. Il changelog ufficiale di Claude Code lo registra come attivo di default nella versione 2.1.232 del 13 agosto 2026, e precisa che il subagent eredita anche la prompt cache della sessione madre.

Come si crea un subagent che eredita la conversazione?

Si usa il valore `subagent_type: "fork"` quando si genera il subagent. Il changelog di Claude Code 2.1.232 indica che un subagent dichiarato in questo modo eredita la conversazione completa e la prompt cache della sessione che lo ha creato. Gli altri tipi di subagent continuano a partire da un contesto proprio e vuoto.

I subagent di Claude Code partono in background?

Sì, dalla versione 2.1.232 del 13 agosto 2026. Il changelog ufficiale indica che nelle sessioni interattive gli agenti generati che non sono teammate partono in background di default. Il pannello degli agenti nasconde subito i subagent completati e rimanda al comando `/tasks` per rivederli.

Un subagent forkato consuma più token di uno che parte da zero?

Un subagent forkato porta dentro molti più token di input, perché eredita tutta la conversazione, ma non li paga come se fossero nuovi: eredita anche la prompt cache. Il changelog di Claude Code descrive la stessa logica per i fan-out dei workflow, dove gli agenti successivi leggono il prefisso di prompt già in cache invece di ripagarlo. Il costo vero di un subagent che parte vuoto è che qualcuno deve rimettergli il contesto dentro, a mano o rileggendo file.

Conviene ancora creare subagent personalizzati in Claude Code?

Conviene per i lavori ricorrenti con istruzioni stabili, molto meno per dare contesto a un compito che nasce dentro una conversazione già in corso. Nella versione 2.1.232 Claude Code ha rimosso il suggerimento di avvio che invitava a creare subagent personalizzati e il richiamo corrispondente nel tour di `/powerup`, il che dice bene in che direzione si sta muovendo lo strumento.

Continua a leggere

claude

Dove finiscono i dati dell'intelligenza artificiale, e quanto costa deciderlo

Dove finiscono i dati dell'intelligenza artificiale dipende da dove gira l'inferenza. Adesso quel vincolo ha un prezzo scritto: il dieci per cento in più.
claude

Claude Code e GitLab: cosa funziona davvero e dove si ferma

Claude Code e GitLab: le merge request entrano nel flag --worktree, i marketplace clonano da gitlab.com. Cosa coprono la 2.1.232 e la 2.1.233.
claude

Claude Code in un container: cosa non vede dell'ambiente in cui gira

Claude Code in un container leggeva i core della macchina ospite invece del limite del container. Cosa corregge la 2.1.229 e cosa controllare.

Risorse pratiche su questi temi

Articolo

Le nuove regole del context engineering per i modelli Claude 5

L'articolo di Anthropic sul context engineering per i modelli Claude 5: cosa togliere dal prompt di sistema, dal CLAUDE.md e dalle skill.
Video

Estrarre il testo da un PDF e farlo leggere davvero all'AI

Estrarre il testo da un PDF in modo che l'AI lo legga davvero: come si fa gratis e in locale con AnyDoc, e cosa cambia con le scansioni.