Claude Code Projects: үйлестіруші, ағындар және бета-нұсқаның шектеулері

Anthropic жақында Claude Code ішіндегі Projects мүмкіндігін жаңартты. Енді ол параллель бұлттық сессияларды — ағындарды — тапсырмаларға іске қосып, олардан есеп алатын бір үйлестіруші әңгімеден тұрады. Егер жұмысыңыздың мақсаты бір сессиядан ұзаққа созылып, жаңа тапсырмалар туындататын болса, мысалы, GitHub репозиторийін бірнеше апта бойы дамыту қажет болса, жоба ашқан жөн. Тек параллель жұмыс істеу қажеттігінің өзі жеткіліксіз. Егер дәл қазір бір файлды жылдам түзету керек болса, кәдімгі сессия жеткілікті.

Жұмысты үйлестіруші басқарады — бұл ұзақ уақытқа созылатын әңгімеде Claude сіздің хабарламаңыздан ағынға арналған тапсырманы анықтайды. Кодты ағындар жазады: әрқайсысы өз репозиторий тармағында жұмыс істейтін бөлек бұлттық Claude Code сессиясы. Әрқайсысының өз контексті мен тармағы бар бірнеше ағын бір уақытта жұмыс істей алады. Үйлестіруші ағын аяқталғандағы есебін көреді, бірақ оның әр қадамын көрмейді. Ол сізге аяқталған pull request-терді (өзгерістерді біріктіру туралы сұрауларды) хабарлайды және сіздің пәрменіңіз бойынша ағыннан оларды қайта қарауды немесе біріктіруді сұрайды. Төменде Anthropic-тің ресми құжаттамасына негізделген шолу берілген: нені баптау керек, жұмыс қалай ұйымдастырылады және бета-нұсқада қандай шектеулер бар.

Бета-нұсқа біртіндеп қолжетімді болып жатыр: алдымен бұлттық Claude Code сессияларын қолданып көрген және кәдімгі чатта не Cowork ішінде жоба ашпаған Pro және Max есептік жазбаларына ұсынылады. Projects бөлімін әлі көрмесеңіз, күту тізіміне жазыла аласыз.

Claude Code Projects деген не: қарапайым тілмен#

Жоба — үйлестірушісі бар, репозиторийлер, жад және нұсқаулар тіркелген ұзақ мерзімді бір әңгіме. Сіз үйлестірушіге жазасыз, ал ол бірден жауап беру немесе ағынды іске қосу керегін шешеді. Әр тапсырма үшін жаңа сессияны қолмен ашудың қажеті жоқ.

Ағын — толыққанды бұлттық Claude Code сессиясы: оның өз контексті мен репозиторий тармағы болады және қажет болса pull request ашады. Үйлестіруші бір уақытта бірнеше ағынды ашық ұстай алады — мысалы, бірі қатені түзетеді, екіншісі тест жазады, үшіншісі құжаттаманы жаңартады — әрі негізгі әңгімеде сұрақтарыңызға жауап береді.

Салыстыру үшін, репозиторийдің әрқайсысы өз жұмыс көшірмесінде ашылған бірнеше жергілікті Claude Code сессиясы бар қойындыларды елестетіңіз. Мұндай көшірме worktree деп аталады — бір тармаққа арналған бөлек бума, сондықтан жергілікті сессиялар бір-біріне кедергі келтірмейді. Сессиялар арасында өзіңіз ауысып, әрқайсысына не тапсыру керегін шешесіз. Бұлттық ағындарға worktree қажет емес: әр ағын репозиторийлерді өз оқшауланған бұлттық ортасына көшіреді. Projects үйлестіруді өз мойнына алып, жаңа ағынды қашан ашу керегін және оның қажет-қажет еместігін шешеді.

Жобада әр жаңа ағын алатын ортақ жад пен нұсқаулар болады. Баптау бөлімінде оларға нені сақтау және ағындарға қалай берілетіні түсіндіріледі.

Кәдімгі сессиядан және агенттер тобынан айырмашылығы#

Егер Claude Code сессиясының ішінде ішкі субагенттерді қолданып жүрсеңіз, оларды агенттер тобынан және жоба ағындарынан ажыратып алған жөн. Агенттер тобы — жұмысты басқаға тапсырудың тағы бір жолы: бір сессия белгілі бір тапсырмаға арналған әріптес сессияларын іске қосады. Оны өз компьютеріңізде де, бұлттық сессия ішінде де қолдануға болады.

• Агенттер тобы — жергілікті жерде немесе бұлтта іске қосуға болатын, бір нақты тапсырмаға арналған әріптес сессиялары. Бұлар бөлек жоба ағындары емес.
• Жоба және оның ағындары — жұмыс бұлтта орындалады. Әр ағын — өз тармағындағы бөлек сессия және ноутбугіңізді жапқаннан кейін де жұмысын жалғастыра береді. Жергілікті сессия жоба құрамына кіре алмайды.
• Agent view — компьютеріңіздегі бірнеше жергілікті сессияны бақылауға арналған экран. Онда үйлестіруші жоқ: әрқайсысына не тапсыру керегін өзіңіз шешесіз.

Anthropic-тің ресми құжаттамасында бір нәрсе ерекше атап өтілген: тек қатар жұмыс істеу қажеттілігі жоба құруға себеп бола алмайды. Жобада Claude сессияларды өзі іске қосып, олардың есептерін қабылдайды; барлық сессия ортақ репозиторийлерден, нұсқаулардан және жадтан бастайды. Тапсырма орындалып жатқанда жұмыс бұлтта қалады.

Үйлестіруші тапсырмаларды агенттерге бөлетін ұқсас тәсіл басқа құралда да іске асырылған; ол Cursor Projects туралы мақалада қарастырылған. Механизмі бөлек болғанымен, онда да үйлестіруші тапсырманы кімге беру керегін шешеді.

Алғашқы жобаңызды ашпай тұрып нені баптау керек#

Жоба ашпас бұрын үш нәрсені тексеріңіз.

1. GitHub есептік жазбасы және Claude GitHub App. Егер GitHub-ты /web-setup арқылы әлдеқашан қосқан болсаңыз, бұл токен кәдімгі бұлттық сессияларыңызға репозиторийге кіруге мүмкіндік береді. Бірақ жоба ағындары үшін бұл жеткіліксіз: репозиторийге өзгерістер жіберу рұқсаты бар қосылған GitHub есептік жазбасы және сол репозиторийге орнатылған Claude GitHub App қажет. Онсыз ағын репозиторийді көшіре де, pull request аша да алмайды.

2. Жоба нұсқаулары. Жоба нұсқаулары — әр жаңа ағынға және үйлестірушінің өзіне жіберілетін, көлемі 16 000 таңбаға дейінгі мәтін. Әр сессияда қайта түсіндіруге тура келетін ақпаратты осында жазыңыз: репозиторий құрылымын, код жазу ережелерін және pull request ашпас бұрын орындалуы тиіс тексерулерді.

3. Модель және күш деңгейі. Әдепкіде жаңа жоба әр ағынды жоғары күш деңгейіндегі Opus моделімен, ал үйлестірушіні төмен күш деңгейімен іске қосады. Құжаттамада бұл баптау «жоспар лимитін ең жылдам жұмсайды» делінген (аударма; түпнұсқасы: draws on your plan fastest). Тапсырмаларыңыз қарапайым болса, Project settings > General бөлімінде арзанырақ модель таңдай аласыз немесе күш деңгейін төмендете аласыз. Ағын мен үйлестірушінің баптаулары бөлек өзгертіледі; құжаттамада үнемдірек нұсқалар сипатталған.

Жоба жады MEMORY.md деп аталатын индекстік файлды қоса алғанда, кәдімгі файлдар түрінде сақталады. Әр жаңа ағын іске қосылғанда осы файлды оқып, қажетіне қарай басқа файлдарға жүгінеді. Бір ағынның жадқа сақтаған қорытындылары келесі ағынға қайта айтып беруді қажет етпей қолжетімді болады.

Ағындар бір кодты қатар өзгерткенде не істеу керек#

Әр ағын өз тармағында жұмыс істейді және қажет болса өзі pull request ашады. Бірақ үйлестіруші тапсырмалардың ешқашан қабаттаспайтынына кепілдік бермейді: бірнеше ағын кодтың бір бөлігіне кірісіп кетсе, тиісті ағыннан интерфейс арқылы қақтығысты шешуді сұрай аласыз. Оның pull request-інің жанындағы Resolve conflicts түймесі ағынға сізден хабарлама түрінде нұсқау жібереді.

Ресми құжаттама жоба нұсқауларында ағын саны бойынша қалауыңызды көрсетуді ұсынады: мысалы, үйлестірушіден бір уақытта екіден артық ағын іске қоспауды немесе бір аймақтағы жаңа тапсырмаларға бұрыннан бар ағынды қайта пайдалануды сұраңыз. Бұл — үйлестіруші ұстануға тырысатын қалау, қатаң шектеу емес. Оның өзі ағындардың бір файлда қақтығысуына жол бермейді деген кепілдік бермейді — туындаған қақтығысты бөлек шешу керек. Бір аймақтағы байланысты тапсырмалар үшін белсенді не бос ағынды қайта пайдалануға болады. Егер ол бір сағаттан астам уақыт бос тұрса, жаңа хабарлама алған кезде бүкіл тарихты қайта оқиды, бұл жазылым лимитінің жұмсалуына әсер етеді.

Тапсырмалар файлдар немесе модульдер бойынша неғұрлым анық бөлінсе, қатар жұмыс істеу соғұрлым жеңіл болады. Үлкен тапсырманы тәуелсіз бөліктерге бөлудің мысалы мыңдаған агентке код жазуды қалай тапсыруға болатыны туралы мақалада берілген. Ондағы ауқым бөлек болғанымен, жұмысты бөлу қағидасы бірдей.

Әңгіме кэші белсенді болған кезде (Pro және Max жоспарларында, бір сағат ішінде, жоспарыңыздың лимиті рұқсат етсе), ағын тарихын қайта өңдеуге жазылым лимитінен азырақ токен жұмсайды. Кэштің мерзімі біткен соң, ағын жұмысын бастамай тұрып жаңа хабарлама алған кезде бүкіл тарихын қайта оқиды. Жаңа, дербес тапсырма үшін үйлестірушіден жаңа ағын ашуды сұрау үнемдірек болуы мүмкін: кэші біткеннен кейін үлкен тарихы бар ескі сессияны жалғастырғаннан гөрі, бұл бір жазылым лимитінен азырақ токен жұмсауы ықтимал.

Бета-нұсқаның алдын ала білуге тиіс шектеулері#

Маңызды тапсырма үшін жоба ашпас бұрын бета-нұсқаның шектеулерін тексеріңіз:

• Тек Pro және Max жоспарларында қолжетімді. Team және Enterprise жоспарларына әлі қолдау көрсетілмейді.
• Күніне ең көбі 200 жаңа ағын ашылады; шектеу бір есептік жазбаның барлық жобаларына ортақ.
• Жоба бір пайдаланушыға тиесілі. Оған не жеке ағынға басқа адамға ортақ рұқсат бере алмайсыз; бета-нұсқада командаларға арналған ұйым баптаулары жоқ.
• Тек claude.ai/code, компьютерлік қолданба және мобильді қолданба арқылы қолжетімді. Projects терминалдағы CLI ішінде, Amazon Bedrock, Google Cloud Agent Platform немесе Microsoft Foundry арқылы жұмыс істемейді.
• Жоба жергілікті файлдар мен құралдарды көре алмайды. Ағындар GitHub репозиторийлерімен, жүктелген файлдармен және Google Drive бумаларымен жұмыс істейді, бірақ тек компьютеріңізде ғана бар нәрселерге қол жеткізе алмайды.

Терминал арқылы кіру немесе тек компьютеріңізде бар құралдарды пайдалану қажет болса, жергілікті сессияны немесе бірнеше осындай сессияға арналған agent view мүмкіндігін қолданыңыз. Бір жұмыс кеңістігінде бірнеше адам бірге жұмыс істеуі керек болса, Anthropic-тің Team және Enterprise жоспарларына арналған бөлек Claude Tag өнімі бар. Ол Slack арнасында жұмыс істейді: кез келген мүше Claude-ға тапсырма бере алады, ал арнадағы барлық адам жұмысты көріп, бағыттай алады. Жоба басқаша жұмыс істейді: ол тек сізге тиесілі. Тек нақты жергілікті файлдар қажет болса, оларды жобаға жүктей аласыз, сонда әр ағын оларға қол жеткізеді. Бірақ бұл жергілікті құралдарға қолжетімділік бермейді.

Әрі қарай не істеу керек#

Жұмыс үрдісіңізді Projects-ке көшірмес бұрын, маңызы аз репозиторийде бір сынақ жобасын ашып көріңіз: GitHub App-ты қосыңыз, қысқа нұсқаулар жазыңыз, үйлестірушіге бір дербес тапсырма беріңіз де, оның қалай орындайтынын бақылаңыз. Бұл алғашқы іске қосу үйлестіруші мен ағын интерфейсін түсінген-түсінбегеніңізді көрсетеді. Ол бірнеше тапсырмадағы қатар жұмыс, қақтығыстар немесе лимиттің жұмсалуын тексермейді — бұларды бөлек сынау қажет.