
Un sandbox locale per i tuoi agenti AI
CodeRunner ti aiuta a isolare in un sandbox i tuoi agenti AI e le loro azioni.
Caso d'uso principale: eseguire il codice degli agenti AI in un sandbox con mount dell'host e accesso alla rete scelti esplicitamente. L'isolamento riduce il rischio; non impedisce ogni perdita o esfiltrazione di dati.
Per VM gestite nel cloud per gli agenti, abbiamo lanciato - InstaVM - Instant computers for AI agents
Prerequisiti: Mac con macOS e Apple Silicon (M1/M2/M3/M4), Python 3.10+
L'installer genera il token del sandbox in ~/.coderunner/api-token (oppure salva
il CODERUNNER_API_TOKEN che hai esportato). I client lo inviano come
Authorization: Bearer <token>; cat ~/.coderunner/api-token lo stampa. Solo
GET /health è pubblico, e un token mancante o debole causa un fallimento chiuso. Il proxy di Claude
Desktop e gli esempi leggono il token da quel file quando la variabile
non è impostata. Vedi autenticazione e confini di rete.
git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh
Arresta la sandbox quando hai finito:
container stop coderunner
Riprendi la stessa sandbox in un secondo momento, preservandone il filesystem. Lo stato del kernel Python è volatile e non sopravvive a un riavvio della VM o del server:
container start coderunner
Per ricominciare da zero con una sandbox pulita, eliminare il container ed eseguire nuovamente l'installer:
container delete coderunner && ./install.sh
I limiti di CPU e memoria possono essere impostati con le opzioni dell'installer o con le variabili d'ambiente CODERUNNER_CPUS e CODERUNNER_MEMORY:
./install.sh --cpus 4 --memory 8g
Ulteriori directory host devono essere montate sotto /workspace. Sono di sola lettura per impostazione predefinita; aggiungere :rw solo quando la sandbox deve scrivere sull'host:
./install.sh \
--mount "$HOME/projects/api:/workspace/api" \
--mount "$HOME/projects/output:/workspace/output:rw"
I mount aggiuntivi predefiniti sono nessuno. Le impostazioni delle risorse e dei mount sono fisse al momento della creazione del container; eliminare il container prima di modificarle.
Per impostazione predefinita, il codice in esecuzione nella sandbox ha accesso di rete senza restrizioni. Per eseguirlo su una rete host-only senza accesso a Internet:
CODERUNNER_NETWORK=none ./install.sh
In questa modalità, il server MCP è disponibile all'indirizzo http://127.0.0.1:8222/mcp. L'impostazione è fissa al momento della creazione del container; l'installer rifiuta di riprendere un container con una modalità di rete diversa.
Claude Code esegue comandi sulla tua macchina, come te, con i prompt di autorizzazione come unico confine. Indirizzandolo invece verso gli strumenti di CodeRunner, il codice che scrive viene eseguito nella VM: può accedere solo alle cartelle che hai montato sotto /workspace, alla rete che hai consentito e al filesystem proprio della sandbox, qualunque cosa gli venga detto di fare. Usa la sandbox per codice che gestisce input non attendibili o che non eseguiresti manualmente, e per più agenti che non devono condividere stato (sessioni con nome). Non protegge nulla di ciò che monti in lettura-scrittura.
./install.sh (se non è già stato fatto)
container exec -it coderunner /bin/bash
root@coderunner:/app# npm install -g @anthropic-ai/claude-code
Il server MCP sarà disponibile all'indirizzo: http://coderunner.local:8222/mcp
L'installer crea ~/.coderunner/venv per il proxy di Claude Desktop. Per gli altri esempi Python, installa le loro dipendenze nel tuo virtualenv:
pip install -r examples/requirements.txt



Copia la configurazione di esempio:
cd examples
cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
Modifica il file di configurazione e sostituisci i percorsi segnaposto:
/path/to/your/python con $HOME/.coderunner/venv/bin/python usando il percorso completo della tua directory home/path/to/coderunner con il percorso effettivo del tuo repository clonatoEsempio dopo la modifica:
{
"mcpServers": {
"coderunner": {
"command": "/Users/yourname/.coderunner/venv/bin/python",
"args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
}
}
}
Aggiorna la configurazione di Claude Desktop:
Inizia a usare CodeRunner in Claude: Il codice che Claude scrive ora viene eseguito nella sandbox.
Se lo strumento appare come "Disabilitato" nel menu degli strumenti della chat anche se il server risulta in esecuzione: chiudi completamente Claude
Desktop (Cmd-Q) e riaprilo, assicurati che command sia il python del venv stampato dall'installer (ha
fastmcp), e leggi ~/Library/Logs/Claude/mcp-server-coderunner.log per l'errore del proxy. Il proxy
necessita della sandbox in esecuzione (container list) e del file token ~/.coderunner/api-token.
Avvio rapido:
# 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
Il plugin Claude Code (claude plugin marketplace add https://github.com/instavm/coderunner-plugin) è precedente
al token e restituisce 401 finché non invia la stessa intestazione; usa il comando sopra finché il plugin non viene aggiornato.
Passaggi di installazione:
Vai al Marketplace dei Plugin:

Aggiungi il repository InstaVM:
