Claude Code Projects: koordinátor, szálak és a béta korlátai

Az Anthropic nemrég átalakította a Claude Code Projects működését. Mostantól egyetlen koordináló beszélgetésről van szó, amely párhuzamos felhőmunkameneteket – szálakat – indít a feladatokhoz, majd jelentéseket kap tőlük. Akkor érdemes projektet létrehozni, ha a munkádnak olyan célja van, amely túlmutat egyetlen munkameneten, és új feladatokat eredményez – például egy GitHub-tároló több héten át tartó fejlesztése. Önmagában a párhuzamos munkavégzés igénye nem elég. Ha most rögtön egyetlen fájlt kell kijavítanod, egy hagyományos munkamenet is elegendő.

A munkát egy koordinátor vezeti: ez egy hosszú életű beszélgetés, amelyben Claude eldönti, hogy az üzenetedből milyen feladatot adjon át egy szálnak. A kódot a szálak írják: mindegyik különálló, felhőbeli Claude Code-munkamenet, saját tárolóágon. Egyszerre több szál is futhat, mindegyik saját kontextussal és ággal. A koordinátor látja, mit jelent egy szál a munka befejezésekor, de nem látja minden egyes lépését. Jelenti neked az elkészült pull requesteket (a módosítások egyesítésére irányuló kéréseket), és a kérésedre felkéri a szálat azok átdolgozására vagy egyesítésére. Az alábbi áttekintés az Anthropic hivatalos dokumentációján alapul: mit kell beállítani, hogyan szerveződik a munka, és milyen korlátai vannak a bétának.

A béta fokozatosan válik elérhetővé, elsőként azoknak a Pro és Max fiókoknak, amelyek már használtak felhőbeli Claude Code-munkameneteket, és még nem hoztak létre projektet a normál csevegésben vagy a Coworkben. Ha még nem látod a Projects részt, feliratkozhatsz a várólistára.

Mi az a Claude Code Projects, egyszerűen?#

A projekt egyetlen, hosszú életű beszélgetés egy koordinátorral, amelyhez tárolók, memória és utasítások tartoznak. Te a koordinátornak írsz, ő pedig eldönti, hogy azonnal válaszoljon-e, vagy indítson egy szálat. Nem kell minden feladathoz kézzel új munkamenetet nyitnod.

A szál egy teljes értékű felhőbeli Claude Code-munkamenet: saját kontextusa és tárolóága van, és szükség esetén pull requestet nyit. A koordinátor egyszerre több szálat is nyitva tarthat – például az egyik hibát javít, a másik teszteket ír, a harmadik pedig frissíti a dokumentációt –, miközben a fő beszélgetésben válaszol a kérdéseidre.

Összehasonlításként képzelj el több lapot, mindegyiken egy-egy helyi Claude Code-munkamenettel, mindegyik a tároló saját munkapéldányában. Az ilyen példányt worktree-nek nevezik: egy külön mappának egyetlen ághoz, hogy a helyi munkamenetek ne zavarják egymást. Te váltasz a munkamenetek között, és te döntöd el, melyiknek mit adsz feladatul. A felhőbeli szálaknak nincs szükségük worktree-re: mindegyik a saját elszigetelt felhőkörnyezetébe klónozza a tárolókat. A Projects gondoskodik a koordinációról: eldönti, mikor kell új szálat indítani, és mikor felesleges.

A projekt közös memóriát és utasításokat tartalmaz, amelyeket minden új szál megkap. A beállításokról szóló rész ismerteti, mit érdemes ezekben elmenteni, és hogyan jutnak el a szálakhoz.

Miben különbözik a hagyományos munkamenettől és az ügynökcsapattól?#

Ha már futtatsz beágyazott alügynököket egyetlen Claude Code-munkameneten belül, érdemes megkülönböztetni őket az ügynökcsapatoktól és a projekt szálaitól. Az ügynökcsapat a munka delegálásának egy másik módja: egy munkamenet társmunkatársak munkameneteit indítja el egy konkrét feladathoz. Helyi gépen és felhőbeli munkameneten belül is használhatod.

• Ügynökcsapat – társmunkatársak munkamenetei egy konkrét feladathoz; helyben és a felhőben is elindíthatók. Ezek nem külön projekt szálai.
• Projekt és annak szálai – a munka a felhőben fut. Minden szál külön munkamenet a saját ágán, és akkor is fut tovább, ha bezárod a laptopodat. Helyi munkamenet nem lehet egy projekt része.
• Ügynöknézet – képernyő, amelyen megfigyelheted a gépeden futó több helyi munkamenetet. Nincs koordinátora: te döntöd el, melyiknek mit adsz feladatul.

Az Anthropic hivatalos dokumentációja külön kiemeli: önmagában a párhuzamos munkavégzés nem indok projekt létrehozására. Egy projektben Claude maga indítja el a munkameneteket és fogadja a jelentéseiket, és minden munkamenet közös tárolókkal, utasításokkal és memóriával indul. A feladat teljes ideje alatt a munka a felhőben marad.

Hasonló megközelítést – egy koordinátor feladatokat oszt ki az ügynököknek – valósít meg egy másik eszköz is, amelyről a Cursor Projects című cikk szól. A mechanizmus más, de ott is a koordinátor dönti el, kinek mit adjon feladatul.

Mit állíts be az első projekted előtt?#

Projekt létrehozása előtt ellenőrizz három dolgot.

1. GitHub-fiók és Claude GitHub App. Ha már összekapcsoltad a GitHubot a /web-setup segítségével, ez a token hozzáférést ad a tárolóhoz a hagyományos felhőbeli munkamenetek számára. A projekt szálaihoz ez nem elég: összekapcsolt GitHub-fiókra van szükséged, amely push-hozzáféréssel rendelkezik a tárolóhoz, és telepíteni kell a Claude GitHub Appot az adott tárolóhoz. Ezek nélkül a szál nem tudja klónozni a tárolót vagy pull requestet nyitni.

2. Projektutasítások. A projektutasítás legfeljebb 16 000 karakteres szöveg, amelyet minden új szál és maga a koordinátor is megkap. Írd ide azokat az információkat, amelyeket egyébként minden munkamenetben újra el kellene magyaráznod: a tároló szerkezetét, a kódolási konvenciókat és a pull request előtt kötelező ellenőrzéseket.

3. Modell és erőfeszítési szint. Alapértelmezés szerint egy új projekt minden szálát Opus modellel, magas erőfeszítési szinten futtatja, a koordinátort pedig alacsony erőfeszítési szinten. A dokumentáció szerint ez a beállítás „a leggyorsabban fogyasztja a csomagod keretét” (fordítás; az eredeti: draws on your plan fastest). Ha a feladataid egyszerűek, választhatsz olcsóbb modellt, vagy csökkentheted az erőfeszítési szintet a Project settings > General menüpontban. A szál és a koordinátor beállításai külön módosíthatók; a dokumentáció takarékosabb lehetőségeket is ismertet.

A projektmemória közönséges fájlokként tárolódik, egy MEMORY.md nevű indexfájllal. Minden új szál induláskor elolvassa ezt, a többi fájlhoz pedig szükség szerint fér hozzá. Ha az egyik szál elmenti a megállapításait a memóriába, a következő szál is eléri azokat anélkül, hogy újra el kellene mondani neki.

Mi a teendő, ha a szálak ugyanazt a kódot módosítják?#

Minden szál a saját ágán dolgozik, és maga nyit pull requestet, ha a munkához szükséges. A koordinátor azonban nem garantálja, hogy a feladatok soha nem fedik át egymást: ha több szál ugyanahhoz a kódrészhez jut, megkérheted az érintett szálat, hogy az interfészen keresztül oldja fel az ütközést. A pull request melletti Resolve conflicts gomb üzenetként küldi el az utasításodat a szálnak.

A hivatalos dokumentáció azt javasolja, hogy a projektutasításokban add meg a szálak számával kapcsolatos preferenciáidat: például kérd meg a koordinátort, hogy egyszerre legfeljebb két szálat indítson, vagy használjon újra egy meglévő szálat az ugyanahhoz a területhez tartozó új feladatoknál. Ez olyan preferencia, amelyet a koordinátor igyekszik követni, nem pedig szigorú korlát. Önmagában nem garantálja, hogy a szálak nem ütköznek ugyanabban a fájlban – egy már kialakult ütközést külön kell feloldani. Az ugyanahhoz a területhez kapcsolódó feladatokhoz aktív vagy tétlen szálat is újra felhasználhatsz. Ha egy szál több mint egy órán át tétlen volt, új üzenet érkezésekor újraolvassa a teljes előzményt, ami befolyásolja az előfizetés felhasználási keretét.

Minél világosabban különülnek el a feladatok fájlok vagy modulok szerint, annál könnyebb párhuzamosan dolgozni. Egy külön cikk azt mutatja be, hogyan lehet egy nagy feladatot független részekre bontani: hogyan lehet a kódolást több ezer ügynöknek delegálni. Ott más a lépték, de a munka felosztásának elve ugyanaz.

Amíg a beszélgetési gyorsítótár aktív (Pro és Max csomagban egy órán belül, ha a csomagod korlátai ezt lehetővé teszik), a szál kevesebb tokent használ fel az előfizetési keretből az előzmények újbóli feldolgozására. A gyorsítótár lejárta után a szál új üzenet érkezésekor, a munka megkezdése előtt újraolvassa a teljes előzményt. Egy új, független feladathoz takarékosabb lehet megkérni a koordinátort, hogy hozzon létre egy új szálat: ez kevesebb tokent használhat fel ugyanabból az előfizetési keretből, mint egy régi, hosszú előzményű munkamenet folytatása a gyorsítótár lejárta után.

A béta előre ismert korlátai#

Fontos feladat projektbe helyezése előtt ellenőrizd a béta korlátait:

• Csak Pro és Max csomagban érhető el. A Team és az Enterprise még nem támogatott.
• Fiókonként naponta legfeljebb 200 új szál hozható létre, az összes projektet együtt számolva.
• A projekt egyetlen felhasználóhoz tartozik. Nem oszthatod meg másokkal sem a projektet, sem egy adott szálat, a bétában pedig nincsenek csapatokhoz használható szervezeti beállítások.
• Csak a claude.ai/code-on, az asztali alkalmazásban és a mobilalkalmazásban érhető el. A Projects nem működik a terminálos CLI-ben, az Amazon Bedrockon, a Google Cloud Agent Platformon vagy a Microsoft Foundryn keresztül.
• A projekt nem látja a helyi fájlokat és eszközöket. A szálak GitHub-tárolókkal, feltöltött fájlokkal és Google Drive-mappákkal dolgoznak, a csak a gépeden található dolgokkal viszont nem.

Ha terminálhozzáférésre vagy csak a gépeden elérhető eszközökre van szükséged, használj helyi munkamenetet, vagy több ilyen munkamenethez az ügynöknézetet. Ha több embernek kell egy munkaterületen együtt dolgoznia, az Anthropic külön terméket kínál a Team és Enterprise csomagokhoz: a Claude Taget. Ez egy Slack-csatornában működik; bármelyik tag adhat feladatot Claude-nak, a csatorna minden résztvevője pedig láthatja és irányíthatja a munkát. A projekt másképp működik: csak hozzád tartozik. Ha csak bizonyos helyi fájlokra van szükséged, feltöltheted őket a projektbe, és így mindegyik szál hozzáférhet. Ez nem biztosít hozzáférést a helyi eszközökhöz.

Mi legyen a következő lépés?#

Mielőtt áthelyeznéd a munkafolyamatodat a Projectsbe, próbálj létrehozni egy tesztprojektet egy nem kritikus tárolón: csatlakoztasd a GitHub Appot, írj rövid utasításokat, adj a koordinátornak egy független feladatot, és figyeld meg, hogyan kezeli. Ez az első próba megmutatja, érted-e a koordinátor és a szálak kezelőfelületét. A párhuzamos munkát, az ütközéseket és a több feladat együttes keretfelhasználását nem vizsgálja – ezeket külön kell tesztelni.