Sandboxes pour agents IA : démarrage rapide
Une commande suffit pour obtenir une machine virtuelle Linux prête à coder, sans compte ni carte bancaire :
ssh yorkhost.sh
Vous arrivez directement dans un shell Ubuntu 24.04 où les agents de code sont déjà installés (Claude Code, OpenAI Codex, OpenCode, Cursor CLI, Gemini CLI). Votre application web est accessible en HTTPS sur une adresse de preview, et si le résultat vous plaît, la sandbox peut devenir un VPS classique.
Ce qu'il vous faut
Un client SSH (inclus dans Windows 10/11, macOS et Linux) et une clé SSH : c'est elle qui vous identifie, il n'y a ni compte ni mot de passe.
Si vous n'avez pas encore de clé, créez-en une :
ssh-keygen -t ed25519
Validez les questions (Entrée), puis relancez ssh yorkhost.sh. Sans clé, la connexion affiche :
YorkHost sandboxes identify you by your SSH key.
Create one with: ssh-keygen -t ed25519
then run again: ssh yorkhost.sh
Types de clés acceptés : ssh-ed25519, ECDSA, et RSA de 2048 bits minimum.
La sandbox est liée à l'empreinte de votre clé. Pour la retrouver, gérer ou supprimer, reconnectez-vous avec la même clé (même ordinateur, ou ssh -i ~/.ssh/ma_cle yorkhost.sh).
Première connexion
Lors de la toute première connexion, SSH vous demande d'accepter l'empreinte de yorkhost.sh : tapez yes. La sandbox est ensuite prête en quelques secondes (jusqu'à une minute si aucune machine n'est préparée à l'avance). Un message récapitule tout ce qu'il faut savoir :
✅ YorkHost sandbox sbxabcd2345efgh ready — linux (trial, no public IP)
Preview: https://sbxabcd2345efgh-8080.yorkhost.sh (any port: https://sbxabcd2345efgh-<port>.yorkhost.sh)
Keep it as a VPS: https://api.yorkhost.fr/sandbox/claim#yhsc_…
Runs until 14:32 UTC; deleted with its files at 2026-09-28 13:32 UTC unless kept.
Reconnect: ssh sbxabcd2345efgh@yorkhost.sh · JSON: ssh status@yorkhost.sh
Agents installed: claude, codex, opencode, cursor-agent, gemini. Work in /home/agent: it moves with you to the VPS.
| Ligne | Signification |
|---|---|
| Preview | Adresse HTTPS publique de votre application (port 8080 par défaut, autres ports possibles). Voir Previews HTTPS. |
| Keep it as a VPS | Lien pour conserver la sandbox en la transformant en VPS. Notez-le : il n'est affiché qu'une fois (vous pouvez en générer un nouveau avec ssh claim@yorkhost.sh). |
| Runs until | Heure d'arrêt de la sandbox (60 minutes après sa création). Les heures sont en UTC. |
| deleted … at | Heure de suppression définitive de la VM et de ses fichiers (24 h après la création), sauf passage en VPS. |
| Reconnect | Commande pour revenir dans cette sandbox précise. |
Pour noter l'identifiant et les échéances plus tard, utilisez ssh status@yorkhost.sh (voir Commandes SSH).
Ce qui est installé
La sandbox tourne sous Ubuntu 24.04, avec l'utilisateur agent (sudo sans mot de passe, membre du groupe docker) :
| Catégorie | Outils |
|---|---|
| Agents IA | claude (Claude Code), codex (OpenAI Codex), opencode, cursor-agent (Cursor CLI), gemini (Gemini CLI) |
| Langages | Node.js 22 LTS avec npm et pnpm, Python 3 avec pip, venv et pipx, build-essential (gcc, make…) |
| Conteneurs | Docker et Docker Compose (v2) |
| Git | git, GitHub CLI (gh) |
| Bases de données | clients sqlite3, psql (PostgreSQL) et mysql |
| Utilitaires | curl, wget, jq, ripgrep, fd-find, tmux, htop, zip, unzip |
Vous pouvez installer d'autres paquets avec sudo apt install …, npm, pip, etc.
Si vous gardez la sandbox en VPS, seul le dossier /home/agent est copié sur le VPS. Ce qui est installé ou stocké ailleurs (paquets système, images et conteneurs Docker…) n'est pas repris. Le VPS part toutefois de la même image, avec les mêmes outils préinstallés.
Combien de temps ça dure ?
| Étape | Quand | Ce qui se passe |
|---|---|---|
| Essai en cours | 60 minutes après la création | La sandbox fonctionne, gratuitement. |
| Sandbox arrêtée | de 60 minutes à 24 h | La VM est éteinte, ses fichiers sont conservés. Elle ne redémarre pas : il reste seulement à la garder en VPS ou à la supprimer. |
| Suppression | 24 h après la création | La VM et tous ses fichiers sont effacés définitivement. |
La durée de 60 minutes court depuis la création, que vous soyez connecté ou non : fermer votre terminal ne met pas la sandbox en pause.
Pour les quotas, les ports sortants autorisés et les usages interdits, consultez Limites et sécurité.
Types de sandbox
Seule la sandbox Linux (terminal SSH, agents préinstallés) est ouverte pour le moment. Des sandboxes avec bureau graphique dans le navigateur (Linux et Windows) arriveront bientôt.
Et ensuite ?
- Commandes SSH : se reconnecter, lancer une commande, transférer des fichiers, ouvrir un tunnel.
- Utiliser un agent IA dans la sandbox ou depuis votre machine.
- Garder la sandbox en VPS.
- API et MCP pour créer des sandboxes depuis un script ou un assistant IA relié à votre compte.
- FAQ et dépannage.