---
title: "Claude Code, Codex et OpenCode dans une sandbox · Pethost"
description: "Claude Code, Codex et OpenCode sont installés dans chaque sandbox : un appel donne un prompt, un autre diffuse chaque appel d’outil. Les clés restent dehors."
---

[Agent Sandboxes](https://pethost.dev/fr/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.

Un prompt à un agent de code dans une sandbox, et ses appels d’outils qui reviennent en direct : il lit un fichier, le modifie, lance les tests, et le tour se termine avec son nombre de tokens.

## 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](https://pethost.dev/fr/sandboxes/preview-urls/).

Python

CLI

```
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](https://pethost.dev/fr/sandboxes/secrets/).

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](https://pethost.dev/fr/sandboxes/pause-resume/) 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](https://pethost.dev/fr/docs/sandboxes/coding-agents/)

## 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](https://pethost.dev/fr/sandboxes/fork/). 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

- [Dans la sandbox, la clé d’API est un marqueur ; le proxy de sortie met la vraie clé dans la requête vers api.anthropic.com, et une requête vers un autre hôte garde le marqueur. Des clés qui n’entrent jamais Une sandbox voit un marqueur ; le proxy de sortie le remplace par la vraie clé d’API dans les en-têtes des requêtes HTTPS, seulement pour les hôtes que vous nommez. Comment ça marche](https://pethost.dev/fr/sandboxes/secrets/)
- [Une sandbox active, à l’étape 41 d’une tâche, est dupliquée en trois copies en 0,25 s ; chacune poursuit seule depuis l’étape 41. Duplication, mémoire comprise Copiez une sandbox active, sa mémoire, ses processus et son disque, dans de nouvelles sandboxes en un appel. Trois copies prennent environ un quart de seconde. Comment ça marche](https://pethost.dev/fr/sandboxes/fork/)

## Donnez un ordinateur à votre agent en 0,15 s

[Démarrer l’essai gratuit](https://console.pethost.dev/welcome?kind=sandboxes)

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/)
