GrundlagenVibe-Coding / Agentic EngineeringKapitel 09 von 13

Sandbox und Iso­lie­rung

Gleiches Kapitel, drei Tiefen. Die Wahl gilt überall und bleibt gespeichert.

Tiefe 1: Überblick · Lesezeit 9 Min. · Stand

Ein Agent auf der Kommandozeile fragt im manuellen Modus, bevor er etwas ausführt. Wer damit arbeitet, beantwortet diese Frage am Tag ein paar Dutzend Mal, und irgendwann steht eine Liste dessen da, was ohne Rückfrage durchlaufen darf.

Diese Liste beantwortet eine Frage. Sie lässt eine zweite offen: Was erreicht ein Befehl, während er läuft?

Zwei Größen, die man leicht verwechselt

Der Hersteller trennt beide in einem Satz: Die Isolierung begrenzt laut Übersicht der Sandbox-Umgebungen (externe Seite, code.claude.com), worauf ein Befehl zugreifen kann, sobald er läuft.

Eine Rechteregel entscheidet vor dem Start. Sie sieht auf den Aufruf und lässt ihn zu oder hält ihn an. Die Isolierung wirkt danach, und sie sieht auf etwas anderes: auf das, was der laufende Vorgang berührt, also welche Dateien und welche Adressen im Netz.

Der Unterschied wird an einer Stelle greifbar, die für den Betrieb mit Agenten gebaut ist. Laut Sandbox-Doku (externe Seite, code.claude.com) setzt das Betriebssystem die Grenze am laufenden Vorgang durch. Sie hält deshalb unabhängig davon, was das Modell zu starten beschlossen hat, und selbst dann, wenn ein erlaubter Befehl mehr tut, als sein Name vermuten lässt.

Zwei Halbsätze, zwei verschiedene Sorgen. Der erste betrifft ein Modell, das etwas anderes gewählt hat, als jemand erwartet hätte. Der zweite betrifft einen Befehl, den man selbst erlaubt hat und dessen Name weniger verrät als sein Inhalt. Ein Skript heißt test, und was darin steht, hat niemand gelesen.

Die Grenze hat Stufen

Isolierung ist keine Eigenschaft, die man an- oder ausschaltet. Die Dokumentation stellt sechs Stufen nebeneinander, und fünf davon unterscheiden sich darin, wie viel innerhalb der Grenze liegt. Die sechste liegt neben der stärksten: derselbe eigene Kern, nur bei Anthropic statt beim Nutzer.

StufeWas darin liegt
Bash-Sandboxjeder Befehl über Bash, PowerShell oder das Monitor-Werkzeug, samt den Prozessen, die er startet
Sandbox-Runtimeder ganze Claude-Code-Prozess, also auch Dateiwerkzeuge, Hooks und MCP-Server
Dev-Containerderselbe Umfang, dazu eine Firewall, die alles verbietet, was nicht erlaubt ist
eigener Containerdasselbe mit den Netzregeln und Abbildern der eigenen Organisation
virtuelle Maschineeigener Betriebssystemkern, die stärkste Trennung
Cloud-Sitzungderselbe eigene Kern, in einer virtuellen Maschine bei Anthropic
Fünf Stufen der Isolierung als Schalen: jede weitere schließt mehr ein, von den Bash-Befehlen bis zum eigenen Betriebssystemkern. Die Schalen liegen ineinander, die Bash-Sandbox als kleinste innen. Hooks, MCP-Server, die Monitore von Plugins und die Dateiwerkzeuge stehen erst ab der Sandbox-Runtime mit im Rand, bei der Bash-Sandbox allein daneben auf dem Rechner. WAS INNERHALB DER GRENZE LIEGT VIRTUELLE MASCHINE, EIGENER KERN EIGENER CONTAINER, EIGENE NETZREGELN DEV-CONTAINER, FIREWALL DAVOR SANDBOX-RUNTIME BASH-SANDBOX Befehle Hooks, MCP-Server Plugin-Monitore Dateiwerkzeuge Die Bash-Sandbox fasst nur den linken Kasten. Erst die Runtime nimmt den rechten dazu. Auf macOS zieht Seatbelt die Grenze, auf Linux bubblewrap.
Fünf der sechs Stufen schließen einander ein, bis zum eigenen Kern. Bei der Bash-Sandbox stehen Hooks, MCP-Server, Plugin-Monitore und Dateiwerkzeuge außerhalb; die sechste, eine Cloud-Sitzung, liegt daneben, mit demselben Kern bei Anthropic statt beim Nutzer.

eigene Darstellung nach der Herstellerdokumentation, Stand 27.10.2026

Auf macOS zieht die Grenze das eingebaute Seatbelt-System, auf Linux und WSL2 ein Werkzeug namens bubblewrap. Natives Windows wird nicht unterstützt.

Wo die Frage wirklich zählt

Solange ein Mensch danebensitzt und jede Rückfrage beantwortet, ist die Isolierung eine zweite Schicht. Wer Claude Code mit --dangerously-skip-permissions startet, schaltet die Rückfrage ganz ab, und für diesen Fall sagt es die Dokumentation (externe Seite, code.claude.com) ungewöhnlich deutlich: Wo keine Rückfrage mehr Fehler abfängt, schützt die Grenze das System, die man bei der Isolierung gewählt hat. Eine solche Sitzung gehört deshalb in einen Container, eine virtuelle Maschine oder die Sandbox-Runtime.

Im Auto-Modus prüft an Stelle der Rückfrage ein Klassifikator die Aktionen. Eine Grenze um den Lauf ist laut derselben Übersicht auch dort eine zusätzliche Schutzschicht, sobald niemand mehr zusieht.

Damit hängt die Antwort daran, wie ein Lauf gestartet wird. Ein nächtlicher Automat, ein Lauf ohne Rückfragen, eine Runde in einem Ablauf: Überall dort fällt die Rückfrage als Sicherung weg. Was der laufende Befehl erreicht, entscheidet dann die Grenze.

Was der einfachste Fall nicht abdeckt

Die eingebaute Sandbox fasst Shell-Befehle, also Befehle über Bash, PowerShell und das Monitor-Werkzeug samt den Prozessen, die sie starten. Daneben stehen Einrichtungen, die laut Übersicht der Sandbox-Umgebungen (externe Seite, code.claude.com) eigene Prozesse sind und unbeschränkt auf dem Rechner laufen: MCP-Server, Befehls-Hooks und die Monitore von Plugins. Die Sandbox-Doku (externe Seite, code.claude.com) zählt LSP-Server und Hilfsbefehle wie den Befehl für die Statuszeile dazu. Auch die eingebauten Werkzeuge für Dateien und fürs Web stehen außerhalb, für sie gelten die Rechteregeln.

MCP-Server und Hooks sind genau die Einrichtungen aus Kapitel 12 und Agenten und Harness, Kapitel 02. Wer sie benutzt und die Isolierung für vollständig hält, hat eine Grenze um den kleineren Teil gezogen.

Auch die stärkeren Stufen haben ihre Kante. Die Anleitung zum Dev-Container schreibt sie selbst hin: Läuft Claude Code darin mit --dangerously-skip-permissions, hält der Container ein bösartiges Projekt nicht davon ab, alles auszuleiten, was in ihm erreichbar ist, und dazu zählen die Zugangsdaten von Claude Code. Erheblichen Schutz bietet er laut Dev-Container-Anleitung (externe Seite, code.claude.com) durchaus, gegen alle Angriffe vollständig gefeit ist aber kein System.

Was daraus für die Einrichtung folgt, steht in der zweiten Tiefe. Der Grundsatz für diese hier ist schlichter. Was ein Agent anrichten kann, ergibt sich aus dem, was er erreicht, und das ist eine Entscheidung beim Einrichten. Sie fällt vor dem ersten Auftrag.

Quellen

8 Einträge, davon 2 Schlüsselarbeitenalle erreichbar

Erreichbarkeit automatisch geprüft

  • SchlüsselarbeitDokumentationerreichbar

    Anthropic, Choose a sandbox environment (externe Seite, code.claude.com)

    code.claude.comgeprüft 13.11.2026

    Die Seite, die die Isolierung als eigene Größe neben den Rechten führt und sechs Stufen gegeneinanderstellt: die eingebaute Bash-Sandbox, die Sandbox-Runtime um den ganzen Prozess, den Dev-Container, einen eigenen Container, die virtuelle Maschine und, seit einem am 23.09.2026 gesehenen neuen Abschnitt, die Cloud-Sitzung, eine virtuelle Maschine bei Anthropic mit eigenem Proxy für das GitHub-Zugangstoken (vorher unter dem Namen 'Claude Code on the web' geführt). Sie liefert die Trennlinie zum Auto-Modus, dessen Klassifikator je Aktion urteilt und deshalb keine Grenze ist, und sie benennt die Lücke der Bash-Sandbox. Die eingebauten Dateiwerkzeuge laufen im Prozess von Claude Code und unterliegen nur den Rechteregeln. MCP-Server, Command-Hooks und Plugin-Monitore sind eigene Prozesse und laufen unbeschränkt auf dem Rechner. Der schwerste Satz steht bei der Runtime und beschreibt, wie eine Grenze sich selbst aufhebt: Eine abgeschottete Sitzung, die an die Konfigurationspfade schreiben darf, hinterlässt Hooks, Rechteregeln oder MCP-Server, die beim nächsten Start außerhalb laufen. Dazu die Warnung, dass die Runtime ohne Einstellungsdatei trotzdem startet, weshalb ein sauberer Start nichts über die geladenen Einstellungen beweist; eine leere, unlesbare oder ungültige Datei hält den Start dagegen auf.

  • SchlüsselarbeitDokumentationerreichbar

    Anthropic, Choose a permission mode (externe Seite, code.claude.com)

    code.claude.comgeprüft 13.11.2026

    Die Herstellerdokumentation zu den sechs Rechtemodi und dazu, in welchem eine Sitzung startet. Sie hält mehrere Dinge fest, die anderswo fehlen. Eine Grenze, die im Gespräch gezogen wird, liegt nirgends als Regel: Der Klassifikator liest sie bei jeder Prüfung neu aus dem Verlauf, und mit dem Verdichten kann sie verschwinden. Eine Freigabe in die Gegenrichtung wirkt dagegen nur, wenn die Nachricht die Handlung und das Gefährliche daran konkret benennt; das bloße Nennen des Verbs hebt eine Sperre nicht auf. Beim Wechsel in den Auto-Modus setzt Claude Code die eigenen weiten Freigaberegeln außer Kraft, weil sie an der Prüfung vorbeiführen würden. Dazu die Liste der geschützten Pfade, die keine Freigaberegel öffnet, und die Schwellen, ab denen der Auto-Modus wieder zu fragen anfängt. Seit einer Ergänzung, gesehen am 23.09.2026, trennt die Seite zwei Prüfwege: In den Anfragen, die Claude Code selbst an den Klassifikator schickt, sieht dieser Nutzernachrichten, Werkzeugaufrufe außer reinen Lesevorgängen und die Projektanweisung, die Ergebnisse der Werkzeugaufrufe dagegen nicht. Seit einer weiteren Überarbeitung, gesehen am 27.09.2026, prüft der Server diesen Weg inzwischen auf jedem Tarif mit direkter API-Verbindung (ab Version 2.1.271), nicht nur auf Enterprise- und API-Konten, dazu bei Cloud-Anbietern und hinter einem eigenen LLM-Gateway (ab 2.1.278) und in einer angemeldeten Claude-Apps-Gateway-Sitzung (ab 2.1.280); was der Server dabei zu sehen bekommt, sagt die Seite weiter nicht. Neu benannt sind auch zwei Ausweichfälle: Prüft der Server eine Sitzung gar nicht, fällt Claude Code auf die eigene Klassifikator-Anfrage zurück; kommt für eine einzelne Handlung kein Urteil zurück, verweigert Claude Code sie. Eine Auskunft der Seite steht unter dem aufklappbaren Abschnitt „How the classifier evaluates actions“ und deshalb hier ohne hinterlegtes Zitat: die Reihenfolge, in der eine Handlung geprüft wird. Seit Version 2.1.283 startet eine Sitzung im Terminal und in der VS-Code-Erweiterung in der Voreinstellung im Auto-Modus, ein Lauf mit -p dagegen meist im manuellen Modus. Im Auto-Modus fragt Claude Code weiter bei eigenen ask-Regeln und vor dem Löschen eines kritischen Pfads, im Terminal mit einer Frist von zwei Minuten (Stand 09.10.2026). Als kritisch gilt dabei nur, was Claude Code als solchen Pfad erkennt (gesehen am 22.10.2026). In einer Organisation mit HIPAA-Konfiguration gilt der Auto-Start nicht: Dort beginnt eine Sitzung im Terminal und in VS Code ab Version 2.1.285 im manuellen Modus, solange nichts anderes den Startmodus festlegt (gesehen am 17.10.2026).

  • Dokumentationerreichbar

    Anthropic, Configure the sandboxed Bash tool (externe Seite, code.claude.com)

    code.claude.comgeprüft 13.11.2026

    Die Herstellerdokumentation zur Sandbox, die jeden Bash-Befehl in eine vom Betriebssystem gezogene Grenze sperrt. Sie ist die Quelle für den Unterschied, um den es in diesem Kapitel geht: Eine Rechteregel entscheidet je Aufruf, diese Grenze gilt für den laufenden Prozess und alle seine Kinder. Zwei Stellen wiegen schwerer als die Beschreibung selbst. Erstens läuft die Sandbox voreingestellt fail-open: Fehlt ein Paket oder ist die Plattform nicht unterstützt, arbeitet Claude Code ohne Sandbox weiter, bis jemand sandbox.failIfUnavailable setzt. Zweitens darf das Modell die Grenze über einen Rückfallpfad selbst verlassen, wenn ein Befehl darin scheitert; der zweite Versuch läuft dann außerhalb, und wer ihn genehmigt, richtet sich nach dem Rechtemodus. Auf macOS zieht Seatbelt die Grenze, auf Linux und WSL2 bubblewrap, natives Windows wird nicht unterstützt. Seit Version 2.1.271 (Abschnitt 'Per-command allowed domains in auto mode', gesehen 23.09.2026) gibt es einen engeren Weg für einzelne Rechner: Im Auto-Modus kann ein Befehl seine eigene Liste erlaubter Rechner mitbringen, der Klassifikator prüft sie zusammen mit dem Befehl, und der Befehl bleibt dabei in der Sandbox.

  • Dokumentationerreichbar

    Anthropic, Development containers (externe Seite, code.claude.com)

    code.claude.comgeprüft 13.11.2026

    Die Anleitung zum Dev-Container samt der Beispielfassung mit einer Firewall, die alles verbietet, was nicht ausdrücklich erlaubt ist. Wertvoll ist sie vor allem, weil sie ihre eigene Grenze benennt: Läuft Claude Code darin mit `--dangerously-skip-permissions`, hält der Container ein bösartiges Projekt nicht davon ab, alles auszuleiten, was in ihm erreichbar ist, und dazu gehören die Zugangsdaten von Claude Code selbst. Ebenso steht dort, dass das eingehängte Projektverzeichnis unmittelbar auf dem Rechner des Benutzers liegt, ein Schreibzugriff darin also die Grenze gar nicht erst berührt. Die Beispielfassung bezeichnet sich ausdrücklich als Ausgangspunkt, den jeder an seine eigene Umgebung anpasst.

  • Dokumentationerreichbar

    Anthropic, Claude Code changelog (externe Seite, code.claude.com)

    code.claude.comgeprüft 13.11.2026

    Die Versionsliste von Claude Code mit Neuerungen, Verbesserungen und Fehlerbehebungen je Fassung, erzeugt aus der Datei CHANGELOG.md im GitHub-Repository. Jede Fassung steht mit ihrem Erscheinungsdatum da, am 09.10.2026 zuoberst 2.1.296 vom selben Tag.

  • Ankündigung des Herstellerserreichbar

    Auto Mode Default in Claude Code (externe Seite, claude.com)

    claude.comgeprüft 13.11.2026

    Anthropics Ankündigung vom 07.08.2026, mit der der Auto-Modus ab dem 14.08.2026 zur Voreinstellung auf den Plänen Pro, Max und Team wurde. Der Beitrag begründet den Schritt mit eigenen Messungen: Freigabefragen werden zu 97 Prozent bejaht, während dieselben Menschen einem vorgelegten Plan in 39 Prozent der Fälle widersprechen. In einem Versuch mit 1.053 bezahlten Fachleuten erkannte die menschliche Prüfung 13,6 Prozent der gefährlichen Befehle, der Klassifikator 89 Prozent, und die menschliche Quote fiel im Lauf einer Sitzung von 17 auf 5 Prozent. Eine von Trajectory Labs geprüfte Reihe von 720 Angriffen über eine Browser-Anbindung blieb gegen Fable 5, Opus 5 und Sonnet 5 im Auto-Modus ohne Erfolg. Der Beitrag sagt selbst, wie weit seine Zahlen reichen: Die Fehlerquote gegen Angriffe ist an einem eigens dafür gebauten Angriffssatz gemessen. Über den Alltag sagt sie nichts.

  • Originalarbeiterreichbar

    SharedRoot; Escaping the Claude Cowork sandbox (externe Seite, accomplish.ai)

    accomplish.aigeprüft 13.11.2026

    Bericht des Entdeckers, Oren Yomtov von Accomplish AI, vom 23.07.2026. Beschreibt Schritt für Schritt, wie ein Agent in Claude Cowork aus seiner virtuellen Maschine ausbricht und auf dem Mac lesen und schreiben kann, und begründet, warum der dafür genutzte Kernel-Fehler der austauschbare Teil der Kette ist. Der Autor entwickelt ein konkurrierendes Produkt und legt das im Schlussabschnitt offen.

  • Dokumentationerreichbar

    CVE-2026-46331 (externe Seite, nvd.nist.gov)

    nvd.nist.govgeprüft 13.11.2026

    Der Eintrag im Schwachstellenverzeichnis des US-Normungsinstituts zu dem Linux-Kernel-Fehler, den die Ausbruchskette benutzt. Er sitzt in der Paketbearbeitung des Netzwerk-Schedulers und erlaubt es, den zwischengespeicherten Inhalt einer Datei zu verändern, die man nur lesen darf. Von kernel.org mit 7,8 von 10 bewertet, von Red Hat mit 6,7, vom Verzeichnis selbst noch nicht (Stand: 06.11.2026). Öffentlich seit Juni 2026, in acht Kernel-Branches behoben.

In den Meldungen

neueste zuerst

↑↓ auswählenEnter öffnenDie Suche läuft im Browser. Nichts wird übertragen.