Claude Code Projects: koordinátor, vlákna a omezení beta verze

Anthropic nedávno přepracoval Projects v Claude Code. Nyní jde o jednu koordinační konverzaci, která spouští paralelní cloudové relace — vlákna — pro jednotlivé úkoly a přijímá od nich zprávy. Projekt se vyplatí vytvořit, když má vaše práce cíl, který přesahuje jednu relaci a bude vytvářet nové úkoly — například vývoj repozitáře na GitHubu po několik týdnů. Samotná potřeba paralelní práce nestačí. Pokud potřebujete rychle opravit jeden soubor právě teď, postačí běžná relace.

Práci řídí koordinátor — dlouhodobá konverzace, ve které Claude rozhoduje, co z vaší zprávy předat jako úkol vláknu. Kód píší vlákna: každé je samostatná cloudová relace Claude Code na vlastní větvi repozitáře. Několik vláken může běžet současně, každé s vlastním kontextem a větví. Koordinátor vidí, co vlákno po dokončení oznámí, ale ne každý jeho krok. Informuje vás o dokončených pull requestech (požadavcích na sloučení změn) a na váš pokyn požádá vlákno, aby je upravilo nebo sloučilo. Níže najdete přehled vycházející z oficiální dokumentace Anthropic: co nastavit, jak je práce organizována a jaká omezení má beta verze.

Beta verze se postupně zpřístupňuje nejprve účtům Pro a Max, které již využily cloudové relace Claude Code a nevytvořily projekt v běžném chatu ani v Cowork. Pokud zatím sekci Projects nevidíte, můžete se přidat na čekací listinu.

Co Claude Code Projects znamená, jednoduše?#

Projekt je jedna dlouhodobá konverzace s koordinátorem, ke které jsou připojeny repozitáře, paměť a pokyny. Píšete koordinátorovi a ten rozhoduje, zda odpovědět hned, nebo spustit vlákno. Nemusíte ručně otevírat novou relaci pro každý úkol.

Vlákno je plnohodnotná cloudová relace Claude Code: má vlastní kontext i větev repozitáře a v případě potřeby otevře pull request. Koordinátor může mít současně otevřeno několik vláken — například jedno opravuje chybu, druhé píše testy a třetí aktualizuje dokumentaci — a přitom odpovídat na vaše dotazy v hlavní konverzaci.

Pro srovnání si představte několik karet s místními relacemi Claude Code, z nichž každá pracuje ve vlastní kopii repozitáře. Taková kopie se nazývá worktree — samostatná složka pro jednu větev, aby se místní relace navzájem nerušily. Mezi relacemi přepínáte sami a rozhodujete, co které přiřadit. Cloudová vlákna worktree nepotřebují: každé naklonuje repozitáře do vlastního izolovaného cloudového prostředí. Projects se postará o koordinaci a rozhodne, kdy vytvořit nové vlákno a kdy to není potřeba.

Projekt má sdílenou paměť a pokyny, které dostane každé nové vlákno. V části o nastavení se dozvíte, co do nich ukládat a jak se předávají vláknům.

Jak se Claude Code Projects liší od běžné relace a týmu agentů?#

Pokud už v rámci jedné relace Claude Code spouštíte vnořené podřízené agenty, je dobré odlišit je od týmů agentů a vláken projektů. Tým agentů je další způsob delegování práce: jedna relace spustí relace kolegů pro konkrétní úkol. Můžete ho spustit na vlastním počítači i v cloudové relaci.

• Tým agentů — relace kolegů pro jeden konkrétní úkol, které lze spustit místně nebo v cloudu. Nejde o samostatná projektová vlákna.
• Projekt a jeho vlákna — práce probíhá v cloudu. Každé vlákno je samostatná relace na vlastní větvi a běží dál, i když zavřete notebook. Místní relace nemůže být součástí projektu.
• Zobrazení agentů — obrazovka pro sledování několika místních relací na vašem počítači. Nemá koordinátora: sami rozhodujete, co které přiřadit.

Oficiální dokumentace Anthropic zvlášť zdůrazňuje, že samotná paralelní práce není důvodem k vytvoření projektu. V projektu Claude sám spouští relace a přijímá od nich zprávy a všechny relace začínají se sdílenými repozitáři, pokyny a pamětí. Práce zůstává po celou dobu úkolu v cloudu.

Podobný přístup — koordinátor rozděluje úkoly mezi agenty — je implementován v jiném nástroji, kterému se věnuje článek o Cursor Projects. Mechanismus se liší, ale koordinátor také rozhoduje, komu co přiřadit.

Co nastavit před prvním projektem#

Než vytvoříte projekt, zkontrolujte tři věci.

1. Účet GitHub a aplikace Claude GitHub App. Pokud jste již připojili GitHub přes /web-setup, tento token umožňuje běžným cloudovým relacím přístup k repozitáři. Pro projektová vlákna to nestačí: potřebujete připojený účet GitHub s oprávněním push do repozitáře a pro daný repozitář nainstalovanou aplikaci Claude GitHub App. Bez ní vlákno nemůže repozitář naklonovat ani otevřít pull request.

2. Pokyny projektu. Pokyny projektu jsou text o délce až 16 000 znaků, který se posílá každému novému vláknu i samotnému koordinátorovi. Uveďte sem informace, které byste jinak museli vysvětlovat znovu v každé relaci: strukturu repozitáře, konvence pro kód a kontroly požadované před pull requestem.

3. Model a úroveň úsilí. Ve výchozím nastavení běží každé vlákno nového projektu na modelu Opus s vysokým úsilím a koordinátor s nízkým úsilím. Dokumentace uvádí, že toto nastavení „nejrychleji spotřebovává váš tarifní limit“ (překlad; originál: draws on your plan fastest). Pokud jsou vaše úkoly jednoduché, můžete v Project settings > General zvolit levnější model nebo snížit úsilí. Nastavení vláken a koordinátora se mění odděleně; dokumentace popisuje úspornější možnosti.

Paměť projektu se ukládá jako běžné soubory s indexovým souborem nazvaným MEMORY.md. Každé nové vlákno ho načte při spuštění a podle potřeby přistupuje k ostatním souborům. Zjištění z jednoho vlákna uložená do paměti jsou dostupná dalšímu, aniž byste je museli znovu sdělovat.

Co dělat, když vlákna mění stejný kód#

Každé vlákno pracuje na vlastní větvi a v případě potřeby samo otevře pull request. Koordinátor ale nezaručuje, že se úkoly nikdy nebudou překrývat: pokud několik vláken pracuje ve stejné části kódu, můžete přes rozhraní požádat příslušné vlákno, aby konflikt vyřešilo. Vedle jeho pull requestu je tlačítko Resolve conflicts, které odešle vláknu pokyn jako vaši zprávu.

Oficiální dokumentace doporučuje uvést v pokynech projektu preference ohledně počtu vláken: například požádat koordinátora, aby spouštěl nejvýše dvě vlákna současně, nebo aby pro nové úkoly ve stejné oblasti znovu používal existující vlákno. Jde o preferenci, kterou se koordinátor snaží dodržovat, nikoli o pevný limit. Samo o sobě to nezaručuje, že se vlákna nesrazí ve stejném souboru — případný konflikt je nutné vyřešit zvlášť. U souvisejících úkolů ve stejné oblasti můžete znovu použít aktivní i nečinné vlákno. Pokud bylo nečinné déle než hodinu, při přijetí nové zprávy znovu načte celou historii, což ovlivňuje čerpání tarifního limitu.

Čím jasněji jsou úkoly rozdělené podle souborů nebo modulů, tím snazší je paralelní práce. Samostatný článek se věnuje rozdělení velkého úkolu na nezávislé části: jak delegovat programování tisícům agentů. Měřítko je tam jiné, princip rozdělení práce je však stejný.

Dokud zůstává aktivní mezipaměť konverzace (u tarifů Pro a Max po dobu jedné hodiny, pokud to limity tarifu dovolují), spotřebovává vlákno méně tokenů z tarifního limitu při opětovném zpracování historie. Jakmile platnost mezipaměti vyprší, vlákno při přijetí nové zprávy znovu načte celou historii, než začne pracovat. U nového nezávislého úkolu může být úspornější požádat koordinátora o vytvoření nového vlákna: může to spotřebovat méně tokenů ze stejného tarifního limitu než pokračování ve staré relaci s dlouhou historií po vypršení její mezipaměti.

Omezení beta verze, která je dobré znát předem#

Než vytvoříte projekt pro důležitý úkol, ověřte si omezení beta verze:

• Dostupné pouze pro tarify Pro a Max. Tarify Team a Enterprise zatím nejsou podporovány.
• Limit 200 nových vláken denně na účet, celkem napříč všemi projekty.
• Projekt patří jednomu uživateli. Nemůžete sdílet přístup k němu ani k jednotlivému vláknu s další osobou a beta verze nemá nastavení organizace pro týmy.
• Přístup pouze přes claude.ai/code, desktopovou aplikaci a mobilní aplikaci. Projects nefunguje v terminálovém CLI, přes Amazon Bedrock, Google Cloud Agent Platform ani Microsoft Foundry.
• Projekt nevidí místní soubory ani nástroje. Vlákna pracují s repozitáři GitHub, nahranými soubory a složkami Google Drive, ale ne s věcmi, které existují pouze ve vašem počítači.

Pokud potřebujete přístup k terminálu nebo k nástrojům dostupným pouze na vašem počítači, použijte místní relaci nebo zobrazení agentů pro několik takových relací. Pokud potřebuje spolupracovat několik lidí v jednom pracovním prostoru, Anthropic nabízí samostatný týmový produkt pro tarify Team a Enterprise: Claude Tag. Funguje v kanálu Slack; každý člen může zadat Claude úkol a všichni v kanálu mohou práci sledovat a řídit. Projekt funguje jinak: patří pouze vám. Pokud potřebujete jen určité místní soubory, můžete je nahrát do projektu a každé vlákno k nim pak bude mít přístup. Místní nástroje tím přístupné nebudou.

Co dál#

Než přesunete svůj pracovní postup do Projects, zkuste vytvořit jeden testovací projekt v nekritickém repozitáři: připojte GitHub App, napište krátké pokyny, zadejte koordinátorovi jeden nezávislý úkol a sledujte, jak si poradí. První spuštění vám ukáže, zda rozumíte rozhraní koordinátora a vláken. Neověří však paralelní práci, konflikty ani čerpání tarifního limitu při více úkolech — ty je třeba otestovat samostatně.