# Claude Code Projects: koordinátor, szálak és a béta korlátai
> Hogyan működnek a Claude Code Projects felhőszálai: GitHub App, utasítások, memória, ütközések és a béta korlátai.
Source: https://ailoot.ai/blog/hu/claude-code-projects/
Canonical: https://ailoot.ai/blog/hu/claude-code-projects/
Language: hu
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-051
Revision: sha256-71e5bd4561533c034c32b9fa43a0cc72703aeebb8bb7fadb7cdd8dac0c83c1d8
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.
Az Ailoot használatára vonatkozó gyakorlati útmutató a [dokumentációban](https://ailoot.ai/docs/) található.
## 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](https://ailoot.ai/blog/hu/claude-code-nested-subagents/) 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](https://ailoot.ai/blog/hu/cursor-projects-coordinator-agents/) 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.
### Források
- [Claude Code Projects – az Anthropic hivatalos dokumentációja](https://code.claude.com/docs/en/claude-projects)
Az Ailoot felfedezését az [ailoot.ai](https://ailoot.ai/) oldalon folytathatod.
## Kérdések és válaszok: Claude Code Projects: koordinátor, szálak és a béta korlátai
### A párhuzamos munka önmagában indok Project létrehozására?
A Project több munkameneten át tartó, közös tárolóból, utasításból és memóriából profitáló célhoz való. Gyors helyi módosítás maradhat szokásos munkamenetben; a Projects-szálak elkülönített felhőkörnyezetekben dolgoznak.
### Mit nézzek meg, ha a szál nem tudja klónozni a tárolót?
A kapcsolt GitHub-fiók push-hozzáférését és a Claude GitHub App telepítését az adott tárolóra. A szokásos felhőmunkamenet meglévő tokenje a Project-szálakhoz nem elég.
## Ailoot · A vállalat és projektportfóliója
Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít.
A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.
Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.