# Claude Code Projects: koordynator, wątki i ograniczenia wersji beta
> Jak działają wątki zadań w chmurze Claude Code Projects: GitHub App, instrukcje, pamięć, konflikty i ograniczenia wersji beta.
Source: https://ailoot.ai/blog/pl/claude-code-projects/
Canonical: https://ailoot.ai/blog/pl/claude-code-projects/
Language: pl
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-051
Revision: sha256-3526f0b7cc1c5ea9fc6cb81dc98d970988217ddfb481445c95f0099fee87887b
Anthropic niedawno przeprojektowało Projects w Claude Code. Teraz jest to pojedyncza rozmowa koordynująca, która uruchamia równoległe sesje w chmurze — wątki — do wykonywania zadań i otrzymuje od nich raporty. Warto utworzyć projekt, gdy Twoja praca ma cel, który potrwa dłużej niż jedna sesja i wygeneruje nowe zadania — na przykład rozwijanie repozytorium GitHub przez kilka tygodni. Sama potrzeba równoległej pracy nie wystarczy. Jeśli chcesz szybko naprawić jeden plik tu i teraz, wystarczy zwykła sesja.
Pracą kieruje koordynator — długotrwała rozmowa, w której Claude decyduje, co z Twojej wiadomości przekształcić w zadanie dla wątku. Wątki piszą kod: każdy z nich jest osobną sesją Claude Code w chmurze na własnej gałęzi repozytorium. Kilka wątków może działać jednocześnie, każdy z własnym kontekstem i gałęzią. Koordynator widzi raport wątku po zakończeniu pracy, ale nie każdy wykonany przez niego krok. Informuje Cię o ukończonych pull requestach (prośbach o scalenie zmian) i na Twoje polecenie prosi wątek o wprowadzenie poprawek lub scalenie zmian. Poniżej przedstawiamy omówienie oparte na oficjalnej dokumentacji Anthropic: co skonfigurować, jak zorganizowana jest praca i jakie ograniczenia ma wersja beta.
Wersja beta jest udostępniana stopniowo, począwszy od kont Pro i Max, które korzystały już z sesji Claude Code w chmurze i nie utworzyły projektu w zwykłym czacie ani w Cowork. Jeśli nie widzisz jeszcze sekcji Projects, możesz dołączyć do listy oczekujących.
Praktyczne instrukcje korzystania z Ailoot znajdziesz w [dokumentacji](https://ailoot.ai/docs/).
## Czym Claude Code Projects jest w prostych słowach
Projekt to pojedyncza, długotrwała rozmowa z koordynatorem, do której dołączone są repozytoria, pamięć i instrukcje. Piszesz do koordynatora, a on decyduje, czy odpowiedzieć od razu, czy uruchomić wątek. Nie musisz ręcznie otwierać nowej sesji dla każdego zadania.
Wątek to pełna sesja Claude Code w chmurze: ma własny kontekst i gałąź repozytorium, a w razie potrzeby otwiera pull request. Koordynator może jednocześnie utrzymywać kilka otwartych wątków — na przykład jeden naprawia błąd, drugi pisze testy, a trzeci aktualizuje dokumentację — i odpowiadać na Twoje pytania w głównej rozmowie.
Dla porównania wyobraź sobie kilka kart z lokalnymi sesjami Claude Code, z których każda korzysta z własnej kopii roboczej repozytorium. Taka kopia nazywa się worktree — to osobny folder dla jednej gałęzi, dzięki któremu lokalne sesje nie przeszkadzają sobie nawzajem. Samodzielnie przełączasz się między sesjami i decydujesz, co przydzielić każdej z nich. Wątki w chmurze nie potrzebują worktree: każdy klonuje repozytoria do własnego, odizolowanego środowiska w chmurze. Projects zajmuje się koordynacją, decydując, kiedy utworzyć nowy wątek, a kiedy nie jest on potrzebny.
Projekt ma wspólną pamięć i instrukcje, które otrzymuje każdy nowy wątek. Sekcja dotycząca konfiguracji wyjaśnia, co warto w nich zapisać i jak są przekazywane wątkom.
## Czym różni się to od zwykłej sesji i zespołu agentów
Jeśli korzystasz już z [zagnieżdżonych podagentów](https://ailoot.ai/blog/pl/claude-code-nested-subagents/) w ramach jednej sesji Claude Code, warto odróżnić je od zespołów agentów i wątków projektowych. Zespół agentów to inny sposób delegowania pracy: jedna sesja uruchamia sesje współpracowników do konkretnego zadania. Możesz uruchomić go zarówno na własnym komputerze, jak i w sesji w chmurze.
- **Zespół agentów** — sesje współpracowników do jednego konkretnego zadania, które można uruchomić lokalnie lub w chmurze. Nie są to osobne wątki projektu.
- **Projekt i jego wątki** — praca odbywa się w chmurze. Każdy wątek jest osobną sesją na własnej gałęzi i działa dalej nawet po zamknięciu laptopa. Sesja lokalna nie może należeć do projektu.
- **Widok Agent** — ekran do obserwowania kilku lokalnych sesji na komputerze. Nie ma koordynatora: to Ty decydujesz, co przydzielić każdej z nich.
Oficjalna dokumentacja Anthropic osobno podkreśla, że sama równoległa praca nie jest powodem do utworzenia projektu. W projekcie Claude sam uruchamia sesje i otrzymuje ich raporty, a wszystkie sesje rozpoczynają pracę ze wspólnymi repozytoriami, instrukcjami i pamięcią. Przez cały czas wykonywania zadania praca pozostaje w chmurze.
Podobne podejście — koordynator przydzielający zadania agentom — zaimplementowano w innym narzędziu, opisanym w artykule o [Cursor Projects](https://ailoot.ai/blog/pl/cursor-projects-coordinator-agents/). Mechanizm jest inny, ale koordynator również decyduje, komu przydzielić dane zadanie.
## Co skonfigurować przed utworzeniem pierwszego projektu
Przed utworzeniem projektu sprawdź trzy rzeczy.
**1. Konto GitHub i Claude GitHub App.** Jeśli połączyłeś już GitHuba przez `/web-setup`, ten token zapewnia zwykłym sesjom w chmurze dostęp do repozytorium. Nie wystarcza jednak dla wątków projektowych: potrzebujesz połączonego konta GitHub z uprawnieniami do wysyłania zmian do repozytorium oraz zainstalowanej w nim aplikacji Claude GitHub App. Bez tego wątek nie może sklonować repozytorium ani otworzyć pull requesta.
**2. Instrukcje projektu.** Instrukcje projektu to tekst o długości do 16 000 znaków, wysyłany do każdego nowego wątku i samego koordynatora. Umieść tu informacje, które w przeciwnym razie trzeba byłoby wyjaśniać ponownie w każdej sesji: strukturę repozytorium, konwencje kodowania i kontrole wymagane przed otwarciem pull requesta.
**3. Model i poziom wysiłku.** Domyślnie nowy projekt uruchamia każdy wątek z modelem Opus przy wysokim poziomie wysiłku, a koordynator działa przy niskim poziomie wysiłku. Dokumentacja podaje, że to ustawienie „najszybciej zużywa limit planu” (tłumaczenie; oryginał: draws on your plan fastest). Jeśli Twoje zadania są proste, możesz wybrać tańszy model lub obniżyć poziom wysiłku w **Project settings \> General**. Ustawienia wątków i koordynatora zmienia się oddzielnie; dokumentacja opisuje bardziej ekonomiczne opcje.
Pamięć projektu jest przechowywana w zwykłych plikach, z plikiem indeksu o nazwie `MEMORY.md`. Każdy nowy wątek odczytuje go podczas uruchamiania i w razie potrzeby sięga do pozostałych plików. Ustalenia zapisane w pamięci przez jeden wątek stają się dostępne dla kolejnego bez konieczności ponownego ich opisywania.
## Co zrobić, gdy wątki zmieniają ten sam kod
Każdy wątek pracuje na własnej gałęzi i sam otwiera pull request, jeśli wymaga tego zadanie. Koordynator nie gwarantuje jednak, że zadania nigdy się nie pokryją: jeśli kilka wątków zajmie się tym samym obszarem kodu, możesz poprosić odpowiedni wątek o rozwiązanie konfliktu przez interfejs. Przycisk Resolve conflicts obok pull requesta wysyła do wątku Twoją instrukcję w formie wiadomości.
Oficjalna dokumentacja zaleca określenie w instrukcjach projektu preferowanej liczby wątków: na przykład poproszenie koordynatora, by uruchamiał najwyżej dwa wątki jednocześnie albo ponownie wykorzystywał istniejący wątek do nowych zadań w tym samym obszarze. To preferencja, której koordynator stara się przestrzegać, a nie sztywny limit. Sama w sobie nie gwarantuje, że wątki nie będą kolidować w tym samym pliku — istniejący konflikt trzeba rozwiązać osobno. Do powiązanych zadań w tym samym obszarze możesz ponownie wykorzystać aktywny lub bezczynny wątek. Jeśli był bezczynny dłużej niż godzinę, po otrzymaniu nowej wiadomości ponownie odczyta całą historię, co wpływa na zużycie limitu subskrypcji.
Im wyraźniej zadania są podzielone według plików lub modułów, tym łatwiej pracować równolegle. Osobny artykuł opisuje dzielenie dużego zadania na niezależne części: jak delegować programowanie tysiącom agentów. Skala jest inna, ale zasada podziału pracy pozostaje taka sama.
Gdy pamięć podręczna rozmowy jest aktywna (w planach Pro i Max przez godzinę, jeśli pozwalają na to limity planu), wątek zużywa mniej tokenów z limitu subskrypcji na ponowne przetwarzanie historii. Po wygaśnięciu pamięci podręcznej wątek ponownie odczytuje całą historię po otrzymaniu nowej wiadomości, zanim rozpocznie pracę. W przypadku nowego, niezależnego zadania bardziej ekonomiczne może być poproszenie koordynatora o utworzenie nowego wątku: może to zużyć mniej tokenów z tego samego limitu subskrypcji niż kontynuowanie starej sesji z długą historią po wygaśnięciu pamięci podręcznej.
## Ograniczenia wersji beta, które warto znać z wyprzedzeniem
Przed utworzeniem projektu do ważnego zadania sprawdź ograniczenia wersji beta:
- **Dostępne tylko w planach Pro i Max.** Plany Team i Enterprise nie są jeszcze obsługiwane.
- **Limit 200 nowych wątków dziennie** na konto, łącznie we wszystkich projektach.
- **Projekt należy do jednego użytkownika.** Nie możesz udostępnić innej osobie projektu ani pojedynczego wątku, a wersja beta nie oferuje ustawień organizacyjnych dla zespołów.
- **Dostęp wyłącznie przez claude.ai/code, aplikację desktopową i aplikację mobilną.** Projects nie działa w terminalowym CLI ani przez Amazon Bedrock, Google Cloud Agent Platform lub Microsoft Foundry.
- **Projekt nie ma dostępu do lokalnych plików ani narzędzi.** Wątki obsługują repozytoria GitHub, przesłane pliki i foldery Google Drive, ale nie rzeczy znajdujące się wyłącznie na Twoim komputerze.
Jeśli potrzebujesz dostępu do terminala albo narzędzi dostępnych wyłącznie na Twoim komputerze, użyj sesji lokalnej lub widoku Agent dla kilku takich sesji. Jeśli kilka osób ma pracować razem w jednym obszarze roboczym, Anthropic oferuje osobny produkt zespołowy dla planów Team i Enterprise: Claude Tag. Działa on w kanale Slacka; każdy członek może zlecić Claude zadanie, a wszyscy w kanale mogą obserwować pracę i nią kierować. Projekt działa inaczej: należy wyłącznie do Ciebie. Jeśli potrzebujesz tylko określonych lokalnych plików, możesz przesłać je do projektu, a wtedy każdy wątek będzie miał do nich dostęp. Nie zapewnia to dostępu do lokalnych narzędzi.
## Co dalej
Zanim przeniesiesz swój przepływ pracy do Projects, spróbuj utworzyć jeden testowy projekt w niekrytycznym repozytorium: połącz GitHub App, napisz krótkie instrukcje, przydziel koordynatorowi jedno niezależne zadanie i sprawdź, jak sobie z nim poradzi. Ten pierwszy przebieg pokaże, czy rozumiesz interfejs koordynatora i wątków. Nie pozwoli jednak sprawdzić pracy równoległej, konfliktów ani zużycia limitu przy wielu zadaniach — te kwestie trzeba przetestować osobno.
### Źródła
- [Claude Code Projects - oficjalna dokumentacja Anthropic](https://code.claude.com/docs/en/claude-projects)
Możesz dalej odkrywać Ailoot na stronie [ailoot.ai](https://ailoot.ai/).
## Pytania i odpowiedzi
### Czy sama równoległa praca uzasadnia Project?
Używaj Project dla celu trwającego przez sesje i korzystającego ze wspólnych repozytoriów, instrukcji i pamięci. Szybka lokalna edycja może zostać w zwykłej sesji; wątki Projects pracują w izolowanej chmurze.
### Co sprawdzić, gdy wątek nie klonuje repozytorium?
Sprawdź prawo push podłączonego konta GitHub i instalację Claude GitHub App dla repozytorium. Token zwykłych sesji chmurowych nie wystarcza wątkom Project.
## Ailoot · Firma i jej portfel projektów
Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.
Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.
Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.