Passa al contenuto principale

Progetti: il coordinatore e i thread paralleli

Avanzato

Il 17 settembre 2026 Anthropic ha ricostruito i Progetti. Il vecchio Progetto era una cartella: file, istruzioni e un mucchio di chat che li condividevano tutte. Il nuovo Progetto è un organigramma — "thread che fanno il lavoro e un coordinatore che li dirige".

È un cambiamento più grande di quanto sembri. Un Progetto non è più un posto dove metti il contesto; è una cosa che esegue lavoro per conto tuo. Descrivi un risultato nella chat principale del progetto, e Claude lo delimita, lo suddivide, lo delega a thread paralleli, rivede quello che torna indietro e assembla il risultato.

What you'll learn
  • Cos'è davvero un thread — e perché 'una sessione cloud di Claude Code su un proprio branch' è la frase chiave
  • In cosa il coordinatore differisce da un orchestratore di subagent, e quando ciascuno dei due è lo strumento giusto
  • I quattro modi di eseguire lavoro in parallelo in Claude Code oggi, e come scegliere tra loro
  • Perché i Progetti bruciano più in fretta i limiti d'uso, e le due manopole di modello/effort che lo controllano
  • La regola di idoneità che spiega perché il tuo account forse non vede ancora il redesign

L'architettura in un diagramma​

Contano tre pezzi, ed è facile confonderli:

  • Il coordinatore è la chat principale del progetto. L'immagine usata da Anthropic è quella di dare un briefing a un capo di gabinetto: dici cosa ti serve, e lui instrada il lavoro verso thread nuovi o già esistenti.
  • Un thread non è un lavoratore leggero. "Sotto il cofano, ogni thread è una sessione cloud di Claude Code che lavora su un proprio branch e una propria copia del repo." È una sessione completa, con una propria finestra di contesto, i propri strumenti e la propria capacità di generare subagent, loop e workflow quando un incarico è abbastanza grande da giustificarlo.
  • La memoria condivisa e la libreria sono ciò che impedisce al fan-out di frammentarsi. Ogni thread attinge allo stesso bacino di memoria, e la libreria "raccoglie i file che aggiungi e gli artefatti prodotti da Claude", così gli output restano trovabili invece di morire dentro una sessione chiusa.

Con un repository collegato, i thread aprono pull request ed eseguono i test da soli. Puoi osservare e indirizzare da qualunque posto, telefono compreso.

La frase che determina tutto il resto​

Ogni thread è una sessione cloud di Claude Code che lavora su un proprio branch e una propria copia del repo.

Leggila come tre impegni separati:

  1. Sessione propria → finestra di contesto propria. I thread non condividono un budget di contesto come fanno i subagent dentro un'unica sessione. Il fan-out non si mangia più la finestra del genitore.
  2. Branch proprio → i thread non possono sovrascriversi i file a vicenda. L'isolamento è imposto da git, non dalla disciplina di prompt. Il prezzo è che l'integrazione si sposta al momento del merge.
  3. Copia propria del repo → un thread può eseguire test, installare dipendenze e rompere cose senza toccare la tua macchina né gli altri thread.

Quel terzo punto è anche il tetto attuale: i thread girano solo nel cloud. Anthropic dice che l'esecuzione "sulla tua macchina, insieme ai tuoi strumenti e al tuo codice locali e dietro la tua rete, sta arrivando molto presto" — finché non arriva, tutto ciò che richiede un servizio locale, un host raggiungibile solo in VPN o una dipendenza non pubblicata resta fuori dai Progetti.

Scegliere tra quattro tipi di parallelismo​

Claude Code offre ora quattro modi per fare più di una cosa alla volta. Non sono intercambiabili, e sceglierne uno sbagliato è l'errore più comune qui.

MeccanismoChi orchestraIsolamentoContestoIdeale per
SubagentIl tuo agente principale, dentro una sessioneStesso working treeCondividono i limiti della sessione; massimo 20 in parallelo, profondità 3Fan-out di letture e ricerca dentro un singolo task
WorktreeTu, a manoBranch + directory separati, in localeSessioni separate che avvii tuLavoro parallelo locale che vuoi osservare e controllare
Messaggistica tra sessioniTu, indirizzando le sessioni per nomeQuello che ogni sessione ha giàIndipendenteCoordinare sessioni già in esecuzione
Thread di progettoClaude, dal coordinatoreBranch + copia del repo separati, nel cloudIndipendente per ogni threadIncarichi lunghi che vuoi delimitati, suddivisi e assemblati al posto tuo

L'euristica onesta:

  • Se il lavoro sta in una sessione ed è per lo più lettura, usa i subagent — non richiedono configurazione e sono i più economici.
  • Se vuoi supervisionare ogni passo sulla tua macchina, usa i worktree.
  • Se la suddivisione è ovvia per te e preferisci deciderla tu, usa worktree o messaggistica. I Progetti aggiungono valore proprio quando la decomposizione è la parte difficile.
  • Se l'incarico è grande, la suddivisione non è ovvia e vuoi controllare dal telefono invece di fare da balia a un terminale, usa i Progetti.

Configurarne uno​

Guided walkthrough1 of 6
  1. Sei tu a scegliere il risultato e il repository o il contesto rilevante in partenza. Il coordinatore usa entrambi per proporre la prima fetta di lavoro, quindi un obiettivo vago produce una delega vaga.

Il modello di costo, detto chiaramente​

Anthropic è diretta su questo: "I Progetti possono raggiungere i limiti d'uso più in fretta." La ragione discende dall'architettura — ogni thread è una sessione cloud completa di Claude Code, quindi cinque thread sono all'incirca cinque sessioni di consumo in esecuzione simultanea, non una sessione divisa in cinque.

Esistono due manopole, e sono tutta la storia del costo:

Pro tip
  • Modello/effort del coordinatore — delimita, rivede e assembla. Legge molto e scrive poco, quindi beneficia di un ragionamento capace.
  • Modello/effort dei thread — questo viene moltiplicato per il numero di thread. Abbassarlo di un gradino è la singola modifica di costo con più leva che puoi fare.
  • L'uso per progetto è visibile separatamente, così puoi vedere quanto costa un progetto senza tirare a indovinare dal tuo limite globale.

Lo schema che ne deriva: tieni affilato il coordinatore, rendi proporzionati i lavoratori. Delegare il lavoro meccanico — scrittura di test, migrazioni, passate sulla documentazione — a thread con un livello di effort più basso mentre il coordinatore rivede a un livello più alto ti dà quasi tutta la qualità a una frazione della spesa moltiplicata. È la stessa economia dell'instradare i subagent su modelli più economici, applicata un livello più in alto.

Perché forse non ce l'hai​

Il cancello della beta è insolitamente specifico, e inganna chi presume che sia un semplice rilascio a percentuale. Al lancio, l'accesso è andato a:

abbonati Claude Pro e Max selezionati che usano le sessioni cloud in Claude Code e non hanno progetti già esistenti sul web o sul desktop

Tre condizioni, tutte necessarie:

CondizionePerché punge
Piano Pro o MaxTeam ed Enterprise arrivano dopo, a valle del rilascio consumer
Usa già le sessioni cloud in Claude CodeGli utenti solo-locale non sono nella prima ondata, per quanto intenso sia il loro uso
Nessun progetto già esistente su web o desktopLa condizione sorprendente — essere un utente storico e intenso dei vecchi Progetti ti squalificava attivamente al lancio

Quella terza regola è la trappola. Chi usa i Progetti da tempo è il meno probabile ad aver visto il redesign, perché il percorso di migrazione per i progetti esistenti non era ancora arrivato. I progetti esistenti continuano a funzionare durante il rilascio. Gli utenti Pro e Max senza accesso possono iscriversi a una lista d'attesa; Anthropic ha detto che l'accesso si sarebbe allargato "nel corso della settimana successiva" ad altri utenti di Claude Code su quei piani, poi al resto di Claude e a Team ed Enterprise.

Errori comuni​

  • Trattare il coordinatore come una casella di prompt. È un delegatore. Dagli un risultato e dei vincoli; se gli passi una lista ordinata di passi, paghi l'overhead di orchestrazione per qualcosa che una singola sessione fa meglio.
  • Presumere che i thread condividano il tuo stato locale. Hanno una copia cloud del repo. Modifiche locali non committate, file env locali e servizi su localhost lì non ci sono.
  • Dimenticare che l'isolamento rinvia i conflitti invece di rimuoverli. Un branch per thread garantisce che i thread non si sovrascrivano a vicenda mentre girano. Non garantisce che tre PR che toccano lo stesso modulo si uniscano senza attriti. Dove puoi, delimita i thread lungo i confini dei moduli.
  • Lasciare l'effort dei thread allo stesso livello del coordinatore. Quell'impostazione viene moltiplicata per il numero di thread. È il modo più rapido per sbattere contro un limite a metà incarico.
  • Usarlo per lavoro che richiede la tua macchina. Le dipendenze da rete locale o strumenti locali appartengono ai worktree finché non arrivano i thread locali.

Cosa segnala tutto questo​

I Progetti sono il primo punto in cui Anthropic ha reso prodotto la decomposizione stessa. I subagent permettono a un modello di aprirsi a ventaglio dentro un task che hai definito tu. Un Progetto chiede al modello di definire i task. I controlli che Anthropic ha scelto di esporre — frequenza dei check-in, quanto prontamente apre nuovi thread, effort separato per coordinatore e lavoratori — sono tutte manopole su quanta autonomia stai delegando, il che è un segnale utile su dove stanno andando i prodotti agentici in generale. Vedi il collo di bottiglia della verifica per capire perché è la revisione, non la generazione, il vincolo contro cui va a sbattere questo design.

Check yourself

0/3
  1. Cos'è, tecnicamente, un thread di progetto?
  2. Perché i Progetti raggiungono i limiti d'uso più in fretta di una singola sessione?
  3. Al lancio, quale condizione SQUALIFICAVA un account dalla beta?
Key takeaways
  • Un Progetto è ora un livello di orchestrazione, non una cartella: un coordinatore delimita e delega, i thread eseguono.
  • Un thread è una sessione cloud completa su un proprio branch e una propria copia del repo — contesto indipendente, PR proprie, consumo proprio.
  • Ricorri ai Progetti quando la decomposizione è la parte difficile; ricorri a subagent o worktree quando la suddivisione la conosci già.
  • L'effort dei thread viene moltiplicato per il numero di thread; quello del coordinatore no. Regolali separatamente.
  • Oggi i thread sono solo cloud, quindi tutto ciò che richiede strumenti locali o una rete privata resta per ora nei worktree.

Avanti​

  • Subagent — la primitiva di fan-out dentro la sessione, sopra cui stanno i thread
  • Limiti della flotta di subagent — i tetti di concorrenza e l'instradamento di costo che valgono dentro ogni thread
  • Worktree — l'alternativa locale, orchestrata da te, finché il solo-cloud è un vincolo

Fonti e approfondimenti​