Referencia de comandos · Cursor CLI
agent sandbox enable
Activa el modo sandbox para la ejecución de comandos.
agent sandbox enable es un subcomando de agent sandbox y activa el modo sandbox de forma permanente. A partir de entonces, los comandos de terminal del agente se ejecutan con acceso de lectura/escritura al workspace, pero aislados del resto del sistema; el acceso a red está desactivado por defecto. Según la visión general oficial de la CLI, esta configuración persiste entre sesiones y se guarda en un archivo de configuración (~/.cursor/sandbox.json a nivel global, o .cursor/sandbox.json a nivel de proyecto, válido también por SSH). Es equivalente a la opción global --sandbox enabled.
Hay que distinguirlo de agent sandbox run <cmd>, que solo ejecuta de forma aislada un único comando, sin cambiar la configuración permanente. Para una configuración paso a paso mediante un menú interactivo, incluido el acceso a red, se usa en su lugar el comando slash /sandbox, que según el registro de cambios alterna entre los tres modos Run Everything, Auto-Run in Sandbox y Ask Every Time. Para restablecer los valores por defecto existe agent sandbox reset.
✅ ¿CUÁNDO USARLO?
Activar la ejecución aislada permanente de comandos para todas las sesiones futuras
agent sandbox enable
Forzar desde el principio una configuración por defecto segura al instalar la CLI en un ordenador nuevo
agent sandbox enable
⛔ ¿CUÁNDO MEJOR NO?
El sandbox debe aplicarse solo a un único comando, no de forma permanente
agent sandbox enable cambia la configuración persistente para todas las ejecuciones futuras.
Mejor: usar agent sandbox run <cmd> para ejecutar de forma aislada solo un único comando
Se quiere configurar el modo y el acceso a red de forma interactiva y detallada, no solo activarlo en bloque
agent sandbox enable solo conoce el estado binario activado/desactivado, sin niveles intermedios.
Mejor: usar /sandbox para el menú interactivo con los tres modos Run Everything, Auto-Run in Sandbox y Ask Every Time
FUENTES
- Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com