# Claude Code Projects: Koordinator, Threads und Einschränkungen der Beta > So funktionieren Cloud-Threads in Claude Code Projects: GitHub App, Anweisungen, Speicher, Konflikte und Einschränkungen der Beta. Source: https://ailoot.ai/blog/de/claude-code-projects/ Canonical: https://ailoot.ai/blog/de/claude-code-projects/ Language: de Publisher: Ailoot (https://ailoot.ai/) Translation: guide-051 Revision: sha256-95273d08a878a6e65b39d82b26d15c7f1ccaae76874dfe98c75e64f59bfe56f4 Anthropic hat Projects in Claude Code kürzlich neu gestaltet. Es besteht nun aus einer einzigen koordinierenden Unterhaltung, die parallele Cloud-Sitzungen – Threads – für Aufgaben startet und Berichte von ihnen erhält. Ein Projekt lohnt sich, wenn Ihre Arbeit ein Ziel hat, das über eine einzelne Sitzung hinaus Bestand hat und neue Aufgaben mit sich bringt – zum Beispiel die Entwicklung eines GitHub-Repositorys über mehrere Wochen. Der Bedarf an paralleler Arbeit allein reicht nicht aus. Wenn Sie schnell eine einzelne Datei hier und jetzt korrigieren müssen, genügt eine gewöhnliche Sitzung. Die Arbeit wird von einem Koordinator geleitet – einer langlebigen Unterhaltung, in der Claude entscheidet, was aus Ihrer Nachricht in eine Aufgabe für einen Thread umgewandelt wird. Die Threads schreiben den Code: Jeder ist eine separate Claude-Code-Cloud-Sitzung auf einem eigenen Repository-Branch. Mehrere Threads können gleichzeitig laufen, jeder mit eigenem Kontext und eigenem Branch. Der Koordinator sieht, was ein Thread nach Abschluss meldet, aber nicht jeden einzelnen Schritt. Er meldet Ihnen abgeschlossene Pull Requests (Anfragen zum Zusammenführen von Änderungen) und bittet auf Ihre Anweisung einen Thread, sie zu überarbeiten oder zusammenzuführen. Im Folgenden finden Sie einen Überblick auf Grundlage der offiziellen Dokumentation von Anthropic: was Sie konfigurieren sollten, wie die Arbeit organisiert ist und welche Einschränkungen die Beta hat. Die Beta wird schrittweise verfügbar, zunächst für Pro- und Max-Konten, die bereits Cloud-Sitzungen von Claude Code genutzt und noch kein Projekt im gewöhnlichen Chat oder in Cowork erstellt haben. Wenn der Bereich Projects noch nicht angezeigt wird, können Sie sich auf die Warteliste setzen lassen.
Praktische Anleitungen zur Arbeit mit Ailoot finden Sie in der [Dokumentation](https://ailoot.ai/docs/).
## Was sind Claude Code Projects? Ein Projekt ist eine einzelne langlebige Unterhaltung mit einem Koordinator, der Repositorys, Speicher und Anweisungen zugeordnet sind. Sie schreiben dem Koordinator, und er entscheidet, ob er sofort antwortet oder einen Thread startet. Sie müssen nicht für jede Aufgabe manuell eine neue Sitzung öffnen. Ein Thread ist eine vollständige Claude-Code-Cloud-Sitzung: Er hat einen eigenen Kontext und einen eigenen Repository-Branch und öffnet bei Bedarf einen Pull Request. Der Koordinator kann mehrere Threads gleichzeitig offen halten – zum Beispiel korrigiert einer einen Fehler, ein anderer schreibt Tests und ein dritter aktualisiert die Dokumentation –, während er Ihre Fragen in der Hauptunterhaltung beantwortet. Zum Vergleich: Stellen Sie sich mehrere Tabs mit lokalen Claude-Code-Sitzungen vor, jede in einer eigenen Arbeitskopie eines Repositorys. Eine solche Kopie heißt Worktree – ein separater Ordner für einen Branch, damit sich lokale Sitzungen nicht gegenseitig stören. Sie wechseln selbst zwischen den Sitzungen und entscheiden, was Sie jeder zuweisen. Cloud-Threads benötigen keinen Worktree: Jeder Thread klont die Repositorys in seine eigene isolierte Cloud-Umgebung. Projects übernimmt die Koordination und entscheidet, wann ein neuer Thread erstellt werden sollte und wann nicht. Ein Projekt hat einen gemeinsamen Speicher und gemeinsame Anweisungen, die jeder neue Thread erhält. Im Abschnitt zur Einrichtung wird erklärt, was Sie darin speichern und wie sie an Threads weitergegeben werden. ## Wie sich das von einer gewöhnlichen Sitzung und einem Agententeam unterscheidet Wenn Sie bereits [verschachtelte Subagenten](https://ailoot.ai/blog/de/claude-code-nested-subagents/) innerhalb einer einzelnen Claude-Code-Sitzung ausführen, sollten Sie sie von Agententeams und Projekt-Threads unterscheiden. Ein Agententeam ist eine weitere Möglichkeit, Arbeit zu delegieren: Eine Sitzung startet für eine bestimmte Aufgabe Sitzungen von Teammitgliedern. Sie können es sowohl auf Ihrem eigenen Rechner als auch innerhalb einer Cloud-Sitzung ausführen. - **Agententeam** – Sitzungen von Teammitgliedern für eine bestimmte Aufgabe, die lokal oder in der Cloud gestartet werden können. Dies sind keine separaten Projekt-Threads. - **Ein Projekt und seine Threads** – die Arbeit läuft in der Cloud. Jeder Thread ist eine separate Sitzung auf einem eigenen Branch und läuft auch nach dem Schließen Ihres Laptops weiter. Eine lokale Sitzung kann nicht Teil eines Projekts sein. - **Agentenansicht** – ein Bildschirm, auf dem Sie mehrere lokale Sitzungen auf Ihrem Rechner beobachten können. Sie hat keinen Koordinator: Sie entscheiden, was Sie jeder Sitzung zuweisen. In der offiziellen Dokumentation von Anthropic wird ein eigener Punkt hervorgehoben: Parallele Arbeit allein ist kein Grund, ein Projekt zu erstellen. In einem Projekt startet Claude selbst Sitzungen und erhält deren Berichte; alle Sitzungen beginnen mit gemeinsamen Repositorys, Anweisungen und gemeinsamem Speicher. Während der gesamten Aufgabe bleibt die Arbeit in der Cloud. Ein ähnlicher Ansatz – ein Koordinator verteilt Aufgaben auf Agenten – wird in einem anderen Tool umgesetzt, das im Artikel über [Cursor Projects](https://ailoot.ai/blog/de/cursor-projects-coordinator-agents/) behandelt wird. Der Mechanismus ist anders, aber auch dort entscheidet der Koordinator, wer welche Aufgabe erhält. ## Was Sie vor Ihrem ersten Projekt konfigurieren sollten Prüfen Sie vor dem Erstellen eines Projekts drei Dinge. **1. GitHub-Konto und Claude GitHub App.** Wenn Sie GitHub bereits über `/web-setup` verbunden haben, ermöglicht dieses Token Ihren gewöhnlichen Cloud-Sitzungen den Zugriff auf das Repository. Für Projekt-Threads genügt es nicht: Sie benötigen ein verbundenes GitHub-Konto mit Push-Zugriff auf das Repository und die für dieses Repository installierte Claude GitHub App. Ohne sie kann ein Thread weder das Repository klonen noch einen Pull Request öffnen. **2. Projektanweisungen.** Die Projektanweisungen sind ein Text mit bis zu 16 000 Zeichen, der an jeden neuen Thread und an den Koordinator selbst gesendet wird. Schreiben Sie hier Informationen hinein, die Sie sonst in jeder Sitzung erneut erklären müssten: die Struktur des Repositorys, Code-Konventionen und die vor einem Pull Request erforderlichen Prüfungen. **3. Modell und Aufwandsstufe.** Standardmäßig führt ein neues Projekt jeden Thread mit dem Modell Opus und hohem Aufwand aus, den Koordinator dagegen mit niedrigem Aufwand. Laut Dokumentation „verbraucht diese Einstellung Ihr Plankontingent am schnellsten“ (Übersetzung; Original: draws on your plan fastest). Wenn Ihre Aufgaben unkompliziert sind, können Sie unter **Project settings \> General** ein kostengünstigeres Modell auswählen oder den Aufwand verringern. Thread- und Koordinatoreinstellungen werden separat geändert; die Dokumentation beschreibt sparsamere Optionen. Der Projektspeicher wird als gewöhnliche Dateien mit einer Indexdatei namens `MEMORY.md` gespeichert. Jeder neue Thread liest sie beim Start und greift bei Bedarf auf die anderen Dateien zu. Erkenntnisse aus einem Thread, die im Speicher abgelegt werden, stehen dem nächsten zur Verfügung, ohne dass sie erneut erzählt werden müssen. ## Was zu tun ist, wenn Threads denselben Code ändern Jeder Thread arbeitet auf seinem eigenen Branch und öffnet selbst einen Pull Request, wenn die Arbeit einen erfordert. Der Koordinator garantiert jedoch nicht, dass sich Aufgaben nie überschneiden: Wenn mehrere Threads im selben Codebereich landen, können Sie den betreffenden Thread über die Oberfläche bitten, den Konflikt zu lösen. Neben seinem Pull Request gibt es eine Schaltfläche Resolve conflicts, die eine Anweisung als Ihre Nachricht an den Thread sendet. Die offizielle Dokumentation empfiehlt, in den Projektanweisungen Präferenzen für die Anzahl der Threads festzulegen: Bitten Sie den Koordinator zum Beispiel, nicht mehr als zwei Threads gleichzeitig zu starten oder für neue Aufgaben im selben Bereich einen vorhandenen Thread wiederzuverwenden. Das ist eine Präferenz, an die sich der Koordinator nach Möglichkeit hält, und keine feste Begrenzung. Für sich genommen garantiert sie nicht, dass Threads nicht dieselbe Datei bearbeiten – ein bestehender Konflikt muss separat gelöst werden. Bei zusammenhängenden Aufgaben im selben Bereich können Sie einen aktiven oder inaktiven Thread wiederverwenden. War er länger als eine Stunde inaktiv, liest er beim Empfang einer neuen Nachricht den gesamten Verlauf erneut ein, was sich auf den Verbrauch des Abonnementkontingents auswirkt. Je klarer Aufgaben auf Dateien oder Module aufgeteilt sind, desto einfacher lässt sich parallel arbeiten. Ein eigener Artikel behandelt die Aufteilung einer großen Aufgabe in unabhängige Teile: wie sich das Programmieren an Tausende Agenten delegieren lässt. Der Maßstab ist dort ein anderer, aber das Prinzip der Aufteilung ist dasselbe. Solange der Unterhaltungscache aktiv ist (bei Pro- und Max-Tarifen innerhalb einer Stunde, sofern die Tariflimits es zulassen), verbraucht ein Thread weniger Tokens aus dem Abonnementkontingent, um seinen Verlauf erneut zu verarbeiten. Sobald der Cache abläuft, liest der Thread beim Empfang einer neuen Nachricht vor Arbeitsbeginn seinen gesamten Verlauf erneut ein. Bei einer neuen, unabhängigen Aufgabe kann es sparsamer sein, den Koordinator um einen neuen Thread zu bitten: Das kann weniger Tokens desselben Abonnementkontingents verbrauchen, als eine alte Sitzung mit umfangreichem Verlauf fortzusetzen, nachdem ihr Cache abgelaufen ist. ## Einschränkungen der Beta, die Sie vorab kennen sollten Prüfen Sie die Einschränkungen der Beta, bevor Sie ein Projekt für eine wichtige Aufgabe erstellen: - **Nur für Pro und Max verfügbar.** Team und Enterprise werden noch nicht unterstützt. - **Begrenzung auf 200 neue Threads pro Tag** je Konto, über alle Projekte zusammen. - **Ein Projekt gehört einer einzelnen Person.** Sie können einer anderen Person weder gemeinsamen Zugriff auf das Projekt noch Zugriff auf einen einzelnen Thread geben; außerdem bietet die Beta keine Organisationseinstellungen für Teams. - **Zugriff nur über claude.ai/code, die Desktop-App und die mobile App.** Projects funktioniert nicht in der Terminal-CLI, über Amazon Bedrock, Google Cloud Agent Platform oder Microsoft Foundry. - **Ein Projekt kann lokale Dateien und Tools nicht sehen.** Threads arbeiten mit GitHub-Repositorys, hochgeladenen Dateien und Google-Drive-Ordnern, aber nicht mit Dingen, die nur auf Ihrem Rechner vorhanden sind. Wenn Sie Terminalzugriff oder Zugriff auf Tools benötigen, die nur auf Ihrem Rechner verfügbar sind, verwenden Sie eine lokale Sitzung oder eine Agentenansicht für mehrere solcher Sitzungen. Wenn mehrere Personen gemeinsam in einem Arbeitsbereich arbeiten müssen, bietet Anthropic für Team und Enterprise ein separates Teamprodukt an: Claude Tag. Es befindet sich in einem Slack-Kanal; jedes Mitglied kann Claude eine Aufgabe geben, und alle im Kanal können die Arbeit sehen und steuern. Ein Projekt funktioniert anders: Es gehört nur Ihnen. Wenn Sie nur bestimmte lokale Dateien benötigen, können Sie sie in das Projekt hochladen; dann hat jeder Thread Zugriff darauf. Dadurch erhalten Sie keinen Zugriff auf lokale Tools. ## Wie es weitergeht Bevor Sie Ihren Arbeitsablauf auf Projects umstellen, erstellen Sie ein Testprojekt in einem unkritischen Repository: Verbinden Sie die GitHub App, schreiben Sie kurze Anweisungen, geben Sie dem Koordinator eine unabhängige Aufgabe und beobachten Sie, wie er sie bearbeitet. Dieser erste Durchlauf zeigt, ob Sie die Oberfläche für Koordinator und Threads verstehen. Er behandelt nicht die parallele Arbeit, Konflikte oder den Verbrauch des Kontingents über mehrere Aufgaben hinweg – das muss separat getestet werden.
### Quellen - [Claude Code Projects – offizielle Dokumentation von Anthropic](https://code.claude.com/docs/en/claude-projects)
Sie können Ailoot unter [ailoot.ai](https://ailoot.ai/) weiter erkunden.
## Fragen und Antworten ### Ist parallele Arbeit allein ein Grund für ein Project? Nutze ein Project für ein über mehrere Sitzungen laufendes Ziel, das gemeinsame Repositorys, Anweisungen und Speicher braucht. Eine schnelle lokale Änderung kann in einer normalen Sitzung bleiben. Projects-Threads laufen in isolierten Cloud-Umgebungen. ### Was prüfe ich, wenn ein Thread das Repository nicht klonen kann? Prüfe Push-Zugriff des verbundenen GitHub-Kontos und die Installation der Claude GitHub App für dieses Repository. Ein vorhandenes Token gewöhnlicher Cloud-Sitzungen genügt für Project-Threads nicht. ## Ailoot · Das Unternehmen und sein Projektportfolio Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle. Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe. Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.