---
title: "Documentation de Pethost Agent Sandboxes"
description: "Comment marchent Pethost Agent Sandboxes et ce qu’elles coûtent : des microVM Firecracker pour du code, des agents de code et un navigateur."
---

# Documentation de Pethost Agent Sandboxes

Mis à jour le 22 novembre 2026 · 3 min de lecture

Une sandbox est une microVM Linux pour du code, des agents de code et un bureau avec Chrome : une VM Firecracker avec son propre noyau, et vous y êtes root. Elle démarre depuis un template en 0,15 s environ, se met en pause avec sa mémoire et ses processus quand il ne s’y passe rien, se réveille au prochain appel en 0,1 s environ, et s’arrête vers le stockage objet quand elle reste inactive plus longtemps. Vous payez à la seconde ce que garde chaque état.

**RUNNING**

Dans la mémoire de son serveur

Fait tourner vos processus et répond à chaque appel.

0,018 $ de l’heure, SMALL

Inactive 5 min : elle se met en pause

Le prochain appel la réveille

**PAUSED**

Sur le disque de son serveur

Garde mémoire, processus et disque.

0,0054 $ de l’heure, SMALL

Inactive 30 min : elle s’arrête

**STOPPED**

En stockage objet

Garde son disque ; ses processus prennent fin.

0,03 $ par GiB et par mois

ResumeSandbox la redémarre, ses fichiers tels qu’elle les a laissés

Le cycle de vie par défaut. Chaque délai se modifie ou se désactive, et une sandbox n’est jamais supprimée sans que vous le demandiez : [cycle de vie et inactivité](https://pethost.dev/fr/docs/sandboxes/lifecycle/).

## Par où commencer

[**Écrire du code** Le démarrage rapide : une sandbox, une commande, un fichier et une URL publique depuis Python, TypeScript, Go ou Rust, ou depuis la CLI pethost.](https://pethost.dev/fr/docs/sandboxes/quickstart/) [**La confier à votre agent** Ajoutez le serveur MCP à Claude, Codex, Cursor ou un autre client MCP, et l’agent crée et utilise lui-même des sandboxes.](https://pethost.dev/fr/docs/sandboxes/connect-an-agent/) [**Comprendre d’abord** Les trois états, ce qui réveille une sandbox, et où vit chacun de ses octets.](https://pethost.dev/fr/docs/sandboxes/how-it-works/)

## En chiffres

- **0,15 s** pour démarrer une sandbox, mesuré via une console à 16 ms de son serveur
- **0,1 s** pour réveiller une sandbox en pause, à son prochain appel
- **0,018 $** de l’heure pour 2 vCPU et 4 GiB, à la seconde
- **30 %** de ce prix tant qu’elle est en pause

## Ce que fait une sandbox

- **Commandes, fichiers et terminal.** Lancez une commande et attendez son port, modifiez un fichier par remplacement exact, suivez la sortie en direct, ou ouvrez un terminal dans un navigateur : [commandes et fichiers](https://pethost.dev/fr/docs/sandboxes/commands-and-files/).
- **Ports.** N’importe quel port à `https://<port>-<id>.<server>`, public ou derrière un token : [ports et prévisualisations](https://pethost.dev/fr/docs/sandboxes/ports-and-previews/).
- **Agents de code.** Claude Code, Codex et OpenCode sont installés. Un appel donne un prompt à un agent, un autre diffuse chacun de ses appels d’outils : [agents de code](https://pethost.dev/fr/docs/sandboxes/coding-agents/).
- **Un bureau.** Chrome sur un écran 1280×800, qui démarre à sa première utilisation : cliquer, taper et prendre une capture d’écran en un appel, ou suivre en direct : [computer use](https://pethost.dev/fr/docs/sandboxes/computer-use/).
- **Templates, duplications et volumes.** Enregistrez le disque d’une sandbox et démarrez-en de nouvelles à partir de lui ([templates](https://pethost.dev/fr/docs/sandboxes/templates/)) ; copiez une sandbox active, mémoire comprise, en 100 copies au plus ([duplications](https://pethost.dev/fr/docs/sandboxes/forks/)) ; gardez des données sur un disque hors de toute sandbox, sur un serveur ([volumes](https://pethost.dev/fr/docs/sandboxes/volumes/)).
- **Secrets et trafic sortant.** Des clés d’API que la sandbox ne détient jamais, et une liste d’autorisation des destinations où elle peut se connecter : [secrets et trafic sortant](https://pethost.dev/fr/docs/sandboxes/secrets-and-egress/).
- **SSH et observabilité.** `ssh`, `scp` et `ssh -L` standard ([SSH](https://pethost.dev/fr/docs/sandboxes/ssh/)), et les métriques, les événements et la consommation de chaque sandbox ([observabilité](https://pethost.dev/fr/docs/sandboxes/observability/)).

## Agent Sandboxes et App Platform

Pethost a deux sortes d’espaces de travail. **App Platform** est la machine d’une offre pour vos applications Docker Compose, à prix fixe chaque mois : sa documentation est celle d’[App Platform](https://pethost.dev/docs/). **Agent Sandboxes** est le sujet de ces pages : des microVM que votre code ou votre agent démarre, utilise et arrête par une API, facturées à la seconde. Chaque espace de travail est d’une seule sorte, et un même compte peut avoir les deux.

## Toutes les pages

### Premiers pas

- [Comment marchent Pethost Agent Sandboxes](https://pethost.dev/fr/docs/sandboxes/how-it-works/) Ce qu’est une sandbox, ses trois états RUNNING, PAUSED et STOPPED, ce qui la réveille, les deux API, et où vivent sa mémoire, ses processus et ses fichiers.
- [Démarrage rapide : votre première sandbox](https://pethost.dev/fr/docs/sandboxes/quickstart/) Créez une sandbox, lancez une commande, écrivez un fichier, ouvrez un port et supprimez-la : en Python, TypeScript, Go, Rust, avec la CLI pethost ou un agent.
- [Connecter un agent aux sandboxes par MCP](https://pethost.dev/fr/docs/sandboxes/connect-an-agent/) Donnez des sandboxes comme outils à Claude Code, Codex, Cursor ou Claude : ajoutez le serveur MCP de Pethost Agent Sandboxes et connectez un espace de travail.

### Notions

- [Cycle de vie d’une sandbox : pause, arrêt et inactivité](https://pethost.dev/fr/docs/sandboxes/lifecycle/) Quand une sandbox inactive se met en pause, s’arrête ou est supprimée : ce qui compte comme activité, les trois délais, keep_awake et wake_when_stopped.
- [Prix et facturation des sandboxes : à la seconde, selon l’état](https://pethost.dev/fr/docs/sandboxes/billing/) Ce que coûte une sandbox à chaque seconde active, en pause ou arrêtée, ce qu’inclut une offre, les démarrages gratuits, l’essai et des exemples chiffrés.
- [Bonnes pratiques pour Pethost Agent Sandboxes](https://pethost.dev/fr/docs/sandboxes/best-practices/) Les quelques choix qui font démarrer vite les sandboxes, baissent leur coût et les gardent sûres : templates, pause, lots, keep_awake, request_id, secrets.

### Tâches

- [Lancer des commandes et modifier des fichiers dans une sandbox](https://pethost.dev/fr/docs/sandboxes/commands-and-files/) Lancez des commandes shell dans une sandbox et attendez leur sortie ou leur port, suivez les longues, modifiez des fichiers et déplacez les gros par des liens.
- [Ports et prévisualisations : les URL d’une sandbox](https://pethost.dev/fr/docs/sandboxes/ports-and-previews/) Donnez à tout port d’une sandbox une adresse HTTPS, publique ou derrière un token, attendez qu’un serveur écoute, et lancez des prévisualisations qui dorment.
- [Faire tourner Claude Code, Codex et OpenCode dans une sandbox](https://pethost.dev/fr/docs/sandboxes/coding-agents/) Donnez un prompt à Claude Code, Codex ou OpenCode dans une sandbox en un appel, suivez ses appels d’outils et connectez-le sans y faire entrer sa clé.
- [Computer use : Chrome sur un bureau dans une sandbox](https://pethost.dev/fr/docs/sandboxes/computer-use/) Cliquez, tapez et capturez l’écran d’un bureau avec Chrome en un appel, pour un agent de computer use, ou suivez l’écran de la sandbox en direct.
- [Templates : des sandboxes prêtes à travailler dès le démarrage](https://pethost.dev/fr/docs/sandboxes/templates/) Enregistrez le disque d’une sandbox comme template, avec vos paquets et vos images Docker, et démarrez-en de nouvelles sur tout serveur en 0,2 s environ.
- [Secrets et trafic sortant : des clés qu’une sandbox ne détient jamais](https://pethost.dev/fr/docs/sandboxes/secrets-and-egress/) Donnez à une sandbox des clés d’API qu’elle ne détient jamais, insérées par le proxy de sortie pour vos hôtes, et limitez où elle se connecte par une liste.
- [Dupliquer une sandbox (fork), mémoire et processus compris](https://pethost.dev/fr/docs/sandboxes/forks/) Copiez une sandbox active, avec sa mémoire, ses processus et son disque, dans 100 sandboxes au plus en un appel, pour tenter plusieurs pistes du même point.
- [Volumes : un disque qui survit aux sandboxes](https://pethost.dev/fr/docs/sandboxes/volumes/) Créez un volume, montez-le dans des sandboxes, en lecture-écriture par une ou en lecture seule par plusieurs, et sachez où il vit et ce qu’il coûte.
- [SSH dans une sandbox : shell, scp, SFTP et tunnels](https://pethost.dev/fr/docs/sandboxes/ssh/) Connectez-vous à toute sandbox en ssh standard, copiez avec scp et SFTP, redirigez ses ports avec ssh -L, par clé ou avec un token comme mot de passe.
- [Observabilité : métriques, événements et consommation d’une sandbox](https://pethost.dev/fr/docs/sandboxes/observability/) Lisez CPU, mémoire, disque et réseau d’une sandbox, suivez son cycle de vie, ses commandes, connexions, requêtes et tours d’agents, et voyez son coût.

### Référence

- [Limites de Pethost Agent Sandboxes](https://pethost.dev/fr/docs/sandboxes/limits/) Toutes les limites de Pethost Agent Sandboxes au même endroit : tailles, budgets des offres, démarrages, limites par sandbox et par appel, historique et réseau.
- [Erreurs de l’API des sandboxes, et que faire](https://pethost.dev/fr/docs/sandboxes/errors/) Chaque refus de l’API des sandboxes, son code et son détail typé, ce qu’il veut dire et ce que votre programme ou votre agent doit faire ensuite.

[SuivantComment marchent Pethost Agent Sandboxes](https://pethost.dev/fr/docs/sandboxes/how-it-works/)

## Essayez Pethost Agent Sandboxes

Un essai gratuit de 7 jours avec 1 $ de consommation et 4 vCPU, avec une carte. Ensuite, une offre dès 20 $ par mois, qui inclut autant de consommation.

[Démarrer l’essai gratuit](https://console.pethost.dev/)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/fr/templates/)
- [À propos](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/fr/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Conditions](https://pethost.dev/terms/)
- [Confidentialité](https://pethost.dev/privacy/)
- [Remboursements](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bases de données

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/fr/sandboxes/)
- [Tarifs](https://pethost.dev/fr/sandboxes/#pricing)
- [Docs](https://pethost.dev/fr/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparatifs

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/fr/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/fr/blog/coolify-cloud-vs-dokploy-cloud/)
- [Tarifs Railway vs Render vs Fly.io](https://pethost.dev/fr/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hébergement Docker Compose managé](https://pethost.dev/fr/blog/managed-docker-compose-hosting/)

Alternatives

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