Projects è in beta pubblica sui piani Pro, Max e Ultra e sta venendo implementato gradualmente. L’implementazione è iniziata con gli account che hanno utilizzato sessioni cloud e non hanno progetti esistenti in claude.ai chat o Cowork. Projects non è ancora disponibile sui piani Team o Enterprise.Se Projects non appare nella barra laterale su claude.ai/code o nella scheda Code dell’app desktop, controlla sotto More. Se non c’è nemmeno lì, l’implementazione non ha ancora raggiunto il tuo account. Puoi unirti alla lista d’attesa e consultare Esegui agenti in parallelo per sapere cosa puoi utilizzare nel frattempo.
- Invia il lavoro in un unico posto: incolla una segnalazione di bug, una traccia dello stack, o un elenco di attività nella conversazione ogni volta che ne viene fuori una. Claude avvia un thread per ogni pezzo di lavoro o lo passa al thread già al lavoro in quell’area, e risponde a domande rapide sul posto.
- Imposta il contesto una volta: ogni nuovo thread inizia con le istruzioni del progetto, quindi una regola che dichiari una volta, come quale branch scegliere come target, raggiunge tutti loro.
- Allontanati e torna al lavoro finito: quando torni un’ora dopo o la mattina successiva, il riquadro Overview mostra quali thread sono terminati, quali pull request sono pronte per la revisione, e quale thread sta aspettando la tua risposta.
Quando creare un progetto
Un progetto vale la pena crearlo quando il lavoro ha un obiettivo che va oltre una singola sessione e continua a generare attività. Questi tipi di lavoro si adattano bene a un progetto:- Un obiettivo su molti repository: “Portare ogni servizio alla nuova configurazione lint.” Claude può eseguire un thread per repository, ognuno con la propria pull request, e il riquadro Overview mostra quali sono pronti per la revisione.
- Un’area che continui ad alimentare: i bug, le stack trace e le richieste di revisione per un servizio, incollati nella conversazione man mano che li ricevi. Un errore che dici a Claude di ricordare dopo una correzione è nella memoria del progetto per il prossimo.
- Una build o migrazione più grande di una sessione: “Costruisci quello che
docs/spec.mddescrive” o “Sposta l’app dal vecchio ORM deprecato.” Il lavoro si divide in thread che affrontano ciascuno una parte, le decisioni che chiedi a Claude di ricordare all’inizio raggiungono i thread successivi, e le specifiche e i bug che trovi durante la build vanno nella stessa conversazione. - Lavoro che non è codice: una cartella di contratti o un’esportazione di ticket di supporto a cui continui a tornare con nuove domande, come “trova i dieci errori di integrazione più comuni in questi ticket.” Carica i documenti invece di aggiungere un repository, e i thread consegnano ogni relazione come file nella scheda Library del progetto.
Quando qualcos’altro si adatta meglio
Un progetto si adatta ancora quando solo alcune attività hanno bisogno della tua macchina. I thread cloud funzionano su repository GitHub e sui file, cartelle e cartelle Google Drive che carichi nel progetto, e per l’occasionale attività che ha bisogno di un database locale o di uno strumento sul tuo computer, puoi chiedere a Claude di eseguire il thread di quell’attività sul tuo computer. Qualcos’altro si adatta meglio in questi casi:- Un’attività che rientra in una sessione: “Correggi il test di login instabile.” Avvia una cloud session tu stesso.
- Lavoro dove ogni attività ha bisogno della tua macchina: un database locale, un emulatore di dispositivo, o un’API dietro il tuo VPN. Usa una sessione locale, o agent view per eseguirne diversi contemporaneamente. Se il lavoro ha bisogno solo di file locali, caricali nel progetto invece.
- Un’attività che si ripete in un programma senza conversazione intorno: “Pubblica un rapporto sulle dipendenze ogni lunedì.” Crea un’attività pianificata cloud a sé stante.
- Più persone che danno a Claude lavoro e lo guidano insieme in un canale Slack: vedi Claude Tag.
Come è organizzato un progetto
Un progetto è una conversazione coordinata con Claude più i thread che avvia per svolgere il lavoro. Queste sono le sue parti:- La conversazione del progetto: una sessione di lunga durata in cui Claude agisce come coordinatore. Prende quello che invii, decide cosa diventa un thread e tiene traccia di ogni thread che ha avviato. Vede cosa riferiscono i thread, non ogni passaggio che compiono.
- Thread: i lavoratori. Ognuno è una sessione separata con la propria finestra di contesto che svolge un pezzo di lavoro e riferisce alla conversazione quando finisce. Un thread cloud lavora sul proprio ramo e apre una pull request quando il lavoro lo richiede.
- Quello con cui ogni thread cloud inizia:
- I repository e i file del progetto, più le sue istruzioni e memoria
- Il
CLAUDE.mdin ogni repository del progetto, ma non le skill, il.claude/settings.jsono il.mcp.jsondei repository - I connettori sul tuo account claude.ai
- Un ambiente cloud che imposta il suo accesso di rete, le variabili d’ambiente, i segreti di rete e gli strumenti installati
- Il riquadro Overview: dove vedi tutti i thread contemporaneamente e quali di loro hanno bisogno di te. Le sue altre schede sono Library per i file che hai aggiunto e i file che i thread hanno prodotto, Pull requests per quelle che i thread hanno aperto, e Scheduled tasks per il lavoro pianificato nel progetto.
Crea un project
Crei e usi i project su claude.ai/code, nella scheda Code dell’app desktop, o nell’app mobile Claude per iOS e Android. Nel browser e nell’app desktop ci sono due modi per avviare un project:- Da zero, quando conosci il flusso di lavoro che vuoi che Claude esegua: apri la finestra di dialogo New project e assegnagli un nome. Avvia un nuovo project da zero ti guida attraverso la finestra di dialogo.
- Da una sessione cloud che sta già facendo il lavoro: nel menu di quella sessione nella barra laterale, scegli Continue in project, quindi Continue as new project. Claude propone la configurazione del project da quello che la sessione stava facendo. Vedi Avvia da una sessione cloud esistente.
Controlla i prerequisiti
Prima di creare un project, controlla il tuo piano, la tua configurazione GitHub e cosa il lavoro ha bisogno di raggiungere:- Piano: sei su Pro, Max o Ultra e Projects appare nella tua barra laterale, direttamente o sotto More. Seleziona Projects e verifica che offra New project o Get started.
- GitHub, se il project lavorerà su codice: il tuo codice è su github.com piuttosto che su GitHub Enterprise Server, GitLab o Bitbucket, il tuo account GitHub connesso ha accesso push, e l’app Claude GitHub è installata su di esso. Se hai connesso GitHub con
/web-setup, quel token lascia che le tue altre sessioni cloud raggiungano un repository ma non è sufficiente per i thread del project, che hanno bisogno dell’app Claude GitHub. Configura l’accesso a GitHub ha i passaggi. - Accesso alla rete, segreti e strumenti: per i thread cloud, questi provengono dal cloud environment del project. L’ambiente predefinito raggiunge già registri di pacchetti comuni, quindi controlla questo solo se il lavoro ha bisogno di altri domini, un segreto o uno strumento che non è preinstallato. Se il lavoro ha bisogno di un server MCP, controlla che appaia come connesso nei tuoi connettori di claude.ai.
Avvia un nuovo project da zero
Avviare un project da zero significa aprire la finestra di dialogo New project, assegnare un nome al flusso di lavoro e facoltativamente dargli un obiettivo e i repository e i file su cui lavora. Solo il nome è obbligatorio, quindi puoi creare il project prima e riempire il resto mentre il lavoro prende forma.1
Apri Projects
Su claude.ai/code o nella scheda Code dell’app desktop, seleziona Projects nella barra laterale sinistra, o sotto More al suo interno. In un browser puoi anche andare direttamente a claude.ai/code/projects/browse. Quindi seleziona New project. Se il pulsante riporta invece Get started, selezionalo e prima aggiorna o archivia i project claude.ai esistenti che elenca.
2
Compila la finestra di dialogo New project
Limita il project a un flusso di lavoro che continuerai ad aggiungere, come tutto quello che serve per mantenere un’API sotto il suo obiettivo di latenza. Quando usare un project ha più esempi. Quindi compila i campi della finestra di dialogo:
- Name: come il project appare nell’elenco Projects.
- Goal (facoltativo): una riga di quello che stai cercando di realizzare, come “Mantieni la latenza API p95 sotto 200 ms”. Claude nella conversazione lavora verso di esso. Senza un obiettivo, Claude lavora dai compiti che invii, e puoi aggiungere un obiettivo in seguito in Project settings > General.
- Context (facoltativo): i repository GitHub su cui questo project lavora, più eventuali file, cartelle o cartelle Google Drive che i thread dovrebbero leggere. Fai clic su Add per ognuno. Aggiungi i repository di cui la maggior parte dei compiti ha bisogno piuttosto che ogni uno che il lavoro potrebbe toccare; Decidi quali repository aggiungere copre la scelta, e puoi aggiungerne altri in seguito in Project settings > Environment.
3
Crea il project
Fai clic su Create project. La conversazione del project si apre con una casella di messaggio in basso, dove descrivi il lavoro per Claude.Nel tuo primo project, Claude prende un turno da solo non appena il project viene creato, a meno che tu non invii un messaggio per primo. Quel turno usa il tuo piano. In esso, Claude potrebbe:
- Avviare un thread che esplora il repository senza cambiare nulla e propone i prossimi passi, se il project ha un repository che può leggere.
- Pubblicare Setup recommendations tratte dalle tue recenti sessioni cloud: repository da aggiungere, attività pianificate da creare e thread che potrebbe avviare. Ogni repository e attività pianificata consigliati iniziano attivati. Disattiva quelli che non vuoi, quindi fai clic su Update setup per aggiungere il resto, o ignora le raccomandazioni e descrivi il lavoro da solo.
Avvia da una sessione esistente
Se una sessione cloud che hai avviato tu stesso sta facendo lavoro che appartiene a un project, apri il suo menu nella barra laterale e scegli Continue in project, quindi scegli dal sottomenu:- Scegli Continue as new project per creare un nuovo project dalla sessione. Il project si apre, e Claude legge la sessione e pubblica Setup recommendations nella conversazione del project per te da confermare. La sessione originale rimane nel tuo elenco di sessioni. Se era nel mezzo di un turno continua a funzionare, quindi fermala da solo se non vuoi che entrambi funzionino contemporaneamente.
- Scegli uno dei tuoi project esistenti per portare il lavoro della sessione in quel project. Quel project si apre, e un messaggio inviato per tuo conto chiede a Claude di leggere la sessione e riprendere da dove l’ha lasciata. La sessione originale rimane nel tuo elenco di sessioni, invariata.
- Se la sessione non è ancora connessa, esegui
/remote-controlal suo interno. Se si è connessa mentre quell’impostazione era attiva, prima disconnettila e connettila di nuovo. - In un browser, trova la riga della sessione nella barra laterale su claude.ai/code, apri il suo menu e scegli dallo stesso sottomenu.
Configura l’accesso a GitHub
La maggior parte della configurazione di GitHub accade una volta, non per project. Connetti il tuo account GitHub a Claude una volta, e l’app Claude GitHub è installata una volta per repository, o una volta per un’intera organizzazione GitHub se le dai tutti i repository. Torni a questi passaggi quando aggiungi un repository che l’app Claude GitHub non copre ancora o uno in un’organizzazione GitHub che applica SSO.1
Connetti il tuo account GitHub
Se non hai mai usato claude.ai/code prima, la tua prima visita ti guida attraverso la connessione di GitHub; vedi Connetti GitHub. Altrimenti usa una delle opzioni di autenticazione GitHub.
2
Installa l'app Claude GitHub sui repository del project
Installa l’app Claude GitHub e concedile i repository che il project userà. Su un repository di proprietà di un’organizzazione GitHub, solo un proprietario dell’organizzazione può completare l’installazione; se non lo sei, GitHub invia al proprietario una richiesta di installazione e il project non può usare il repository fino a quando non la approva.
3
Autorizza SSO per le organizzazioni che lo applicano
Se un’organizzazione GitHub applica SAML SSO, riconnetti GitHub e autorizza l’app Claude per quell’organizzazione. Fino a quando non lo fai, i repository privati di quell’organizzazione non appaiono nella finestra di dialogo New project o Project settings > Environment.
Lavora in un progetto
Assegna lavoro a Claude attraverso la conversazione del progetto: attività una alla volta o più contemporaneamente, più aggiornamenti e pensieri sparsi man mano che emergono. Claude instrada ogni messaggio e i thread svolgono il lavoro e riferiscono i risultati.Il tuo primo batch
Prima di inviare a un nuovo progetto un batch di lavoro, configuralo in modo che i primi thread tornino nel modo che desideri:- Scrivi le istruzioni del progetto: il brief da cui ogni thread inizia, ad esempio quale branch puntare, come un thread verifica il suo lavoro e cosa ha bisogno della tua approvazione.
- Invia un piccolo pezzo del lavoro reale, o avvia uno dei thread che Claude ha suggerito se ne ha offerti, e apri il thread quando finisce per vedere come riferisce i risultati e cosa ha fatto sul suo branch. Se ha assunto qualcosa di sbagliato o non ha potuto raggiungere quello di cui aveva bisogno, I thread hanno indovinato o si sono bloccati invece di chiedere copre dove correggere questo.
- Controlla Thread model e Thread effort in Project settings > General. Un nuovo progetto esegue ogni thread su Opus con sforzo elevato, che consuma il tuo piano più velocemente; Scegli modelli e lascia che Claude gestisca il contesto copre le alternative.
- Chiedi a Claude di proporre thread prima di avviarli e di eseguirne pochi alla volta, e rimuovi quei limiti una volta che alcuni thread tornano nel modo che desideri.
Invia lavoro e leggi i risultati
Claude decide dove va ogni messaggio che invii nella conversazione:- Una domanda veloce di solito riceve una risposta nella conversazione.
- Il nuovo lavoro va a un nuovo thread o a un thread già al lavoro in quell’area, e Claude ti dice quale. Ogni nuovo thread appare sotto il tuo messaggio come una card: una casella con il titolo e lo stato del thread, che fai clic per aprire il thread.
- Diversi compiti non correlati in un messaggio diventano thread separati.
Rivedi la pull request di un thread
Quando un cloud thread cambia il codice, questo è quello che fa a meno che tu non gli dica diversamente:- Branch: lavora su un nuovo branch, avviato dal branch predefinito del repository.
- Pull request: apre una quando chiedi, e può aprirne una da sola per una correzione di bug o un altro cambiamento concreto.
- Dopo che l’apre: osserva la pull request con auto-fix attivato, indipendentemente dal fatto che auto-fix sia attivo per le tue altre sessioni cloud. Spinge correzioni quando CI fallisce, affronta i commenti di revisione e risponde nel thread quando i controlli passano e la pull request è pronta per te.
- Resolve conflicts, Fix CI, Address comments e Merge it inviano quell’istruzione al thread come messaggio da te, così puoi richiedere il thread stesso invece di aspettare che reagisca alla pull request.
- Review PR apre la pull request su GitHub.
- Create PR appare quando un thread inattivo ha spinto un branch ma non ha aperto una pull request. Facendo clic su di esso crea la pull request da quel branch direttamente piuttosto che inviare al thread un’istruzione per aprirne una.
Vedi cosa ha bisogno di te in Overview
Il riquadro Overview accanto alla conversazione traccia i thread del progetto. È già aperto la prima volta che apri un nuovo progetto. Il pulsante Overview nell’intestazione del progetto lo chiude e lo riapre, e mostra un punto quando un thread è in attesa di te. Nell’app desktop, ricevi anche una notifica desktop quando Claude pubblica nella conversazione, un thread raggiunge un errore, o un thread ha bisogno del tuo input, così non devi tenere il progetto aperto per scoprirlo. Per riceverne una anche ogni volta che un thread finisce un turno, o per disattivarle per un progetto, scegli Notifications nel menu della barra laterale del progetto. Queste notifiche sono solo desktop: in un browser, controlla il punto sul pulsante Overview. La scheda Threads del riquadro raggruppa i thread per stato:
Le altre schede del riquadro sono:
- Library: i file e le cartelle che hai aggiunto e i file che i thread hanno prodotto
- Pull requests: mostrata una volta che i thread ne hanno aperte
- Scheduled tasks: le attività pianificate cloud che Claude ha configurato da questo progetto
Apri un thread quando hai bisogno di controllo
Fai clic sulla card di un thread nella conversazione o sulla sua riga in Overview per aprire la sua trascrizione nel riquadro Overview. Da lì puoi:- Leggere cosa ha fatto Claude, passo dopo passo.
- Guidare l’attività scrivendo nella casella di messaggio del thread. Un messaggio lì va direttamente a quel thread, mentre un follow-up nella conversazione del progetto lo raggiunge solo quando Claude abbina il follow-up a quel thread.
- Rispondere a un prompt di autorizzazione su cui il thread è in attesa.
- Interrompere il thread con Stop, che sostituisce il pulsante di invio mentre il thread è al lavoro, o premendo Esc.
Scegli modelli e lascia che Claude gestisca il contesto
Imposta modelli e sforzo in Project settings > General. Un nuovo progetto esegue Opus ovunque, con sforzo elevato per i thread e sforzo basso per la conversazione:- Thread model e Thread effort si applicano ai thread. Per usare un modello diverso per un’attività, chiedilo nell’attività; per un thread già in esecuzione, usa il selettore di modello di quel thread.
- Coordinator model e Coordinator effort si applicano a Claude nella conversazione del progetto.
Sintonizza come Claude esegue un progetto
Dì a Claude nella conversazione quanti thread eseguire contemporaneamente, quando pubblicare aggiornamenti e quando aprire pull request. Se Claude sta coordinando in un modo che non vuoi, dillo. Ad esempio, puoi dire:- “Proponi thread e aspetta la mia approvazione prima di avviarli” o “Avvia questi ora senza chiedermi di confermare”
- “Esegui al massimo due thread contemporaneamente” o “Riutilizza un thread esistente per i follow-up nella stessa area”
- “Pubblica aggiornamenti più brevi” o “Pubblica solo quando qualcosa finisce o è bloccato”
- “Dammi un aggiornamento di stato su ogni thread”
- “Fai questo compito con un modello più piccolo”
- “Non aprire una pull request finché non ho visto il piano”
- “Dimmi cosa c’è di sbagliato in questi repository e non correggere nulla ancora”, quando vuoi esaminare i risultati prima che uno di loro diventi un thread
- “Rispondi qui invece di avviare un thread”, quando Claude avvia un thread per qualcosa che intendevi come una domanda veloce
Sblocca un thread in attesa di approvazione
I thread vengono eseguiti in auto mode quando il modello del thread lo supporta, quindi la maggior parte delle chiamate di strumento vengono eseguite senza chiederti. Quando un thread ha bisogno della tua approvazione, il prompt è dentro quel thread e il thread aspetta finché non rispondi lì. Dire a Claude nella conversazione del progetto di procedere non lo raggiunge. Ogni approvazione copre quella richiesta, o il resto di quel thread se scegli l’opzione più ampia. I cloud thread non leggono le regole di permesso dal.claude/settings.json di un repository, quindi fai affidamento sulla modalità auto e sulle approvazioni che dai dentro ogni thread.
Esegui un thread sul tuo computer
Quando un’attività ha bisogno di qualcosa che solo il tuo computer ha, ad esempio un database locale, un emulatore di dispositivo o un’API dietro il tuo VPN, chiedi a Claude di eseguire il thread per quell’attività sul tuo computer invece che nel cloud. Quando chiedi nella conversazione del progetto, il thread è una sessione Claude Code in una cartella sulla tua macchina, connessa tramite Remote Control. Gli altri thread del progetto continuano a essere eseguiti nel cloud. Rispetto a un cloud thread, un thread sul tuo computer:- Funziona con i file, gli strumenti, i server MCP e le impostazioni di Claude Code su quella macchina, inclusi i suoi hook e le regole di autorizzazione, invece dell’ambiente cloud del progetto
- Inizia con le istruzioni del progetto, ma non con i suoi file di memoria caricati
- Viene eseguito solo mentre quel computer è sveglio con Remote Control attivato
1
Connetti la cartella
Sul computer che ha la cartella di cui l’attività ha bisogno, rendila disponibile tramite Remote Control in uno dei due modi. Entrambi hanno bisogno di Claude Code v2.1.280 o successivo su quel computer.
- Nell’app desktop Claude: apri Settings > Code o Settings > Claude Code e attiva Use this computer from your phone and claude.ai. Aggiungi la cartella all’elenco sotto quell’interruttore. I thread possono essere eseguiti su questo computer mentre l’app è aperta.
- In un terminale: esegui
claude remote-controlnella cartella e lascialo in esecuzione. In un repository git, aggiungi--spawn worktreeper dare a ogni thread lì il suo worktree invece della cartella stessa.
2
Chiedi l'attività con Work locally
Nella conversazione del progetto, scegli Work locally dal menu + accanto alla casella di messaggio, che etichetta il tuo messaggio Local, e scrivi cosa vuoi che sia fatto. Dire nel messaggio che l’attività dovrebbe essere eseguita sul tuo computer funziona anche.
3
Consentigli sulla card
Claude risponde con una card Allow Claude to work in a folder on your device. Scegli la cartella se ne hai connesse diverse. Due thread che lavorano in una cartella contemporaneamente possono sovrascrivere i cambiamenti l’uno dell’altro, quindi se la cartella è un repository git, puoi attivare Worktree nelle opzioni della cartella per dare a questo thread il suo worktree invece. Quindi fai clic su Allow once.
claude remote-control si chiude.
- Per far ripartire il thread: consulta Perso il contatto con la tua cartella
- Per impedire al computer di andare in sospensione da solo: nell’app desktop, attiva Keep this computer awake for Remote Control in Settings > Code o Settings > Claude Code
Fornire contesto permanente al progetto
La memoria del progetto, le istruzioni del progetto e i repository, i file e l’ambiente del progetto portano il contesto tra i thread. Imposti ciascuno una sola volta.
Project settings > Memory elenca questi file in Auto memory, perché Claude li scrive da solo mentre lavora nel progetto. Sono separati dalla memoria automatica che Claude Code mantiene sulla tua macchina, anche se entrambe utilizzano un indice
MEMORY.md. La memoria del progetto è anche separata dai file CLAUDE.md nei repository del progetto. Ogni thread cloud legge comunque quei file CLAUDE.md dal suo clone quando inizia, quindi inserisci le istruzioni su un repository nel suo CLAUDE.md e le note sul progetto nella memoria del progetto.
Scrivi le istruzioni del progetto
Le istruzioni del progetto sono il briefing da cui ogni nuovo thread inizia. Fai clic sull’icona dell’ingranaggio nell’intestazione del progetto per aprire Project settings, quindi vai a Memory > Project instructions. Un briefing utile copre:- A cosa serve il progetto
- Dove avviene il lavoro: quali repository, da quale branch iniziare, come denominare le pull request
- Come un thread verifica il proprio lavoro prima di considerarlo completato
- Cosa fare quando manca qualcosa di cui ha bisogno
- Cosa ha bisogno della tua approvazione prima
CLAUDE.md di quel repository, che ogni thread cloud legge quando il repository fa parte del progetto. Una volta che il lavoro è in corso, quando correggi un thread, chiedi anche a Claude di ricordare la correzione: va nella memoria del progetto e i thread cloud successivi iniziano con essa.
Decidi quali repository aggiungere
I repository che aggiungi a un progetto vengono forniti con il loro codice e il loroCLAUDE.md in ogni thread cloud, ma non con le loro skill, .claude/settings.json o .mcp.json. I repository che non aggiungi sono comunque raggiungibili: un thread cloud può aggiungerne uno a se stesso quando il suo compito lo richiede. La maggior parte dei progetti utilizza entrambi:
- Aggiungilo al progetto, nella finestra di dialogo New project, in Project settings > Environment, oppure chiedendo a Claude nella conversazione di aggiungerlo al progetto. Ogni thread cloud da quel momento in poi lo clona e inizia con il suo
CLAUDE.mdcaricato, indipendentemente dal fatto che il compito lo tocchi o meno. - Lascialo fuori e lascia che i thread lo aggiungano quando necessario. Un thread cloud il cui compito richiede un repository che il progetto non ha può aggiungerlo a se stesso, e una nota nel thread dice che è stato aggiunto solo a questo thread. Il clone avviene a metà del compito, quindi il
CLAUDE.mddi quel repository non era presente quando il thread è iniziato. Il thread successivo inizia senza di esso. Un repository aggiunto in questo modo ha bisogno degli stessi prerequisiti di un repository del progetto: l’app GitHub di Claude installata su di esso e accesso push dal tuo account GitHub.
Aggiungi file e cartelle
Aggiungi i file e le cartelle che desideri che i thread leggano nel campo Context della finestra di dialogo New project, oppure successivamente con Add nella scheda Library in Overview. Questi limiti si applicano a ciò che aggiungi:- Scheda Library: fino a 100 file e 2 GB in una selezione, con un singolo file fino a 480 MB.
- Finestra di dialogo New project: i file superiori a 30 MB vengono saltati, quindi aggiungi file più grandi dalla scheda Library dopo aver creato il progetto.
- Cartelle: quando aggiungi una cartella da uno dei due posti, il progetto riceve una copia dei suoi primi 100 file fino a 200 MB, senza alcun file superiore a 30 MB, file nascosti o
node_modules. Un progetto contiene fino a 10 cartelle e cartelle Google Drive combinate, e i singoli file non contano verso quel limite. - Modifiche dopo il caricamento: i caricamenti sono copie, quindi una modifica che fai sul tuo computer in seguito non raggiunge il progetto fino a quando non carichi di nuovo il file e scegli Replace quando ti viene chiesto del nome esistente.
Cosa i thread prendono dai tuoi repository
I thread cloud caricano le istruzioniCLAUDE.md di ogni repository ma non le sue skill, i server di .mcp.json o .claude/settings.json, indipendentemente dal fatto che il progetto abbia un solo repository o diversi.
Scegli un ambiente per i thread
Ogni nuovo thread cloud inizia nell’ambiente cloud del progetto. L’ambiente imposta quali domini i thread possono raggiungere, quali variabili d’ambiente hanno, quali secret di rete vengono aggiunti alle loro richieste, e cosa lo script di setup installa prima che Claude inizi. I thread cloud utilizzano un ambiente predefinito ospitato da Anthropic fino a quando non ne scegli uno in Project settings > Environment. Se i thread cloud hanno bisogno di raggiungere un’API interna o un registro di pacchetti privato, o hanno bisogno di un token che la tua macchina normalmente contiene, cambia l’ambiente piuttosto che il progetto: vedi Network access, Add network secrets, e Setup scripts.Ottieni skill, plugin, connettori e strumenti nei thread
I thread cloud non hanno le skill, i server MCP, i plugin e gli strumenti installati solo sulla tua macchina. Un thread che Claude esegue sulla tua macchina attraverso Remote Control utilizza ciò che è installato lì. Per rendere ciascuno di questi disponibile ai thread cloud:- Skill: abilitale per il tuo account claude.ai, e i thread cloud caricano le skill che abiliti lì, a parte alcuni thread in un ambiente self-hosted. Le skill sottoposte a commit nella directory
.claude/skills/di un repository non si caricano nei thread cloud. - Plugin: aggiungili in Project settings > Plugins; si caricano in ogni nuovo thread cloud. I plugin che un repository dichiara nel suo
.claude/settings.jsonnon si caricano nei thread cloud. - Server MCP: i thread cloud ottengono i loro strumenti MCP dai connettori sul tuo account claude.ai, che sono server MCP che colleghi una volta in claude.ai/customize/connectors. Ogni thread cloud può utilizzarli tutti senza alcuna configurazione per progetto. La conversazione del progetto stessa non ha connettori, quindi invia il lavoro che ne richiede uno come compito per un thread cloud. How connectors reach Claude Code elenca le regole per le sessioni cloud e le impostazioni che disattivano i connettori.
- Strumenti da riga di comando e pacchetti: installali nello script di setup dell’ambiente.
Riferimento delle impostazioni del project
Cambi le impostazioni del project su claude.ai/code o nell’app desktop, non insettings.json. Apri Project settings da Settings nel menu della barra laterale del project o dall’icona dell’ingranaggio nell’intestazione del project.
Le impostazioni vengono salvate mentre le modifichi; un campo di testo che stai modificando, come l’obiettivo o le istruzioni, mostra Save changes e Discard finché non lo lasci. Le modifiche alle istruzioni, ai repository, ai plugin e all’ambiente in Project settings raggiungono i nuovi thread, non i thread già in esecuzione.
Pausa, archivia o elimina un project
Tutti e tre i controlli sono in fondo a Project settings > General:- Pause: ferma tutto contemporaneamente. Ogni thread in esecuzione e la conversazione vengono interrotti, nessun nuovo thread inizia, le attività pianificate non vengono eseguite e il project non accetta messaggi finché non lo riprendi. Fai clic su Resume nello stesso posto o sul banner sopra la casella di messaggio del project; un thread in pausa continua quando gli invii un messaggio dopo.
- Archive: nasconde il project dalla barra laterale e archivia i suoi thread, il che ferma qualsiasi thread che era in esecuzione o guardava una pull request. Le attività pianificate nel project non vengono eseguite mentre è archiviato. Per riportare il project, aprilo dalla pagina Projects e fai clic su Unarchive. I suoi thread rimangono archiviati finché non li disarchivi individualmente dall’elenco delle sessioni.
- Delete: rimuove permanentemente il project insieme ai suoi thread, alla sua memoria e ai suoi file, e disattiva le attività pianificate del project. Questo non può essere annullato. I branch e le pull request che i thread hanno spinto a GitHub non sono interessati.
Utilizzo e costo
L’utilizzo del project conta rispetto agli stessi limiti di piano delle tue altre sessioni Claude Code, e un project non può spendere oltre quei limiti da solo. Un thread che raggiunge il limite del tuo piano aspetta e continua da solo quando il limite si ripristina, quindi il lavoro che hai lasciato in esecuzione inizia a usare la tua prossima finestra di utilizzo senza un messaggio da te. Un thread ha raggiunto il limite di utilizzo copre quello che vedi, come fermarlo e l’unico caso che non aspetta. Il lavoro va oltre i limiti del tuo piano solo se hai attivato crediti di utilizzo per il tuo account. Un thread non può attivarli per te.Cosa attinge al tuo piano
Un project usa i tuoi limiti più velocemente di una singola sessione, e su un piano Pro in particolare dovresti aspettarti di raggiungere il tuo limite prima nei giorni in cui ne esegui uno. Queste sono le parti di un project che usano il tuo piano:- Thread in esecuzione: ognuno è una sessione completa, e più possono essere eseguiti contemporaneamente. Non c’è un numero fisso; Claude avvia quanti il lavoro richiede, e un limite che chiedi è una preferenza piuttosto che un limite. Il limite applicato è 500 nuovi thread al giorno nei tuoi project.
- La conversazione: Claude usa token da solo leggendo quello che i thread riportano e decidendo cosa fare dopo.
- Thread che guardano una pull request: un thread inattivo si sveglia e usa il tuo piano di nuovo quando CI fallisce o un commento di revisione arriva sulla sua pull request. Per fermare questo, chiedi nel thread di smettere di guardare la pull request.
Vedi e riduci l’utilizzo di un project
Apri la scheda Usage in Project settings per vedere l’utilizzo di token per thread e per modello, e quanto è andato alla conversazione del project. Per ridurlo:- Su Pro, Max e Ultra entro i limiti del tuo piano, la durata della cache è di un’ora. Un thread che è stato inattivo più a lungo di così rilegge l’intera conversazione prima di fare qualsiasi cosa quando gli arriva un follow-up. Per il nuovo lavoro, chiedi a Claude di avviare un thread nuovo, che può usare meno che far rivivere uno grande e vecchio.
- Per il lavoro che non ha bisogno del modello più grande, scegli un modello più piccolo o un livello di sforzo inferiore per i thread, la conversazione o entrambi.
- Chiedi a Claude nella conversazione del project di eseguire meno thread contemporaneamente, o di rispondere da solo a piccole domande invece di avviare un thread.
Come i project si relazionano ad altre funzioni Claude Code
Diverse funzioni Claude Code permettono a più di una sessione di funzionare contemporaneamente, quindi eseguire il lavoro in parallelo non è di per sé quello per cui è un project. In un project, Claude avvia e traccia le sessioni invece di te, e ognuno inizia dalle stesse istruzioni. Ecco come ogni funzione vicina si connette a un project:- Claude Tag: Claude Tag è Claude nei canali Slack del tuo team, su piani Team e Enterprise. Chiunque in un canale può dargli lavoro, tutti nel canale lo vedono e lo guidano, e usa connessioni che un amministratore ha configurato per quel canale. I project sono disponibili su Pro, Max e Ultra. Un project è solo tuo: sei l’unico che gli invia lavoro o vede i suoi thread, e usa il tuo accesso GitHub e i tuoi connettori. Come Claude Tag differisce da Cowork e Claude Code ha il confronto fianco a fianco.
- Sessioni cloud: ogni thread è una sessione cloud a meno che non chiedi a Claude di eseguirla sulla tua macchina. In entrambi i casi, Claude la avvia e la traccia invece di te. Puoi anche portare in un project il lavoro di una sessione cloud che hai avviato da solo: scegli Continue in project nel menu della barra laterale di quella sessione.
- Attività pianificate: quando chiedi lavoro pianificato in un project, Claude crea un’attività pianificata cloud che viene eseguita come thread in quel project e appare nella sua scheda Scheduled tasks. Le attività pianificate che crei al di fuori di un project continuano a funzionare da sole.
- Remote Control: Remote Control connette claude.ai a una sessione Claude Code in esecuzione sulla tua macchina. Quando chiedi a Claude in un project di eseguire un thread sul tuo computer, il project usa Remote Control per farlo.
- Sessioni locali e agent view: una sessione che avvii da solo nel tuo terminale, IDE o nell’ambiente locale dell’app desktop rimane al di fuori dei tuoi project, anche se puoi portarne il lavoro in uno di essi. Agent view è una schermata per tracciare diverse sessioni locali fianco a fianco, e tu avvii ancora ognuna e le dai il suo compito da solo.
- Worktree: un worktree dà a ogni sessione locale la sua copia di lavoro di un repository. I thread cloud non ne hanno bisogno: ognuno clona i suoi repository nella sua sandbox cloud e lavora sul suo branch.
- Agent teams: un agent team è una sessione che avvia sessioni di compagno per un singolo compito, sulla tua macchina o dentro una sessione cloud, e finisce con quel compito.
- Subagents: un subagent viene eseguito dentro una sessione, esegue un compito secondario nella sua finestra di contesto propria, e restituisce un riepilogo a quella sessione. I thread di un project sono sessioni intere che Claude avvia e che riferiscono di nuovo alla conversazione del project, e un thread può comunque usare subagent per i suoi propri compiti secondari.
- Projects in claude.ai chat e Cowork: l’esperienza Projects precedente, che raggruppa conversazioni e file di riferimento senza thread o un coordinatore. Questi project continuano a funzionare come fanno oggi fino a quando l’esperienza riprogettata li raggiunge.
Limitazioni
- I project sono disponibili su claude.ai/code, nell’app desktop e nell’app mobile di Claude, non nel CLI del terminale, nell’estensione VS Code o nel plugin JetBrains, e non attraverso Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry.
- I thread del project sono sessioni cloud, o sessioni sulla vostra macchina attraverso Remote Control, con Anthropic come fornitore di modello in entrambi i casi. Sicurezza e Utilizzo dei dati coprono come le sessioni cloud sono isolate e cosa viene conservato, e Connessione e sicurezza copre come un thread sulla vostra macchina si connette e cosa viene archiviato.
- Non puoi aggiungere a un project una sessione che hai avviato tu stesso sulla tua macchina, anche se puoi portarne il lavoro in un project. Un project raggiunge la tua macchina eseguendo un thread lì attraverso Remote Control, e quella sezione elenca di cosa ha bisogno.
- La sandbox di un thread cloud si mette in pausa tra i turni e riprende quando il thread continua. Se la sandbox non può essere ripresa, il thread continua da un clone fresco, quindi i cambiamenti non committati possono essere persi. Su compiti lunghi, chiedete a Claude di committare e spingere il lavoro in corso.
- Un project appartiene a un utente. Non puoi condividere un project o i suoi thread con un altro utente, e le trascrizioni dei thread non hanno l’opzione di condivisione che hanno altre sessioni cloud. Non ci sono controlli a livello di organizzazione per i project durante la beta.
- Un thread appartiene all’unico project che l’ha avviato. Non puoi spostare o copiare un thread in un altro project, o spostarlo fuori per stare da solo. Continue in project va solo nell’altro modo: porta il lavoro di una sessione cloud in un project. Non puoi fare il merge di due project in uno.
Risoluzione dei problemi
Per i prompt di configurazione di GitHub nella finestra di dialogo New project, vedi Configura l’accesso a GitHub.Un thread sembra bloccato
Claude non pubblica ogni passo che un thread compie, quindi un thread che mostra come in esecuzione senza nuovi messaggi nella conversazione del project di solito sta ancora funzionando. Un nuovo thread cloud provisiona anche il suo cloud environment prima che Claude inizi, quindi il suo primo aggiornamento richiede un momento. Apri il thread per leggere la sua trascrizione. Se il thread sta aspettando un prompt di permesso, rispondi lì.I thread hanno indovinato o si sono bloccati invece di chiedere
Quando più thread tornano avendo assunto qualcosa di sbagliato, hanno aggirato l’accesso mancante o si sono fermati con “bloccato”, la causa di solito è lo stesso gap nella configurazione del project piuttosto che un problema con ogni compito. Ordina quali thread sono solidi prima di correggere qualsiasi cosa:- Chiedi a Claude nella conversazione: “Per ogni thread aperto, elenca quello che gli hai chiesto di fare, cosa ha assunto o non poteva raggiungere e cosa sta aspettando.” Claude legge ogni thread e risponde nella conversazione.
- Per i thread che hanno iniziato da un’assunzione sbagliata, apri il thread da Overview e contrassegnalo come risolto dal suo menu, o digli cosa fare invece nella sua casella di messaggio. Il suo branch e qualsiasi pull request rimangono su GitHub finché non li elimini.
- Correggi il gap una volta, nelle istruzioni del project o nell’ambiente, quindi invia un thread prima di inviare il resto del lavoro di nuovo come nuovi thread.
Claude non ha risposto
La conversazione del project mostra un banner “Claude hasn’t responded” quando Claude è in esecuzione ma le sue risposte non raggiungono il project. Fai clic su Restart Claude sul banner, o vai a Project settings > General e fai clic su Restart nella riga Restart Claude. Claude si riconnette alla conversazione; qualsiasi risposta che stava scrivendo viene persa, e i thread non sono interessati.Errori di accesso al repository
Tre messaggi significano che un thread o il project non può raggiungere uno dei suoi repository. Un thread del project ha bisogno dei prerequisiti di GitHub anche quando le tue altre sessioni cloud clonano lo stesso repository senza problemi.- “Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository”, segnalato prima che il thread inizi, quando l’app Claude GitHub non è installata su quel repository, è sospesa o non è collegata all’account GitHub che hai connesso.
- “Unable to access your repository”, segnalato da un thread quando il suo clone fallisce: GitHub ha rifiutato il clone, il repository non è stato trovato sotto il nome che il project ha, o il branch da cui al thread è stato chiesto di iniziare non esiste.
- “Claude can’t access” un repository, mostrato quando salvi i repository nella finestra di dialogo New project o Project settings. Il messaggio continua con un link di installazione e un link di riconnessione. Usa il link di installazione se l’app Claude GitHub non è su quel repository, e il link di riconnessione se lo è, poiché l’app GitHub può essere installata su GitHub senza essere collegata all’account che hai connesso a Claude. Se il messaggio dice che l’app GitHub è sospesa o non include questo repository, segui il suo link a GitHub per correggere.
Un thread ha raggiunto il limite di utilizzo
Quando un thread o la conversazione del project raggiunge il limite di cinque ore o settimanale del tuo piano, continua a riprovare da solo e continua quando il limite si ripristina. Un thread che un’attività pianificata ha avviato non aspetta: il suo turno si ferma con un errore di limite, e gli invii un messaggio dopo che il limite si ripristina. Mentre un thread aspetta, mostra Service is busy con “Claude is still retrying and will continue automatically.” Non devi fare nulla perché il lavoro continui. Se preferisci che non usi la tua prossima finestra di utilizzo, fai clic su Stop nel thread, o metti in pausa il project per sospendere tutti i thread. Errori di limite di utilizzo spiegano i limiti e quando si ripristinano.Sono richiesti crediti di utilizzo aggiuntivi
Un thread o la conversazione del project ha fatto una richiesta che il tuo piano copre solo con crediti di utilizzo, come una a un modello o una dimensione di contesto che il tuo piano non include, e i crediti di utilizzo non sono attivati per il tuo account. Aggiungi crediti di utilizzo al tuo abbonamento copre chi può attivarli o comprarli su ogni piano. Una volta che i crediti sono disponibili, invia un altro messaggio per riprovare.Contatto perso con la tua cartella
Un thread in esecuzione sul tuo computer mostra questo quando la sessione Claude Code lì ha smesso di rispondere, di solito perché il computer è andato in sospensione o l’app desktop oclaude remote-control è uscito. Riattiva il computer. Se l’app desktop o claude remote-control non è più in esecuzione lì, avvialo di nuovo:
- App desktop: riapri l’app e conferma che Use this computer from your phone and claude.ai è ancora attivo in Settings > Code o Settings > Claude Code
- Terminale: esegui di nuovo
claude remote-controlnella stessa cartella
Altri messaggi
Questi messaggi nominano la loro stessa causa. La tabella fornisce il prossimo passo per ognuno.Risorse correlate
- Usa Claude Code nel cloud: come funzionano le sessioni cloud dietro ogni thread, incluse le opzioni di accesso a GitHub e auto-fix sulle pull request
- Configura cloud environment: cambia cosa i thread cloud possono raggiungere sulla rete, fornisci loro variabili d’ambiente e segreti di rete, e installa strumenti con uno script di configurazione
- Automatizza il lavoro con le attività pianificate: programmi, trigger e gestione per le attività pianificate, incluse quelle che Claude crea da un project
- Gestisci più agenti con agent view: esegui e traccia più sessioni sulla tua macchina quando il lavoro ha bisogno di strumenti o servizi che solo la tua macchina può raggiungere
- Projects redesigned: from folder to conversation: l’annuncio di lancio, con il ragionamento dietro la trasformazione di un project in una conversazione con Claude