DEV Community

Cover image for Codex Sandbox vs. Docker Sandboxes: Zwei Wege, einen Coding-Agenten zu isolieren
Emre Demir
Emre Demir

Posted on Originally published at apidog.com

Codex Sandbox vs. Docker Sandboxes: Zwei Wege, einen Coding-Agenten zu isolieren

Codex-Sandbox vs. Docker Sandboxes: Wo dein Agent wirklich läuft

Bei der Frage Codex-Sandbox vs. Docker Sandboxes liegt der Unterschied darin, wo die Befehle des Agenten ausgeführt werden. Die Codex-Sandbox behält Befehle auf deiner eigenen Maschine und beschränkt sie mit OS-Tools (Seatbelt unter macOS, bubblewrap plus seccomp unter Linux, MXC unter Windows). Docker Sandboxes verschieben den Agenten in eine MicroVM mit eigenem Kernel, Dateisystem, Docker Engine und Netzwerk. Wähle die Codex-Sandbox, wenn du native Toolchains brauchst; wähle Docker Sandboxes, wenn du eine harte Grenze um alles ziehen willst, was der Agent tut.

Teste Apidog noch heute

Codex-Sandbox vs. Docker Sandboxes auf einen Blick

Codex-Sandbox Docker Sandboxes
Wo die Befehle ausgeführt werden Deine bestehende Umgebung Eine MicroVM pro Sandbox
Isolierungsmechanismus Seatbelt (macOS), bubblewrap + seccomp-bpf (Linux), MXC (Windows) Hypervisor, separater Kernel pro Sandbox
Konfiguriert mit Berechtigungsprofile in config.toml sbx CLI und Richtlinien
Standardnetzwerk Für das Profil :workspace deaktiviert Ein standardmäßig ablehnender Proxy mit einer Standard-Allow-List
Native Host-Tools Ja (Xcode, Simulatoren, lokale SDKs) Nein, nur was sich in der VM befindet
Unterstützte Agenten Codex (plus jeder Befehl über codex sandbox) Claude Code, Codex, Copilot, Cursor, Devin, Kiro, OpenCode und weitere
Team-Richtlinie Von requirements.toml verwaltete Anforderungen Docker AI Governance (separates kostenpflichtiges Abonnement)
Preis Teil von Codex sbx CLI und lokale Rechenleistung kostenlos; Cloud nach Pay-as-you-go

Was ist die Codex-Sandbox?

Die Codex-Sandbox ist die Ebene, die begrenzt, welche Befehle, die Codex auf deinem Computer ausführt, lesen, schreiben und erreichen können. Sie verschiebt die Arbeit nicht in einen Container oder eine VM. Stattdessen umschließt sie jeden Befehl und jeden von ihm gestarteten untergeordneten Prozess mit den Sandboxing-Funktionen des Betriebssystems selbst, anhand von Regeln, die du in einem Berechtigungsprofil festlegst.

Das integrierte Profil :workspace ist der Standard für ein Git-Repository. Es erlaubt Schreibzugriffe innerhalb des Arbeitsbereichs, während .git und .codex schreibgeschützt bleiben, erlaubt weitreichende Lesezugriffe anderswo (Compiler benötigen SDKs außerhalb des Repos) und deaktiviert den Netzwerkzugriff. Du kannst es in config.toml erweitern. Dieses Beispiel stammt aus OpenAIs Beitrag:

default_permissions = "dev"

[permissions.dev]
description = "Development with extra read-only protections."
extends = ":workspace"

[permissions.dev.filesystem]
"~/build-cache" = "write"

[permissions.dev.filesystem.":workspace_roots"]
".devcontainer" = "read"
".vscode" = "read"
"**/*.env" = "deny"
"secrets" = "deny"
Enter fullscreen mode Exit fullscreen mode

Der Befehl codex sandbox führt jedes Programm unter einem Profil aus, außerhalb einer Agentensitzung. So testest du ein Profil oder umschließt einen stdio-MCP-Server, den Codex sonst ohne Sandbox starten würde:

codex sandbox --permission-profile dev -- bash -c 'cat > .vscode/settings.json'
Enter fullscreen mode Exit fullscreen mode

Unter macOS schlägt dieser Schreibvorgang mit Operation not permitted fehl. Kopierfertige Profile findest du in der Dokumentation zu Berechtigungsprofilen.

Was sind Docker Sandboxes?

Docker Sandboxes führen KI-gestützte Coding-Agenten in isolierten MicroVMs aus – auf deiner Maschine oder auf der von Docker verwalteten Cloud-Infrastruktur. Jede Sandbox erhält einen eigenen Kernel, Docker-Daemon, ein eigenes Dateisystem und Netzwerk. Der Agent hat innerhalb der VM volle Rechte, einschließlich sudo und einer privaten Docker Engine, erreicht aber nur die Host-Ressourcen, die du freigibst.

Du steuerst sie über die sbx CLI, die kein Docker Desktop benötigt. Lokale Sandboxes erfordern macOS 14 oder neuer auf Apple Silicon, Windows 11 mit Hypervisor Platform oder Ubuntu 24.04 oder neuer mit KVM. Aus dem Leitfaden für den Einstieg:

cd ~/my-project
sbx run --name my-sandbox claude   # or: sbx run codex
sbx policy ls
sbx policy allow network registry.npmjs.org
sbx stop my-sandbox
sbx rm my-sandbox
Enter fullscreen mode Exit fullscreen mode

Dein Projektverzeichnis wird unter demselben absoluten Pfad in die VM eingebunden. Eine direkte Einbindung ist les- und schreibbar, sodass der Agent deinen Arbeitsbaum direkt bearbeitet. Mit --clone wird das Host-Repo schreibgeschützt eingebunden und der Agent arbeitet stattdessen in einem privaten Git-Clone. Anmeldedaten bleiben auf dem Host: In Dockers Architekturdokumentation heißt es: „Die Rohwerte der Anmeldedaten gelangen niemals in die VM."

Side-by-side diagram: the Codex sandbox wraps commands on the host OS with a permission profile, while Docker Sandboxes run the whole agent inside a microVM with its own kernel and network proxy

Isolationsstärke: OS-Richtlinien vs. ein separater Kernel

Codex beschränkt Prozesse auf dem Host-Kernel. Unter macOS erzeugt es ein Seatbelt-Profil, das mit (deny default) beginnt. Unter Linux baut es mit bubblewrap eine Dateisystemansicht auf, trennt die Netzwerk-, IPC- und PID-Namespaces ab und wendet einen seccomp-bpf-Filter mit gesetztem no_new_privs an. Unter Windows wechselt es zu Microsofts MXC-Bibliothek (Microsoft eXecution Container). Die Grenzen sind real und werden vom Kernel durchgesetzt, aber der Agent teilt deinen Kernel und sieht deine Maschine durch einen Filter.

Docker setzt einen Hypervisor zwischen den Agenten und deinen Host. Jede Sandbox hat einen separaten Kernel und eine eigene Docker Engine „ohne Pfad zum Host-Daemon". Ein Kernel-Bug oder eine falsch konfigurierte Regel innerhalb der VM übergibt dem Agenten nicht deinen Laptop.

Beide lassen Lücken, die sie offen dokumentieren:

  • Codex' Standardprofil lässt weitreichende Lesezugriffe aktiviert, sodass eine Konfigurationsdatei an anderer Stelle mit einem API-Schlüssel lesbar bleiben kann. OpenAI warnt außerdem, dass ein Agent eine ignorierte Datei wie node_modules/prettier manipulieren könnte, die dein Editor später außerhalb der Sandbox ausführt.
  • Dockers direkte Einbindung ist les- und schreibbar, sodass Git-Hooks, CI-Konfiguration und ein Makefile, die der Agent bearbeitet, später auf deinem Host ausgeführt werden können. Lokale stdio-MCP-Server laufen zudem außerhalb der Sandbox-VM.

Keine der beiden ersetzt die Notwendigkeit, die Änderungen des Agenten zu überprüfen. Wenn du mit der Codex-Sandbox gekämpft hast, behandelt unser Leitfaden zum Umgehen der Codex-Sandbox den sichereren Mittelweg.

Native Tools und Einrichtungsaufwand

OpenAIs Argument gegen Container ist konkret. Wenn du Codex beim Entwickeln einer iOS-App mit Docker sandboxen würdest, „könnte Codex die iOS-Build-Toolchain aus nativen Mac-Executables nicht ausführen und auch den iPhone-Simulator nicht starten". Diese Schritte wieder an den Host zu delegieren, würde sie erneut außerhalb der Sandbox verlagern.

Die Codex-Sandbox kostet daher fast nichts in der Einrichtung: Deine Shell, SDKs und Caches bleiben, wo sie sind.

Docker Sandboxes verlangen im Vorfeld mehr. Die VM startet aus einer Vorlage (docker/sandbox-templates:codex für Codex), und du fügst Tools über Kits oder durch Installation innerhalb der VM hinzu. Sandboxes lesen keine Konfiguration auf Benutzerebene wie ~/.codex, sondern nur Projektkonfiguration im Arbeitsverzeichnis. Im Gegenzug erhältst du eine saubere, reproduzierbare Umgebung, die für jeden Agenten gleich funktioniert, und eine Container-Workload kann sicher in der privaten Docker Engine der VM laufen.

Für einen Dienst, der bereits in einem Container gebaut wird, ist dieser Aufwand gering. Für Xcode oder ein lizenziertes Desktop-SDK ist er groß.

Netzwerkkontrolle im Vergleich

Beide leiten Datenverkehr über einen Proxy, der Domains prüft, und beide starten mit geschlossenem Netzwerk.

Codex hat drei Modi: Netzwerk aus (Standard bei :workspace), voller Zugriff (:danger-full-access) oder ein Proxy, der Domain-Regeln pro Profil durchsetzt:

[permissions.dev.network]
enabled = true

[permissions.dev.network.domains]
"*.openai.com" = "allow"
"localhost" = "allow"
"evil.example" = "deny"

[features]
network_proxy = true
Enter fullscreen mode Exit fullscreen mode

Explizite Ablehnungen haben Vorrang vor Erlaubnissen, und eine Anfrage an eine nicht aufgeführte Domain kann anhalten und auf deine Genehmigung warten. Der Proxy löst einen Hostnamen erst auf, nachdem er erlaubt wurde; OpenAI merkt jedoch an, dass breite Wildcards weiterhin DNS-basierte Exfiltration ermöglichen können.

Docker leitet den gesamten ausgehenden TCP-Datenverkehr aus der VM über einen Proxy auf dem Host, blockiert UDP und ICMP standardmäßig und verwaltet Regeln mit sbx policy. Die Seite zum Sicherheitsmodell warnt: „Die standardmäßig erlaubten Domains umfassen breite Wildcards." Führe daher sbx policy ls aus, bevor du den Standardeinstellungen vertraust.

Team-Richtlinien: verwaltete Anforderungen vs. Docker AI Governance

Teams brauchen eine Richtlinie, die Benutzer nicht still und leise lockern können.

Codex verwendet verwaltete Anforderungen. Ein Administrator stellt eine requirements.toml bereit – aus einer Systemdatei wie /etc/codex/requirements.toml oder aus einer Cloud-Richtlinie –, die festlegt, welche Profile Benutzer auswählen dürfen:

default_permissions = ":read-only"

[allowed_permission_profiles]
":read-only" = true
":danger-full-access" = false
Enter fullscreen mode Exit fullscreen mode

Docker verkauft diese Ebene als Docker AI Governance: Sandbox-Richtlinien für Netzwerk und Dateisystem, MCP-Tool-Richtlinien in Cedar, durchgesetzt am MCP-Gateway von Docker, sowie Audit-Aufzeichnungen zu jeder Entscheidung, die du lokal behalten oder in die Cloud senden kannst. Dockers Dokumentation führt organisationsweite Richtlinien als separates kostenpflichtiges Abonnement auf. Der Vorteil ist eine einzige Richtlinie für jeden Agenten, den dein Team verwendet – nicht nur für Codex.

Wann du was verwendest

Es gibt keinen eindeutigen Sieger. Passe die Grenze an die Arbeit an:

  1. Verwende die Codex-Sandbox, wenn du für macOS oder iOS entwickelst, auf Host-exklusive SDKs angewiesen bist oder null Einrichtung möchtest und Codex dein einziger Agent ist.
  2. Verwende Docker Sandboxes, wenn du mehrere Agenten ausführst, einen separaten Kernel zwischen Agent und Laptop möchtest oder den Agenten lange unbeaufsichtigte Aufgaben mit Docker im Inneren ausführen lässt.
  3. Verwende beides, wenn du Codex innerhalb einer harten Grenze möchtest. Auf Dockers Codex-Seite wird gezeigt, dass sbx run codex standardmäßig codex --dangerously-bypass-approvals-and-sandbox startet: Die MicroVM wird zur Mauer, und Codex' eigene Genehmigungen treten beiseite. Behalte diesen Kompromiss im Hinterkopf, bevor du dich dafür entscheidest.

Decision flow for choosing between the Codex sandbox and Docker Sandboxes based on native tools, number of agents and isolation needs

Teste deine API mit der Apidog CLI aus jeder der beiden Sandboxes

Egal für welche Mauer du dich entscheidest, dein Agent muss weiterhin nachweisen, dass seine Änderungen gegen eine echte API funktionieren. Apidog CLI gibt ihm Befehle für Testfälle und Läufe mit JSON-Ausgabe, die es lesen kann. Richte sie einmal ein:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Enter fullscreen mode Exit fullscreen mode

Öffne dann das Netzwerk für genau zwei Hosts: deine API und api.apidog.com, die Standard-API-Basis der CLI. Füge in Codex beide der Tabelle [permissions.<name>.network.domains] des Profils hinzu. Führe in Docker Sandboxes sbx policy allow network api.apidog.com und zusätzlich denselben Befehl für den Host deiner API aus.

Gib deinem Agenten einen Prompt:

Using Apidog CLI, create a test case in project <projectId> for
POST /orders on endpoint <endpointId> that asserts a 201 status and an
"id" field in the body. Run it against environment <envId> and summarize
any failures.
Enter fullscreen mode Exit fullscreen mode

Der Agent liest das Schema, validiert seine Payload und führt den Testfall aus:

apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog test-case run --project <projectId> --endpoint <endpointId> -e <envId> -r cli,json
Enter fullscreen mode Exit fullscreen mode

Wenn ein Lauf mit einem Netzwerkfehler fehlschlägt, hat die Sandbox ihre Aufgabe erfüllt: Prüfe, welcher Host in der Allow-List gefehlt hat. Die vollständige Codex-Anleitung findest du unter Apidog CLI in Codex; ersetze -r cli,json durch -r junit, wenn derselbe Lauf in eine CI-Pipeline wandert. Der Free-Plan von Apidog deckt bis zu 4 Benutzer ab.

FAQ

Ist die Codex-Sandbox ein Container? Nein. Codex beschränkt Befehle in deiner bestehenden Umgebung mit Seatbelt unter macOS, bubblewrap und seccomp-bpf unter Linux und MXC unter Windows. Es gibt kein separates Dateisystem-Image und keine VM.

Sind Docker Sandboxes einfach Container? Nein. Dockers Dokumentation beschreibt sie als MicroVMs mit Hypervisor-Isolierung und einem separaten Kernel pro Sandbox. Jede betreibt eine eigene Docker Engine, sodass der Agent darin Container bauen und ausführen kann.

Kann ich Codex in Docker Sandboxes ausführen? Ja. sbx run codex startet Codex in einer MicroVM. Standardmäßig wird es mit --dangerously-bypass-approvals-and-sandbox gestartet, sodass die VM und nicht Codex' Sandbox die Grenze bildet.

Sind Docker Sandboxes kostenlos? Docker zufolge sind die sbx CLI und die lokale Sandbox-Rechenleistung kostenlos, auch für kommerzielle Arbeit. Cloud-Sandboxes verwenden ein Pay-as-you-go-Abonnement, die Gebühren der Modellanbieter fallen separat an, und die Verwaltung organisationsweiter Richtlinien ist ein separates kostenpflichtiges Abonnement.

Deckt eine der beiden Sandboxes MCP-Server ab? Standardmäßig nicht. Codex sandboxt stdio-MCP-Server nicht, sofern du sie nicht mit codex sandbox umschließt. Docker führt lokale stdio-MCP-Server außerhalb der VM aus; seine MCP-Gateway- und Cedar-Richtlinien gelten für Server, die durch das Gateway geleitet werden.

Top comments (0)