
Un bac à sable local pour vos agents IA
CodeRunner vous aide à isoler vos agents IA et leurs actions dans un bac à sable.
Cas d'usage principal : exécuter le code d'un agent IA dans un bac à sable avec des montages d'hôte et un accès réseau explicitement choisis. L'isolation réduit les risques ; elle ne prévient pas toute perte ou exfiltration de données.
Pour les VM cloud managées destinées aux agents, nous avons lancé - InstaVM - Instant computers for AI agents
Prérequis : Mac avec macOS et Apple Silicon (M1/M2/M3/M4), Python 3.10+
L'installateur génère le jeton du bac à sable dans ~/.coderunner/api-token (ou enregistre
le CODERUNNER_API_TOKEN que vous avez exporté). Les clients l'envoient sous la forme
Authorization: Bearer <token> ; cat ~/.coderunner/api-token l'affiche. Seul
GET /health est public, et un jeton absent ou faible échoue par défaut (fail closed). Le proxy Claude
Desktop et les exemples lisent le jeton depuis ce fichier lorsque la variable
n'est pas définie. Voir authentification et frontières réseau.
git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh
Arrêtez le bac à sable lorsque vous avez terminé :
container stop coderunner
Reprenez le même bac à sable plus tard, en préservant son système de fichiers. L'état du noyau Python est volatil et ne survit pas à un redémarrage de la VM ou du serveur :
container start coderunner
Pour repartir de zéro avec un bac à sable propre, supprimez le conteneur et relancez l'installateur :
container delete coderunner && ./install.sh
Les limites de CPU et de mémoire peuvent être définies via les options de l'installateur ou les variables d'environnement CODERUNNER_CPUS et CODERUNNER_MEMORY :
./install.sh --cpus 4 --memory 8g
Les répertoires hôtes supplémentaires doivent être montés sous /workspace. Ils sont en lecture seule par défaut ; ajoutez :rw uniquement lorsque le bac à sable doit écrire sur l'hôte :
./install.sh \
--mount "$HOME/projects/api:/workspace/api" \
--mount "$HOME/projects/output:/workspace/output:rw"
Les montages supplémentaires sont par défaut à aucun. Les paramètres de ressources et de montages sont fixés lors de la création du conteneur ; supprimez le conteneur avant de les modifier.
Par défaut, le code exécuté dans le bac à sable dispose d'un accès réseau illimité. Pour l'exécuter sur un réseau hôte uniquement, sans accès à Internet :
CODERUNNER_NETWORK=none ./install.sh
Dans ce mode, le serveur MCP est disponible à l'adresse http://127.0.0.1:8222/mcp. Ce paramètre est fixé lors de la création du conteneur ; l'installateur refuse de reprendre un conteneur avec un mode réseau différent.
Claude Code exécute des commandes sur votre machine, en votre nom, les invites de permission étant la seule limite. Le fait de le pointer vers les outils de CodeRunner exécute plutôt le code qu'il écrit dans la VM : il ne peut accéder qu'aux dossiers que vous avez montés sous /workspace, au réseau que vous avez autorisé et au système de fichiers propre au bac à sable, quoi qu'on lui ait demandé de faire. Utilisez le bac à sable pour le code qui traite des entrées non fiables ou que vous n'exécuteriez pas à la main, et pour plusieurs agents qui ne doivent pas partager d'état (sessions nommées). Il ne protège rien de ce que vous montez en lecture-écriture.
./install.sh (si ce n'est pas déjà fait)
container exec -it coderunner /bin/bash
root@coderunner:/app# npm install -g @anthropic-ai/claude-code
Le serveur MCP sera disponible à l'adresse : http://coderunner.local:8222/mcp
L'installateur crée ~/.coderunner/venv pour le proxy Claude Desktop. Pour les autres exemples Python, installez leurs dépendances dans votre propre environnement virtuel :
pip install -r examples/requirements.txt



Copiez la configuration d'exemple :
cd examples
cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
Modifiez le fichier de configuration et remplacez les chemins d'espace réservé :
/path/to/your/python par $HOME/.coderunner/venv/bin/python en utilisant le chemin complet vers votre répertoire personnel/path/to/coderunner par le chemin réel vers votre dépôt clonéExemple après modification :
{
"mcpServers": {
"coderunner": {
"command": "/Users/yourname/.coderunner/venv/bin/python",
"args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
}
}
}
Mettre à jour la configuration de Claude Desktop :
Commencer à utiliser CodeRunner dans Claude : Le code que Claude écrit s'exécute désormais dans le sandbox.
Si l'outil apparaît comme « Disabled » dans le menu des outils du chat bien que le serveur soit indiqué comme en cours d'exécution : quitter entièrement Claude
Desktop (Cmd-Q) et le rouvrir, vérifier que command correspond au python du venv affiché par l'installateur (il
contient fastmcp), et consulter ~/Library/Logs/Claude/mcp-server-coderunner.log pour l'erreur du proxy. Le proxy
nécessite que le sandbox soit en cours d'exécution (container list) et le fichier de jeton ~/.coderunner/api-token.
Démarrage rapide :
# 1. Install and start CodeRunner (one-time setup; run as yourself, it asks for sudo when it needs it)
git clone https://github.com/instavm/coderunner.git
cd coderunner
./install.sh
# 2. Add the sandbox with its token (the installer prints this command)
claude mcp add --transport http coderunner http://coderunner.local:8222/mcp \
--header "Authorization: Bearer $(cat ~/.coderunner/api-token)"
# 3. Reconnect to MCP servers
/mcp
Le plugin Claude Code (claude plugin marketplace add https://github.com/instavm/coderunner-plugin) est antérieur au
jeton et renvoie une erreur 401 tant qu'il n'envoie pas le même en-tête ; utilisez la commande ci-dessus jusqu'à ce que le plugin soit mis à jour.
Étapes d'installation :