Repolode
Enviar
anthropics

anthropics/sandbox-runtime

CLI y biblioteca ligeros que restringen el acceso al sistema de archivos y a la red de procesos arbitrarios a nivel del sistema operativo, sin contenedores.

Ver en GitHub
Estrellas
6,425
Forks
562
Issues abiertos
300
Último commit
hace 7 horas

¿Qué es?

srt envuelve cualquier comando —como un agente de IA, un servidor MCP local, un comando de bash u otro proceso— y limita lo que puede leer, escribir y a qué puede conectarse. En macOS usa sandbox-exec con perfiles Seatbelt generados, y en Linux usa bubblewrap con un espacio de nombres de red. En Windows, ejecuta el proceso con una cuenta local dedicada y un filtro de salida de Windows Filtering Platform.

El acceso a la red está denegado de forma predeterminada. El tráfico permitido pasa por proxies HTTP y SOCKS5 en el host, que aplican listas de dominios permitidos y bloqueados. Las reglas del sistema de archivos siguen un modelo de denegación y luego autorización para las lecturas, y un modelo que solo permite explícitamente para las escrituras. El acceso a sockets Unix está bloqueado de forma predeterminada en ambas plataformas.

El paquete se puede usar desde la línea de comandos como `srt` o importar como biblioteca de TypeScript mediante SandboxManager. También admite un archivo de configuración, informes de infracciones en macOS y un canal de configuración en tiempo de ejecución.

Funciones clave

  • 01Restringe las lecturas y escrituras del sistema de archivos para cualquier árbol de procesos
  • 02Aplica listas de dominios permitidos y bloqueados mediante proxies en el host
  • 03Usa sandbox-exec en macOS y bubblewrap en Linux
  • 04Bloquea el acceso a sockets Unix de forma predeterminada
  • 05Ofrece tanto una CLI como una API de biblioteca de TypeScript

Casos de uso

  • Aislar agentes de programación con IA para impedir que lean claves SSH o se conecten a hosts arbitrarios
  • Restringir servidores MCP locales a directorios y destinos de red específicos
  • Ejecutar comandos de bash o scripts de compilación no confiables con acceso limitado

Inicio rápido

  1. 1

    Instala el paquete globalmente con npm

    npm install -g @anthropic-ai/sandbox-runtime
  2. 2

    Ejecuta un comando dentro del sandbox

    srt "curl example.com"

Antes de usarlo

  • Es una versión preliminar de investigación en fase beta; las API y los formatos de configuración pueden cambiar.
  • Depende de primitivas del sistema operativo, como sandbox-exec en macOS y bubblewrap en Linux. En Linux, es necesario instalar bubblewrap.
  • La compatibilidad con Windows tiene limitaciones conocidas y documentadas relacionadas con los tokens de proceso y los servicios del sistema.

En colecciones

Servidores MCPHerramientas de escaneo, auditoría e inteligencia de amenazas

Temas

#sandbox#security#agent-safety#network-isolation#filesystem#bubblewrap#seatbelt#mcp

Preguntas frecuentes

¿Qué es sandbox-runtime?
CLI y biblioteca ligeros que restringen el acceso al sistema de archivos y a la red de procesos arbitrarios a nivel del sistema operativo, sin contenedores. srt envuelve cualquier comando —como un agente de IA, un servidor MCP local, un comando de bash u otro proceso— y limita lo que puede leer, escribir y a qué puede conectarse. En macOS usa sandbox-exec con perfiles Seatbelt generados, y en Linux usa bubblewrap con un espacio de nombres de red. En Windows, ejecuta el proceso con una cuenta local dedicada y un filtro de salida de Windows Filtering Platform.
¿sandbox-runtime es gratuito? ¿Qué licencia tiene?
sandbox-runtime es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿sandbox-runtime sigue mantenido?
Mantenimiento activo. El último commit de sandbox-runtime fue el 24 oct 2026.
¿Para qué puedo usar sandbox-runtime?
Aislar agentes de programación con IA para impedir que lean claves SSH o se conecten a hosts arbitrarios Restringir servidores MCP locales a directorios y destinos de red específicos Ejecutar comandos de bash o scripts de compilación no confiables con acceso limitado
¿Cómo se instala sandbox-runtime?
Instala el paquete globalmente con npm: npm install -g @anthropic-ai/sandbox-runtime Ejecuta un comando dentro del sandbox: srt "curl example.com"
¿Dónde consigo sandbox-runtime?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/anthropics/sandbox-runtime

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados