# Claude Code Projects: coördinator, threads en bèta-beperkingen
> Hoe cloudthreads in Claude Code Projects werken: GitHub App, instructies, geheugen, conflicten en bèta-beperkingen.
Source: https://ailoot.ai/blog/nl/claude-code-projects/
Canonical: https://ailoot.ai/blog/nl/claude-code-projects/
Language: nl
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-051
Revision: sha256-8c26830168e30a8b82dcec7eacfd526640961c1dd50ce898d166cdc482263389
Anthropic heeft Projects in Claude Code onlangs opnieuw ontworpen. Het bestaat nu uit één coördinerend gesprek dat parallelle cloudsessies — threads — voor taken start en daar rapporten van ontvangt. Een project is het aanmaken waard wanneer je werk een doel heeft dat langer meegaat dan één sessie en nieuwe taken oplevert — bijvoorbeeld het ontwikkelen van een GitHub-repository gedurende meerdere weken. Alleen de behoefte aan parallel werk is niet voldoende. Als je hier en nu snel één bestand moet aanpassen, volstaat een gewone sessie.
Het werk wordt geleid door een coördinator: een langdurig gesprek waarin Claude beslist wat uit je bericht wordt omgezet in een taak voor een thread. De threads schrijven de code: elk is een aparte Claude Code-cloudsessie op een eigen repositorybranch. Er kunnen meerdere threads tegelijk draaien, elk met een eigen context en branch. De coördinator ziet wat een thread na afloop rapporteert, maar niet elke stap die deze uitvoert. De coördinator meldt voltooide pull requests (verzoeken om wijzigingen samen te voegen) aan jou en vraagt, op jouw verzoek, een thread om ze aan te passen of samen te voegen. Hieronder staat een overzicht op basis van de officiële documentatie van Anthropic: wat je moet instellen, hoe het werk wordt georganiseerd en welke beperkingen de bèta heeft.
De bèta wordt geleidelijk beschikbaar, te beginnen met Pro- en Max-accounts die al cloudsessies van Claude Code hebben gebruikt en geen project hebben aangemaakt in gewone chat of Cowork. Als je de sectie Projects nog niet ziet, kun je je aanmelden voor de wachtlijst.
Praktische instructies voor het werken met Ailoot vind je in de [documentatie](https://ailoot.ai/docs/).
## Wat Claude Code Projects in eenvoudige bewoordingen is
Een project is één langdurig gesprek met een coördinator, waaraan repositories, geheugen en instructies zijn gekoppeld. Je schrijft naar de coördinator en die beslist of hij direct antwoordt of een thread start. Je hoeft niet voor elke taak handmatig een nieuwe sessie te openen.
Een thread is een volledige Claude Code-cloudsessie: deze heeft een eigen context en repositorybranch en opent indien nodig een pull request. De coördinator kan meerdere threads tegelijk openhouden — bijvoorbeeld één die een bug oplost, een andere die tests schrijft en een derde die de documentatie bijwerkt — terwijl hij je vragen in het hoofdgesprek beantwoordt.
Ter vergelijking: stel je meerdere tabbladen voor met lokale Claude Code-sessies, elk in een eigen werkkopie van een repository. Zo’n kopie heet een worktree: een aparte map voor één branch, zodat lokale sessies elkaar niet in de weg zitten. Je schakelt zelf tussen de sessies en beslist wat je aan elk ervan toewijst. Cloudthreads hebben geen worktree nodig: elke thread kloont de repositories naar een eigen geïsoleerde cloudomgeving. Projects regelt de coördinatie en beslist wanneer een nieuwe thread nodig is en wanneer niet.
Een project heeft gedeeld geheugen en instructies die elke nieuwe thread ontvangt. In het gedeelte over instellen wordt uitgelegd wat je hierin opslaat en hoe het aan threads wordt doorgegeven.
## Hoe dit verschilt van een gewone sessie en een agentteam
Als je al [geneste subagents](https://ailoot.ai/blog/nl/claude-code-nested-subagents/) binnen één Claude Code-sessie gebruikt, is het handig om die te onderscheiden van agentteams en projectthreads. Een agentteam is een andere manier om werk uit te besteden: één sessie start sessies van teamgenoten voor een specifieke taak. Je kunt dit zowel op je eigen computer als binnen een cloudsessie gebruiken.
- **Agentteam** — sessies van teamgenoten voor één specifieke taak, die lokaal of in de cloud kunnen worden gestart. Dit zijn geen afzonderlijke projectthreads.
- **Een project en zijn threads** — het werk draait in de cloud. Elke thread is een afzonderlijke sessie op een eigen branch en blijft draaien, ook nadat je je laptop sluit. Een lokale sessie kan geen deel uitmaken van een project.
- **Agentweergave** — een scherm om meerdere lokale sessies op je computer te volgen. Er is geen coördinator: jij beslist wat je aan elke sessie toewijst.
De officiële documentatie van Anthropic maakt een afzonderlijk punt: alleen parallel werk is geen reden om een project aan te maken. In een project start Claude zelf sessies en ontvangt hij hun rapporten; alle sessies beginnen met gedeelde repositories, instructies en geheugen. Gedurende de hele taak blijft het werk in de cloud.
Een vergelijkbare aanpak — een coördinator die taken onder agents verdeelt — is geïmplementeerd in een andere tool, die wordt besproken in het artikel over [Cursor Projects](https://ailoot.ai/blog/nl/cursor-projects-coordinator-agents/). Het mechanisme is anders, maar ook daar beslist de coördinator wie welke taak krijgt.
## Wat je vóór je eerste project moet instellen
Controleer drie dingen voordat je een project aanmaakt.
**1. GitHub-account en Claude GitHub App.** Als je GitHub al via `/web-setup` hebt gekoppeld, geeft die token je gewone cloudsessies toegang tot de repository. Voor projectthreads is dat niet voldoende: je hebt een gekoppeld GitHub-account met schrijfrechten voor de repository nodig en de Claude GitHub App moet voor die repository zijn geïnstalleerd. Zonder deze app kan een thread de repository niet klonen en geen pull request openen.
**2. Projectinstructies.** Projectinstructies zijn tekst van maximaal 16 000 tekens die naar elke nieuwe thread en naar de coördinator zelf wordt gestuurd. Zet hier informatie in die je anders in elke sessie opnieuw zou moeten uitleggen: de repositorystructuur, codeconventies en de controles die vóór een pull request nodig zijn.
**3. Model en inspanningsniveau.** Standaard draait een nieuw project elke thread op het Opus-model met hoge inspanning en de coördinator met lage inspanning. Volgens de documentatie “verbruikt deze instelling je plantoelage het snelst” (vertaling; origineel: draws on your plan fastest). Als je taken eenvoudig zijn, kun je een goedkoper model kiezen of de inspanning verlagen in **Project settings \> General**. De instellingen voor threads en de coördinator worden afzonderlijk gewijzigd; de documentatie beschrijft voordeligere opties.
Projectgeheugen wordt opgeslagen als gewone bestanden, met een indexbestand met de naam `MEMORY.md`. Elke nieuwe thread leest dit bestand bij het opstarten en gebruikt andere bestanden wanneer dat nodig is. Bevindingen die door één thread in het geheugen zijn opgeslagen, zijn beschikbaar voor de volgende thread zonder dat ze opnieuw hoeven te worden verteld.
## Wat je moet doen als threads dezelfde code wijzigen
Elke thread werkt op een eigen branch en opent zelf een pull request als het werk dat vereist. De coördinator garandeert echter niet dat taken elkaar nooit overlappen: als meerdere threads in hetzelfde deel van de code terechtkomen, kun je de betreffende thread via de interface vragen het conflict op te lossen. Naast de pull request staat een knop Conflicten oplossen. Die stuurt een instructie naar de thread als bericht van jou.
De officiële documentatie raadt aan om in de projectinstructies voorkeuren op te geven voor het aantal threads: vraag de coördinator bijvoorbeeld om maximaal twee threads tegelijk te starten of een bestaande thread te hergebruiken voor nieuwe taken in hetzelfde gebied. Dit is een voorkeur die de coördinator probeert te volgen, geen harde limiet. Op zichzelf garandeert dit niet dat threads niet in hetzelfde bestand botsen — een bestaand conflict moet afzonderlijk worden opgelost. Voor verwante taken in hetzelfde gebied kun je een actieve of een inactieve thread hergebruiken. Als deze langer dan een uur inactief is geweest, leest hij de volledige geschiedenis opnieuw wanneer hij een nieuw bericht ontvangt; dat heeft invloed op het verbruik van je abonnementstegoed.
Hoe duidelijker taken over bestanden of modules zijn verdeeld, hoe makkelijker het is om parallel te werken. Een apart artikel behandelt hoe je een grote taak in onafhankelijke delen verdeelt: hoe je codeerwerk delegeert aan duizenden agents. De schaal is daar anders, maar het principe van het verdelen van het werk is hetzelfde.
Zolang de gesprekscache actief blijft (bij Pro- en Max-abonnementen binnen een uur, mits je planlimieten dit toestaan), verbruikt een thread minder van je abonnementstegoed om de geschiedenis opnieuw te verwerken. Zodra de cache verloopt, leest de thread de volledige geschiedenis opnieuw wanneer hij een nieuw bericht ontvangt, voordat hij aan het werk gaat. Voor een nieuwe, onafhankelijke taak kan het voordeliger zijn om de coördinator een nieuwe thread te laten aanmaken: dit kan minder tokens van hetzelfde abonnementstegoed verbruiken dan doorgaan met een oude sessie met een lange geschiedenis waarvan de cache is verlopen.
## Beperkingen van de bèta om vooraf te kennen
Controleer de beperkingen van de bèta voordat je een project aanmaakt voor een belangrijke taak:
- **Alleen beschikbaar voor Pro en Max.** Team en Enterprise worden nog niet ondersteund.
- **Een limiet van 200 nieuwe threads per dag** per account, voor alle projecten samen.
- **Een project hoort bij één gebruiker.** Je kunt het project of een afzonderlijke thread niet met iemand anders delen; de bèta heeft geen organisatie-instellingen voor teams.
- **Alleen toegankelijk via claude.ai/code, de desktopapp en de mobiele app.** Projects werkt niet in de terminal-CLI, via Amazon Bedrock, Google Cloud Agent Platform of Microsoft Foundry.
- **Een project heeft geen toegang tot lokale bestanden en tools.** Threads werken met GitHub-repositories, geüploade bestanden en Google Drive-mappen, maar niet met zaken die alleen op je eigen computer bestaan.
Als je toegang tot de terminal of tot tools nodig hebt die alleen op je computer beschikbaar zijn, gebruik dan een lokale sessie of een agentweergave voor meerdere van zulke sessies. Als meerdere mensen in één werkruimte moeten samenwerken, heeft Anthropic een afzonderlijk product voor teams op Team en Enterprise: Claude Tag. Dat werkt in een Slack-kanaal; elk lid kan Claude een taak geven en iedereen in het kanaal kan het werk zien en aansturen. Een project werkt anders: het hoort alleen bij jou. Als je alleen bepaalde lokale bestanden nodig hebt, kun je die naar het project uploaden, waarna elke thread er toegang toe heeft. Dit geeft geen toegang tot lokale tools.
## Wat nu
Probeer één testproject aan te maken in een niet-kritieke repository voordat je je workflow naar Projects verplaatst: koppel de GitHub App, schrijf korte instructies, geef de coördinator één onafhankelijke taak en kijk hoe die ermee omgaat. Deze eerste uitvoering laat zien of je begrijpt hoe de interface voor de coördinator en threads werkt. Parallel werk, conflicten of het verbruik van je tegoed bij meerdere taken worden hiermee niet getest — die moet je afzonderlijk testen.
### Bronnen
- [Claude Code Projects - officiële documentatie van Anthropic](https://code.claude.com/docs/en/claude-projects)
Je kunt Ailoot verder verkennen op [ailoot.ai](https://ailoot.ai/).
## Vragen en antwoorden
### Is parallel werk alleen een reden om een Project te maken?
Gebruik een Project voor een doel dat over sessies doorloopt en baat heeft bij gedeelde repositories, instructies en geheugen. Een snelle lokale bewerking kan in een gewone sessie blijven; Project-threads werken in geïsoleerde cloudomgevingen.
### Wat controleer ik als een thread de repository niet kan klonen?
Controleer de pushtoegang van het gekoppelde GitHub-account en of de Claude GitHub App voor die repository is geïnstalleerd. Een bestaand token voor gewone cloudsessies is niet voldoende voor Project-threads.
## Ailoot · Het bedrijf en zijn projectenportefeuille
Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle.
Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.
Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.