Claude Code auf eigener Infrastruktur betreiben
Mit Self-Hosted Environments laufen Claude-Code-Cloud-Sitzungen seit August 2026 auf Rechnern deiner Organisation. Das ist vor allem für interne Dienste, eigene Toolchains und kontrollierte Build-Umgebungen interessant. Die Modellberechnung bleibt bei Anthropic: Prompts, Antworten und Toolergebnisse werden zur Inferenz übertragen; Sitzungsprotokolle werden für die Fortsetzung gespeichert. Die Funktion ist eine öffentliche Beta für Team und Enterprise.
Was bedeutet „self-hosted“ bei Claude Code genau?
Eine Cloud-Sitzung kann im Browser, auf dem Handy, in der Desktop-App oder aus einer Routine gestartet werden. Standardmäßig läuft sie auf Infrastruktur von Anthropic. Mit einer selbst betriebenen Umgebung wählt das Team stattdessen seine eigene Ausführungsumgebung: Ein Runner holt die Aufgabe ab, checkt das Repository aus und startet dort Claude Code. Interne Dienste, Paketregister und Build-Werkzeuge können im eigenen Netz erreichbar bleiben. Quelle: Claude Code Docs – Self-hosted environments.
Wichtig für die Architektur: Es ist kein lokal betriebenes Claude-Modell. Das Modell läuft über die Anthropic API. Auch der Kontrollbereich für Queue und Sitzungssteuerung bleibt bei Anthropic. Lokal bleiben insbesondere Checkout, erstellte Dateien, Artefakte und Secrets auf den bereitgestellten Rechnern; Gesprächsinhalt und Toolergebnisse gehen zur Inferenz an Anthropic. Quelle: Produktankündigung vom 6. August 2026.
Für wen ist die öffentliche Beta verfügbar?
Self-Hosted Environments sind zum Stand 23. September 2026 in der öffentlichen Beta für Claude Team und Enterprise, standardmäßig ausgeschaltet. Ein Organisations-Owner aktiviert die Funktion für Cloud-Sitzungen. Für Organisationen mit Zero Data Retention (ZDR) ist sie derzeit nicht verfügbar. Die Inferenz dieser Sitzungen läuft über Anthropics API; Bedrock, Google Cloud, Microsoft Foundry und eigene LLM-Gateways werden für diesen Betriebsweg laut Dokumentation nicht unterstützt. Quelle: Verfügbarkeit und Einschränkungen.
Für einen einzelnen Entwickler, der Claude Code direkt im Terminal nutzt, ist diese Beta nicht erforderlich: Die normale Terminalsitzung läuft bereits auf seinem Rechner. Self-Hosted Environments betreffen die von anderen Oberflächen gestarteten Cloud-Sitzungen auf gemeinsam betriebener Infrastruktur.
So richtest du eine erste Testumgebung ein
- Verantwortung festlegen: Plattformteam für Runner-Image, Updates, Skalierung, Netz und Git-Zugriff benennen.
- Funktion aktivieren: Der Owner schaltet Cloud-Sitzungen und Self-Hosted Environments in den Organisationseinstellungen frei.
- Umgebung und Runner anlegen: Runner auf freigegebener Infrastruktur bereitstellen, Umgebungsschlüssel sicher verwahren und den ausgehenden Zugriff auf die dokumentierten Anthropic-Endpunkte erlauben.
- Werkzeuge vorbereiten: benötigte Compiler, SDKs, interne CLI-Programme und Repositories in einem reproduzierbaren Image bereitstellen.
- Begrenzten Test starten: aus Claude eine ungefährliche Cloud-Sitzung explizit in dieser Umgebung starten, Logs und Artefakte prüfen und Berechtigungen nachjustieren.
Die genauen Kommandos und Konfigurationsfelder stehen im offiziellen Quickstart und Produktionsleitfaden. Diese Anleitung ist bewusst ein Entscheidungs- und Ablaufrahmen: Runner-Versionen und Infrastrukturvorlagen können sich während der Beta ändern.
Datenfluss und Sicherheitsprüfung vor produktiven Repositories
| Bestandteil | Betriebsort laut Anthropic | Prüffrage |
|---|---|---|
| Repository und Build-Artefakte | Eigene Infrastruktur | Wer kann Checkout und Arbeitsverzeichnis lesen? |
| Secrets und lokale Dateien | Eigene Infrastruktur | Welche Rechte hat der Runner wirklich? |
| Prompts, Antworten, Toolergebnisse | Übertragung an Anthropic zur Inferenz | Können Logs oder Toolausgaben Quellcode enthalten? |
| Sitzungsprotokoll | Bei Anthropic zur Fortsetzung gespeichert | Passen Vertrag und Aufbewahrung zur Datenklasse? |
Die Aussage „Quellcode bleibt lokal“ muss präzise gelesen werden: Das Checkout bleibt auf eigener Infrastruktur; von Claude gelesene Codeausschnitte können in Toolergebnissen zur Modellberechnung übertragen werden. Prüfe Datenklassifikation, Zugriff, Aufbewahrung und Freigaberegeln mit dem konkreten Vertrag. Quelle: Netzwerkpfade und Datenhaltung.
Wann lohnt sich ein eigener Runner?
Ein eigener Runner lohnt sich, wenn der Nutzen aus privaten Netzverbindungen, vorinstallierten Werkzeugen oder Betriebsregeln den zusätzlichen Aufwand rechtfertigt. Typische Pilotfälle sind ein Build mit internem Paketregister oder ein Fehler, der nur in einer firmeneigenen Testumgebung reproduzierbar ist. Für einen kleinen Standardprozess kann Anthropics gehostete Umgebung einfacher sein; Anthropic empfiehlt sie selbst für die meisten Unternehmen. Quelle: Anthropic zu Einsatzfällen und Betriebsaufwand.
Miss im Pilot nicht nur die Laufzeit, sondern auch Bereitstellungsaufwand, Auslastung, Runner-Wartung und Fehlerbehebung. Ein sicherer Test beginnt mit einem nicht kritischen Repository und klarer Abnahme durch Entwickler. Bei der Auswahl von Rollen, Rechten und Pilotfällen helfen unsere Claude-Code-Einrichtung und Datenflussprüfung.
Self-Hosted Environment, lokales Terminal und Remote Control vergleichen
Lokales Terminal: Claude Code läuft unmittelbar auf dem Rechner des Entwicklers. Remote Control: Eine laufende persönliche Sitzung kann von anderen Geräten aus fortgesetzt werden; sie hängt vom Rechner des Nutzers ab. Self-Hosted Environment: Ein Plattformteam betreibt gemeinsame Runner für Cloud-Sitzungen. Die drei Wege lösen unterschiedliche Betriebsfragen. Der offizielle Vergleich im Claude-Code-Handbuch erläutert die Grenzen.
Wenn dein Unternehmen den zweiten oder dritten Weg braucht, starte mit einem Architekturcheck: Welche Dienste müssen erreichbar sein, welche Daten dürfen in Modellkontext gelangen, wer betreibt Runner und wer gibt Codeänderungen frei? Daraus folgt die kleinste brauchbare Umgebung für einen kontrollierten Test.
Quellen und Produktstand
Produktangaben wurden am 23. September 2026 geprüft. Der Zugang kann je nach Tarif und Rollout abweichen.