Skip to content
KitploitKITPLOIT
OutilsExploitsBlog
Log in
Soumettre
OutilsExploitsBlog
Soumettre

Outils de Hacking, PenTest et Cybersécurité pour votre Arsenal de Sécurité !

Kitploit est un répertoire d'outils de hacking, de cybersécurité et de pentesting. Découvrez les dernières mises à jour des projets pour trouver des vulnérabilités, analyser des systèmes, automatiser les tests et renforcer votre sécurité.

FluxContactConfidentialité© 2026 Kitploit

Répertoire d'outils

Catégories

Voir toutes les catégories
Loading categories
coderunner — Un bac à sable local pour vos agents IA | Kitploit
Outils/GitHubGitHub/instavm/coderunner
Sécurité des ConteneursAnalyse Dynamique (Sandboxing)Virtualisation de SécuritéDevSecOpsSécurité de l'IA
GitHubinstavm/coderunner

coderunner

Un bac à sable local pour vos agents IA

Voir le dépôt
8824149il y a 10 joursVérifié par Kitploit
Partager
Site web

Start License

CodeRunner : 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

Démarrage rapide

Prérequis : Mac avec macOS et Apple Silicon (M1/M2/M3/M4), Python 3.10+

Identifiants

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êter et reprendre

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

Limites de ressources et montages d'espace de travail

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.

Désactiver l'accès réseau sortant

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.

Avec Claude Code

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.

Exécuter Claude Code dans un bac à sable

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

image

Autres options d'intégration

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

1. Intégration de Claude Desktop

Configurer Claude Desktop pour utiliser CodeRunner comme serveur MCP :

demo1

demo2

demo4

  1. Copiez la configuration d'exemple :

    cd examples
    cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
    
  2. Modifiez le fichier de configuration et remplacez les chemins d'espace réservé :

    • Remplacez /path/to/your/python par $HOME/.coderunner/venv/bin/python en utilisant le chemin complet vers votre répertoire personnel
    • Remplacez /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"]
        }
      }
    }
    
  3. Mettre à jour la configuration de Claude Desktop :

    • Ouvrir Claude Desktop
    • Aller dans Settings → Developer
    • Ajouter la configuration du serveur MCP
    • Redémarrer Claude Desktop
  4. 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.

2. Claude Code CLI

Utiliser CodeRunner avec Claude Code CLI pour une assistance IA en terminal :

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 :

  1. Accédez au Marketplace de plugins :
Télécharger l’outil

Populaires

Voir tout →

Découvrez les outils les plus utilisés par notre communauté.

Pas encore de données de popularité.

Explorer tous les outils

Parcourez notre collection d'outils

Voir tous les outils →