Cloud-Sessions in Claude Code sicher einrichten: ein Aufbau, der die Produktion schützt, und 5 Stellen, an denen ich hängen blieb

Sie können Entwicklungsarbeit an Cloud-Sessions von Claude Code übergeben, ohne einen neuen Zugang zur Produktion zu öffnen – vorausgesetzt, die Cloud kann nur ein einziges GitHub-Repository erreichen und Ihr Produktionsserver zieht aus diesem Repository nur per Pull. Bis dahin bin ich allerdings mehr als einmal hängen geblieben. Dieser Artikel ist mein Protokoll (ich betreibe diese Website), wie ich am 4. Oktober 2026 in einem separaten Entwicklungsprojekt mit Cloud-Sessions begonnen habe – nachgeprüft am Originaltext der offiziellen Dokumentation.

Quellen: Use Claude Code in the cloud und Configure cloud environments. Geprüft am 4. Oktober 2026. Funktionsweise, Einstieg und Preise erklärt „Was sind Cloud-Sessions in Claude Code?“

1. Ein Aufbau, der die Produktion schützt: Die Produktion zieht nur per Pull

Meine größte Sorge war, dass der Umweg über GitHub einen weiteren Zugang zum Produktionsserver schaffen würde. Ich habe mich für den folgenden Aufbau entschieden (das ist meine eigene Wahl, keine offizielle Empfehlung). Die Pfeile zeigen, in welche Richtung Daten abgerufen werden.

• Cloud-Session Schreibt Code und pusht Branches (kommt nicht in die Produktion)
• →push
• Privates GitHub-Repository Das einzige Repository, auf dem die App installiert ist
• ←fetch
• Produktionsserver Zieht per Pull mit einem schreibgeschützten Deploy Key; das Deployment startet ein Mensch

2. Was übertragen wird, wenn Sie ohne GitHub starten

Normalerweise liegt mein Code in einem Git-Repository auf meinem eigenen Server, deshalb habe ich zunächst überlegt, Cloud-Sessions ohne GitHub zu nutzen. Laut offizieller Dokumentation wird Ihr lokales Repository, wenn Sie claude --cloud "task description" etwa in einem Repository ohne Remote ausführen, zu einem einzigen Bundle gepackt und in die Cloud geschickt. Folgendes wird übertragen.

Riskant sind die Fälle, in denen Sie eine Datei mit Geheimnissen in Git verfolgen und sie bearbeitet haben, und in denen Sie irgendwann in der Vergangenheit Geheimnisse committet haben. Eine per .gitignore ausgeschlossene .env wird gar nicht erst übertragen.

Noch etwas: Laut offizieller Dokumentation kann eine aus einem Bundle erstellte Session nur in „repositories your GitHub connection has push access to“ pushen (Repositories, auf die Ihre GitHub-Verbindung Push-Zugriff hat). In der Dokumentation fand ich keinen Weg, Ergebnisse direkt an ein selbst gehostetes Repository außerhalb von GitHub zurückzuschicken. Nachdem ich schon eine Schritt-für-Schritt-Anleitung geschrieben hatte, gab ich nach und legte ein privates Repository auf GitHub an.

3. Fünf Stellen, an denen ich tatsächlich hängen blieb

Hier sind die Stolpersteine zwischen dem Anlegen eines privaten Repositorys auf GitHub und dem tatsächlichen Start, jeweils gegliedert nach Symptom, Ursache und Lösung.

1) Das Repository erscheint nicht in der Liste

2) Wie breit die GitHub App installiert wird

3) Repositories aus Organisationen ohne App tauchen auf

4) Eine alte Cloud-Umgebung war noch da

5) Ich wollte eine lokale Datei lesen lassen

4. Wie sich die Berechtigungsmodi in der Cloud unterscheiden

Kurz vor dem Absenden bemerkte ich, dass der Berechtigungsmodus auf „Accept edits“ stand. Der Name klingt nach dem Modus, der am forschesten vorangeht, doch laut offizieller Dokumentation entspricht Accept edits in der Cloud dem Standardmodus (Manual) des lokalen Claude Code. In der Cloud sind Dateiänderungen in jedem Modus vorab genehmigt, daher erscheint der Standardmodus einfach unter diesem Namen.

Ich wollte, dass er ohne mich weiterarbeitet, also wechselte ich zu Auto. Beachten Sie, dass Sie in der Cloud den Modus, der alle Prüfungen überspringt (bypass permissions), nicht wählen können und er ignoriert wird, selbst wenn er in der Einstellungsdatei des Repositorys gesetzt ist. Einen ausführlichen Vergleich der Modi finden Sie unter „Berechtigungsmodi in Claude Code“.

5. Was es tatsächlich gekostet hat: $226 für eine Anweisung

Nach all diesen Vorbereitungen ließ ich eine Cloud-Session mit dem befristeten Guthaben des Max-Tarifs ($250) laufen. In der ersten Nachricht übergab ich das Designdokument und die Anweisungen, mit dem Berechtigungsmodus Auto. Danach habe ich kein einziges Mal mit ihr gesprochen. Zwischendurch schaute ich auf die Nutzungsanzeige, erschrak, wie schnell das Guthaben schwand, und wies sie an anzuhalten. Beim Anhalten waren noch $24 Guthaben übrig. Hätte ich sie nicht gestoppt, wären die gesamten $250 verbraucht worden.

Quelle: meine Nutzungsanzeige in Claude Code (4. Oktober 2026, Tarif Max 20x). Die 86 % des Wochenlimits schließen Nutzung außerhalb der Cloud ein.

So viel Arbeit hatte die Cloud mit einer einzigen Anweisung erledigt, als ich sie anhielt (laut meinem Arbeitsprotokoll).

Warum das Guthaben so schnell schwindet

Die Kosten hängen nicht davon ab, wie oft Sie mit ihm sprechen, sondern davon, wie oft Claude das Modell aufruft und wie viel Kontext es dabei jedes Mal liest. Arbeitet es selbstständig, löst jedes Lesen einer Datei, jedes Schreiben und jeder Testlauf einen Aufruf aus – so kommen ohne jede Unterhaltung Hunderte oder Tausende Aufrufe zusammen. Auch die offizielle Dokumentation (Manage costs effectively) sagt, dass die Kosten mit der Kontextgröße steigen.

Jeder Aufruf liest den bisherigen Kontext erneut. Selbst mit Caching ist das Lesen nicht kostenlos: Beim Cache-Read-Preis von Opus 5.5 ($0,20 pro Million Token) kostet das einmalige Lesen von 500.000 Token etwa $0,10. Wiederholt man das 1.000-mal, sind es etwa $100 (ein Beispiel, das ich aus dem Stückpreis berechnet habe; die tatsächliche Zahl der Aufrufe und die Aufteilung nach Modellen habe ich für diese Session nicht geprüft). Der Code und die Tests, die es schreibt, werden separat zum Output-Preis abgerechnet.

Die Aufschlüsselung: erneutes Lesen und Subagents

Nach dem Anhalten öffnete ich die detaillierte Aufschlüsselung in der Nutzungsanzeige (diese Zahlen umfassen die gesamte Session, einschließlich der Zusammenfassung, die ich nach dem Anhalten schreiben ließ).

Quelle: die Session-Ansicht meiner Nutzungsanzeige in Claude Code (4. Oktober 2026). Angezeigte Kosten: $231,09.

Ich selbst war nur 2 Minuten und 24 Sekunden aktiv; die übrigen gut 8 Stunden arbeitete Claude allein. Während dieser ganzen Zeit lasen die Opus-Hauptunterhaltung und die Subagents, die ebenfalls auf Opus liefen, eine immer länger werdende Unterhaltung wieder und wieder. Als ich die Cloud-Session die Aufschlüsselung auszählen ließ, meldete sie, dass die Fertigstellung eines Tools bei einem Sonnet-Subagent etwa 30 Aktionen und bei einem Opus-Subagent 130 bis 230 Aktionen gebraucht habe (das ist die eigene Auszählung der Session; ich habe nicht jeden Fall einzeln geprüft).

Die in der Anzeige ausgewiesenen Kosten ($231,09) entsprachen fast genau dem Rückgang des Guthabens zum Zeitpunkt, als ich diese Anzeige öffnete ($250 → $18, also $232). Beim Anhalten der Session hatte ich noch $24; geöffnet habe ich die Anzeige erst danach, sodass das Guthaben bis dahin noch etwas weiter gesunken war. Laut offizieller Dokumentation sind die Kosten in dieser Anzeige eine Schätzung aus Tokenzahlen multipliziert mit Listenpreisen. Man kann also wohl davon ausgehen, dass das Guthaben zu API-Listenpreisen abgezogen wird (die offizielle Dokumentation sagt das nicht ausdrücklich).

Wenn Sie kein Modell angeben, nutzen Subagents dasselbe Modell wie die Hauptunterhaltung (offizielle Dokumentation: „Create custom subagents“). Mit Opus als Hauptmodell läuft also selbst Massenarbeit auf Opus.

Wege, die Kosten zu senken (größte Wirkung zuerst)

• 1. Subagents auf Sonnet laufen lassen Schreiben Sie „run subagents with model: sonnet“ in Ihre Anweisungen. Den Standard können Sie auch mit der Umgebungsvariable CLAUDE_CODE_SUBAGENT_MODEL ändern (sie ist kein Geheimnis und darf daher in die Umgebung).
• 2. Unterhaltungen kurz halten (/compact oder eine neue Session) Je kürzer die Unterhaltung, desto günstiger jede Aktion. Bleiben Sie beim selben Thema, kürzt eine Zusammenfassung mit /compact die Unterhaltung, ohne die Session zu wechseln (Sie können angeben, was erhalten bleiben soll, etwa „behalte die Testergebnisse“). Wechselt das Thema oder machen Sie nach einer langen Pause weiter, starten Sie eine neue Session. Wenn Sie den Fortschritt in ein Übergabedokument schreiben lassen, geht beim Aufteilen nichts verloren.
• 3. Vorab einen Haltepunkt festlegen Schreiben Sie etwa „halte an und berichte, sobald das Grundgerüst steht“ oder „halte bei etwa $50 an und berichte“ (eine Einstellung zur Ausgabenobergrenze gibt es nicht, also ziehen Sie die Grenzen per Anweisung).
• 4. Auch Integrationsarbeit delegieren Lassen Sie Subagents Tests, Commits und Pushes übernehmen, damit weniger Arbeit in der langen, teuren Hauptunterhaltung anfällt.
• 5. Die Verifikation verschlanken Führen Sie UI-Tests nur für die gerade gebauten Tools aus und die komplette Testsuite einmal vor dem Merge. Machen Sie pro Tool je einen Screenshot in Desktop- und in Smartphone-Breite.
• 6. Unnötige Arbeit sofort stoppen Ein mittendrin gestoppter Subagent hinterlässt keine Ergebnisse, und was er verbraucht hat, wird nicht erstattet.

Als Faustregel: 2 bis 3 parallel laufen lassen. Nach Einschätzung der Cloud-Session selbst verlängert weniger Parallelität nur die Laufzeit, ohne die Gesamtkosten wesentlich zu ändern. Wichtiger als die Zahl paralleler Läufe ist, jede Unterhaltung kurz und jede Anweisung konkret zu halten.

Auf Grundlage der offiziellen Dokumentation entscheide ich so zwischen /compact und einer neuen Session. /compact liest die gesamte Unterhaltung erneut, um eine Zusammenfassung zu erstellen; solange der Cache noch warm ist, kommt aber ein Großteil davon aus dem Cache, sodass es nicht so teuer ist, wie die Größe der Unterhaltung vermuten ließe („Prompt caching“). Nach einer langen Leerlaufzeit, wenn der Cache abgelaufen ist, wird alles ohne Caching neu gelesen, und das ist teuer. Eine neue Session dagegen kostet nichts, übernimmt aber nichts vom Bisherigen („Manage costs effectively“). Zusammenfassungen können Details verlieren, daher ist es sicherer, alles, was erhalten bleiben soll, vorher in ein Dokument schreiben zu lassen. Beachten Sie, dass in Cloud-Sessions /compact funktioniert, /clear aber nicht; eine neue Session starten Sie über die Seitenleiste („Claude Code on the web“).

So sieht die Nachricht aus, die ich zu Beginn der nächsten Session einfüge (Projektname weggelassen).

Bitte mach dort weiter, wo du aufgehört hast.
Lies CLAUDE.md → docs/HANDOFF.md → docs/TODO.md und halte dich an die Regeln.
Thema dieser Session: XX
Lass Subagents mit model: sonnet laufen, höchstens 2–3 parallel.
Halte an und berichte, sobald ein Budget von $XX erreicht ist. Berichte auf Deutsch.

Für die Kontextzusammenfassung in Cloud-Sessions setzt die Cloud die Umgebungsvariable CLAUDE_AUTOCOMPACT_PCT_OVERRIDE selbst, daher bewirkt es nichts, diese Variable in Ihre Umgebung aufzunehmen. Damit die Zusammenfassung früher einsetzt, verwenden Sie CLAUDE_CODE_AUTO_COMPACT_WINDOW oder /autocompact, wie es die offizielle Dokumentation empfiehlt.

6. Checkliste vor dem Start

• GitHub-Konto Ist das mit claude.ai verbundene Konto das, das Sie nutzen wollen?
• App-Umfang Haben Sie sie mit „Only select repositories“ nur auf den benötigten Repositories installiert?
• Historie Liegen früher committete Geheimnisse noch in der Historie des Repositorys?
• Umgebung Haben Sie für dieses Projekt eine neue angelegt? Halten Sie Geheimnisse aus ihren Umgebungsvariablen heraus?
• Produktion Haben Sie vermieden, einen Weg von der Cloud oder von GitHub in die Produktion zu schaffen (zieht die Produktion stattdessen per Pull)?
• Regeln Stehen die wiederverwendeten Regeln in der CLAUDE.md des Repositorys?
• Berechtigungsmodus Haben Sie Auto gewählt, um ihn laufen zu lassen, oder Accept edits, um jeden Schritt zu prüfen?

Fazit

Cloud-Sessions zu nutzen und dabei die Produktion zu schützen, läuft auf drei Punkte hinaus: Die Cloud erreicht nur ein GitHub-Repository, die Produktion zieht daraus per Pull mit einem schreibgeschützten Schlüssel, und das Deployment startet ein Mensch. Sie können ohne GitHub starten, aber dann wird das Repository mit der Historie aller Branches übertragen, und unter Windows werden nicht committete Änderungen an verfolgten Dateien unabhängig von ihren Namen mitgeschickt.

Woran ich tatsächlich hängen blieb: ein anderes verbundenes GitHub-Konto, der Umfang der App, eine zurückgebliebene alte Umgebung, unsichtbare lokale Dateien und „Accept edits“, das bei jedem Befehl anhält. Die Checkliste oben verhindert all das.

Zu den Kosten: Eine einzige, selbstständig ausgeführte Anweisung verbrauchte $226 des befristeten Guthabens, bevor ich sie mittendrin anhielt. Die Kosten hängen nicht davon ab, wie oft Sie mit ihm sprechen, sondern von der Zahl der Aufrufe und der Länge des Kontexts. In der Aufschlüsselung entfiel das meiste auf das erneute Lesen der Unterhaltung und auf Subagents, die auf demselben Modell wie die Hauptunterhaltung liefen. Lassen Sie Subagents auf Sonnet laufen, halten Sie Unterhaltungen mit /compact oder einer neuen Session kurz und schreiben Sie einen Haltepunkt in Ihre Anweisungen.

FAQ

F. Kann ich Cloud-Sessions ohne GitHub ausprobieren?

A. Ja. claude --cloud "task description" bündelt Ihr lokales Repository und schickt es hoch. Es muss kleiner als 100 MB sein und mindestens einen Commit haben. Die Historie aller Branches wird übertragen, und die offizielle Dokumentation beschreibt keinen Weg, Ergebnisse direkt an ein Repository außerhalb von GitHub zurückzuschicken.

F. In der Liste tauchen Repositories aus Organisationen auf, in denen ich die App nicht installiert habe. Leckt da etwas?

A. Nicht, wenn es öffentliche Repositories sind. Bei einer Verbindung über die GitHub App können Cloud-Sessions alle öffentlichen Repositories nutzen, daher erscheinen sie als Auswahl. Private Repositories sind nur dort nutzbar, wo die App installiert ist.

F. Darf ich einen API-Schlüssel in eine Umgebungsvariable legen?

A. Davon rate ich ab. Die offizielle Dokumentation warnt, dass jeder, der eine Umgebung nutzt, ihre Umgebungsvariablen lesen kann, und rät davon ab, Geheimnisse dort abzulegen. Bei Pro und Max können Sie ihn stattdessen unter „API credentials“ hinterlegen; dessen Wert kann die Session nicht lesen.

F. Ich habe „Accept edits“ gewählt, aber er hält bei jedem Befehl an.

A. Das ist so vorgesehen. In der Cloud sind Änderungen in jedem Modus erlaubt, daher erscheint der Standardmodus unter dem Namen „Accept edits“. Damit Befehle ohne Freigabe laufen, wählen Sie Auto (erscheint nur, wenn Ihre Organisation es erlaubt und das Modell es unterstützt).

F. Warum sinkt das Guthaben so stark, obwohl ich gar nicht mit ihm spreche?

A. Weil die Kosten nicht davon abhängen, wie oft Sie etwas sagen, sondern davon, wie oft Claude das Modell aufruft und wie viel Kontext es dabei jedes Mal liest. Arbeitet es selbstständig, löst jedes Lesen einer Datei, jedes Schreiben und jeder Testlauf einen Aufruf aus, und der Kontext wächst immer weiter. In meinem Fall verbrauchte eine Anweisung $226, bevor ich sie mittendrin anhielt (Abschnitt 5).

F. Lässt sich das befristete Guthaben auch so verwenden?

A. Ja. Das Guthaben für Pro und Max (Pro $100, Max $250) wird automatisch auf die Nutzung von Cloud-Sessions angerechnet, und solange es reicht, zählt diese Nutzung nicht zu den Nutzungslimits Ihres Tarifs. Einlösen können Sie es bis zum 7. Oktober (US-Pazifikzeit); es verfällt mit Ablauf des 4. November (5. November, 16:59 Uhr japanischer Zeit). Für Projects, Routines, Remote Control und Ähnliches ist es nicht nutzbar. Einzelheiten finden Sie im offiziellen Support-Artikel und in „Was sind Cloud-Sessions in Claude Code?“

Quellen

• Offizielle Claude-Code-Dokumentation: Use Claude Code in the cloud (einschließlich des Abschnitts „Send local repositories without GitHub“)
• Offizielle Claude-Code-Dokumentation: Get started with cloud sessions
• Offizielle Claude-Code-Dokumentation: Configure cloud environments
• Offizielle Claude-Code-Dokumentation: Permission modes
• Offizielle Claude-Code-Dokumentation: Manage costs effectively
• Offizielle Claude-Code-Dokumentation: Create custom subagents
• Claude Help Center: Cloud sessions bonus credit promotion
• GitHub Docs: Managing deploy keys und Error: Key already in use

Alle offiziellen Spezifikationen wurden am 4. Oktober 2026 am Originaltext geprüft. Das Einrichtungsprotokoll stammt aus einem einzigen Durchlauf in einem einzigen meiner Projekte, und was die Anzeigen zeigen, kann sich mit neuen Versionen und im Lauf der Zeit ändern.