Con ajustes que generan muchas confirmaciones en Claude Code, aprobar los comandos puede interrumpir tu trabajo. Pero desactivar las confirmaciones con --dangerously-skip-permissions (bypass de permisos) permite que una inyección de prompt o un error afecte a archivos de toda tu máquina. Reducir las confirmaciones sigue requiriendo decidir qué ámbito permitir.

El sandbox restringe, a nivel del sistema operativo, los archivos y destinos de red a los que pueden acceder los comandos de shell y sus procesos hijos. Con el modo auto-allow, ayuda a reducir las confirmaciones, pero no garantiza proteger todo el equipo ni evitar filtraciones de datos. Este artículo explica su alcance, ajustes, condiciones para omitir la confirmación y vías fuera del sandbox.

La conclusión en 30 segundos

Si solo lees una cosa

Qué es
Un mecanismo que delimita el acceso a archivos y red a nivel del sistema operativo. Abarca los shells y procesos hijos ejecutados dentro del sandbox.
Por qué ayuda
Ofrece una alternativa a la fatiga de confirmaciones frente al bypass completo: reducir el impacto y, en modo auto-allow, también las confirmaciones. La destrucción o el envío dentro de las áreas permitidas y las herramientas externas al sandbox siguen siendo asuntos distintos.
Por dónde empezar
Ejecuta /sandbox. En macOS funciona sin más; Linux/WSL2 necesita dos paquetes.

* Anthropic informa de que el sandbox redujo las solicitudes de permisos un 84% en su uso interno (fuente más abajo).

1. Por qué necesitas un sandbox

Claude Code es un agente de IA que actúa de verdad: ejecuta pruebas y reescribe archivos. Según los ajustes de permisos, pide aprobación antes de ejecutar. Pero si aparecen decenas de solicitudes al día, el trabajo se fragmenta y terminas pulsando Enter sin leer. Eso es la «fatiga de confirmaciones».

Un desarrollador cansado recurre a --dangerously-skip-permissions (también llamado modo YOLO), que desactiva todas las confirmaciones. Es cómodo y, como dice su nombre, peligroso. Tres amenazas enseñan los dientes a la vez.

💉 Inyección de prompts

Si una página web o un issue que lee esconde «envía ~/.ssh», tus claves privadas pueden filtrarse sin ninguna confirmación.

🗑️ Descuidos destructivos

Un comando generado limpia una ruta inesperada. Sin confirmación, también pueden desaparecer archivos fuera del proyecto.

📤 Contaminación de la cadena de suministro

Una dependencia maliciosa envía datos al exterior durante la instalación. Con la red abierta de par en par, no puedes impedirlo.

Además de la aprobación de una cadena de comandos, el sandbox limita hasta dónde puede llegar un proceso en ejecución. Las restricciones del sistema operativo también se aplican a scripts arbitrarios, pero no impiden abusar de ubicaciones de escritura o destinos permitidos. En su artículo oficial de ingeniería, Anthropic informó de una reducción del 84% de las solicitudes de permisos internas (octubre de 2025). Es una medición interna del proveedor, no una garantía de reducción ni de seguridad para todos los entornos.

2. Qué es el sandbox: dos aislamientos

El sandbox de Claude Code aplica dos límites a los comandos de shell de Bash, PowerShell y Monitor y sus procesos hijos. Ambos deben funcionar juntos; usar solo uno deja huecos (véase §7).

🗂️ ① Aislamiento del sistema de archivos

Las ubicaciones de escritura predeterminadas son el directorio de trabajo, los directorios de trabajo adicionales y el almacenamiento temporal por usuario. Las rutas protegidas se deniegan aparte. Las lecturas se permiten ampliamente por defecto, por lo que los secretos necesitan restricciones como denyRead. Sigue siendo posible borrar y modificar en las áreas donde se puede escribir.

🌐 ② Aislamiento de red

Las conexiones pasan por un proxy y se comparan con los dominios permitidos. La lista empieza vacía, pero los ajustes y las reglas de permisos añaden entradas. El tratamiento de hosts fuera de la lista depende del modo de permisos; no siempre implica rechazo o confirmación. No se garantiza bloquear el envío de secretos a un destino permitido.

Lo esencial es que no depende de que Claude se comporte bien. El límite lo impone el propio mecanismo de seguridad del sistema operativo: macOS usa Seatbelt, Linux/WSL2 usa bubblewrap. El mismo límite alcanza a los scripts invocados por un comando y a los procesos descendientes. En vez de una petición al modelo, como las barreras de protección de IA, es una restricción de acceso de procesos impuesta por el sistema operativo.

💡 Abarca comandos de shell y procesos hijos. El sandbox envuelve los shells de Bash, PowerShell y Monitor y sus procesos hijos. Read/Edit/Write integrados, los servidores MCP y los hooks son vías separadas, controladas por reglas de permisos. Para aislar el proceso completo, considera @anthropic-ai/sandbox-runtime, descrito más adelante.

3. Primeros pasos: /sandbox y sistemas operativos compatibles

El sandbox está integrado en Claude Code. No hace falta otra cuenta, pero según el sistema operativo debes preparar paquetes de dependencias. En una sesión, ejecuta:

/sandbox

Se abre un panel con tres pestañas. Mode (cómo se aprueban los comandos con sandbox, en la siguiente sección), Overrides (si un comando que falla bajo el sandbox puede recurrir a ejecutarse sin sandbox) y Config (ver la configuración resuelta). En Linux/WSL2, si falta un paquete necesario, aparece en su lugar una pestaña Dependencies que te indica qué instalar.

Requisitos por sistema operativo

🍎 macOS

Nada que instalar. Usa el Seatbelt integrado. Actívalo de inmediato con /sandbox.

🐧 Linux / WSL2

Instala dos paquetes: bubblewrap y socat (p. ej. apt-get install bubblewrap socat).

🪟 Windows nativo

No es compatible. Ejecuta Claude Code dentro de WSL2 (WSL1 no funciona).

En Linux/WSL2, instala bubblewrap (la herramienta de sandbox sin privilegios que impone el aislamiento del sistema de archivos) y socat (el relé que dirige el tráfico al proxy).

# Ubuntu / Debian
sudo apt-get install bubblewrap socat

# Fedora
sudo dnf install bubblewrap socat

⚠️ Ubuntu 24.04 y posteriores: la política de AppArmor predeterminada puede impedir que bubblewrap cree los espacios de nombres de usuario que necesita. Si sysctl kernel.apparmor_restrict_unprivileged_userns devuelve 1, añade un perfil de AppArmor para bwrap que se lo conceda (los pasos están en la documentación oficial). Si devuelve 0 o la clave no existe, no hay que hacer nada. Comprueba lo mismo dentro de WSL2.

Algo útil que conviene activar es el filtro seccomp (que añade el bloqueo de sockets de dominio Unix). Es opcional; instálalo con npm install -g @anthropic-ai/sandbox-runtime. La pestaña Dependencies de /sandbox muestra el estado de ripgrep, bubblewrap, socat y el filtro seccomp. Tras instalar los paquetes, reinicia Claude Code y vuelve a abrir /sandbox (la comprobación se ejecuta al iniciar).

En Linux/WSL2, por defecto los comandos dentro del sandbox no pueden crear espacios de nombres de usuario. Para que Chromium o el propio sandbox de Electron, o un bubblewrap o unshare anidado, puedan ejecutarse, pon sandbox.allowNestedUserNamespaces en true en ~/.claude/settings.json (v2.1.305 o posterior; no se puede activar en la configuración del proyecto). Sin embargo, la documentación oficial advierte de que esto abre un límite de seguridad. Es porque el código de un comando dentro del sandbox podría ejecutarse fuera de él. Rootless Podman y Buildah no funcionan solo con este ajuste (explicación oficial).

4. Los dos modos (auto-allow / regular)

La pestaña Mode elige cómo se aprueban los comandos dentro del sandbox.

✅ Auto-allow mode

Los comandos de shell dentro del sandbox normalmente se aprueban sin confirmación. Permanecen las reglas deny aplicables, las reglas ask que especifican contenido y las comprobaciones de borrado en rutas críticas. La decisión sobre un destino desconocido es distinta de la decisión de reintentar fuera del sandbox. Ninguna pide confirmación siempre.

🔍 Regular permissions mode

Incluso dentro del sandbox, los comandos de shell pasan por la evaluación ordinaria de permisos. Añade control y puede añadir aprobaciones. Es apropiado para un flujo cauteloso que combina aislamiento y comprobaciones ordinarias de confirmación.

En ambos modos los límites del sistema de archivos y de la red son idénticos; la única diferencia es «autoaprobación frente a confirmación». Ten en cuenta que, incluso en el modo de autoaprobación, estas válvulas de seguridad siguen activas:

  • Entre las reglas de ajustes, un deny coincidente tiene prioridad sobre allow. Las condiciones en las que los mods cambian decisiones están en la guía de reglas de permisos.
  • rm / rmdir dirigidos a /, al directorio personal o a rutas críticas del sistema piden confirmación o se rechazan según el modo de permisos
  • Las reglas de tipo «ask» con alcance de contenido, como Bash(git push *), siguen forzando una confirmación, incluso dentro del sandbox

Cuidado con los dos «auto» de nombres parecidos. Auto-allow del sandbox es distinto de auto de los modos de permisos. El primero aprueba automáticamente comandos contenidos por el límite del sistema operativo; el segundo usa un clasificador para evaluar su seguridad. Pueden combinarse, pero en Plan, auto-allow no amplía el ámbito de aprobación. La evaluación de hosts de auto y la revisión adicional del clasificador también pueden permanecer en ciertas condiciones.

Comunicación con un destino desconocido

En un terminal interactivo, Manual, acceptEdits y Plan ordinario piden confirmación; dontAsk rechaza. Auto permite hosts nombrados en el comando cuando el clasificador los aprueba. Bypass y Plan con bypass habilitado como opción los permiten sin confirmar. Los rechazos de strictAllowlist, allowManagedDomainsOnly y deniedDomains se aplican por separado. El propio comando sigue dentro del sandbox.

Reintento fuera del sandbox

En un terminal interactivo, Manual y acceptEdits normalmente piden confirmación, auto usa el clasificador y dontAsk rechaza. Plan sigue la evaluación de comandos de Plan. Bypass o un allow coincidente omiten la confirmación, pero una regla ask para Bash(dangerouslyDisableSandbox:true), restricciones de lectura fuera del área de trabajo u otras comprobaciones pueden tener prioridad. allowUnsandboxedCommands:false bloquea los reintentos; excludedCommands es independiente. failIfUnavailable impide ejecutar sin aislamiento si el sandbox no está disponible. Comprueba también las condiciones oficiales de las excepciones.

Por defecto está el modo de permisos regular (desde v2.1.324). Con solo activar el sandbox, los comandos aislados siguen pidiendo confirmación como hasta ahora. Hasta v2.1.323, el valor por defecto era auto-allow. Si quieres reducir las confirmaciones, elige auto-allow en la pestaña Mode o escribe sandbox.autoAllowBashIfSandboxed: true en settings.json (lista oficial de ajustes). Las organizaciones que exigen el sandbox mediante ajustes gestionados deben poner el mismo valor en el ajuste gestionado de mayor prioridad.

5. Configurarlo en settings.json

Las opciones del panel de /sandbox se escriben en el .claude/settings.local.json del proyecto (que no se sube a git). Para mantenerlo siempre activo en todos los proyectos, pon sandbox.enabled: true en tu configuración de usuario, en ~/.claude/settings.json. Si quieres reducir las confirmaciones, añade también autoAllowBashIfSandboxed: true dentro del mismo bloque sandbox (por defecto es false, es decir, el modo de permisos regular). Vive en la misma familia de settings.json que las reglas de permisos (allow/ask/deny).

Añadir destinos de escritura, denegar lecturas

Las ubicaciones de escritura predeterminadas son el directorio de trabajo, los directorios de trabajo adicionales y el almacenamiento temporal por usuario. allowWrite añade ubicaciones. denyRead limita las lecturas de comandos dentro del sandbox; no bloquea directamente Read integrado ni MCP.

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "allowWrite": ["~/.kube", "/tmp/build"],
      "denyRead": ["~/"],
      "allowRead": ["."]
    }
  }
}

El ejemplo anterior deniega las lecturas de todo el directorio personal permitiendo a la vez el proyecto actual (. se resuelve a la raíz del proyecto cuando la configuración vive en los ajustes del proyecto). Las rutas se imponen a nivel del sistema operativo, así que se aplican por igual a procesos hijos como npm y terraform.

Proteger las credenciales

Una trampa importante: el valor por defecto de las lecturas es «ampliamente permitido», así que ~/.aws/credentials y ~/.ssh/ son legibles tal cual. El ajuste específico sandbox.credentials (una función relativamente reciente) declara archivos cuya lectura se deniega y variables de entorno que se eliminan.

{
  "sandbox": {
    "enabled": true,
    "credentials": {
      "files": [
        { "path": "~/.aws/credentials", "mode": "deny" },
        { "path": "~/.ssh", "mode": "deny" }
      ],
      "envVars": [
        { "name": "GITHUB_TOKEN", "mode": "deny" }
      ]
    }
  }
}

Permitir destinos

La lista de dominios permitidos empieza vacía, pero allowedDomains, las reglas de dominios de WebFetch y otros ajustes añaden entradas. Los destinos desconocidos pueden pedir confirmación, rechazarse o permitirse sin confirmación según el modo de permisos. Si los destinos deben constituir un límite obligatorio, comprueba también strictAllowlist y el ajuste gestionado allowManagedDomainsOnly.

{
  "sandbox": {
    "enabled": true,
    "network": {
      "allowedDomains": ["*.github.com", "registry.npmjs.org"]
    }
  }
}

Para exigirlo en toda la organización. En ajustes gestionados, sandbox.enabled: true, failIfUnavailable: true (impide iniciar Claude Code si el sandbox no puede inicializarse) y allowUnsandboxedCommands: false (cierra la vía de reintento sin sandbox) restringen la ejecución sin aislamiento cuando el sandbox no está disponible y los reintentos fuera de él. Sin embargo, excludedCommands, las herramientas de archivos integradas, MCP y otras vías son independientes; esos ajustes por sí solos no garantizan aislar toda operación.

6. Relación con los modos y reglas de permisos

Es fácil confundirlos, pero la maquinaria de seguridad de Claude Code tiene tres capas con funciones distintas. El sandbox es una de ellas: no sustituye a las otras dos, sino que las complementa.

Capa Qué controla Quién lo impone Alcance
Reglas de permisos Qué herramientas/comandos se pueden usar Claude Code (antes de ejecutar) Todas las herramientas
Modos de permisos Cuántas confirmaciones aparecen Claude Code (antes de ejecutar) Depende del modo
Sandbox Qué puede tocar una vez que se ejecuta El sistema operativo (kernel) Comandos de shell y procesos hijos

Las reglas de permisos evalúan llamadas a herramientas antes de ejecutarlas; el sandbox restringe el acceso a archivos y red de los procesos que se ejecutan dentro de él. Tiene la ventaja de no depender de otras formas de escribir un comando. Sin embargo, las herramientas externas, los comandos excluidos, los reintentos sin sandbox y los permisos amplios dejan vías donde no se aplica el mismo límite.

Bypass es un modo de permisos que omite confirmaciones y el clasificador; el sandbox es una capa que restringe el ámbito de ejecución. Cumplen funciones distintas. Incluso juntos, bypass puede permitir hosts desconocidos y reintentos sin sandbox sin confirmación en ciertas condiciones. No presupongas que el uso cotidiano en tu equipo es seguro; revisa el ámbito permitido, las excepciones y las credenciales en conjunto.

7. Límites y advertencias: no confíes de más

El sandbox es potente, pero no es un aislamiento completo. Antes de apoyarte en él como un límite de seguridad estricto, conoce los límites que detalla la documentación.

🔓 El TLS no se inspecciona por defecto

El proxy juzga solo por el nombre de host y no inspecciona el contenido cifrado (por defecto). Permitir un dominio amplio como github.com deja margen para exfiltrar datos mediante domain fronting y técnicas similares. Mantén la lista de permitidos estrecha.

🔌 Abrir sockets Unix es arriesgado

Permitir /var/run/docker.sock entrega todo el host a través del socket de Docker: en la práctica, una fuga del sandbox. Ten cuidado con qué sockets abres.

📈 Acceso de escritura demasiado amplio

Ejecutables escribibles en el $PATH o archivos como .bashrc pueden convertirse en ejecución de código en otro contexto. Mantén allowWrite al mínimo.

Read/Edit/Write integrados, WebFetch/WebSearch, MCP, hooks, LSP y comandos auxiliares se ejecutan fuera del sandbox integrado. Para restringir el proceso completo, considera otro límite, como un contenedor, una VM o sandbox-runtime. También importan allí los montajes, las conexiones de red, los sockets y las credenciales permitidos.

8. Cuándo recurrir a contenedores de desarrollo o máquinas virtuales

El sandbox no es la única opción de aislamiento de Claude Code. La comodidad y la solidez del aislamiento son un compromiso, así que elige según el propósito.

Sandbox (integrado)

Aísla comandos de shell y procesos hijos. Sin Docker, configuración mínima. Con el modo auto-allow, una opción principal para reducir las confirmaciones en el desarrollo diario.

sandbox-runtime

Envuelve Claude Code y los procesos hijos locales que inicia. Aislar el propio servidor MCP remoto es un asunto aparte. Sin Docker.

contenedor de desarrollo

Pone en un contenedor todo el entorno de desarrollo. Para estandarizar la configuración de un equipo. Requiere Docker.

máquina virtual

Separa todo el sistema operativo con un sistema invitado. Las carpetas compartidas, la red y las credenciales requieren una configuración cuidadosa. Una opción para código no fiable, con el mayor esfuerzo de preparación.

La regla general: mantén el sandbox integrado siempre activo y usa el modo auto-allow para reducir las confirmaciones diarias, y solo sube de nivel a sandbox-runtime, contenedores o máquinas virtuales cuando ejecutes de forma desatendida o manejes dependencias no confiables. Para el trabajo que llega a producción —como dejar que la IA opere la nube—, combinar credenciales de mínimo privilegio con un nivel de aislamiento más fuerte da tranquilidad.

Resumen

  • El sandbox delimita «qué se puede tocar» a nivel del sistema operativo, disolviendo el binario de fatiga por confirmaciones frente a omisión total.
  • Usa el aislamiento del sistema de archivos y de la red como un conjunto. Quién lo impone: macOS = Seatbelt, Linux/WSL2 = bubblewrap.
  • Empieza con /sandbox. En macOS funciona sin más; Linux/WSL2 necesita bubblewrap+socat; Windows nativo no es compatible (usa WSL2).
  • Por defecto está el modo de permisos regular (desde v2.1.324). Para reducir las confirmaciones, elige auto-allow. Aun sin confirmación, se pueden modificar y enviar datos dentro de las áreas permitidas. Permanecen deny, los rm peligrosos y las reglas ask que especifican contenido.
  • Es una capa complementaria con una función distinta de las reglas y modos de permisos. El sistema operativo restringe el acceso durante la ejecución. Las vías externas al sandbox son independientes.
  • No es un muro completo: cuidado con TLS sin inspección, sockets Unix y permisos excesivamente amplios. Abarca los shells aislados y sus procesos hijos.

Al reducir las confirmaciones, revisa primero el ámbito permitido y las vías externas al sandbox. Para conocer la configuración exacta y actual, usa la documentación oficial de ajustes del sandbox como fuente primaria.

Preguntas frecuentes

P. ¿En qué se diferencia el sandbox de --dangerously-skip-permissions?

A. Bypass omite confirmaciones y el clasificador. El sandbox limita hasta dónde pueden llegar los shells aislados y sus procesos hijos. Las herramientas de archivos integradas y MCP quedan fuera, y siguen siendo posibles modificaciones o envíos dentro de áreas permitidas. La combinación también puede permitir hosts desconocidos o reintentos sin sandbox sin confirmar, por lo que no vuelve seguro todo el equipo.

P. ¿Puedo usarlo en Windows?

A. Windows nativo no está soportado; úsalo dentro de WSL2. Las restricciones de acceso a binarios de Windows dependen de seccomp y de los ajustes de sockets Unix, por lo que no es correcto decir que nunca pueden iniciarse. Los comandos de excludedCommands se ejecutan fuera del sandbox; revisa su impacto por separado.

P. ¿Activarlo hará que todo vaya más lento?

A. Esta revisión no estableció una medición de rendimiento aplicable a todos los entornos. Menos confirmaciones y menor tiempo de ejecución de comandos son resultados distintos. Compara la misma compilación o prueba registrando tiempo transcurrido, número de aprobaciones y fallos.

P. Con el sandbox activado, ¿están garantizadas a salvo mis claves privadas?

A. No hay garantía absoluta. La lectura está ampliamente permitida por defecto, por lo que ~/.ssh y ~/.aws/credentials se pueden leer inicialmente. Restringe las lecturas de shells aislados con sandbox.credentials o denyRead y mantén acotada la lista de destinos de red permitidos. Read integrado y MCP necesitan controles separados. Desactivar el aislamiento de archivos con filesystem.disabled:true deja sin efecto denyRead y los ajustes deny de archivos de credenciales. El aislamiento de archivos y red debe funcionar en conjunto.

P. ¿Los servidores MCP y los hooks también están en sandbox?

A. El sandbox integrado abarca comandos de shell de Bash, PowerShell y Monitor y sus procesos hijos. MCP, los hooks y Read/Edit/Write integrados se ejecutan fuera. Si consideras sandbox-runtime, contenedores o VM para envolver el proceso completo, comprueba por separado las conexiones de red, los montajes y las credenciales que permite ese entorno.

Si necesitas investigar y recibir asesoramiento sin cambios, consulta cómo usar Codex y Claude Code solo para investigar. El sandbox permite escribir en el área de trabajo por defecto, por lo que debe distinguirse del acceso de solo lectura.

El alcance y las excepciones de los permisos y el aislamiento se contrastaron de nuevo con la documentación oficial original el 9 de octubre de 2026. No se cambiaron ajustes del equipo ni se hicieron pruebas de inicio.