---
title: "Doku zu Pethost Agent Sandboxes"
description: "Wie Pethost Agent Sandboxes funktionieren und was sie kosten: Firecracker-MicroVMs für Code, Coding-Agenten und einen Browser, aus deinem Code oder Agenten."
---

# Doku zu Pethost Agent Sandboxes

Aktualisiert 22. November 2026 · 2 Min. Lesezeit

Eine Sandbox ist eine Linux-MicroVM für Code, Coding-Agenten und einen Desktop mit Chrome: eine Firecracker-VM mit eigenem Kernel, und darin bist du root. Sie startet aus einer Vorlage in etwa 0,15 s, pausiert mit RAM und Prozessen, wenn nichts in ihr passiert, wacht beim nächsten Aufruf in etwa 0,1 s auf und stoppt in den Objektspeicher, wenn sie länger im Leerlauf bleibt. Du zahlst sekundengenau für das, was jeder Zustand hält.

**RUNNING**

Im RAM ihres Servers

Führt deine Prozesse aus und beantwortet jeden Aufruf.

0,018 $ pro Stunde, SMALL

5 min Leerlauf: Sie pausiert

Der nächste Aufruf weckt sie

**PAUSED**

Auf der Disk ihres Servers

Behält RAM, Prozesse und Disk.

0,0054 $ pro Stunde, SMALL

30 min Leerlauf: Sie stoppt

**STOPPED**

Im Objektspeicher

Behält ihre Disk; ihre Prozesse enden.

0,03 $ pro GiB und Monat

ResumeSandbox startet sie wieder, ihre Dateien, wie sie sie verlassen hat

Der Standard-Lebenszyklus. Jeder Timer lässt sich ändern oder abschalten, und eine Sandbox wird nie gelöscht, außer du verlangst es: [Lebenszyklus und Leerlauf](https://pethost.dev/de/docs/sandboxes/lifecycle/).

## Wo du anfängst

[**Code schreiben** Der Schnellstart: eine Sandbox, ein Befehl, eine Datei und eine öffentliche URL aus Python, TypeScript, Go oder Rust oder mit der pethost-CLI.](https://pethost.dev/de/docs/sandboxes/quickstart/) [**Deinem Agenten geben** Füg den MCP-Server zu Claude, Codex, Cursor oder einem anderen MCP-Client hinzu, und der Agent erstellt und nutzt Sandboxes selbst.](https://pethost.dev/de/docs/sandboxes/connect-an-agent/) [**Erst verstehen** Die drei Zustände, was eine Sandbox weckt und wo jedes ihrer Bytes liegt.](https://pethost.dev/de/docs/sandboxes/how-it-works/)

## In Zahlen

- **0,15 s** zum Start einer Sandbox, gemessen über ein Panel 16 ms von ihrem Server entfernt
- **0,1 s** zum Wecken einer pausierten, beim nächsten Aufruf
- **0,018 $** pro Stunde für 2 vCPUs und 4 GiB, sekundengenau
- **30 %** dieses Preises, solange sie pausiert

## Was eine Sandbox kann

- **Befehle, Dateien und ein Terminal.** Führ einen Befehl aus und warte auf seinen Port, bearbeite eine Datei durch exaktes Ersetzen, streame die Ausgabe oder öffne ein Terminal im Browser: [Befehle und Dateien](https://pethost.dev/de/docs/sandboxes/commands-and-files/).
- **Ports.** Jeder Port unter `https://<port>-<id>.<server>`, öffentlich oder hinter einem Token: [Ports und Vorschauen](https://pethost.dev/de/docs/sandboxes/ports-and-previews/).
- **Coding-Agenten.** Claude Code, Codex und OpenCode sind installiert. Ein Aufruf gibt einem Agenten einen Prompt, ein anderer streamt jeden Tool-Aufruf, den er macht: [Coding-Agenten](https://pethost.dev/de/docs/sandboxes/coding-agents/).
- **Ein Desktop.** Chrome auf einem Bildschirm mit 1280×800, der bei seiner ersten Nutzung startet: klicken, tippen und einen Screenshot machen in einem Aufruf, oder live zusehen: [Computer Use](https://pethost.dev/de/docs/sandboxes/computer-use/).
- **Vorlagen, Forks und Volumes.** Speichere die Disk einer Sandbox und starte neue daraus ([Vorlagen](https://pethost.dev/de/docs/sandboxes/templates/)); kopier eine laufende Sandbox samt RAM in bis zu 100 Kopien ([Forks](https://pethost.dev/de/docs/sandboxes/forks/)); halte Daten auf einer Disk außerhalb jeder Sandbox, auf einem Server ([Volumes](https://pethost.dev/de/docs/sandboxes/volumes/)).
- **Secrets und Egress.** API-Keys, die die Sandbox nie hält, und eine Allowlist, wohin sie sich verbinden darf: [Secrets und Egress](https://pethost.dev/de/docs/sandboxes/secrets-and-egress/).
- **SSH und Observability.** Einfaches `ssh`, `scp` und `ssh -L` ([SSH](https://pethost.dev/de/docs/sandboxes/ssh/)) und die Metriken, Events und der Verbrauch jeder Sandbox ([Observability](https://pethost.dev/de/docs/sandboxes/observability/)).

## Agent Sandboxes und App Platform

Pethost hat zwei Arten von Workspaces. **App Platform** ist die Maschine eines Tarifs für deine Docker-Compose-Apps, zu einem festen Preis im Monat: Die Doku dazu ist die [Doku zur App Platform](https://pethost.dev/docs/). Um **Agent Sandboxes** geht es auf diesen Seiten: MicroVMs, die dein Code oder dein Agent über eine API startet, nutzt und stoppt, sekundengenau abgerechnet. Jeder Workspace ist von einer Art, und ein Konto kann beide haben.

## Alle Seiten

### Einstieg

- [So funktionieren Pethost Agent Sandboxes](https://pethost.dev/de/docs/sandboxes/how-it-works/) Was eine Sandbox ist, ihre drei Zustände RUNNING, PAUSED und STOPPED, was sie weckt, die zwei APIs und wo RAM, Prozesse und Dateien liegen.
- [Schnellstart: deine erste Sandbox](https://pethost.dev/de/docs/sandboxes/quickstart/) Sandbox erstellen, Befehl ausführen, Datei schreiben, Port öffnen, aufräumen: mit Python, TypeScript, Go, Rust, der pethost-CLI oder deinem Agenten.
- [Einen Agenten über MCP mit Sandboxes verbinden](https://pethost.dev/de/docs/sandboxes/connect-an-agent/) Gib Claude Code, Codex, Cursor oder Claude Sandboxes als Tools: Füg den MCP-Server von Pethost Agent Sandboxes hinzu und melde dich bei einem Workspace an.

### Konzepte

- [Lebenszyklus einer Sandbox: Auto-Pause, Auto-Stopp und Leerlauf](https://pethost.dev/de/docs/sandboxes/lifecycle/) Wann eine Sandbox im Leerlauf pausiert, stoppt oder gelöscht wird: was als Aktivität zählt, die drei Timer, keep_awake, wake_when_stopped und Werte je Einsatz.
- [Preise und Abrechnung von Sandboxes: sekundengenau, je Zustand](https://pethost.dev/de/docs/sandboxes/billing/) Was eine Sandbox pro Sekunde kostet, wenn sie läuft, pausiert oder schläft, was ein Tarif enthält, kostenlose Starts und Limits, die Testphase und Beispiele.
- [Best Practices für Pethost Agent Sandboxes](https://pethost.dev/de/docs/sandboxes/best-practices/) Die wenigen Entscheidungen für schnelle Starts, weniger Kosten und Sicherheit: Vorlagen, Pausen, Batch-Jobs, keep_awake, request_id, Secrets und Egress.

### Aufgaben

- [Befehle ausführen und Dateien bearbeiten in einer Sandbox](https://pethost.dev/de/docs/sandboxes/commands-and-files/) Shell-Befehle in einer Sandbox ausführen und auf Ausgabe oder Port warten, lange streamen, Dateien durch exaktes Ersetzen bearbeiten, große über Links bewegen.
- [Ports und Vorschauen: die URLs einer Sandbox](https://pethost.dev/de/docs/sandboxes/ports-and-previews/) Gib jedem Port einer Sandbox eine HTTPS-Adresse, öffentlich oder hinter einem Token, warte auf einen Dev-Server und lass Vorschauen zwischen Besuchen schlafen.
- [Claude Code, Codex und OpenCode in einer Sandbox ausführen](https://pethost.dev/de/docs/sandboxes/coding-agents/) Gib Claude Code, Codex oder OpenCode in einer Sandbox mit einem Aufruf einen Prompt, streame seine Tool-Aufrufe und melde ihn an, ohne dass der Key hineinkommt.
- [Computer Use: Chrome auf einem Desktop in einer Sandbox](https://pethost.dev/de/docs/sandboxes/computer-use/) Klicken, tippen und einen Screenshot eines Desktops mit Chrome machen, in einem Aufruf für einen Computer-Use-Agenten, oder den Bildschirm live sehen.
- [Vorlagen: Sandboxes startklar starten](https://pethost.dev/de/docs/sandboxes/templates/) Speichere die Disk einer Sandbox als Vorlage, mit deinen Paketen und Docker-Images, und starte daraus neue Sandboxes auf jedem Server in etwa 0,2 s.
- [Secrets und Egress: Keys, die eine Sandbox nie hält](https://pethost.dev/de/docs/sandboxes/secrets-and-egress/) Gib einer Sandbox API-Keys, die sie nie hält, vom Egress-Proxy für die genannten Hosts eingesetzt, und begrenze mit einer Allowlist, wohin sie sich verbindet.
- [Eine Sandbox forken, RAM und Prozesse eingeschlossen](https://pethost.dev/de/docs/sandboxes/forks/) Kopier eine laufende Sandbox mit RAM, Prozessen und Disk in einem Aufruf in bis zu 100 Sandboxes, um vom selben Punkt aus mehreres gleichzeitig zu probieren.
- [Volumes: eine Disk, die Sandboxes überdauert](https://pethost.dev/de/docs/sandboxes/volumes/) Erstell ein Volume, mounte es an einem Pfad in Sandboxes, schreibend in eine oder lesend in viele, und erfahre, wo es liegt und was es kostet.
- [Per SSH in eine Sandbox: Shell, scp, SFTP und Tunnel](https://pethost.dev/de/docs/sandboxes/ssh/) Melde dich mit einfachem ssh bei jeder Sandbox an, kopier Dateien mit scp und SFTP, leite Ports mit ssh -L weiter, mit einem Key oder Token als Passwort.
- [Observability: Metriken, Events und Verbrauch einer Sandbox](https://pethost.dev/de/docs/sandboxes/observability/) Lies CPU, RAM, Disk und Netzwerk einer Sandbox, liste und streame Lebenszyklus, Befehle, Verbindungen, Port-Requests und Turns, und sieh, was sie gekostet hat.

### Referenz

- [Limits von Pethost Agent Sandboxes](https://pethost.dev/de/docs/sandboxes/limits/) Jede Grenze von Pethost Agent Sandboxes an einem Ort: Größen, Budgets der Tarife, Startlimits, Limits pro Sandbox und Aufruf, aufbewahrter Verlauf und Netzwerk.
- [Fehler der Sandboxes-API, und was zu tun ist](https://pethost.dev/de/docs/sandboxes/errors/) Jede Ablehnung der Sandboxes-API, ihr Code und ihr typisiertes Detail, was sie bedeutet und was dein Programm oder dein Agent als Nächstes tun sollte.

[WeiterSo funktionieren Pethost Agent Sandboxes](https://pethost.dev/de/docs/sandboxes/how-it-works/)

## Pethost Agent Sandboxes ausprobieren

Eine Testphase von 7 Tagen mit 1 $ Verbrauch und 4 vCPUs, mit Karte. Danach ein Tarif ab 20 $ im Monat, der genauso viel Verbrauch enthält.

[Testphase starten](https://console.pethost.dev/)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Vorlagen](https://pethost.dev/de/templates/)
- [Über uns](https://pethost.dev/about/)
- [Doku](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/de/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [AGB](https://pethost.dev/terms/)
- [Datenschutz](https://pethost.dev/privacy/)
- [Erstattung](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Datenbanken

- [Postgres](https://pethost.dev/de/postgres/)
- [Valkey](https://pethost.dev/de/valkey/)

Agent Sandboxes

- [Sandboxes](https://pethost.dev/de/sandboxes/)
- [Preise](https://pethost.dev/de/sandboxes/#pricing)
- [Doku](https://pethost.dev/de/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Vergleiche

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/de/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/de/blog/coolify-cloud-vs-dokploy-cloud/)
- [Railway vs Render vs Fly.io Preise](https://pethost.dev/de/blog/railway-vs-render-vs-fly-io-pricing/)
- [Managed Hosting für Docker Compose](https://pethost.dev/de/blog/managed-docker-compose-hosting/)

Alternativen

- [Railway-Alternativen](https://pethost.dev/de/blog/railway-alternatives/)
- [Heroku-Alternativen](https://pethost.dev/de/blog/heroku-alternatives/)
- [Dokploy-Alternativen](https://pethost.dev/de/blog/dokploy-alternatives/)
- [Coolify-Alternativen](https://pethost.dev/de/blog/coolify-alternatives/)
- [Render-Alternativen](https://pethost.dev/de/blog/render-alternatives/)
- [Sliplane-Alternativen](https://pethost.dev/de/blog/sliplane-alternatives/)
