SandboxesÜbersicht

Sandboxes für KI-Agenten

Sandboxes auf Lizard (lizard.build) sind isolierte Linux-Maschinen, in denen ein KI-Agent Code und Aufgaben ausführt. Sandboxes laufen als Firecracker microVMs, jede mit eigenem Kernel. Ihr Code erstellt eine mit Lizard SDK (@lizard-build/sdk für TypeScript, lizard-sdk für Python), oder Sie führen lizard sandbox create in einem Terminal aus; danach führen Sie Befehle aus, lesen und schreiben Dateien und öffnen Ports. In einem Test am 2026-10-12 dauerte es vom Erstellen einer Sandbox bis zur ersten Python-Ausgabe im Median 228 ms.

Wann Sie Sandboxes verwenden

  • Code ausführen, den ein Modell geschrieben hat. Geben Sie einem LLM einen Code Interpreter, der den Python-Zustand zwischen Aufrufen behält.
  • Einem Coding-Agenten eine eigene Maschine geben. Führen Sie Claude Code, OpenCode oder Codex in einer Sandbox statt auf Ihrem Laptop aus. Verbinden Sie seine Zugangsdaten mit lizard agents und senden Sie Prompts mit lizard sandbox prompt.
  • Ansehen, was der Agent gebaut hat. Starten Sie einen Dev-Server und öffnen Sie ihn über eine private Vorschau-URL.
  • Mehrere Wege gleichzeitig ausprobieren. Forken Sie eine laufende Sandbox einschließlich Arbeitsspeicher und Prozessen, oder stellen Sie viele Kopien aus einem Snapshot wieder her.
  • Einen Browser steuern. Die Vorlage desktop führt einen grafischen Desktop aus, den ein Agent mit Screenshots, Klicks und Tasten steuert.

Für einen Webservice oder Worker, der dauerhaft laufen soll, stellen Sie stattdessen eine App bereit; siehe den App-Schnellstart.

Wie schnell startet eine Sandbox?

In einem Test am 2026-10-12 dauerte es vom Erstellen einer Sandbox bis zur ersten Python-Ausgabe im Median 228 ms; das 95. Perzentil lag bei 310 ms. Der Test lief 300-mal aus der Region US East von Railway gegen us-east-1, mit der Vorlage base und der Größe Small. Ergebnisse desselben Tests für E2B, Daytona und Modal stehen auf der Sandboxes-Seite.

Sandboxes auf einen Blick

FrageAntwort
Was führt den Code aus?Eine Firecracker microVM mit eigenem Kernel; siehe Laufzeit und Vorlagen
Wie erstelle ich eine?Lizard SDK, lizard sandbox, das Dashboard oder die HTTP-API
Welche Vorlagen gibt es?base, interpreter, codex, claude, opencode, pi, prime, desktop und desktop-camoufox (nur US East)
Welche Größen gibt es?Mini (1 vCPU / 2 GB), Small (2 vCPU / 4 GB), Medium (4 vCPU / 8 GB, Standard) und Large (8 vCPU / 16 GB). Mini startet nur aus den Vorlagen base, claude, codex und interpreter. Die Testphase erlaubt Mini und Small sowie eine Medium-Sandbox zur selben Zeit, in US-Regionen. Siehe Größen und Preise
Wie lange lebt eine?Standardmäßig fünf Minuten über SDK und CLI; standardmäßig kein Ablauf über die direkte API und das Dashboard
Was übersteht eine Pause?Die ganze Festplatte, auch Pakete außerhalb von /workspace, dazu Arbeitsspeicher und laufende Prozesse (eine Pause mit fast: true behält nur die Festplatte)
Was übersteht einen Stopp (Kill oder Ablauf)?Dateien auf einem Volume aus Persistent Volumes unter /workspace und jeder Snapshot, den Sie erstellt haben; ein Snapshot enthält die ganze Festplatte
Wie viele können gleichzeitig laufen?Die Limits zählen vCPU: 40 mit Pro (zum Beispiel 10 Medium), 220 mit Pro 5x, 1,200 mit Pro 20x und 8 während der Testphase (bis zu 8 Mini oder 4 Small); siehe Kontolimits. Pro, Pro 5x und Pro 20x haben kein Limit für Sandbox-Starts.

Laufzeit und Vorlagen

Wählen Sie eine Vorlage aus dem aktuellen Katalog: base, interpreter, codex, claude, opencode, pi, prime, desktop oder desktop-camoufox. Die Verfügbarkeit hängt von Region und Pool-Kapazität ab. interpreter enthält Python, gängige Datenbibliotheken und Node 22. desktop führt einen grafischen Desktop aus, den Sie mit sandbox.desktop oder lizard sandbox desktop steuern. desktop-camoufox ist die Vorlage desktop plus Camoufox, ein Firefox-Build für Scraping, den Sie mit Playwright steuern; sie läuft vorerst nur in us-east-1. Prüfen Sie die Werkzeugversionen in der Sandbox. Die öffentliche CLI bietet keinen Upload eigener Vorlagen.

Lizard Sandboxes laufen als Firecracker microVMs, jede mit eigenem Kernel. Geben Sie dem Agenten nur die Zugangsdaten und Rechte, die er für seine Aufgabe braucht.

Lebenszyklus

Erstellen Sie eine Sandbox, führen Sie Befehle aus und rufen Sie danach kill auf. connect verbindet mit einer bestehenden Sandbox, ohne ihren Zustand zu ändern; eine pausierte oder gestoppte Sandbox wird dadurch nicht fortgesetzt. Pause, Fortsetzen, Snapshot und Restore sind verfügbar; siehe Pause, Fortsetzen und Snapshots. fork kopiert eine laufende Sandbox einschließlich Arbeitsspeicher und Prozessen; bei angehängtem Volume gibt es 409 zurück. Dateiüberwachung ist noch nicht verfügbar. lizard sandbox ssh öffnet eine interaktive Shell mit Ihren CLI-Zugangsdaten. Zugriff über das SSH-Protokoll gibt es nicht, daher funktionieren SSH-Clients, scp und Portweiterleitung nicht.

create -> running -> stopped (kill / expiration)
running -> paused -> running (pause / resume)
running -> new sandboxes (fork)
snapshot -> new sandbox (restore)

Ressourcen und Laufzeit

Wählen Sie beim Erstellen eine Größe: Mini (1 vCPU / 2 GB), Small (2 vCPU / 4 GB), Medium (4 vCPU / 8 GB, Standard) oder Large (8 vCPU / 16 GB). Mini startet nur aus den Vorlagen base, claude, codex und interpreter, ohne Volume. In der Testphase ist eine Sandbox Mini oder Small, oder eine Medium zur selben Zeit, und läuft in einer US-Region. Siehe Größen und Preise. Geben Sie bei Bedarf eine Region an; ein Katalogeintrag garantiert keine freie Kapazität.

SDK und CLI setzen standardmäßig eine Laufzeit von fünf Minuten. Die direkte API und das Dashboard setzen standardmäßig kein Ablaufdatum. Geben Sie die Laufzeit ausdrücklich an: timeoutMs: 0 bei der Erstellung deaktiviert den Ablauf; ein positiver Wert setzt eine Frist. setTimeout akzeptiert 1000–2147483647 ms, nicht null. Befehle verlängern die Frist nicht. Dies ist kein Leerlauf-Timer.

Speicher und Abrechnung

Dateien und laufende Prozesse bleiben verfügbar, solange die Sandbox läuft. Eine Pause behält die ganze Festplatte, auch Pakete außerhalb von /workspace, dazu Arbeitsspeicher und laufende Prozesse; ein Resume stellt alles wieder her. Ein Snapshot enthält dasselbe, und Sie können ihn wiederherstellen, auch wenn die Quell-Sandbox nicht mehr existiert. Ein Stopp (Kill oder Ablauf) löscht die Festplatte der Sandbox: Es bleiben nur Dateien auf einem angehängten Volume aus Persistent Volumes unter /workspace und Ihre Snapshots. Ohne Volume gehört /workspace zu dieser Festplatte. Ein Volume hängt jeweils an einer Sandbox und liegt auf einem einzelnen Knoten. Exportieren Sie Dateien, die einen Knotenausfall überstehen müssen.

Jede Größe hat einen festen Stundenpreis, sekundengenau abgerechnet, solange die Sandbox läuft, Leerlauf eingeschlossen. Ausgehender Traffic ist bis 2 TB pro Konto in rollierenden 30 Tagen enthalten. Eine aus einem Snapshot wiederhergestellte Sandbox läuft mit Größe und Preis ihrer Quelle. Eine erfolgreiche Pause stoppt die Rechenkosten; Persistent Volumes werden getrennt abgerechnet, solange Sie die Daten behalten. Pausieren oder beenden Sie eine Sandbox, wenn die Aufgabe erledigt ist. Die Tarife für jede Ressource stehen auf der Abrechnungsseite und unter Preise.

Anleitungen

Artikel im Blog von Lizard:

Referenz

Object Storage (S3)Schnellstart

Aktualisiert