Claude Code in einer Sandbox ausführen

Um Claude Code in einer Sandbox auf Lizard (lizard.build) auszuführen, verbinden Sie einmalig Zugangsdaten mit lizard agents add claude (ein Token aus claude setup-token) oder lizard agents add anthropic (ein API-Schlüssel). Erstellen Sie dann eine Sandbox aus der Vorlage claude und schicken Sie ihr Aufgaben mit lizard sandbox prompt <id> --agent claude "…". Claude Code läuft auf einer eigenen Linux-Maschine mit --dangerously-skip-permissions: Es bearbeitet Dateien und führt Befehle aus, ohne nachzufragen, und hat keinen Zugriff auf Ihren Rechner.

Teststatus: Die Befehle und das Verhalten auf dieser Seite stammen aus Lizard CLI 4.0.42 und dem Agent-Runner der Plattform mit Stand 2026-10-12. Wir haben diese Anleitung noch nicht vollständig in einer laufenden Sandbox getestet. Die Schritte mit git bundle und dem Patch haben wir lokal geprüft.

Bevor Sie beginnen

• Lizard CLI, angemeldet mit lizard login, und ein Projekt: Führen Sie lizard init in einem Ordner aus, oder übergeben Sie -p <project> an die Sandbox-Befehle.
• Lizard Pro oder die 7-tägige Pro-Testphase (Karte erforderlich). Sandboxes werden sekundengenau nach Größe abgerechnet, solange sie laufen; siehe Limits und Preise.
• Für ein Claude-Abo: Claude Code auf Ihrem Rechner, um claude setup-token auszuführen.

Zugangsdaten verbinden

Zugangsdaten gehören zu Ihrem Lizard-Konto, nicht zu einem Projekt, und jede Sandbox, die Sie starten, kann sie verwenden. Claude Code verwendet immer nur eine davon. Wenn mehrere verbunden sind, wählen Sie eine aus und, wenn Sie möchten, ein Standardmodell:

lizard agents use claude --credential anthropic
lizard agents use claude -m sonnet
lizard agents status

Alle Optionen finden Sie unter lizard agents.

Eine Sandbox erstellen

lizard sandbox create -t claude --timeout 3600000

Der Befehl gibt die Sandbox-ID aus, etwa sb_abc123. Speichern Sie sie für die folgenden Schritte in einer Variablen: SB=sb_abc123.

• --timeout 3600000 gibt der Sandbox eine Stunde. Der Standard der CLI sind fünf Minuten; danach löscht Lizard die Sandbox samt Dateien, auch mitten in einer Aufgabe. Eine laufende Sandbox verlängern Sie mit lizard sandbox timeout $SB 3600000.
• Die Vorlage claude enthält Node.js 22, eine festgelegte Version von Claude Code, git, Python 3, ripgrep, curl, jq, unzip und Lizard CLI. Die Version von Claude Code prüfen Sie mit lizard sandbox exec $SB -- claude --version.
• Die Standardgröße ist Medium (4 vCPU, 8 GB). Mit --size small oder --size large ändern Sie sie.

Ihren Code in die Sandbox bringen

Aus einem öffentlichen Repository:

lizard sandbox exec $SB -- git clone https://github.com/your-org/your-app /workspace/app

Aus einem lokalen Git-Repository, auch einem privaten:

git bundle create /tmp/app.bundle HEAD
lizard sandbox files put $SB /tmp/app.bundle /workspace/app.bundle
lizard sandbox exec $SB -- git clone -q /workspace/app.bundle /workspace/app

Ein Bundle enthält nur committete Dateien, daher bleiben .env und andere nicht versionierte Dateien auf Ihrem Rechner.

Einen Prompt senden

lizard sandbox prompt $SB --agent claude --cwd /workspace/app "run the tests and fix any that fail"

Die CLI streamt jeden Tool-Aufruf, danach Claudes Antwort, die Anzahl der Tokens und die Konversations-ID. Nützliche Flags: -m <model>, --effort <level>, -v, um die Befehlsausgabe anzuzeigen, und --no-wait, um sofort zurückzukehren. Strg-C beendet die Anzeige; Claude arbeitet weiter. Stoppen Sie Claude mit lizard sandbox interrupt $SB.

Um dieselbe Sitzung von Claude Code fortzusetzen, übergeben Sie die Konversations-ID:

lizard sandbox prompt $SB --agent claude -c conv_0123456789abcdef --cwd /workspace/app "now add a test for an empty list"
lizard sandbox conversations $SB

Übergeben Sie --agent claude und --cwd bei jedem Prompt, auch bei Folgefragen. Ohne --agent geht der Prompt an Codex, und ohne --cwd arbeitet der Agent in /workspace.

Worauf Claude Code zugreifen kann

• Berechtigungen. Jeder Aufruf führt claude -p mit --dangerously-skip-permissions als root in der Sandbox aus. Claude bearbeitet Dateien, installiert Pakete und führt Befehle aus, ohne nachzufragen. Die Grenze ist die Sandbox.
• Dateien. Alles in der Sandbox und nichts auf Ihrem Rechner.
• Netzwerk. Ausgehender Internetzugang, sodass es Pakete laden und APIs aufrufen kann. Im Sandbox-Preis ist ausgehender Traffic bis 2 TB pro Konto in rollierenden 30 Tagen enthalten.
• Ihre Zugangsdaten. Während eines Laufs liegt das Token in der Umgebung von Claude Code als CLAUDE_CODE_OAUTH_TOKEN oder ANTHROPIC_API_KEY, und Befehle, die es ausführt, erben es. Bei einem Abo ist das das langlebige Token aus claude setup-token; nur ChatGPT-Logins erhalten pro Lauf eine kurzlebige Kopie. Gehen Sie davon aus, dass Code in der Sandbox es lesen kann, und entfernen Sie es mit lizard agents remove claude, wenn Sie es nicht mehr brauchen.
• Ihr Lizard-Konto. Standardmäßig kein Zugriff. Erstellen Sie die Sandbox mit --with-token <key>, um einen liz_-Schlüssel zu hinterlegen, damit lizard darin funktioniert, zum Beispiel um zu deployen, was Claude gebaut hat. Alles in der Sandbox kann diesen Schlüssel lesen. Verwenden Sie daher einen, der auf einen Workspace oder ein Projekt beschränkt ist; siehe lizard keys.

Die Änderungen zurückholen

lizard sandbox exec $SB -- sh -c 'cd /workspace/app && git add -A && git diff --cached > /tmp/claude.patch'
lizard sandbox files get $SB /tmp/claude.patch claude.patch
git apply claude.patch

Prüfen Sie den Patch, bevor Sie ihn committen. Um eine Web-App auszuprobieren, die Claude gestartet hat, öffnen Sie eine Vorschau-URL für ihren Port, zum Beispiel mit lizard sandbox expose $SB 3000.

Claude Code von Hand nutzen

lizard sandbox ssh $SB öffnet eine Shell in der Sandbox. Zugangsdaten aus lizard agents erreichen nur Läufe von lizard sandbox prompt; exportieren Sie daher in dieser Shell Ihr eigenes CLAUDE_CODE_OAUTH_TOKEN oder ANTHROPIC_API_KEY und führen Sie dann claude aus.

Die Sandbox pausieren oder entfernen

lizard sandbox pause $SB
lizard sandbox resume $SB
lizard sandbox rm $SB

Eine erfolgreiche Pause stoppt die Rechenkosten; Speicher in Persistent Volumes wird weiter berechnet. Beim Fortsetzen kehren Dateien und Prozesse zurück und die Rechenkosten beginnen erneut. Der Zustand der Konversationen liegt in /workspace/.lizard-agent in der Sandbox. Um Dateien nach dem Entfernen der Sandbox zu behalten, hängen Sie beim Erstellen mit --volume ein Volume aus Persistent Volumes an.

Häufige Probleme

Siehe auch

• OpenCode in einer Sandbox ausführen
• Sandboxes
• lizard sandbox
• Aus einem Coding-Agenten deployen

Aktualisiert 17. Oktober 2026