Trois agents de code, installés
Notre template base contient Claude Code, Codex et OpenCode installés avec leurs SDK officiels, et leurs CLI dans le PATH : claude, codex, opencode. Chacun tourne sans demander de permission : Claude Code en mode bypassPermissions, Codex avec un accès complet et sans approbations, OpenCode avec toutes les permissions accordées et son outil de questions désactivé, puisque personne n’y répondrait. La frontière, c’est la sandbox : une microVM Firecracker avec son propre noyau, où l’agent est root et atteint ce que votre liste d’autorisation du trafic sortant lui permet.
Un appel par prompt
prompt_agent donne un prompt à un agent, dans une nouvelle conversation ou dans celle que vous nommez, avec un modèle et un dossier de travail si vous le souhaitez, et attend le tour jusqu’à 45 secondes. Une conversation exécute un tour à la fois : les prompts suivants sont mis en file. Un tour renvoie son état (QUEUED, RUNNING, DONE, FAILED, STOPPED ou LOST), le dernier message de l’agent jusqu’à 16 KiB, et les tokens qu’il a lus et écrits. get_agent_turn attend un tour plus long, et stop_agent_turn en arrête un.
watch_conversation diffuse ce que fait l’agent, sous la même forme pour les trois agents : chaque prompt, chaque message qu’il écrit, chaque appel d’outil avec son entrée en JSON, chaque résultat, et la fin de chaque tour. Quand un tour se termine, l’agent s’arrête avec lui, mais ce qu’il a lancé en arrière-plan continue : un serveur de développement qu’il a démarré est toujours là, à ouvrir à son URL de prévisualisation.
import os
from pethost.sandboxes import EnvVar, Environment, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # lit PETHOST_TOKEN
key = os.environ["ANTHROPIC_API_KEY"]
sandboxes.set_secret("anthropic", value=key, hosts=["api.anthropic.com"])
env = Environment(variables=[EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic")])
box = sandboxes.create_sandbox(settings=SandboxSettings(environment=env))
prompt = "Write fizzbuzz.py with a test and run it"
turn = sandboxes.prompt_agent(box.sandbox_id, prompt=prompt, wait_seconds=0)
conversation = turn.conversation_id
for event in sandboxes.watch_conversation(box.sandbox_id, conversation_id=conversation):
if event.tool_call:
print("›", event.tool_call.name, event.tool_call.input[:60])
elif event.turn_end:
print(event.turn_end.state.name, event.turn_end.reply)
breakpethost sandbox secret set anthropic --host api.anthropic.com < key.txt
pethost sandbox new --name fizzbuzz --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox agent fizzbuzz "Write fizzbuzz.py with a test and run it"
pethost sandbox agent fizzbuzz --agent opencode "Explain fizzbuzz.py"Se connecter sans la clé à l’intérieur
Gardez votre clé d’API comme secret de l’espace de travail et liez-la à ANTHROPIC_API_KEY ou OPENAI_API_KEY. La variable dans la sandbox contient un marqueur, et le proxy de sortie, hors de la VM, met la vraie clé dans les en-têtes des requêtes, seulement vers les hôtes que le secret nomme, comme api.anthropic.com. Un programme qui affiche son environnement voit le marqueur. Comment marchent les secrets que la sandbox ne détient jamais.
Ou bien une personne se connecte une fois dans le terminal de la sandbox, avec claude auth login ou codex login --device-auth. OpenCode n’a besoin d’aucune connexion : sans clé de fournisseur, il utilise les modèles gratuits d’OpenCode. Un prompt à un agent qui ne peut pas joindre son modèle est refusé avec la variable à définir et la commande de connexion, pour que votre code puisse dire ce qui manque.
La conversation reste avec la sandbox
L’historique d’une conversation est sur le disque de la sandbox. Une pause le garde avec les fichiers et les processus de l’agent, et le prompt suivant le reprend. Une duplication l’emporte : copiez une sandbox entre deux tours en dix exemplaires, et envoyez à la conversation de chaque copie son prochain prompt dans une autre direction. Un template ne garde aucune conversation : une sandbox qui en part commence sans.
Pour regarder un agent travailler, suivez sa conversation en direct, ou ouvrez la page de la sandbox dans la console web, dont l’onglet Agents montre ses conversations.
Limites et prix
Un tour à la fois par conversation. L’agent tourne sur les vCPU et la mémoire de la sandbox, facturés à la seconde au prix de sa taille, 0,018 $ de l’heure pour SMALL (2 vCPU, 4 GiB) et 0,036 $ pour DEFAULT (4 vCPU, 8 GiB). Un tour en cours garde la sandbox éveillée ; entre les tours, après 5 minutes d’inactivité, elle se met en pause à 30 % de ce prix. Les tokens du modèle sont sur la facture de votre fournisseur, pas sur la nôtre.
Face aux autres
Le 21 novembre 2026, le proxy de boat.dev qui tient les clés d’IA hors de ses sandboxes coûtait 1 $ par jour d’activation, plus 1 $ pour 1 000 requêtes. Chez Pethost, la substitution fait partie de chaque sandbox, pour toute clé et tout hôte HTTPS que vous nommez, sans prix à part.