
Un sandbox local para tus agentes de IA
CodeRunner te ayuda a ejecutar tus agentes de IA y sus acciones dentro de un sandbox.
Caso de uso principal: Ejecutar el código de un agente de IA en un sandbox con montajes del host y acceso a la red elegidos explícitamente. El aislamiento reduce el riesgo; no evita toda pérdida de datos ni toda exfiltración.
Para máquinas virtuales gestionadas en la nube para agentes, hemos lanzado - InstaVM - Instant computers for AI agents
Requisitos previos: Mac con macOS y Apple Silicon (M1/M2/M3/M4), Python 3.10+
El instalador genera el token del sandbox en ~/.coderunner/api-token (o guarda
el CODERUNNER_API_TOKEN que hayas exportado). Los clientes lo envían como
Authorization: Bearer <token>; cat ~/.coderunner/api-token lo muestra. Solo
GET /health es público, y un token ausente o débil provoca un fallo cerrado. El proxy de Claude
Desktop y los ejemplos leen el token de ese archivo cuando la variable
no está definida. Consulta authentication and network boundaries.
git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh
Detén el sandbox cuando hayas terminado:
container stop coderunner
Reanude el mismo sandbox más tarde, preservando su sistema de archivos. El estado del kernel de Python es volátil y no sobrevive a un reinicio de la VM o del servidor:
container start coderunner
Para empezar de nuevo con un sandbox limpio, elimine el contenedor y ejecute el instalador de nuevo:
container delete coderunner && ./install.sh
Los límites de CPU y memoria se pueden establecer con las opciones del instalador o con las variables de entorno CODERUNNER_CPUS y CODERUNNER_MEMORY:
./install.sh --cpus 4 --memory 8g
Los directorios adicionales del host deben montarse bajo /workspace. Son de solo lectura por defecto; añada :rw solo cuando el sandbox necesite escribir en el host:
./install.sh \
--mount "$HOME/projects/api:/workspace/api" \
--mount "$HOME/projects/output:/workspace/output:rw"
Los montajes adicionales por defecto son ninguno. La configuración de recursos y montajes es fija una vez creado el contenedor; elimine el contenedor antes de modificarlos.
Por defecto, el código que se ejecuta en el sandbox tiene acceso de red sin restricciones. Para ejecutarlo en una red de solo host sin acceso a internet:
CODERUNNER_NETWORK=none ./install.sh
En este modo, el servidor MCP está disponible en http://127.0.0.1:8222/mcp. La configuración es fija cuando se crea el contenedor; el instalador se niega a reanudar un contenedor con un modo de red diferente.
Claude Code ejecuta comandos en tu máquina, como tú, con los avisos de permisos como único límite. Apuntarlo a las herramientas de CodeRunner en su lugar ejecuta el código que escribe en la VM: solo puede tocar las carpetas que montaste bajo /workspace, la red que permitiste y el propio sistema de archivos del sandbox, sea lo que sea que se le haya indicado hacer. Usa el sandbox para código que maneja entradas no confiables o que no ejecutarías a mano, y para varios agentes que no deben compartir estado (sesiones con nombre). No protege nada que montes en modo lectura-escritura.
./install.sh (si aún no se ha hecho)
container exec -it coderunner /bin/bash
root@coderunner:/app# npm install -g @anthropic-ai/claude-code
El servidor MCP estará disponible en: http://coderunner.local:8222/mcp
El instalador crea ~/.coderunner/venv para el proxy de Claude Desktop. Para los demás ejemplos de Python, instala sus dependencias en tu propio virtualenv:
pip install -r examples/requirements.txt



Copia la configuración de ejemplo:
cd examples
cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
Edita el archivo de configuración y reemplaza las rutas de marcador de posición:
/path/to/your/python con $HOME/.coderunner/venv/bin/python usando la ruta completa a tu directorio home/path/to/coderunner con la ruta real a tu repositorio clonadoEjemplo después de editar:
{
"mcpServers": {
"coderunner": {
"command": "/Users/yourname/.coderunner/venv/bin/python",
"args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
}
}
}
Actualizar la configuración de Claude Desktop:
Empezar a usar CodeRunner en Claude: El código que Claude escribe ahora se ejecuta en el sandbox.
Si la herramienta aparece como "Disabled" en el menú de herramientas del chat aunque el servidor figure como en ejecución: cierra Claude
Desktop por completo (Cmd-Q) y vuelve a abrirlo, asegúrate de que command sea el python del venv que imprimió el instalador (tiene
fastmcp), y lee ~/Library/Logs/Claude/mcp-server-coderunner.log para ver el error del proxy. El proxy
necesita el sandbox en ejecución (container list) y el archivo de token ~/.coderunner/api-token.
Inicio rápido:
# 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
El plugin de Claude Code (claude plugin marketplace add https://github.com/instavm/coderunner-plugin) es anterior
al token y devuelve 401 hasta que envíe la misma cabecera; usa el comando anterior hasta que el plugin se actualice.
Pasos de instalación:
Navega al Marketplace de Plugins:

Añade el repositorio de InstaVM:
