Cloud-Sitzungen sind in Pro-, Max-, Ultra- und Team-Plänen sowie für Enterprise-Benutzer mit Premium-Sitzen oder Chat + Claude Code-Sitzen verfügbar. Wenn Ihr Zugriff über benutzerdefinierte Rollen gesteuert wird, benötigen Sie außerdem eine Rolle mit der Berechtigung für Cloud-Sitzungen, um Sitzungen auf der Infrastruktur von Anthropic aus dem Browser, den Apps oder dem Terminal zu starten. Bitten Sie einen Owner, sie unter Organization settings > Roles zu einer Ihrer Rollen hinzuzufügen.
- Browser: claude.ai/code, auch Claude Code im Web genannt
- Mobil: die Registerkarte Code in der Claude-App
- Desktop-App: wählen Sie in der Umgebungsauswahl unter Cloud eine Umgebung aus, wenn Sie eine Sitzung starten
- Terminal:
claude --cloud - Geplante Aufgaben in der Cloud: geplante und ausgelöste Ausführungen werden jeweils als Cloud-Sitzung ausgeführt
Diese Fälle werden auf anderen Seiten behandelt:
- Ihre erste Cloud-Sitzung starten: Erste Schritte mit Cloud-Sitzungen verbindet GitHub und führt Sie durch eine Aufgabe im Browser
- Viele Cloud-Sitzungen für ein Arbeitspaket: Mit einem Projekt startet Claude diese für Sie und behält sie im Blick
- Eine lokale Sitzung von einem anderen Gerät aus steuern: Sitzungen in Ihrem Terminal, Ihrer IDE oder der Desktop-App mit ausgewähltem Lokal werden auf Ihrem Computer ausgeführt, und mit Remote Control können Sie sie von Ihrem Telefon oder Browser aus erreichen
Cloud-Umgebungen
Jede Cloud-Sitzung wird in einer Cloud-Umgebung ausgeführt, der gespeicherten Konfiguration, die Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte steuert.- Ihre erste Umgebung: Wenn Sie noch keine Umgebung haben, richtet das Onboarding eine Standard-Umgebung mit eingeschränktem Netzwerkzugriff ein. Siehe Die Standard-Umgebung, um zu erfahren, wie das auf Ihrem Plan funktioniert
- Welche Umgebung eine Sitzung verwendet: Siehe Die Standard-Umgebung, um zu erfahren, wie Sitzungen eine Umgebung auswählen, wenn Sie mehr als eine haben
- Ändern, was Sitzungen erreichen oder beim Start ausführen können: Siehe Cloud-Umgebungen konfigurieren
- Was ohne Konfiguration installiert ist: Siehe Installierte Tools
GitHub-Authentifizierungsoptionen
Cloud-Sitzungen benötigen Zugriff auf Ihre GitHub-Repositories, um Code zu klonen und Branches zu pushen. Sie können Zugriff auf zwei Arten gewähren:
Diese Funktionen setzen voraus, dass die Claude GitHub App auf dem Repository installiert ist:
- Auto-fix: Die Installation der Claude GitHub App auf einem Repository ermöglicht auch Auto-fix für Pull Requests darin
- Projekte: Threads in einem Projekt benötigen die Claude GitHub App auf jedem Repository, das sie klonen, unabhängig davon, welche Methode Sie zum Verbinden verwendet haben. Siehe GitHub-Zugriff einrichten
/web-setup-Anleitung, einschließlich dessen, was /web-setup speichert und wie Sie es entfernen.
Organisationen mit aktivierter Zero Data Retention oder mit angewendeter HIPAA-Konfiguration können
/web-setup oder andere Cloud-Sitzungsfunktionen nicht verwenden. Organisationen, die kundenverwaltete Verschlüsselungsschlüssel (CMEK) verwenden, können ebenfalls keine Cloud-Sitzungen starten.Quick setup für Team und Enterprise
Quick setup ist eine Organisationseinstellung, die Schritte bei der GitHub- und Umgebungseinrichtung der Mitglieder entfallen lässt. Bei Team- und Enterprise-Plänen ist sie standardmäßig deaktiviert. Folgendes ändert sich für Mitglieder, wenn sie aktiviert ist:/web-setup: Mitglieder können GitHub mit/web-setupverbinden. Solange die Einstellung deaktiviert ist, ist der Befehl ausgeblendet- Abfrage zur GitHub App: Das Browser-Onboarding überspringt die Abfrage zur Installation der Claude GitHub App
- Erste Umgebung: Das Browser-Onboarding erstellt die Standard-Umgebung für Mitglieder, anstatt das Umgebungsformular anzuzeigen
Aufgaben zwischen Terminal und Cloud verschieben
Diese Workflows erfordern die Claude Code CLI, die bei demselben claude.ai-Konto angemeldet ist. Sie können neue Cloud-Sitzungen von Ihrem Terminal aus starten oder Cloud-Sitzungen in Ihr Terminal ziehen, um lokal fortzufahren. Cloud-Sitzungen bleiben bestehen, auch wenn Sie Ihren Laptop schließen, und Sie können sie von überall aus überwachen, einschließlich der Claude Mobile-App.Von der CLI ist die Sitzungsübergabe unidirektional: Sie können Cloud-Sitzungen mit
--teleport in Ihr Terminal ziehen, aber Sie können keine vorhandene Terminal-Sitzung in die Cloud verschieben. Das Flag --cloud mit einer Aufgabenbeschreibung erstellt eine neue Cloud-Sitzung für Ihr aktuelles Repository; mit -p und einer Sitzungs-ID oder claude.ai/code-URL reiht es stattdessen eine Nachricht in diese vorhandene Sitzung ein. Die Desktop-App kann eine lokale Sitzung in ihrem Code-Tab über das Menü Open in in die Cloud senden.Eine Cloud-Sitzung von Ihrem Terminal aus starten
Starten Sie eine Cloud-Sitzung von der Befehlszeile mit dem Flag--cloud:
Branch <name> is not on GitHub ausgibt, siehe Branch is not on GitHub.
--cloud funktioniert mit einem Repository auf einmal. Die Aufgabe wird in der Cloud ausgeführt, während Sie lokal weiterarbeiten. Die ältere Schreibweise --remote funktioniert immer noch als veralteter Alias für --cloud.
Während der Cloud-Container startet, zeigt die CLI eine Live-Checkliste von Setup-Schritten an, wie z. B. das Klonen des Repositories und das Ausführen Ihres Setup-Skripts. Sie reiht Nachrichten ein, die Sie während der Bereitstellung eingeben, und sendet sie, sobald die Sitzung bereit ist.
--cloud erstellt Cloud-Sitzungen. --remote-control ist nicht verwandt: Es stellt eine lokale CLI-Sitzung zur Überwachung und Steuerung von claude.ai oder der Claude-App aus bereit. Siehe Remote Control.Tipps für Cloud-Aufgaben
Planen Sie lokal, führen Sie in der Cloud aus: Für komplexe Aufgaben starten Sie Claude im Plan Mode, um den Ansatz zu besprechen, und senden Sie dann die Arbeit in die Cloud:--cloud-Befehl erstellt seine eigene Cloud-Sitzung, die unabhängig ausgeführt wird. Sie können mehrere Aufgaben starten und sie werden alle gleichzeitig in separaten Sitzungen ausgeführt:
Senden Sie lokale Repositories ohne GitHub
Wenn Sieclaude --cloud aus einem Repository ausführen, das kein Git-Remote hat, oder aus einem github.com-Repository, auf dem die Claude GitHub App nicht installiert ist, bündelt Claude Code Ihr lokales Repository und lädt es direkt in die Cloud-Sitzung hoch. Dies gilt auch, wenn Sie GitHub mit /web-setup verbunden haben.
Bei einem vollständigen Klon enthält das Bündel Ihre Repository-Historie über alle Branches hinweg sowie nicht committete Änderungen an verfolgten Dateien.
Was mit nicht committeten Änderungen an sensiblen Dateien geschieht, hängt von Ihrer Plattform ab:
- macOS, Linux und WSL: Claude Code lässt nicht committete Änderungen an Dateien, die wie Anmeldedaten oder Schlüssel benannt sind, aus dem Upload weg. Dies umfasst
.env-Dateien, Terraform-*.tfvars-Dateien und Schlüsseldateien wieid_rsaund*.pem. Außerdem lässt es nicht committete Änderungen an Dateien weg, die ein Git-Filter wie Git LFS verwaltet. Ein HinweisLeft on this machine:nennt die weggelassenen Dateien, und die Sitzung startet jeweils mit der committeten Version der Datei oder ohne die Datei, wenn keine committet ist. - Natives Windows: Nicht committete Änderungen an verfolgten Dateien werden unverändert hochgeladen, unabhängig vom Namen der Datei. Stashen oder verwerfen Sie eine Änderung, die Sie nicht in der Cloud-Sitzung haben möchten, bevor Sie die Sitzung starten.
CCR_FORCE_BUNDLE=1:
- Das Verzeichnis muss ein Git-Repository mit mindestens einem Commit sein
- Das gebündelte Repository muss unter 100 MB liegen. Größere Repositories fallen auf das Bündeln nur des aktuellen Branches zurück, dann auf einen einzelnen gequetschten Snapshot des Arbeitsbaums, und schlagen nur fehl, wenn der Snapshot immer noch zu groß ist
- Nicht verfolgte Dateien sind nicht enthalten; führen Sie
git addauf Dateien aus, die die Cloud-Sitzung sehen soll - Auf macOS, Linux und WSL weigert sich Claude Code den Upload, wenn es eine Git-Einstellung nicht befolgen kann, die beeinflusst, welche Attributregeln auf Ihre Dateien angewendet werden, wie
core.attributesFile, das in einer eingebundenen Konfigurationsdatei gesetzt ist. Die Ablehnungsmeldung benennt die Einstellung und die Lösung - Sitzungen, die aus einem Bündel erstellt wurden, können nur dann zurück zu einem GitHub-Remote pushen, wenn Ihre GitHub-Verbindung Push-Zugriff auf dieses Repository hat
Not uploading this working tree: enthält, die Ursache nennt und angibt, was zu ändern ist. Dies sind die häufigsten Ursachen:
- Ältere Git-Version: Das installierte Git ist älter als 2.31. Aktualisieren Sie Git und versuchen Sie es dann erneut.
- Ein Checkout-Layout, das der Upload nicht unterstützt: Sie haben innerhalb eines Submoduls gestartet, in einem Klon, der mit
git clone --separate-git-dir,--sharedoder--referenceerstellt wurde, in einem Checkout mit gesetztemcore.worktreeoder in einem Repository, das seine Refs im Reftable-Format speichert. Starten Sie stattdessen vom Haupt-Checkout eines Klons, der mit einem einfachengit cloneerstellt wurde. - Ein verknüpfter Worktree mit Sparse Checkout:
git sparse-checkoutschreibt Einstellungen in die eigeneconfig.worktree-Datei des Worktrees, die der Upload nicht akzeptiert. Daher wird ein Worktree mit diesen Einstellungen nicht hochgeladen, ebenso wenig einer, den Claude Code mitworktree.sparsePathserstellt hat. Starten Sie stattdessen vom Haupt-Checkout des Repositorys. - Git-Konfiguration innerhalb des Working Trees: Ihre Git-Konfiguration bindet eine Datei ein, die innerhalb des Checkouts liegt, beispielsweise über einen
include.path-Eintrag, der in das Repository zeigt. Verschieben Sie diese Datei aus dem Working Tree heraus oder entfernen Sie das Include, und versuchen Sie es dann erneut.
git clone --filter erstellter partieller Klon als Snapshot seines Working Trees ohne Historie hochgeladen, sofern der Klon jede verfolgte Datei lokal enthält.
Wenn sich das Repository bei claude --cloud auf GitHub befindet, können Sie den Upload und seine Anforderungen vermeiden: Pushen Sie Ihren Branch, installieren Sie die Claude GitHub App im Repository und starten Sie die Sitzung erneut, damit sie von GitHub klont.
Senden Sie Folgenachrichten von der CLI
Sobald eine Cloud-Sitzung ausgeführt wird, unabhängig davon, wo sie ausgeführt wird, senden Sie ihr eine Folgenachricht von derclaude CLI auf jeder Maschine, auf der Sie mit claude auth login angemeldet sind. Die CLI authentifiziert sich mit Ihren Anthropic-Kontoanmeldedaten und sendet keinen lokalen Sitzungsstatus, daher muss der Befehl nicht von der Maschine ausgeführt werden, die die Sitzung gestartet hat.
Der Befehl postet eine Nachricht und beendet sich:
echo "your message" | claude -p --cloud <session-id>.
Für <session-id> übergeben Sie die bloße ID, wie session_... oder cse_..., oder die claude.ai/code/<id>-URL der Sitzung, mit oder ohne Schema oder Abfragezeichenfolge. Finden Sie die ID in Ihrer Sitzungsliste unter claude.ai/code.
--cloud erfordert ein Anthropic-Konto. Es ist nicht verfügbar, wenn Claude Code für Amazon Bedrock, Google Cloud’s Agent Platform oder einen anderen Drittanbieter konfiguriert ist. Ein LLM-Gateway, das nur über ANTHROPIC_BASE_URL konfiguriert ist, zählt nicht als Drittanbieter für diese Überprüfung, aber Sie müssen sich immer noch mit claude auth login anmelden. Die allow_remote_sessions-Richtlinie Ihrer Organisation muss auch aktiviert sein. Ein Owner kann sie in den Claude Code-Admin-Einstellungen unter claude.ai/admin-settings/claude-code aktivieren.Ausgabe
Bei Erfolg druckt der Befehl die Sitzungs-ID und einen Link zum Anzeigen der Sitzung:--output-format json für ein maschinenlesbares Ergebnis: {ok, session_id, url} bei Erfolg oder {ok: false, session_id, error}, wenn der Send fehlschlägt, beispielsweise wenn die Sitzung fehlt oder archiviert ist. Konfigurationsfehler, wie ein nicht unterstützter Anbieter oder eine deaktivierte Organisationsrichtlinie, werden ohne JSON auf stderr gedruckt. --output-format stream-json wird nicht mit --cloud <session-id> unterstützt.
Wenn der Versand fehlschlägt, siehe Fehler beim Senden an eine Cloud-Sitzung.
Eine Cloud-Sitzung in Ihrem Terminal fortsetzen
Ziehen Sie eine Cloud-Sitzung in Ihr Terminal mit einer dieser Methoden:- Mit
--teleport: Führen Sie von der Befehlszeileclaude --teleportfür eine interaktive Sitzungsauswahl aus, oderclaude --teleport <session-id>, um eine bestimmte Sitzung direkt fortzusetzen. Wenn Sie nicht committete Änderungen haben, werden Sie aufgefordert, diese zuerst zu stashen.--resumeöffnet eine Konversation aus der lokalen Historie dieser Maschine erneut und listet keine Cloud-Sitzungen auf. - Mit
/teleport: Führen Sie innerhalb einer vorhandenen CLI-Sitzung/teleportoder/tpaus, um die gleiche Sitzungsauswahl zu öffnen, ohne Claude Code neu zu starten. - Von
/tasks: Führen Sie/tasksaus, um Ihre Hintergrund-Sitzungen zu sehen, drücken Sie dannt, um in eine zu teleportieren. - Von claude.ai/code: Wählen Sie Open in > Terminal aus dem Sitzungsmenü, um einen Befehl zu kopieren, den Sie in Ihr Terminal einfügen können.
- Von innerhalb der Cloud-Sitzung: Geben Sie
/teleportein und Claude Code antwortet mit dem genauenclaude --teleport <session-id>-Befehl für diese Sitzung, bereit zum Ausführen aus einem Checkout des Repositorys.
Wenn Claude Code die Cloud-Sitzung komprimiert hat, was in einer langen Sitzung automatisch geschieht, werden die früheren Nachrichten, die es zusammengefasst hat, nicht in Ihr Terminal kopiert. Claude setzt auf Basis der Zusammenfassung fort. Um die ursprünglichen Nachrichten zu lesen, scrollen Sie in der Cloud-Sitzung auf claude.ai oder in der Claude Mobile-App nach oben.
/remote-control in der lokalen Sitzung.
Teleport-Anforderungen
Teleport überprüft diese Anforderungen, bevor eine Sitzung fortgesetzt wird. Wenn eine Anforderung nicht erfüllt ist, sehen Sie einen Fehler oder werden aufgefordert, das Problem zu beheben.
Wenn Teleport den Branch der Sitzung abruft, wartet der Fetch nie auf Eingaben in Ihrem Terminal. Wenn Git oder ssh nach einem Passwort, einer Schlüssel-Passphrase oder der Bestätigung eines neuen SSH-Hosts fragen würde, schlägt der Fetch fehl, und der Checkout funktioniert dann nur, wenn Ihr lokaler Klon den Branch bereits enthält. Für die beiden SSH-Fälle laden Sie Ihren Schlüssel in
ssh-agent und führen Sie zuvor einmal manuell git fetch aus, um den Host zu registrieren.
--teleport ist nicht verfügbar
Teleport erfordert eine Authentifizierung über ein claude.ai-Abonnement. Suchen Sie den Fall, der auf Sie zutrifft:
- Sie sind mit einem API-Schlüssel oder einem Console-Konto angemeldet: Führen Sie
claude auth loginin Ihrer Shell aus und melden Sie sich dann mit claude.ai an - Der Fehler nennt Ihren Anbieter: Cloud-Sitzungen sind über Drittanbieter nicht verfügbar. Siehe die Fehlertabelle
- Sie sind bereits über claude.ai angemeldet: Ihre Organisation hat Cloud-Sitzungen möglicherweise deaktiviert
Mit Sitzungen arbeiten
Sitzungen werden in der Seitenleiste unter claude.ai/code angezeigt. Von dort aus können Sie Änderungen überprüfen, mit Teamkollegen teilen, abgeschlossene Arbeiten archivieren oder Sitzungen dauerhaft löschen.Berechtigungsmodi in Cloud-Sitzungen
Sie wählen den Berechtigungsmodus einer Cloud-Sitzung aus dem Modus-Dropdown, sowohl wenn Sie die Aufgabe erstellen als auch während die Sitzung läuft. Claude Code setzt eine Sitzung in dem Berechtigungsmodus fort, in dem sie sich befand, wenn Sie eine der folgenden Aktionen ausführen:- Eine Sitzung erneut öffnen, deren von Anthropic gehostete Umgebung abgelaufen ist
- Eine Nachricht an eine Sitzung senden, die ein selbstgehosteter Runner freigegeben hat, während sie untätig war
Änderungen überprüfen
Nachdem Claude seine Änderungen in einen Branch gepusht hat, zeigt die Karte Changes im Bereich neben dem Chat die hinzugefügten und entfernten Zeilen an, wie+42 -18. Klicken Sie auf die Zeilenzahlen auf der Karte Changes, um die Diff-Ansicht zu öffnen.
- Sie können auch in der Titelleiste der Sitzung oder im ⋮-Menü der Leiste auf Changes klicken.
- Um den Bereich anzuzeigen, wenn er ausgeblendet ist, klicken Sie auf das Symbol Show session rail in der Titelleiste der Sitzung oder im ⋮-Menü der Leiste.
- Kommentieren: Hinterlassen Sie Inline-Kommentare zu bestimmten Zeilen und senden Sie die Kommentare dann mit Ihrer nächsten Nachricht an Claude
- Vergleichen: Die Diff-Ansicht vergleicht die Änderungen der Sitzung standardmäßig mit ihrem Basis-Branch. Um gegen einen anderen Branch im Repository zu vergleichen, wählen Sie Compare against und wählen Sie einen aus
textconv-Filter, die im Repository konfiguriert sind, nicht.
Diese Schritte werden an anderer Stelle behandelt:
- Die vollständige Anleitung, einschließlich PR-Erstellung: siehe Überprüfung und Iteration
- Claude den PR automatisch auf CI-Fehler und Review-Kommentare überwachen lassen: siehe Auto-fix Pull Requests
Fehlerbehebung bei einer fehlenden Datei in der Diff-Ansicht
Eine erwartete Datei kann in der Dateiliste der Diff-Ansicht fehlen, wenn diese mit dem Basis-Branch vergleicht, unabhängig davon, ob die Sitzung Änderungen gepusht hat oder nicht:- Noch keine Änderungen gepusht: Die Liste enthält Claudes eigene Bearbeitungen, aber keine Änderungen durch Befehle, die Claude ausgeführt hat, etwa einen Formatierer
- Änderungen gepusht: Die Liste enthält gepushte Commits, aber keine Änderungen, die nach dem letzten Push vorgenommen wurden
Kontext verwalten
Cloud-Sitzungen unterstützen integrierte Befehle, die Textausgabe erzeugen. Befehle, die nur in der Terminal-Schnittstelle ausgeführt werden, wie/plugin oder /resume, sind nicht verfügbar. Befehle, die eine Auswahl oder ein Panel in der Terminal-Schnittstelle öffnen, verhalten sich in Cloud-Sitzungen unterschiedlich:
/model,/effort,/colorund/rename: Übergeben Sie den Wert als Argument, zum Beispiel/model sonnet, anstatt die Terminal-Auswahl oder den Schieberegler zu öffnen. Die Argumentformen folgen den Verfügbarkeitshinweisen jedes Befehls./fast: schaltet den Fast-Modus für die Sitzung um, wenn Fast-Modus auf Ihrem Konto verfügbar ist. Erfordert Claude Code v2.1.271 oder später in der Umgebung der Sitzung./config: In Ihrem Browser unter claude.ai/code öffnet dies Settings > Code oder Settings > Claude Code, anstatt einen Wert zu setzen. Um eine Einstellung für eine Cloud-Sitzung zu ändern, setzen Sie eine Umgebungsvariable in der Umgebung. In einer Sitzung mit einem Repository außerhalb der Threads eines Projekts committen Sie den Schlüssel stattdessen in die.claude/settings.jsondieses Repositorys. Einstellungen in Cloud-Sitzungen listet auf, was jede Sitzung liest.
Auto-Kompaktierung wird automatisch ausgeführt, wenn sich das Kontextfenster der Kapazität nähert. Cloud-Sitzungen setzen
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE selbst, daher wird die Kompaktierung bereits vor dem Ende des Auto-Compact-Fensters ausgelöst, anstatt wenn das Fenster sich füllt. Dieser Wert überschreibt einen, den Sie in Ihren Umgebungsvariablen hinzufügen, daher ändert das Hinzufügen der Variablen dort nicht, wann die Kompaktierung ausgelöst wird.
Um das Auto-Compact-Fenster stattdessen zu ändern, setzen Sie CLAUDE_CODE_AUTO_COMPACT_WINDOW in Ihren Umgebungsvariablen, oder führen Sie /autocompact mit einer Token-Anzahl in einer Sitzung aus, in der die Variable nicht gesetzt ist.
Subagenten funktionieren genauso wie lokal. Claude kann sie mit dem Agent-Tool starten, um Recherche oder parallele Arbeit in ein separates Kontextfenster auszulagern und so die Hauptkonversation schlanker zu halten. Außerhalb der Threads eines Projekts werden Subagenten, die in .claude/agents/ Ihres Repositorys definiert sind, automatisch geladen.
Agent-Teams sind standardmäßig deaktiviert, können aber aktiviert werden, indem Sie CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 zu Ihren Umgebungsvariablen hinzufügen.
Plugin-Vorschläge in der Konversation
Eine Karte in der Konversation, die ein oder mehrere Plugins mit einer Schaltfläche Add auflistet, bedeutet, dass Claude Plugins für Ihre Aufgabe vorschlägt. Claude kann diese Vorschläge machen, ohne dass Sie danach fragen. Sie müssen nicht reagieren, und Claude setzt die Aufgabe in jedem Fall fort.Ein vorgeschlagenes Plugin hinzufügen oder entfernen
Wählen Sie bei einem Plugin Add, um es für Ihr claude.ai-Konto zu aktivieren, wo es auch nach dem Ende der Sitzung aktiviert bleibt. Um dies rückgängig zu machen, öffnen Sie das hinzugefügte Plugin über die Karte, wählen Sie Manage, um zur Seite des Plugins auf claude.ai zu gelangen, und entfernen Sie das Plugin auf dieser Seite.Plugin-Vorschläge deaktivieren
Um zu verhindern, dass Claude Plugins vorschlägt, verweigern Sie die ToolsSearchPlugins und SuggestPluginInstall mit Berechtigungsregeln. In einer Sitzung mit einem Repository außerhalb eines Projekts committen Sie die Regeln in die .claude/settings.json dieses Repositorys und listen beide Tool-Namen unter permissions.deny auf:
.claude/settings.json des Repositorys, einschließlich dieser deny-Regeln, wenn die verwalteten Einstellungen, die für die Sitzung gelten, allowManagedPermissionRulesOnly setzen. Legen Sie die Regeln in diesem Fall stattdessen in diesen verwalteten Einstellungen fest. Für andere Konfigurationen, etwa eine Sitzung mit mehreren Repositorys oder einen Cloud-Thread in einem Projekt, sehen Sie nach, welche Einstellungen eine Cloud-Sitzung erreichen.
Eine eingereihte Nachricht zurücknehmen
Wenn Sie eine Nachricht senden, während Claude arbeitet, wird die Nachricht eingereiht, bis Claude sie liest. Um eine eingereihte Nachricht zurückzunehmen, klicken Sie auf das ✕ darauf. Der Text kehrt in das Nachrichtenfeld zurück, damit Sie ihn bearbeiten oder etwas anderes senden können. Wenn Claude die Nachricht bereits gelesen hat, bleibt sie in der Konversation.Sitzungen teilen
Um eine Sitzung zu teilen, schalten Sie ihre Sichtbarkeit gemäß den Kontotypen unten um. Danach teilen Sie den Sitzungslink wie gewohnt. Empfänger sehen den neuesten Status, wenn sie den Link öffnen, aber ihre Ansicht wird nicht in Echtzeit aktualisiert.Teilen von einem Enterprise- oder Team-Konto
Für Enterprise- und Team-Konten funktioniert das Teilen wie folgt:- Sichtbarkeitsoptionen: Private und Team. Team-Sichtbarkeit macht die Sitzung für andere Mitglieder Ihrer claude.ai-Organisation sichtbar
- Repository-Zugriff: Die Überprüfung ist standardmäßig aktiviert, basierend auf dem GitHub-Konto, das mit dem Konto des Empfängers verbunden ist
- Ihr Name: Der Anzeigename Ihres Kontos ist für alle Empfänger mit Zugriff sichtbar
- Slack-Sitzungen: Claude in Slack-Sitzungen werden automatisch mit Team-Sichtbarkeit geteilt
Teilen von einem Max-, Ultra- oder Pro-Konto
- Sichtbarkeitsoptionen: Private und Public. Public-Sichtbarkeit macht die Sitzung für jeden Benutzer sichtbar, der bei claude.ai angemeldet ist
- Repository-Zugriff: Die Überprüfung ist standardmäßig nicht aktiviert
- Sensible Inhalte: Überprüfen Sie Ihre Sitzung, bevor Sie sie teilen. Sitzungen können Code und Anmeldedaten aus privaten GitHub-Repositorys enthalten
- Wenn das Einstellungsmenü Code statt Claude Code anzeigt: Gehen Sie zu Privacy, wo sich diese Einstellungen befinden
- Andernfalls: Gehen Sie zu Claude Code > Sharing settings
Sitzungen archivieren
Archivieren Sie eine Sitzung, um sie aus der Sitzungsliste der Seitenleiste zu entfernen. Um eine Sitzung zu archivieren, bewegen Sie den Mauszeiger in der Seitenleiste über sie, öffnen Sie ihr ⋯-Menü und wählen Sie Archive.Eine archivierte Sitzung finden
Um Ihre archivierten Sitzungen anzuzeigen, gehen Sie zu claude.ai/code/sessions und öffnen Sie den Tab Archived. Um eine Sitzung wieder in die Sitzungsliste der Seitenleiste aufzunehmen, bewegen Sie den Mauszeiger auf diesem Tab über sie, öffnen Sie ihr ⋮-Menü und wählen Sie Unarchive.Sitzungen löschen
Das Löschen einer Sitzung entfernt die Sitzung und ihre Daten dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden. Löschen Sie eine Sitzung über die Seitenleiste, über das Sitzungsmenü oder über den Tab Archived, falls Sie sie bereits archiviert haben:- Von der Seitenleiste: Bewegen Sie den Mauszeiger über die Sitzung, öffnen Sie ihr ⋯-Menü und wählen Sie Delete
- Vom Sitzungsmenü: Öffnen Sie eine Sitzung, wählen Sie das Dropdown-Menü neben dem Sitzungstitel und wählen Sie Löschen
- Vom Tab Archived: Bewegen Sie den Mauszeiger auf dem Tab Archived über die Sitzung, öffnen Sie ihr ⋮-Menü und wählen Sie Delete
Auto-fix Pull Requests
Claude kann einen Pull Request überwachen und automatisch auf CI-Fehler und Review-Kommentare reagieren. Claude abonniert GitHub-Aktivitäten auf dem PR, und wenn eine Überprüfung fehlschlägt oder ein Reviewer einen Kommentar hinterlässt, untersucht Claude das Problem und pusht eine Lösung, wenn eine klar ist.Auto-fix erfordert, dass die Claude GitHub App auf Ihrem Repository installiert ist. Falls noch nicht geschehen, installieren Sie sie von der GitHub App-Seite.
- PRs, die in einer Cloud-Sitzung erstellt wurden: Öffnen Sie die Sitzung unter claude.ai/code und suchen Sie den Pull Request in der Changes-Karte. Öffnen Sie das ⋮-Menü neben dem Titel des Pull Requests und aktivieren Sie Auto-fix
- Von Ihrem Terminal: Führen Sie
/autofix-praus, während Sie auf dem PR’s Branch sind. Claude Code erkennt den offenen PR mitgh, spawnt eine Cloud-Sitzung und aktiviert Auto-fix in einem Schritt - Von der Mobile-App: Sagen Sie Claude, den PR zu auto-fixen, zum Beispiel „watch this PR and fix any CI failures or review comments“
- Jeder vorhandene PR: Fügen Sie die PR-URL in eine Sitzung ein und sagen Sie Claude, den PR zu auto-fixen
Wie Claude auf PR-Aktivität reagiert
Wenn Auto-fix aktiv ist, empfängt Claude GitHub-Events für den PR, einschließlich neuer Review-Kommentare und CI-Check-Fehler. Für jedes Event untersucht Claude das Problem und entscheidet, wie vorgegangen wird:- Klare Fixes: Wenn Claude sich einer Lösung sicher ist und sie nicht mit früheren Anweisungen in Konflikt steht, nimmt Claude die Änderung vor, pusht sie und erklärt, was getan wurde, in der Sitzung
- Mehrdeutige Anfragen: Wenn ein Reviewer-Kommentar auf mehrere Arten interpretiert werden könnte oder etwas architektonisch Bedeutsames betrifft, fragt Claude Sie, bevor er handelt
- Doppelte oder keine Aktion erforderlich Events: Wenn ein Event ein Duplikat ist oder keine Änderung erfordert, notiert Claude es in der Sitzung und fährt fort
Sicherheit und Isolation
Jede Cloud-Sitzung ist von Ihrem Computer und von anderen Sitzungen durch mehrere Schichten getrennt:- Isolierte virtuelle Maschinen: Jede Sitzung wird in einer isolierten, von Anthropic verwalteten VM ausgeführt. Sitzungen, die Ihre Organisation zu einer selbstgehosteten Umgebung leitet, werden stattdessen auf Ihrer eigenen Infrastruktur ausgeführt, wo Isolation die Verantwortung Ihrer Bereitstellung ist
- Netzwerkzugriffskontrolle: In von Anthropic gehosteten Umgebungen ist der Netzwerkzugriff standardmäßig begrenzt und kann deaktiviert werden. Siehe Netzwerkzugriff für die Zugriffsstufen, die standardmäßig zulässigen Domänen und den Datenverkehr, der nicht durch die Zulassungsliste läuft. In einer selbstgehosteten Umgebung beschränken Sie den Sitzungs-Egress an Ihrer eigenen Netzwerkgrenze. Wenn Claude Code mit deaktiviertem Netzwerkzugriff ausgeführt wird, kann Claude Code immer noch mit der Anthropic API kommunizieren, was möglicherweise ermöglicht, dass Daten die VM verlassen.
- Schutz von Anmeldedaten: In von Anthropic gehosteten Umgebungen befinden sich Git-Anmeldedaten und Signaturschlüssel außerhalb der Sandbox, und ein Proxy authentifiziert sich im Namen der Sitzung mit scoped Credentials. In einer selbstgehosteten Umgebung stellt Ihre Bereitstellung Git-Anmeldedaten bereit; siehe Git konfigurieren
- Netzwerk-Secrets: In von Anthropic gehosteten Umgebungen bleiben Schlüssel, die Sie zu einer Cloud-Umgebung hinzufügen, auf die gleiche Weise außerhalb der Sandbox und werden an übereinstimmende Anfragen angehängt, nachdem diese die Sitzung verlassen haben. Eine selbstgehostete Umgebung hat keine Netzwerk-Secrets
- Sichere Analyse: Code wird in der isolierten Umgebung der Sitzung analysiert und geändert, bevor PRs erstellt werden
Fehlerbehebung
Für Runtime-API-Fehler, die im Gespräch angezeigt werden, wieAPI Error: 500, 529 Overloaded, 429 oder Prompt is too long, siehe die Fehlerreferenz. Diese Fehler und ihre Lösungen werden mit der CLI und der Desktop-App geteilt. Die folgenden Abschnitte behandeln Probleme, die spezifisch für Cloud-Sitzungen sind.
Sitzungserstellung fehlgeschlagen
Wenn eine neue Sitzung mitSession creation failed fehlschlägt oder bei der Bereitstellung steckenbleibt, konnte Claude Code eine VM für die Sitzung nicht zuordnen.
- Überprüfen Sie status.claude.com auf Cloud-Sitzungs-Incidents
- Versuchen Sie es nach einer Minute erneut, da die Kapazität bei Bedarf bereitgestellt wird
- Bestätigen Sie, dass Ihre GitHub-Verbindung das Repository erreichen kann, indem Sie Keine Repositories werden nach dem Verbinden von GitHub angezeigt befolgen
Your new session couldn’t start
Ihr Prompt befindet sich wieder im Eingabefeld, aus dem Sie ihn gesendet haben.- Verbindung unterbrochen: Überprüfen Sie Ihre Internetverbindung sowie ein eventuell verwendetes VPN oder einen Proxy, und senden Sie Ihren Prompt dann erneut
- Serverfehler: Warten Sie einen Moment und senden Sie Ihren Prompt dann erneut. Wenn der Hinweis erneut erscheint, überprüfen Sie status.claude.com
Can’t rewind to this message
Rewind to here schlägt bei jeder Nachricht außer der neuesten mit diesem Fehler fehl, wenn Ihre Sitzung auf einem selbst gehosteten Runner mit Claude Code vor v2.1.246 läuft. Bitten Sie die Person, die die Runner Ihrer Organisation betreibt, diese zu aktualisieren.Unable to get organization UUID
claude --cloud und claude --teleport erfordern eine Anmeldung mit einem claude.ai-Konto. Wenn Sie sich stattdessen mit einem API-Schlüssel oder einer Console-Anmeldung authentifizieren oder Ihre gespeicherten Kontodaten veraltet sind, sehen Sie eine der folgenden Meldungen:
Unable to get organization UUIDCloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.Error loading Claude Code sessionsin der Sitzungsauswahl, wenn Sieclaude --teleportohne eine Sitzungs-ID ausführen
claude auth login in Ihrer Shell aus, um sich mit Ihrem claude.ai-Konto anzumelden, und versuchen Sie dann den Befehl erneut. Innerhalb einer laufenden Sitzung bewirkt /login dasselbe. Wenn der Fehler stattdessen Ihren Anbieter benennt, siehe die Fehlertabelle: Cloud-Sitzungen sind nicht über Drittanbieter verfügbar.
Von v2.1.274 bis v2.1.289 lautete die Anmeldemeldung Claude Code cloud sessions require authentication with a Claude.ai account. API key authentication is not sufficient. Please run /login to authenticate, or check your authentication status with /status.
Branch is not on GitHub
Wennclaude --cloud eine Zeile ausgibt, die mit Branch <name> is not on GitHub beginnt, startet die Cloud-Sitzung trotzdem, aber nicht von Ihrem Branch aus. Die Zeile nennt, wo die Sitzung stattdessen startet: bei einem gepushten Commit aus dem Verlauf Ihres Branches oder beim Standard-Branch des Repositorys. Commits, die nur auf Ihrem Rechner existieren, sowie nicht committete Änderungen sind nicht in der Sitzung enthalten.
Diese Zeile sehen Sie beispielsweise, wenn Sie den Branch nie gepusht haben oder GitHub ihn gelöscht hat, nachdem sein Pull Request gemergt wurde. Wenn der in der Zeile genannte Ausgangspunkt enthält, was Ihre Aufgabe benötigt, verwenden Sie die Sitzung so, wie sie ist. Andernfalls pushen Sie den Branch und starten Sie eine neue Sitzung, damit diese Ihren Branch klont.
Remote Control-Sitzung abgelaufen oder Zugriff verweigert
--teleport verbindet sich über die gleiche Remote Control-Sitzungsinfrastruktur, die Cloud-Sitzungen verwenden, daher werden Authentifizierungs- und Sitzungs-Ablauf-Fehler mit Remote Control-Wording angezeigt. Sie können Remote Control session expired oder Access denied sehen. Das Verbindungs-Token ist kurzlebig und auf Ihr Konto begrenzt.
- Führen Sie
/loginlokal aus, um Ihre Anmeldedaten zu aktualisieren, und verbinden Sie sich dann erneut - Bestätigen Sie, dass Sie sich bei demselben Konto angemeldet haben, das die Sitzung besitzt
- Wenn Sie
Remote Control may not be available for this organizationsehen, hat ein Owner Cloud-Sitzungen für Ihre Organisation nicht aktiviert
Fehler beim Senden an eine Cloud-Sitzung
Diese Fehler entstehen beim Ausführen vonclaude mit --cloud <session-id>, mit oder ohne -p. Die CLI stellt Fehlern Error: voran. Eine fehlgeschlagene Zustellung wird als failed to send message to cloud session <id>: <reason> ausgegeben.
Umgebung abgelaufen
Cloud-Sitzungen werden nach einer Inaktivitätszeit beendet und die Sitzungs-VM wird freigegeben. Eine Sitzung gilt als inaktiv, während sie darauf wartet, dass Sie einen MCP-Connector-Tool-Aufruf genehmigen oder sich bei einem MCP-Server anmelden, und sie kann während dieses Wartens ablaufen. Öffnen Sie die Sitzung erneut über claude.ai/code, um eine neue VM bereitzustellen:- Wiederhergestellt: Ihr Konversationsverlauf
- Nicht wiederhergestellt: Hintergrundarbeit, die noch lief oder ausstand, als die VM freigegeben wurde, darunter:
- Shell-Befehle: Claude Code teilt Claude mit, welche Befehle gestoppt wurden. Bitten Sie Claude, diejenigen erneut auszuführen, die Sie noch benötigen.
- Subagenten: Claude Code teilt Claude mit, welche Subagenten gestoppt wurden und welche davon fortgesetzt werden können, anstatt neu gestartet zu werden. Bitten Sie Claude, deren Arbeit fortzusetzen.
- Sitzungsbezogene geplante Aufgaben: Aufgaben, die Sie in der Sitzung geplant haben, sowie ein
/loop, der auf seine nächste Iteration wartet, werden nicht in die erneut geöffnete Sitzung übernommen. Bitten Sie Claude, die Aufgaben erneut zu planen, oder führen Sie/looperneut aus, um die Schleife neu zu starten.
Einschränkungen
Bevor Sie Cloud-Sitzungen für einen Workflow verwenden, berücksichtigen Sie diese Einschränkungen:- Rate-Limits: Cloud-Sitzungen teilen Rate-Limits mit allen anderen Claude- und Claude Code-Nutzungen in Ihrem Konto. Das Ausführen mehrerer Aufgaben parallel verbraucht proportional mehr Rate-Limits.
- Zeitlimits: Befehle, die Claude ausführt, und SessionStart-Hooks haben Standard-Timeouts, die Sie ändern können, und ein Setup-Skript wird nur zwischengespeichert, wenn es in etwa fünf Minuten abgeschlossen wird. Siehe Zeitlimits
- Repository-Authentifizierung: Sie können eine Cloud-Sitzung nur in Ihr Terminal ziehen, wenn Sie sich bei demselben Konto authentifizieren
- Plattformbeschränkungen: Repository-Klonen in von Anthropic gehosteten Umgebungen und Pull-Request-Erstellung erfordern GitHub. Selbstgehostete GitHub Enterprise Server-Instanzen werden für Team- und Enterprise-Pläne unterstützt. Sie können ein GitLab-, Bitbucket- oder anderes Nicht-GitHub-Repository als lokales Bündel an eine Cloud-Sitzung senden, indem Sie
CCR_FORCE_BUNDLE=1setzen, aber die Sitzung kann die Ergebnisse nicht zurück zu diesem Remote pushen- Selbstgehostete Umgebungen: Für ein Repository auf einem anderen Git-Host siehe die Anforderungen für das Starten einer Sitzung mit
--environment.
- Selbstgehostete Umgebungen: Für ein Repository auf einem anderen Git-Host siehe die Anforderungen für das Starten einer Sitzung mit
Verwandte Ressourcen
- Cloud-Umgebungen: Konfigurieren Sie Netzwerkzugriff, Umgebungsvariablen und Setup-Skripte für Cloud-Sitzungen
- Projekte: eine Konversation, in der Claude parallele Cloud-Sitzungen in Ihren Repositories koordiniert und Bericht erstattet
- Ultrareview: Führen Sie eine tiefe Multi-Agent-Code-Review in einer Cloud-Sandbox aus
- Geplante Aufgaben in der Cloud: Automatisieren Sie Arbeiten nach einem Zeitplan, über API-Aufruf oder als Reaktion auf GitHub-Events
- Hooks-Konfiguration: Führen Sie Skripte bei Sitzungs-Lifecycle-Events aus
- Alle Einstellungen: Alle Konfigurationsoptionen
- Sicherheit: Isolationsgarantien und Datenverarbeitung
- Datennutzung: Was Anthropic aus Cloud-Sitzungen behält
- Claude Tag: Ein von der Organisation verwaltetes @Claude in Slack, das auf der gleichen Cloud-Infrastruktur ausgeführt wird