Français
Commencer

Agent Sandboxes Agents de code installés

Des agents de code dans le cloud : Claude Code, Codex et OpenCode

Faites tourner Claude Code, Codex ou OpenCode dans le cloud en pleine autonomie, chacun dans une VM faite pour la tâche : l’agent peut tout y faire, et il n’a aucune de vos clés.

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)
        break
pethost 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.

Lire la documentation

Questions

Faut-il une clé d’API pour faire tourner Claude Code dans une sandbox ?

Pour Claude Code et Codex, il faut soit une clé liée comme secret, soit la connexion d’une personne dans le terminal. Claude Code se connecte aussi avec CLAUDE_CODE_OAUTH_TOKEN, Bedrock ou Vertex. OpenCode tourne sans clé, sur ses propres modèles gratuits.

Ma clé entre-t-elle dans la sandbox ?

Pas quand c’est un secret : l’agent et tous les processus voient un marqueur, et la clé est ajoutée aux requêtes hors de la VM. Une connexion faite dans le terminal est stockée dans la sandbox, comme sur votre ordinateur.

Puis-je créer une branche d’une conversation ?

Oui : dupliquez la sandbox. Chaque copie emporte la conversation, et un prompt avec son ID repart de là dans cette copie seulement.

Puis-je regarder l’agent travailler ?

Oui : suivez sa conversation avec watch_conversation, ou ouvrez la sandbox dans la console web. Un lien de terminal qui lance claude vous donne votre propre session à côté.

Voir aussi

Donnez un ordinateur à votre agent en 0,15 s

Démarrer l’essai gratuit