Claude Code Projects: koordinaattori, ketjut ja beetaversion rajoitukset

Anthropic uudisti hiljattain Claude Coden Projectsin. Nyt se on yksi koordinoiva keskustelu, joka käynnistää rinnakkaisia pilvi-istuntoja eli ketjuja tehtäviä varten ja vastaanottaa niiltä raportteja. Projekti kannattaa luoda, kun työlläsi on tavoite, joka kestää yhtä istuntoa pidempään ja synnyttää uusia tehtäviä – esimerkiksi GitHub-repositorion kehittäminen useiden viikkojen ajan. Pelkkä rinnakkaisen työn tarve ei riitä. Jos sinun tarvitsee korjata nopeasti yksi tiedosto tässä ja nyt, tavallinen istunto riittää.

Työtä johtaa koordinaattori – pitkäikäinen keskustelu, jossa Claude päättää, mistä viestisi sisällöstä muodostetaan ketjulle annettava tehtävä. Ketjut kirjoittavat koodin: kukin on erillinen Claude Coden pilvi-istunto omalla repositoriohaarallaan. Useita ketjuja voi olla käynnissä yhtä aikaa, ja kullakin on oma kontekstinsa ja haaransa. Koordinaattori näkee, mitä ketju raportoi valmistuttuaan, mutta ei jokaista sen tekemää vaihetta. Se ilmoittaa sinulle valmiista pull requesteista (muutosten yhdistämispyynnöistä) ja pyytää kehotuksestasi ketjua muokkaamaan tai yhdistämään ne. Alla on Anthropicin viralliseen dokumentaatioon perustuva yleiskatsaus: mitä pitää määrittää, miten työ järjestetään ja mitä rajoituksia beetaversiossa on.

Beetaversio tulee saataville vaiheittain. Ensimmäisinä sen saavat Pro- ja Max-tilit, joilla on jo käytetty Claude Coden pilvi-istuntoja eikä ole luotu projektia tavallisessa chatissa tai Coworkissa. Jos Projects-osio ei vielä näy, voit liittyä odotuslistalle.

Mitä Claude Code Projects tarkoittaa yksinkertaisesti#

Projekti on yksi pitkäikäinen keskustelu koordinaattorin kanssa, johon on liitetty repositorioita, muistia ja ohjeita. Kirjoitat koordinaattorille, joka päättää, vastaako se heti vai käynnistääkö ketjun. Sinun ei tarvitse avata manuaalisesti uutta istuntoa jokaista tehtävää varten.

Ketju on täysimittainen Claude Coden pilvi-istunto: sillä on oma konteksti ja repositoriohaara, ja se avaa tarvittaessa pull requestin. Koordinaattori voi pitää useita ketjuja auki samanaikaisesti – esimerkiksi yksi korjaa virheen, toinen kirjoittaa testejä ja kolmas päivittää dokumentaatiota – ja vastata samalla kysymyksiisi pääkeskustelussa.

Vertailun vuoksi kuvittele useita välilehtiä, joissa on paikallisia Claude Code -istuntoja, kukin omassa repositorion työkopiossaan. Tällaista kopiota kutsutaan worktreeksi – se on erillinen kansio yhdelle haaralle, jotta paikalliset istunnot eivät häiritse toisiaan. Vaihdat itse istuntojen välillä ja päätät, mitä kullekin annetaan tehtäväksi. Pilviketjut eivät tarvitse worktree-rakennetta: kukin ketju kloonaa repositoriot omaan eristettyyn pilviympäristöönsä. Projects huolehtii koordinoinnista ja päättää, milloin uusi ketju luodaan ja milloin sitä ei tarvita.

Projektilla on yhteinen muisti ja ohjeet, jotka jokainen uusi ketju saa. Määritysosiossa kerrotaan, mitä niihin kannattaa tallentaa ja miten ne välitetään ketjuille.

Miten se eroaa tavallisesta istunnosta ja agenttitiimistä#

Jos käytät jo sisäkkäisiä aliagentteja yhdessä Claude Code -istunnossa, ne kannattaa erottaa agenttitiimeistä ja projektiketjuista. Agenttitiimi on toinen tapa delegoida työtä: yksi istunto käynnistää tiimikavereiden istuntoja tiettyä tehtävää varten. Sitä voi käyttää sekä omalla koneella että pilvi-istunnossa.

• Agenttitiimi – tiimikavereiden istuntoja yhtä tiettyä tehtävää varten; ne voidaan käynnistää paikallisesti tai pilvessä. Ne eivät ole erillisiä projektiketjuja.
• Projekti ja sen ketjut – työ tehdään pilvessä. Kukin ketju on erillinen istunto omalla haarallaan, ja se jatkaa toimintaansa, vaikka sulkisit kannettavan tietokoneesi. Paikallinen istunto ei voi olla osa projektia.
• Agenttinäkymä – näyttö, josta voit seurata useita koneellasi toimivia paikallisia istuntoja. Siinä ei ole koordinaattoria: päätät itse, mitä kullekin annetaan tehtäväksi.

Anthropicin virallisessa dokumentaatiossa tuodaan esiin erillinen huomio: rinnakkainen työ yksinään ei ole syy luoda projektia. Projektissa Claude käynnistää istunnot ja vastaanottaa niiden raportit itse, ja kaikki istunnot aloittavat yhteisillä repositorioilla, ohjeilla ja muistilla. Työ pysyy pilvessä koko tehtävän ajan.

Samankaltainen lähestymistapa, jossa koordinaattori jakaa tehtäviä agenteille, on toteutettu toisessa työkalussa, jota käsitellään artikkelissa Cursor Projects. Mekanismi on erilainen, mutta koordinaattori päättää siinäkin, kenelle mitä annetaan tehtäväksi.

Mitä kannattaa määrittää ennen ensimmäistä projektia#

Tarkista kolme asiaa ennen projektin luomista.

1. GitHub-tili ja Claude GitHub App. Jos olet jo yhdistänyt GitHubin /web-setup-komennon kautta, kyseinen token antaa tavallisille pilvi-istunnoillesi pääsyn repositorioon. Se ei riitä projektiketjuille: tarvitset yhdistetyn GitHub-tilin, jolla on push-oikeudet repositorioon, ja Claude GitHub Appin on oltava asennettuna kyseiseen repositorioon. Ilman sitä ketju ei voi kloonata repositoriota eikä avata pull requestia.

2. Projektin ohjeet. Projektin ohjeet ovat enintään 16 000 merkin mittainen teksti, joka lähetetään jokaiselle uudelle ketjulle ja myös koordinaattorille. Lisää tähän tiedot, jotka muuten joutuisit selittämään uudelleen jokaisessa istunnossa: repositorion rakenne, koodikäytännöt ja tarkistukset, jotka pitää tehdä ennen pull requestia.

3. Malli ja työskentelytaso. Oletusarvoisesti uusi projekti käyttää jokaisessa ketjussa Opus-mallia suurella työskentelytasolla ja koordinaattorissa matalalla tasolla. Dokumentaation mukaan tämä asetus ”käyttää suunnitelmasi käyttövaran nopeimmin” (käännös; alkuperäinen: draws on your plan fastest). Jos tehtäväsi ovat suoraviivaisia, voit valita edullisemman mallin tai laskea työskentelytasoa kohdassa Project settings > General. Ketjujen ja koordinaattorin asetuksia muutetaan erikseen; dokumentaatiossa kuvataan taloudellisempia vaihtoehtoja.

Projektin muisti tallennetaan tavallisina tiedostoina, ja hakemistotiedoston nimi on MEMORY.md. Jokainen uusi ketju lukee sen käynnistyessään ja käyttää muita tiedostoja tarpeen mukaan. Kun yhden ketjun havainnot tallennetaan muistiin, seuraava ketju voi käyttää niitä ilman, että niitä tarvitsee kertoa uudelleen.

Mitä tehdä, jos ketjut muuttavat samaa koodia#

Kukin ketju työskentelee omalla haarallaan ja avaa itse pull requestin, jos työ sitä edellyttää. Koordinaattori ei kuitenkaan takaa, etteivät tehtävät koskaan mene päällekkäin: jos useampi ketju päätyy samalle koodialueelle, voit pyytää asianomaista ketjua ratkaisemaan ristiriidan käyttöliittymässä. Sen pull requestin vieressä on Resolve conflicts -painike, joka lähettää ketjulle ohjeen sinun lähettämänäsi viestinä.

Virallisessa dokumentaatiossa ehdotetaan, että projektin ohjeissa määritetään toiveet ketjujen määrästä: voit esimerkiksi pyytää koordinaattoria käynnistämään enintään kaksi ketjua kerrallaan tai käyttämään uudelleen olemassa olevaa ketjua saman alueen uusissa tehtävissä. Tämä on koordinaattorin noudattama toive, ei ehdoton raja. Se ei yksin takaa, etteivät ketjut törmää samaan tiedostoon – olemassa oleva ristiriita on ratkaistava erikseen. Saman alueen toisiinsa liittyvissä tehtävissä voit käyttää uudelleen aktiivista tai joutilaana olevaa ketjua. Jos se on ollut joutilaana yli tunnin, se lukee koko historian uudelleen saadessaan uuden viestin, mikä vaikuttaa tilauksen käyttövaran kulutukseen.

Mitä selvemmin tehtävät on jaettu tiedostojen tai moduulien mukaan, sitä helpompi niitä on tehdä rinnakkain. Erillisessä artikkelissa käsitellään suuren tehtävän jakamista itsenäisiin osiin: miten koodausta delegoidaan tuhansille agenteille. Mittakaava on erilainen, mutta työn jakamisen periaate on sama.

Kun keskustelun välimuisti on aktiivinen (Pro- ja Max-tilauksilla tunnin sisällä, jos tilauksen rajat sen sallivat), ketju käyttää vähemmän tilauksen käyttövaraan kuuluvia tokeneita historiansa uudelleenkäsittelyyn. Kun välimuisti vanhenee, ketju lukee koko historian uudelleen saadessaan uuden viestin ennen työn aloittamista. Uuden erillisen tehtävän kohdalla voi olla taloudellisempaa pyytää koordinaattoria luomaan uusi ketju: se voi käyttää vähemmän tokeneita samasta tilauksen käyttövarasta kuin vanhan, pitkän historian sisältävän istunnon jatkaminen välimuistin vanhennuttua.

Beetaversion rajoitukset, jotka kannattaa tietää etukäteen#

Tarkista beetaversion rajoitukset ennen kuin luot projektin tärkeää tehtävää varten:

• Saatavilla vain Pro- ja Max-tilauksilla. Team- ja Enterprise-tilauksia ei vielä tueta.
• Enintään 200 uutta ketjua päivässä tiliä kohti, yhteensä kaikissa projekteissa.
• Projekti kuuluu yhdelle käyttäjälle. Et voi antaa toiselle henkilölle jaettua käyttöoikeutta projektiin tai yksittäiseen ketjuun, eikä beetaversiossa ole organisaation tiimiasetuksia.
• Käytettävissä vain claude.ai/coden, työpöytäsovelluksen ja mobiilisovelluksen kautta. Projects ei toimi terminaalin CLI:ssä, Amazon Bedrockin, Google Cloud Agent Platformin tai Microsoft Foundryn kautta.
• Projekti ei näe paikallisia tiedostoja tai työkaluja. Ketjut toimivat GitHub-repositorioiden, ladattujen tiedostojen ja Google Drive -kansioiden kanssa, mutta eivät sellaisten asioiden kanssa, jotka ovat vain omalla koneellasi.

Jos tarvitset terminaaliyhteyden tai pääsyn vain omalla koneellasi oleviin työkaluihin, käytä paikallista istuntoa tai agenttinäkymää useille tällaisille istunnoille. Jos useiden ihmisten pitää tehdä yhteistyötä samassa työtilassa, Anthropicilla on erillinen tuote Team- ja Enterprise-tilausten tiimeille: Claude Tag. Se toimii Slack-kanavalla: kuka tahansa jäsen voi antaa Claudelle tehtävän, ja kaikki kanavalla voivat nähdä ja ohjata työtä. Projekti toimii eri tavalla: se kuuluu vain sinulle. Jos tarvitset vain tiettyjä paikallisia tiedostoja, voit ladata ne projektiin, jolloin jokaisella ketjulla on pääsy niihin. Tämä ei anna pääsyä paikallisiin työkaluihin.

Mitä seuraavaksi#

Ennen kuin siirrät työnkulkusi Projectsiin, kokeile luoda yksi testiprojekti ei-kriittiseen repositorioon: yhdistä GitHub App, kirjoita lyhyet ohjeet, anna koordinaattorille yksi itsenäinen tehtävä ja katso, miten se hoitaa sen. Ensimmäinen kokeilu näyttää, ymmärrätkö koordinaattorin ja ketjujen käyttöliittymän. Se ei kerro rinnakkaisesta työstä, ristiriidoista tai useiden tehtävien käyttövaran kulutuksesta – ne on testattava erikseen.