Saltar al contenido
Menú
¿Lo necesito?Lo que un agente puede alcanzar en tu máquinaCómo funcionaLas capas entre el agente y tu sistemaCompararSandboxes integrados, Docker y VMsConfigurarAbre solo lo que la tarea necesitaSeguridadEl modelo de amenazas y sus límitesDescargarBinarios, checksums y notas de la versiónInstalar
Un sandbox del sistema operativo para agentes de programación con IA

Una jaula para tu agente de IA

ai-jail ejecuta Claude Code, Codex y otros agentes de programación con IA dentro de un sandbox del sistema operativo en Linux y macOS. El proyecto sigue siendo escribible. Tus archivos y credenciales quedan fuera de alcance, excepto el login del propio agente que ejecutas.

terminal
ai-jail claude
No es una VM

Dale al agente el proyecto, no el equipo entero. ai‑jail hace que ese límite sea real.

Cómo un buen agente sale mal

Todo el día el agente lee texto que no escribiste: páginas web, issues, READMEs, paquetes. Basta una página con instrucciones escondidas, y el agente no necesita ser hostil para seguirlas.

↔ Desliza hacia un lado para ver el diagrama completo

La misma página, con y sin ai-jail. La clave no está ahí para leerla, e internet en general queda cerrado, excepto para la API del propio agente y los registros de paquetes en Linux.
Qué más puede alcanzar un agente
  1. Tu agente se ejecuta como tú

    Un agente de programación es un programa bajo tu cuenta de usuario. También lo es cada script, paquete y servidor MCP que arranca; un servidor MCP es un programa auxiliar que le da herramientas extra al agente. Todos pueden abrir cualquier cosa que tú puedas abrir.

  2. Arráncalo con ai-jail

    Escribe ai-jail delante del comando. El agente arranca en sus propios namespaces, con tu proyecto montado en la misma ruta.

  3. Tu home no está montado

    El agente recibe un directorio home nuevo y vacío. Las claves SSH (los archivos con los que entras a tus servidores), las credenciales de la nube, los perfiles del navegador y tus otros proyectos no existen ahí dentro.

  4. Secretos, red y dispositivos cerrados

    ai-jail reduce las variables de entorno a una lista de permitidos, así que los secretos de tu shell se quedan en tu shell. La red está cerrada, salvo el host de la API del propio agente y, en Linux, los registries de paquetes de los que descargan tus toolchains. El socket de Docker, la pantalla y el portapapeles están apagados.

  5. Abre lo que la tarea necesita

    Claude Code, Codex, Gemini, Grok y Devin arrancan con la sesión iniciada y alcanzan el host de su propia API. Un flag, una opción que escribes después de ai-jail, abre más: --allow-host añade hosts, --network lo abre todo.

El muro rodea todo el harness

Los agentes que traen un sandbox lo ponen alrededor de los comandos que ejecuta el modelo. El proceso del agente, sus herramientas de archivos, sus servidores MCP y sus hooks (scripts que el agente ejecuta en momentos fijos) quedan fuera, bajo tu cuenta. ai-jail los arranca a todos dentro. Una solicitud de permiso le pregunta a una persona, y a una persona se la puede apurar o engañar. Un sandbox le pregunta al kernel, el núcleo del sistema operativo, que responde siempre lo mismo.

↔ Desliza hacia un lado para ver el diagrama completo

Una sola política para todos los agentes que usas, escrita una vez.
Ver la comparación completa

Lo que obtienes sin configurar nada

Todo lo que alcanza tu máquina está apagado hasta que lo actives, salvo el login del propio agente, el host de su propia API, tus toolchains (en Linux) y sus registries de paquetes, cada uno con un interruptor --no-. Las escrituras fuera del proyecto caen en memoria y desaparecen cuando termina la sesión.

Dentro de la jaula

  • Tu proyecto, en lectura y escritura, en su ruta real
  • Tus toolchains, en solo lectura, con una caché propia de la jaula (Linux)
  • El login del propio agente, como ~/.claude, para que arranque con la sesión iniciada
  • El host de la API de un agente conocido, y los registries de paquetes en Linux
  • Un directorio home nuevo y un /tmp privado

Fuera de alcance

  • ~/.ssh, ~/.aws, ~/.gnupg, perfiles del navegador
  • Los secretos de tu shell, salvo la clave de API del propio agente
  • Otros procesos, el IPC del host, ptrace y bpf

Apagado hasta que lo pidas

  • --allow-host para más hosts, --forward-port para un servicio local, --network para toda la red
  • --ssh, --gpu, --display, --docker y más
Todos los interruptores

ai-jail es un programa pequeño, sin daemon y sin root. En Linux levanta los muros con funciones del kernel: bubblewrap para los namespaces y los montajes, más Landlock, seccomp y límites de recursos cuando el kernel los ofrece. En macOS traduce lo que admite la plataforma a un perfil más fino de sandbox-exec. El agente usa los compiladores y runtimes que ya tienes y, por defecto, un archivo .ai-jail dentro de un repositorio solo puede endurecer la jaula, nunca abrirla.

Cómo funcionan las capas

Las primeras preguntas de todos

¿Hace más lento al agente?
No. El sandbox está hecho con funciones del kernel, namespaces y reglas de montaje. No hay emulación ni máquina virtual, y el agente corre a velocidad nativa.
¿Qué agentes soporta?
Cualquier comando. Sabe dónde guardan su login Claude Code, Codex, Gemini CLI, OpenCode, Antigravity, Kimi, Kiro, Prime Agent, Devin, Crush, Grok, jcode, pi, aider, SoulForge y omp, y lo monta por defecto. La tabla de Instalar dice qué recibe cada uno, y ai-jail bash te da una shell dentro de la jaula para echar un vistazo.
¿Funciona en Windows?
De forma nativa, no. Usa WSL2 y el backend de Linux dentro de él.
Mi agente necesita internet. ¿Sigue sirviendo la jaula?
Sí. Un agente conocido como Claude Code alcanza el host de su propia API nada más arrancar, más los registries de paquetes en Linux, y nada más. --allow-host añade los hosts que nombres. Con --network activado, en cambio, el agente sigue pudiendo leer solo tu proyecto, así que tus claves y el resto de tu home no están ahí para enviarlos. Lo que puede leer, puede enviarlo, y por eso importa enmascarar los secretos dentro del proyecto. Mira cómo enmascararlos.
¿Es gratis?
Sí. ai-jail es de código abierto bajo la licencia GPL 3.0.

Pon a tu agente tras las rejas

ai-jail es un único binario que no necesita daemon ni root. Añades una palabra delante del comando que ya usas.

terminal
brew tap akitaonrails/tap && brew install ai-jailai-jail claude