Claude Code Projects, czyli koordynator i równoległe wątki

14 listopada 2026 Claude Code Projects trafiły na pierwszą stronę Hacker News, a w wątku na pytania odpowiadał Boris Cherny z zespołu Claude Code. Funkcja jest starsza: Anthropic ogłosił ją 17 września 2026 jako betę dla wybranych kont, a dziś według dokumentacji to publiczna beta w planach Pro, Max i Ultra.

Czym są Claude Code Projects?

Projekt to jedna długa rozmowa, w której Claude pełni rolę koordynatora. Wklejamy do niej zgłoszenie błędu, stack trace albo listę zadań, a koordynator dla każdego z nich uruchamia osobny wątek (thread) lub przekazuje je wątkowi, który już pracuje w tym obszarze. Na krótkie pytania odpowiada na miejscu.

Każdy wątek to zwykle pełna sesja Claude Code w chmurze, z własnym oknem kontekstu i własnym branchem. Kiedy zadanie tego wymaga, wątek otwiera pull request, a potem go pilnuje: robi push z poprawkami, gdy CI nie przejdzie, i odpowiada na komentarze z review. Wątki działają równolegle i nie zatrzymują się po zamknięciu laptopa, a sterować nimi możemy też z telefonu.

Stan całości pokazuje panel Overview, w którym wątki są pogrupowane m.in. na „Ready for review”, „Waiting on you” i „Working”. Koordynator widzi tylko to, co wątki mu zgłoszą (po szczegóły trzeba otworzyć konkretny wątek).

Cherny napisał na HN, że w ten sposób powstaje dziś prawie cały jego kod (cytując „Projects are how I write pretty much all my code these days”). Koordynator ma według niego rozwiązać problem uwagi rozproszonej między wiele sesji, chociaż, jak dodał, nie każda praca wymaga zrównoleglania.

Co się zmieniło od wrześniowej bety?

Po pierwsze, wątki na własnym komputerze. We wrześniu wątki działały wyłącznie w chmurze, a wersja lokalna miała pojawić się „very soon”. Dziś w dokumentacji jest już opisana: wybieramy Work locally w rozmowie projektu, a wątek staje się sesją Claude Code w folderze na naszej maszynie, połączoną przez Remote Control (potrzebny jest Claude Code w wersji 2.1.280 lub nowszej). Taki wątek korzysta z lokalnych plików, narzędzi, serwerów MCP i hooków, ale działa tylko wtedy, gdy komputer nie śpi.

Po drugie, dostępność. Wrześniowa beta obejmowała wybranych subskrybentów Pro i Max. Teraz to publiczna beta w planach Pro, Max i Ultra, wciąż włączana stopniowo (jeśli nie widzisz Projects w panelu bocznym ani pod „More”, zostaje lista oczekujących). Plany Team i Enterprise nadal nie są obsługiwane.

Wątek na HN prowadzi do tekstu AlphaSignal, w którym wymieniono też m.in. udostępnianie wątków linkiem i przypomnienia. W dokumentacji nadal czytamy, że wątku nie da się udostępnić innej osobie, dlatego tych nowości tu nie opisuję.

Jak szybko projekt zużywa limit?

Szybciej niż pojedyncza sesja. Projekt korzysta z tych samych limitów planu co reszta Claude Code, a każdy działający wątek to pełna sesja. W dokumentacji czytamy, że w planie Pro w dni pracy z projektem dojdziemy do limitu wcześniej.

Nowy projekt uruchamia Opus wszędzie: wątki z wysokim effort (to ustawienie, które według dokumentacji zużywa plan najszybciej), a koordynatora z niskim. Nie ma stałej liczby wątków działających naraz. Jeśli poprosimy o „najwyżej dwa naraz”, Claude potraktuje to jako preferencję, a nie twardą blokadę. Jedyny egzekwowany limit to 500 nowych wątków dziennie we wszystkich projektach.

Na HN Cherny podał, że w testach A/B i ewaluacjach Anthropic koordynator dokłada mniej niż 10% tokenów względem samodzielnego uruchamiania sesji. Przyznał też, że zespół nie ma jeszcze dobrego sposobu na planowanie zużycia, a na razie „trochę działa” wpisanie budżetu w poleceniu, np. „use around 300k tokens”. Obawy w komentarzach dotyczyły właśnie kosztów: jeden z użytkowników opisał, jak w planie Max 5x siedmiu subagentów na Fable 5.2 zużyło jego limit w około 10 minut.

Co możemy z tym zrobić:

1. Zmienić Thread model i Thread effort w Project settings > General na mniejszy model lub niższy effort.
2. Zacząć od jednego małego zadania i sprawdzić, jak wątek raportuje, zanim wyślemy całą listę.
3. Zajrzeć do zakładki Usage, która pokazuje zużycie tokenów według wątku i modelu.

Wątek, który zatrzyma się na limicie, domyślnie czeka i sam rusza dalej po jego odnowieniu. Więcej o tym, co zjada limit w Claude Code, jest w tekście o statusach agentów w tle.

Na co zwrócić uwagę?

Po pierwsze, na to, czego wątki w chmurze nie wczytują z repozytorium. Dostają CLAUDE.md, ale już nie skille z .claude/skills/, serwery MCP z .mcp.json ani hooki i reguły uprawnień z .claude/settings.json. Skille i konektory trzeba włączyć na koncie claude.ai, a pluginy dodać w ustawieniach projektu.

Po drugie, na niezacommitowane zmiany. Sandbox wątku jest wstrzymywany między turami, a jeśli nie uda się go wznowić, wątek zaczyna od świeżego klona. Przy długich zadaniach dokumentacja radzi prosić Claude’a o commit i push w trakcie pracy.

Po trzecie, na wymagania. Kod musi leżeć na github.com (nie na GitHub Enterprise Server, GitLabie ani Bitbuckecie), z zainstalowaną aplikacją Claude GitHub App. Projekt należy do jednej osoby i nie ma na razie żadnych ustawień na poziomie organizacji.

FAQ

Czy Claude Code Projects działają w terminalu?

Nie. Projekty są dostępne na claude.ai/code, w aplikacji desktopowej i w aplikacji mobilnej Claude. Nie ma ich w CLI, w rozszerzeniu VS Code ani we wtyczce JetBrains. Nie działają też przez Amazon Bedrock, Google Cloud i Microsoft Foundry. Jeśli dopiero zaczynasz z samym narzędziem, zobacz poradnik do Claude Code.

Czy za Claude Code Projects płaci się osobno?

Dokumentacja nie wymienia osobnej opłaty. Projekt zużywa limity naszego planu i sam nie może ich przekroczyć. Praca ponad limit jest możliwa tylko wtedy, gdy mamy na koncie włączone usage credits.

Czy projekt potrzebuje repozytorium?

Nie. Wątki w chmurze mogą robić research, pisać dokumenty i uruchamiać kod we własnym sandboxie, a gotowe pliki trafiają do zakładki Library. Zamiast repozytorium możemy wgrać pliki, foldery lub foldery z Dysku Google.