Claude Code Projects: koordinatorius, gijos ir beta versijos apribojimai

Anthropic neseniai pertvarkė Claude Code Projects. Dabar tai viena koordinuojanti pokalbio sesija, kuri užduotims paleidžia lygiagrečias debesijos sesijas — gijas — ir gauna iš jų ataskaitas. Projektą verta kurti, kai jūsų darbas turi tikslą, kuris truks ilgiau nei viena sesija ir sukurs naujų užduočių, pavyzdžiui, kai kelias savaites kuriate GitHub saugyklą. Vien poreikio dirbti lygiagrečiai nepakanka. Jei reikia čia ir dabar greitai pataisyti vieną failą, pakanka įprastos sesijos.

Darbui vadovauja koordinatorius — ilgai trunkantis pokalbis, kuriame Claude nusprendžia, ką iš jūsų pranešimo paversti gijos užduotimi. Gijos rašo kodą: kiekviena yra atskira debesijos Claude Code sesija savo saugyklos šakoje. Vienu metu gali veikti kelios gijos, kiekviena turinti savo kontekstą ir šaką. Koordinatorius mato, ką gija praneša baigusi darbą, bet nemato kiekvieno jos atliekamo veiksmo. Jis praneša jums apie užbaigtas pull užklausas (pakeitimų sujungimo užklausas) ir, jums nurodžius, paprašo gijos jas pataisyti arba sujungti. Toliau pateikiama apžvalga, pagrįsta oficialia Anthropic dokumentacija: ką sukonfigūruoti, kaip organizuojamas darbas ir kokie beta versijos apribojimai taikomi.

Beta versija palaipsniui pradedama teikti Pro ir Max paskyroms, kurios jau naudojosi debesijos Claude Code sesijomis ir nėra sukūrusios projekto įprastame pokalbyje arba Cowork. Jei dar nematote Projects skilties, galite prisijungti prie laukiančiųjų sąrašo.

Kas yra Claude Code Projects, paprastai tariant#

Projektas yra vienas ilgai trunkantis pokalbis su koordinatoriumi, prie kurio prijungtos saugyklos, atmintis ir instrukcijos. Rašote koordinatoriui, o jis nusprendžia, ar atsakyti iš karto, ar paleisti giją. Nereikia kiekvienai užduočiai rankiniu būdu atidaryti naujos sesijos.

Gija yra visavertė debesijos Claude Code sesija: ji turi savo kontekstą ir saugyklos šaką, o prireikus atidaro pull užklausą. Koordinatorius gali vienu metu laikyti atviras kelias gijas — pavyzdžiui, viena taiso klaidą, kita rašo testus, o trečia atnaujina dokumentaciją — ir atsakinėti į jūsų klausimus pagrindiniame pokalbyje.

Palyginimui įsivaizduokite kelis skirtukus su vietinėmis Claude Code sesijomis, kiekvieną atskiroje saugyklos darbinėje kopijoje. Tokia kopija vadinama worktree — atskiru vienos šakos aplanku, kad vietinės sesijos netrukdytų viena kitai. Tarp sesijų perjungiate patys ir nusprendžiate, ką kiekvienai pavesti. Debesijos gijoms worktree nereikia: kiekviena gija klonuoja saugyklas į savo izoliuotą debesijos aplinką. Projects pasirūpina koordinavimu: nusprendžia, kada kurti naują giją, o kada jos nereikia.

Projektas turi bendrą atmintį ir instrukcijas, kurias gauna kiekviena nauja gija. Sąrankos skyriuje paaiškinama, ką jose išsaugoti ir kaip tai perduodama gijoms.

Kuo tai skiriasi nuo įprastos sesijos ir agentų komandos#

Jei vienoje Claude Code sesijoje jau naudojate įdėtinius subagentus, verta juos atskirti nuo agentų komandų ir projektų gijų. Agentų komanda yra dar vienas darbo delegavimo būdas: viena sesija paleidžia kolegų sesijas konkrečiai užduočiai atlikti. Ją galite naudoti ir savo kompiuteryje, ir debesijos sesijoje.

• Agentų komanda—kolegų sesijos konkrečiai užduočiai, kurias galima paleisti vietoje arba debesijoje. Tai nėra atskiros projekto gijos.
• Projektas ir jo gijos—darbas vyksta debesijoje. Kiekviena gija yra atskira sesija savo šakoje ir veikia toliau net uždarius nešiojamąjį kompiuterį. Vietinė sesija negali būti projekto dalis.
• Agentų rodinys—ekranas, kuriame galite stebėti kelias vietines sesijas savo kompiuteryje. Jame nėra koordinatoriaus: patys nusprendžiate, ką kiekvienai pavesti.

Oficialioje Anthropic dokumentacijoje atskirai pabrėžiama, kad vien lygiagretus darbas nėra priežastis kurti projektą. Projekte Claude pats paleidžia sesijas ir gauna jų ataskaitas, o visos sesijos pradedamos naudojant bendras saugyklas, instrukcijas ir atmintį. Visą užduoties vykdymo laiką darbas lieka debesijoje.

Panašus metodas — koordinatorius paskirsto užduotis agentams — įgyvendintas kitame įrankyje, apie kurį rašoma straipsnyje apie Cursor Projects. Mechanizmas kitoks, bet ir ten koordinatorius nusprendžia, kam ką pavesti.

Ką sukonfigūruoti prieš pirmą projektą#

Prieš kurdami projektą patikrinkite tris dalykus.

1. GitHub paskyra ir Claude GitHub App. Jei GitHub jau prijungėte per /web-setup, šis prieigos raktas suteikia įprastoms debesijos sesijoms prieigą prie saugyklos. Projektų gijoms to nepakanka: reikia prijungtos GitHub paskyros, turinčios push prieigą prie saugyklos, ir tai saugyklai įdiegtos Claude GitHub App. Be jos gija negalės nei klonuoti saugyklos, nei atidaryti pull užklausos.

2. Projekto instrukcijos. Projekto instrukcijos yra iki 16 000 simbolių ilgio tekstas, siunčiamas kiekvienai naujai gijai ir pačiam koordinatoriui. Čia įrašykite informaciją, kurią kitu atveju turėtumėte iš naujo aiškinti per kiekvieną sesiją: saugyklos struktūrą, kodo konvencijas ir patikras, kurias reikia atlikti prieš atidarant pull užklausą.

3. Modelis ir pastangų lygis. Pagal numatytuosius nustatymus naujame projekte kiekviena gija veikia su Opus modeliu ir didelėmis pastangomis, o koordinatorius — su mažomis pastangomis. Dokumentacijoje nurodoma, kad šis nustatymas „greičiausiai išeikvoja jūsų plano limitą“ (vertimas; originalas: draws on your plan fastest). Jei jūsų užduotys nesudėtingos, galite pasirinkti pigesnį modelį arba sumažinti pastangų lygį skiltyje Project settings > General. Gijų ir koordinatoriaus nustatymai keičiami atskirai; dokumentacijoje aprašytos taupesnės parinktys.

Projekto atmintis saugoma kaip įprasti failai, o rodyklės failas vadinamas MEMORY.md. Kiekviena nauja gija jį perskaito paleidžiama ir prireikus pasiekia kitus failus. Vienos gijos į atmintį įrašyti radiniai tampa prieinami kitai gijai, todėl jų nereikia pasakoti iš naujo.

Ką daryti, jei gijos keičia tą patį kodą#

Kiekviena gija dirba savo šakoje ir, jei to reikia, pati atidaro pull užklausą. Tačiau koordinatorius negarantuoja, kad užduotys niekada nesidubliuos: jei kelios gijos pradeda dirbti toje pačioje kodo vietoje, galite per sąsają paprašyti atitinkamos gijos išspręsti konfliktą. Šalia jos pull užklausos yra mygtukas Resolve conflicts, kuris nusiunčia gijai jūsų vardu suformuluotą nurodymą.

Oficialioje dokumentacijoje siūloma projekto instrukcijose nurodyti pageidaujamą gijų skaičių: pavyzdžiui, paprašyti koordinatoriaus vienu metu paleisti ne daugiau kaip dvi gijas arba naujoms tos pačios srities užduotims pakartotinai naudoti esamą giją. Tai yra pageidavimas, kurio koordinatorius stengiasi laikytis, o ne griežtas apribojimas. Vien šis nurodymas negarantuoja, kad gijos nesusidurs tame pačiame faile — esamą konfliktą reikia išspręsti atskirai. Susijusioms užduotims toje pačioje srityje galite pakartotinai naudoti aktyvią arba neaktyvią giją. Jei ji buvo neaktyvi ilgiau nei valandą, gavusi naują pranešimą ji iš naujo perskaito visą istoriją, o tai turi įtakos prenumeratos limito naudojimui.

Kuo aiškiau užduotys atskirtos pagal failus ar modulius, tuo lengviau dirbti lygiagrečiai. Atskiras straipsnis aprašo, kaip didelę užduotį suskaidyti į nepriklausomas dalis: kaip programavimo užduotis deleguoti tūkstančiams agentų. Mastas skiriasi, tačiau darbo skaidymo principas tas pats.

Kol pokalbio podėlis aktyvus (Pro ir Max planuose, iki valandos, jei leidžia jūsų plano limitai), gija sunaudoja mažiau prenumeratos limito tokenų pakartotinai apdorodama savo istoriją. Podėliui nustojus galioti, gavusi naują pranešimą gija prieš pradėdama darbą iš naujo perskaito visą savo istoriją. Naują nepriklausomą užduotį gali būti taupiau pavesti koordinatoriui sukurti naują giją: tai gali sunaudoti mažiau tokenų iš to paties prenumeratos limito nei tęsti seną sesiją su ilga istorija pasibaigus jos podėlio galiojimo laikui.

Beta versijos apribojimai, kuriuos verta žinoti iš anksto#

Prieš kurdami projektą svarbiai užduočiai, patikrinkite beta versijos apribojimus:

• Prieinama tik Pro ir Max planuose. Team ir Enterprise planai dar nepalaikomi.
• Ne daugiau kaip 200 naujų gijų per dieną vienai paskyrai, bendrai visuose projektuose.
• Projektas priklauso vienam naudotojui. Negalite suteikti kitam asmeniui bendros prieigos prie projekto ar atskiros gijos, o beta versijoje nėra komandų organizacijos nustatymų.
• Prieinama tik per claude.ai/code, darbalaukio programą ir mobiliąją programą. Projects neveikia terminalo CLI, per Amazon Bedrock, Google Cloud Agent Platform ar Microsoft Foundry.
• Projektas negali pasiekti vietinių failų ir įrankių. Gijos dirba su GitHub saugyklomis, įkeltais failais ir Google Drive aplankais, bet ne su tuo, kas yra tik jūsų kompiuteryje.

Jei reikia prieigos prie terminalo arba tik jūsų kompiuteryje pasiekiamų įrankių, naudokite vietinę sesiją arba agentų rodinį kelioms tokioms sesijoms. Jei keliems žmonėms reikia dirbti kartu toje pačioje darbo srityje, Anthropic turi atskirą produktą komandoms, naudojančioms Team ir Enterprise planus: Claude Tag. Jis veikia Slack kanale; bet kuris narys gali pavesti Claude užduotį, o visi kanalo nariai gali stebėti ir nukreipti darbą. Projektas veikia kitaip: jis priklauso tik jums. Jei jums reikia tik konkrečių vietinių failų, galite juos įkelti į projektą ir tada kiekviena gija galės juos pasiekti. Taip prieigos prie vietinių įrankių nesuteikiama.

Kas toliau#

Prieš perkeldami savo darbo eigą į Projects, pabandykite sukurti vieną bandomąjį projektą nekritinėje saugykloje: prijunkite GitHub App, parašykite trumpas instrukcijas, skirkite koordinatoriui vieną nepriklausomą užduotį ir pažiūrėkite, kaip jis ją atliks. Šis pirmasis bandymas parodys, ar suprantate koordinatoriaus ir gijų sąsają. Jis nepatikrina lygiagretaus darbo, konfliktų ar limito naudojimo atliekant kelias užduotis — tai reikia išbandyti atskirai.