Claude Code Projects: koordinátor, vlákna a obmedzenia beta verzie

Anthropic nedávno prepracoval Projects v Claude Code. Teraz ide o jednu koordinačnú konverzáciu, ktorá spúšťa paralelné cloudové relácie —vlákna— pre úlohy a prijíma od nich správy. Projekt sa oplatí vytvoriť, keď má vaša práca cieľ, ktorý presiahne jednu reláciu a vytvorí nové úlohy — napríklad vývoj repozitára GitHub počas niekoľkých týždňov. Samotná potreba paralelnej práce nestačí. Ak potrebujete rýchlo opraviť jeden súbor tu a teraz, postačí bežná relácia.

Prácu vedie koordinátor —dlhodobá konverzácia, v ktorej Claude rozhoduje, čo z vašej správy premeniť na úlohu pre vlákno. Vlákna píšu kód: každé je samostatná cloudová relácia Claude Code vo vlastnej vetve repozitára. Súčasne môže bežať niekoľko vlákien, každé s vlastným kontextom a vetvou. Koordinátor vidí, čo vlákno oznámi po dokončení, ale nie každý krok, ktorý vykoná. Oznámi vám dokončené pull requesty (žiadosti o zlúčenie zmien) a na váš pokyn požiada vlákno, aby ich upravilo alebo zlúčilo. Nižšie je prehľad založený na oficiálnej dokumentácii Anthropic: čo nastaviť, ako je práca usporiadaná a aké obmedzenia má beta verzia.

Beta verzia sa sprístupňuje postupne, najprv účtom Pro a Max, ktoré už používali cloudové relácie Claude Code a nevytvorili projekt v bežnom chate ani v Cowork. Ak sekciu Projects ešte nevidíte, môžete sa pridať na čakaciu listinu.

Čo je Claude Code Projects jednoduchými slovami#

Projekt je jedna dlhodobá konverzácia s koordinátorom, ku ktorej sú pripojené repozitáre, pamäť a pokyny. Píšete koordinátorovi a ten rozhodne, či odpovie hneď alebo spustí vlákno. Pre každú úlohu nemusíte manuálne otvárať novú reláciu.

Vlákno je plnohodnotná cloudová relácia Claude Code: má vlastný kontext a vetvu repozitára a podľa potreby otvorí pull request. Koordinátor môže mať otvorených niekoľko vlákien naraz — napríklad jedno opravuje chybu, druhé píše testy a tretie aktualizuje dokumentáciu — a pritom odpovedať na vaše otázky v hlavnej konverzácii.

Pre porovnanie si predstavte niekoľko kariet s lokálnymi reláciami Claude Code, každú vo vlastnej pracovnej kópii repozitára. Takáto kópia sa nazýva worktree — samostatný priečinok pre jednu vetvu, aby si lokálne relácie navzájom neprekážali. Medzi reláciami prepínate sami a rozhodujete, čo každej pridelíte. Cloudové vlákna worktree nepotrebujú: každé vlákno naklonuje repozitáre do vlastného izolovaného cloudového prostredia. Projects sa postará o koordináciu a rozhoduje, kedy vytvoriť nové vlákno a kedy to nie je potrebné.

Projekt má zdieľanú pamäť a pokyny, ktoré dostane každé nové vlákno. Časť o nastavení vysvetľuje, čo do nich uložiť a ako sa odovzdávajú vláknam.

Ako sa líši od bežnej relácie a tímu agentov#

Ak už v rámci jednej relácie Claude Code spúšťate vnorených subagentov, treba ich odlíšiť od tímov agentov a projektových vlákien. Tím agentov je ďalší spôsob delegovania práce: jedna relácia spustí relácie kolegov pre konkrétnu úlohu. Môžete ho spustiť na vlastnom počítači aj v cloudovej relácii.

• Tím agentov—relácie kolegov pre jednu konkrétnu úlohu, ktoré možno spustiť lokálne alebo v cloude. Nie sú to samostatné projektové vlákna.
• Projekt a jeho vlákna—práca prebieha v cloude. Každé vlákno je samostatná relácia vo vlastnej vetve a pokračuje v práci aj po zatvorení notebooku. Lokálna relácia nemôže byť súčasťou projektu.
• Zobrazenie Agent—obrazovka na sledovanie viacerých lokálnych relácií na vašom počítači. Nemá koordinátora: rozhodujete, čo každej pridelíte.

Oficiálna dokumentácia Anthropic osobitne zdôrazňuje, že samotná paralelná práca nie je dôvodom na vytvorenie projektu. V projekte Claude samo spúšťa relácie a prijíma ich správy a všetky relácie začínajú so zdieľanými repozitármi, pokynmi a pamäťou. Práca zostáva v cloude počas celej úlohy.

Podobný prístup —koordinátor rozdeľuje úlohy medzi agentov— je implementovaný v inom nástroji, ktorému sa venuje článok o Cursor Projects. Mechanizmus je odlišný, ale aj tam koordinátor rozhoduje, komu čo pridelí.

Čo nastaviť pred prvým projektom#

Pred vytvorením projektu skontrolujte tri veci.

1. Účet GitHub a Claude GitHub App. Ak ste už pripojili GitHub cez /web-setup, tento token poskytuje bežným cloudovým reláciám prístup k repozitáru. Pre projektové vlákna to nestačí: potrebujete pripojený účet GitHub s oprávnením push do repozitára a nainštalovanú aplikáciu Claude GitHub App pre daný repozitár. Bez nej vlákno nedokáže repozitár naklonovať ani otvoriť pull request.

2. Pokyny projektu. Pokyny projektu sú text s dĺžkou najviac 16 000 znakov, ktorý sa odosiela každému novému vláknu aj samotnému koordinátorovi. Uveďte sem informácie, ktoré by ste inak museli vysvetľovať znova v každej relácii: štruktúru repozitára, konvencie kódu a kontroly potrebné pred pull requestom.

3. Model a úroveň úsilia. Nový projekt predvolene spúšťa každé vlákno na modeli Opus s vysokým úsilím a koordinátora s nízkym úsilím. Dokumentácia uvádza, že toto nastavenie „najrýchlejšie čerpá váš plán“ (preklad; originál: draws on your plan fastest). Ak sú vaše úlohy jednoduché, môžete vybrať lacnejší model alebo znížiť úsilie v Project settings > General. Nastavenia vlákien a koordinátora sa menia samostatne; dokumentácia opisuje úspornejšie možnosti.

Pamäť projektu sa ukladá ako bežné súbory, pričom indexový súbor sa nazýva MEMORY.md. Každé nové vlákno si ho prečíta pri spustení a podľa potreby pristupuje k ostatným súborom. Zistenia uložené do pamäte jedným vláknom sú dostupné ďalšiemu bez toho, aby ste ich museli znovu vysvetľovať.

Čo robiť, ak vlákna menia ten istý kód#

Každé vlákno pracuje vo vlastnej vetve a v prípade potreby samo otvorí pull request. Koordinátor však nezaručuje, že sa úlohy nikdy nebudú prekrývať: ak sa niekoľko vlákien ocitne v rovnakej časti kódu, môžete príslušné vlákno požiadať, aby konflikt vyriešilo cez rozhranie. Vedľa jeho pull requestu je tlačidlo Resolve conflicts, ktoré pošle vláknu pokyn ako správu od vás.

Oficiálna dokumentácia odporúča uviesť v pokynoch projektu preferovaný počet vlákien: napríklad požiadať koordinátora, aby naraz spúšťal najviac dve vlákna alebo opätovne používal existujúce vlákno pre nové úlohy v rovnakej oblasti. Ide o preferenciu, ktorú sa koordinátor snaží dodržiavať, nie o pevný limit. Sama osebe nezaručuje, že sa vlákna nedostanú do konfliktu v rovnakom súbore — existujúci konflikt treba vyriešiť samostatne. Pri súvisiacich úlohách v rovnakej oblasti môžete opätovne použiť aktívne alebo nečinné vlákno. Ak bolo nečinné viac ako hodinu, po prijatí novej správy si znova prečíta celú históriu, čo ovplyvňuje čerpanie limitu predplatného.

Čím jasnejšie sú úlohy oddelené podľa súborov alebo modulov, tým jednoduchšie je pracovať paralelne. Samostatný článok opisuje rozdelenie veľkej úlohy na nezávislé časti: ako delegovať programovanie na tisíce agentov. Rozsah je iný, ale princíp rozdelenia práce je rovnaký.

Kým je vyrovnávacia pamäť konverzácie aktívna (v plánoch Pro a Max, počas jednej hodiny, ak to limity vášho plánu umožňujú), vlákno spotrebuje menej tokenov z limitu predplatného na opätovné spracovanie svojej histórie. Po vypršaní vyrovnávacej pamäte si vlákno pri prijatí novej správy pred začatím práce znova prečíta celú históriu. Pri novej nezávislej úlohe môže byť úspornejšie požiadať koordinátora, aby vytvoril nové vlákno: môže spotrebovať menej tokenov z toho istého limitu predplatného než pokračovanie v starej relácii s dlhou históriou po vypršaní jej vyrovnávacej pamäte.

Obmedzenia beta verzie, ktoré treba poznať vopred#

Pred vytvorením projektu pre dôležitú úlohu skontrolujte obmedzenia beta verzie:

• Dostupné iba v plánoch Pro a Max. Plány Team a Enterprise zatiaľ nie sú podporované.
• Limit 200 nových vlákien denne na účet, spoločne pre všetky projekty.
• Projekt patrí jednému používateľovi. Nemôžete udeliť inej osobe zdieľaný prístup k projektu ani k jednotlivému vláknu a beta nemá organizačné nastavenia pre tímy.
• Prístup iba cez claude.ai/code, desktopovú aplikáciu a mobilnú aplikáciu. Projects nefunguje v terminálovom CLI, cez Amazon Bedrock, Google Cloud Agent Platform ani Microsoft Foundry.
• Projekt nevidí lokálne súbory a nástroje. Vlákna pracujú s repozitármi GitHub, nahranými súbormi a priečinkami Google Drive, nie však s tým, čo existuje iba vo vašom počítači.

Ak potrebujete prístup k terminálu alebo k nástrojom dostupným iba vo vašom počítači, použite lokálnu reláciu alebo zobrazenie Agent pre niekoľko takýchto relácií. Ak má v jednom pracovnom priestore spolupracovať viac ľudí, Anthropic má samostatný produkt pre tímy v plánoch Team a Enterprise: Claude Tag. Funguje v kanáli Slack; každý člen môže zadať Claudovi úlohu a všetci v kanáli môžu sledovať a usmerňovať prácu. Projekt funguje inak: patrí iba vám. Ak potrebujete len konkrétne lokálne súbory, môžete ich nahrať do projektu a každé vlákno k nim potom bude mať prístup. To však neposkytuje prístup k lokálnym nástrojom.

Čo ďalej#

Pred presunom pracovného postupu do Projects skúste vytvoriť jeden testovací projekt v nekritickom repozitári: pripojte Claude GitHub App, napíšte krátke pokyny, zadajte koordinátorovi jednu nezávislú úlohu a sledujte, ako si s ňou poradí. Prvý pokus ukáže, či rozumiete rozhraniu koordinátora a vlákien. Neoverí paralelnú prácu, konflikty ani čerpanie limitu pri viacerých úlohách — tie treba otestovať samostatne.