Dentro del entorno aislado de Codex
Cómo ejecuta Codex comandos en tu equipo con límites que tú controlas.
En OpenAI, adoptamos un enfoque de defensa en profundidad(se abre en una ventana nueva) para proteger a los agentes. Aunque nuestra inversión en entrenamiento y alineamiento es fundamental para este fin, también implementamos funciones en nuestro arnés de agentes, Codex(se abre en una ventana nueva), para proporcionar protecciones adicionales. Como una de las acciones más habituales (y potencialmente arriesgadas) de Codex es ejecutar comandos en tu ordenador, creamos el entorno aislado de Codex para que pueda trabajar en tu entorno existente con límites de acceso al sistema de archivos y a la red que tú controlas.
Un (se abre en una ventana nueva)entorno aislado(se abre en una ventana nueva) limita los recursos a los que puede acceder un programa mientras se ejecuta. Para organizar fotos, podrías configurar el entorno aislado de Codex de modo que los comandos puedan leer y modificar archivos en ~/Pictures, pero sin acceso a la red para impedir que se suban archivos. Para revisar código, podrías permitir el acceso a documentación en línea y mantener los archivos de código fuente en modo de solo lectura. Los usuarios configuran el entorno aislado de Codex mediante (se abre en una ventana nueva)perfiles de permisos(se abre en una ventana nueva), que definen las restricciones del sistema de archivos y de red para una sesión de Codex.
En este artículo, empezaremos por las ventajas e inconvenientes de los ajustes predeterminados del entorno aislado de Codex. Después explicaremos su diseño y cómo lo utiliza el arnés para ejecutar comandos. Mostraremos cómo los usuarios finales y las empresas pueden adaptar sus permisos a sus necesidades y cómo los desarrolladores pueden reutilizar el entorno aislado en sus propias herramientas. Por último, examinaremos cómo se aplican estas restricciones en macOS, Linux y Windows.
En Codex, nuestra filosofía es establecer ajustes predeterminados prudentes para el entorno aislado que sigan permitiendo realizar un trabajo útil. Por ejemplo, con un repositorio Git como raíz del espacio de trabajo, el perfil de permisos integrado :workspace:
Permite la escritura en el espacio de trabajo, pero mantiene directorios como
.gity.codexen modo de solo lectura. Esto permite que Codex edite el código fuente sin pedir permiso para cada cambio, pero impide modificar directamente.codex/config.tomlo los hooks de Git en.git/hooks.Permite un amplio acceso de lectura al sistema de archivos, sujeto a los permisos que el usuario ya tiene en el sistema operativo. Los compiladores, los entornos de ejecución y las herramientas de compilación dependen de SDK, bibliotecas y configuraciones externos al repositorio. Restringir la lectura al espacio de trabajo impediría el funcionamiento de muchos flujos de trabajo habituales. La contrapartida es que también pueden seguir siendo legibles archivos sensibles de otras ubicaciones del equipo, como archivos de configuración que contienen claves de API.
Desactiva el acceso a la red. Esto bloquea las subidas directas a servicios externos, incluidos los intentos de exfiltrar datos que el comando puede leer. También impide operaciones legítimas, como descargar dependencias, que requieren acceso adicional.
Estas restricciones impiden muchos tipos de comportamiento no deseado, pero sigue siendo posible realizar acciones perjudiciales. Por ejemplo, el agente podría inyectar código malicioso en un paquete instalado localmente, como node_modules/prettier. Ese cambio podría no aparecer en git status porque Git suele ignorar node_modules. Si el editor del usuario ejecuta esa copia de Prettier al guardar, el mero hecho de guardar un archivo podría ejecutar el código malicioso fuera del entorno aislado de Codex. Por eso adoptamos un enfoque de defensa en profundidad: el entorno aislado limita el acceso de los comandos, mientras que el entrenamiento y el alineamiento ayudan al modelo a utilizar ese acceso de acuerdo con la intención del usuario.
Para saber cómo adaptar los permisos del entorno aislado y combinarlos con otras protecciones en un entorno empresarial, consulta la guía práctica de seguridad de Codex(se abre en una ventana nueva).
Las máquinas virtuales y los contenedores(se abre en una ventana nueva) son dos mecanismos habituales de aislamiento, pero en el entorno aislado de Codex adoptamos un enfoque distinto. En lugar de trasladar los cálculos a un entorno independiente para aislarlos, Codex utiliza las funciones de aislamiento de cada plataforma para restringir los comandos que se ejecutan en el entorno existente del usuario.
Para muchos desarrolladores, su portátil es un entorno de desarrollo a medida que pueden modificar cuando quieran. Reproducir ese entorno en un contenedor Docker puede requerir esfuerzo, y algunos flujos de trabajo siguen dependiendo de herramientas que se ejecutan en el sistema anfitrión.
Por ejemplo, imagina que utilizas Codex para desarrollar una aplicación de iOS en un Mac. Si decidieras aislar Codex ejecutándolo dentro de Docker, no podría ejecutar la cadena de herramientas de compilación de iOS, compuesta por ejecutables nativos de Mac, ni iniciar el simulador de iPhone para ejecutar el código. Un flujo de trabajo basado en Docker podría delegar las compilaciones y las operaciones del simulador al Mac anfitrión, pero estas se ejecutarían fuera del entorno aislado del contenedor y necesitarían sus propias restricciones. En Codex, preferimos simplificar las cosas e invertir a fondo en el aislamiento específico de cada sistema operativo, para que Codex pueda ejecutarse en el entorno más adecuado para la tarea.
El arnés expone estos mecanismos de aislamiento específicos de cada sistema operativo mediante una API común para macOS, Windows y Linux. Esta API recibe un comando y un perfil de permisos. Si el perfil de permisos permite un acceso limitado a la red, quien realiza la llamada debe proporcionar un proxy de red que aplique esos límites:
Esta función inicia el proceso en un entorno aislado y devuelve un identificador Child que el arnés puede utilizar para esperar a que termine. Cada proceso hijo hereda las restricciones de aislamiento de su padre, de modo que se aplican a todo el árbol de procesos iniciado por el comando, incluso a los descendientes que siguen ejecutándose después de que termine el proceso original.
El siguiente diagrama muestra cómo encajan estas piezas, desde la configuración hasta la ejecución de un comando aislado. Las siguientes secciones explican cada etapa.

Como se explica en El bucle del agente de Codex, paso a paso, el arnés de Codex se encarga de ejecutar las llamadas a herramientas que genera el modelo. En las tareas de programación, la herramienta más utilizada es una herramienta de shell, que ejecuta comandos de forma similar a como lo haría un usuario en un shell interactivo como Bash. Aquí examinaremos la herramienta de shell (se abre en una ventana nueva)exec_command(se abre en una ventana nueva) de ejecución única(se abre en una ventana nueva) para ilustrar cómo utiliza el arnés el entorno aislado para lograr las protecciones deseadas.
Esta es una versión simplificada de cómo atendería el arnés de Codex una llamada a la herramienta exec_command sin aislamiento:
Para aislar el comando, el arnés sustituye la llamada a subprocess.Popen() por spawn_command_under_sandbox(). El arnés proporciona el perfil de permisos y, cuando es necesario, el proxy de red:
La herramienta exec_command también permite al modelo solicitar permisos distintos para un comando concreto, pero el arnés decide si concede la solicitud:
Cuando se especifica use_default, el arnés utiliza la configuración de aislamiento predeterminada para ese turno. with_additional_permissions solicita ampliar el acceso dentro del entorno aislado, mientras que require_escalated solicita ejecutar el comando fuera de él. El arnés evalúa la solicitud según las preferencias del usuario antes de ejecutar el comando. (Por ejemplo, Codex puede preguntar directamente al usuario o enviar la solicitud a revisión automática(se abre en una ventana nueva)). Si se autoriza la ejecución, Codex pasará los valores adecuados de permission_profile y network_proxy a perform_exec_command_with_sandboxing(), junto con los argumentos del comando de la llamada ExecCommandToolCall original.
La herramienta de shell es la principal usuaria de spawn_command_under_sandbox(), y el arnés también reutiliza su infraestructura de aislamiento para operaciones como leer y modificar archivos locales. Esta reutilización va más allá del arnés: el comando codex sandbox te permite incorporar la ejecución aislada de comandos a tus propias herramientas, como veremos más adelante. A continuación, veremos cómo se definen los perfiles de permisos.
Un perfil de permisos con nombre te permite reutilizar las mismas restricciones del sistema de archivos y de red en distintos proyectos. Puedes definir tus propios perfiles en la sección [permissions] de config.toml. Por ejemplo, lo siguiente define un perfil llamado dev que amplía(se abre en una ventana nueva) el perfil integrado :workspace:
El perfil dev añade acceso de escritura a ~/build-cache e impone restricciones adicionales a los archivos del espacio de trabajo. Las entradas del sistema de archivos pueden conceder acceso de solo lectura (read), conceder acceso de lectura y escritura (write) o bloquear por completo el acceso (deny).
La tabla :workspace_roots te permite definir reglas para rutas relativas a las raíces del espacio de trabajo de un proyecto. De forma predeterminada, la CLI de Codex utiliza su directorio de trabajo como única raíz del espacio de trabajo, mientras que la aplicación de escritorio de ChatGPT utiliza las carpetas de código fuente del proyecto. Codex aplica cada regla a todas las raíces, por lo que la entrada .vscode de dev hace que el directorio .vscode de cada raíz sea de solo lectura.
Además de sus propias reglas, dev hereda las siguientes protecciones de :workspace:
Para configurar la red del entorno aislado de Codex, hay, a grandes rasgos, tres opciones:
Desactivar todo el acceso a la red (opción predeterminada del perfil
:workspace)Activar el acceso completo y directo a la red (opción predeterminada del perfil
:danger-full-access)Restringir el acceso a la red a un proxy que decide qué tráfico permite según el perfil de permisos
Para dar a dev acceso directo a la red, establece permissions.dev.network.enabled = true en el nivel superior de config.toml. Esto concede acceso completo a la red cuando el proxy de red está desactivado.
Para restringir dev a un conjunto de dominios, activa el proxy de red y configura sus reglas de dominio:
Las reglas de dominio admiten nombres exactos y patrones con comodines. Las reglas de denegación explícita tienen prioridad sobre las de autorización. Las solicitudes a otros dominios requieren aprobación o se bloquean, como se describe en la sección Proxy de red más adelante.
Cada usuario puede configurar valores predeterminados para todos sus proyectos y sustituirlos en un proyecto de confianza concreto. Los administradores de empresas también pueden querer configurar valores predeterminados para sus usuarios y limitar qué ajustes pueden cambiar. Codex admite ambas posibilidades mediante una configuración por capas y requisitos gestionados.
Como se describe en Prioridad de la configuración,(se abre en una ventana nueva) Codex combina los ajustes de varios archivos config.toml. Las tablas se combinan de forma recursiva y, cuando hay valores en conflicto, prevalece la fuente con mayor prioridad. Las matrices se sustituyen por completo.
Por eso los perfiles de permisos utilizan tablas para las rutas del sistema de archivos y los dominios de red. Un equipo puede añadir o sustituir entradas individuales en su propia configuración y heredar automáticamente los cambios en todas las demás entradas de la configuración base de la organización:
Los administradores también pueden aportar requisitos gestionados(se abre en una ventana nueva) mediante requirements.toml para limitar las opciones de configuración de los usuarios. Estos requisitos pueden proceder de varias fuentes, incluidos archivos del sistema y políticas proporcionadas desde la nube. Un caso de uso habitual es especificar allowed_permission_profiles para limitar los perfiles de permisos que puede seleccionar un usuario de la empresa. Por ejemplo, un administrador podría especificar estos requisitos en la nube:
Los requisitos de la nube tendrían prioridad sobre el archivo de requisitos del sistema situado en /etc/codex/requirements.toml, por lo que una entrada de ese archivo no puede anular el ajuste explícito ":danger-full-access" = false anterior. Dejar :workspace sin especificar permite que otra capa de requisitos aporte esa entrada. Los perfiles cuyas entradas sean false o no figuren en la tabla combinada final no estarán disponibles.
Esta separación permite a las organizaciones imponer límites y a los usuarios adaptar su configuración dentro de ellos. El arnés puede utilizar los perfiles de permisos resultantes, o estos pueden aplicarse directamente a un comando, como veremos a continuación.
La CLI de Codex proporciona un comando sandbox que facilita la ejecución de cualquier comando con un perfil de permisos definido en la configuración de Codex. Suele utilizarse para probar el perfil y comprobar que el entorno aislado impide el comportamiento que se diseñó para bloquear.
Por ejemplo, el siguiente comando intenta configurar VS Code para ejecutar un formateador automático malicioso al guardar. Si .vscode ya existe, el perfil dev definido antes debería bloquear esta escritura porque ese directorio es de solo lectura (codex sandbox trata cwd como raíz del espacio de trabajo de forma predeterminada):
En efecto, en macOS falla con el siguiente mensaje:
El comando codex sandbox permite utilizar el mecanismo de aislamiento de Codex con independencia de una sesión del agente. Puedes utilizar el mismo lenguaje de configuración y los mecanismos de aplicación específicos de cada plataforma para restringir los comandos que inicien tus propias herramientas.
Para un servidor MCP con transporte stdio configurado en config.toml, el arnés de Codex no intenta aislar el comando utilizado para iniciar el servidor. Codex no puede deducir de forma fiable qué archivos o servicios de red necesita ese servidor, por lo que aplicar un perfil de aislamiento predeterminado podría impedir el funcionamiento de una configuración válida.
Por ejemplo, la forma habitual de configurar el servidor MCP @modelcontextprotocol/server-memory(se abre en una ventana nueva) para utilizarlo con Codex es la siguiente:
Como este comando npx se ejecuta sin aislamiento, puede escribir archivos y realizar solicitudes de red con los mismos permisos que el usuario que ejecuta Codex, lo que resulta demasiado permisivo. Para restringirlo, podemos definir un perfil de permisos llamado memory-mcp y ejecutar el comando npx original a través de codex sandbox --permission-profile memory-mcp. Así limitamos dónde puede escribir el servidor y le impedimos acceder a la red:
Antes de iniciar el servidor, crea su directorio de datos y guarda en la caché de npm la versión fijada del paquete. Esto permite que npx --offline inicie el servidor con un perfil que desactiva el acceso a la red:
Una vez que el paquete está en caché, Codex puede iniciar el servidor de memoria sin acceso a la red y con la escritura limitada a la caché de npm y al directorio de datos del servidor.
La implementación del entorno aislado convierte un perfil de permisos en restricciones que aplica el sistema operativo. Los tres sistemas operativos principales comparten la lógica central de gestión de solicitudes y políticas del proxy de red, mientras que la configuración del proxy y su integración con el entorno aislado son específicas de cada sistema. Examinaremos primero el proxy compartido y, después, las implementaciones para macOS, Linux y Windows.
Para aplicar las restricciones de red de un perfil de permisos, el arnés inicia un proxy de red y configura el entorno aislado para permitir las conexiones con él y bloquear las conexiones directas con equipos externos. El proxy comprueba cada solicitud según las reglas de dominio del perfil para decidir si la reenvía.
En el repositorio de Codex, el proxy de red se implementa en el crate codex-network-proxy(se abre en una ventana nueva), que el arnés utiliza como biblioteca, aunque también se puede compilar como una CLI independiente(se abre en una ventana nueva). Cuando se activa, codex-network-proxy inicia de forma predeterminada tanto un proxy HTTP como un proxy SOCKS5. Las direcciones de estos proxies se comunican al proceso creado por el entorno aislado mediante variables de entorno. Además de inyectar variables de entorno estándar como HTTP_PROXY, HTTPS_PROXY y ALL_PROXY, también se inyectan varias variables de entorno específicas de aplicaciones(se abre en una ventana nueva) de uso habitual, como PIP_PROXY. Es cierto que no todos los programas respetan estas variables de entorno. Si un programa intenta conectarse directamente a un equipo externo, las restricciones de aislamiento del sistema operativo lo bloquean, como se describe más adelante en las secciones de cada plataforma.
El proxy de red se encarga de aplicar las restricciones de red definidas en un perfil de permisos. Por ejemplo, el perfil dev mostrado antes permite las solicitudes a *.openai.com y deniega explícitamente las dirigidas a evil.example. Cuando una solicitud se dirige a un dominio que no coincide con ninguna regla de autorización o denegación, el proxy puede suspenderla mientras delega su aprobación al arnés. Como en el ejemplo del comando de shell, Codex puede preguntar directamente al usuario o enviar la solicitud a revisión automática(se abre en una ventana nueva). Al recibir una decisión, el proxy permite que la solicitud continúe o la rechaza con una respuesta de error.
El orden es importante, porque incluso una consulta DNS puede filtrar información codificada en un nombre de host. Por ello, el proxy solo resuelve el nombre de host solicitado después de determinar que está permitido o aprobado. Ten en cuenta que las reglas con comodines demasiado amplias o el acceso a servicios DNS aún pueden permitir la exfiltración mediante DNS.
En macOS, Codex utiliza Seatbelt(se abre en una ventana nueva), el mecanismo de aislamiento de Apple que aplica el núcleo del sistema. Las políticas de Seatbelt se escriben en Sandbox Profile Language (SBPL), un lenguaje basado en Scheme para expresar restricciones de aislamiento. Codex invoca Seatbelt mediante el comando /usr/bin/sandbox-exec de macOS. Al igual que codex sandbox, recibe opciones que describen el entorno aislado, seguidas del comando que se ejecutará:
PROFILE es una cadena de SBPL que contiene entradas para configurar el entorno aislado. Por ejemplo, el siguiente fragmento de SBPL permite leer y escribir en /dev/null y /dev/zero según la política del entorno aislado:
Cuando el proxy de red se activa como parte de una invocación del entorno aislado, se inyectan en el perfil reglas como las siguientes para limitar las conexiones a los puertos locales correspondientes:
El perfil base de Codex comienza con (deny default), por lo que las conexiones salientes siguen bloqueadas salvo que se permitan explícitamente.
Por último, el SBPL puede contener marcadores de posición mediante (param):
que se rellenan con las opciones -Dkey=value que se pasan a sandbox-exec.
Para implementar su propia API de aislamiento, Codex construye la lista de argumentos(se abre en una ventana nueva) de sandbox-exec a partir de una política base(se abre en una ventana nueva). Después utiliza permission_profile y otros datos de contexto para modificarla y generar el perfil completo de Seatbelt. El perfil resultante y los argumentos -D que lo acompañan configuran las restricciones que aplica Seatbelt, mientras que el proxy de red aplica reglas de red adicionales. Una vez reunida la lista completa de argumentos, invocar sandbox-exec es sencillo.
Generar el SBPL correcto es complicado porque Apple no documenta el lenguaje para su uso por terceros. De hecho, man sandbox-exec indica The sandbox-exec command is DEPRECATED (al igual que la función de biblioteca sandbox_init(), documentada en man 3 sandbox_init). Pese al aviso de obsolescencia, macOS sigue incluyendo perfiles de Seatbelt en /usr/share/sandbox, y el software de terceros, incluidos Google Chrome y Chromium(se abre en una ventana nueva), sigue dependiendo de Seatbelt. Por ello, prevemos seguir utilizando Seatbelt en el futuro próximo.
Para crear el entorno aislado en Linux, Codex combina bubblewrap(se abre en una ventana nueva) (bwrap), una herramienta de línea de comandos para construir entornos aislados, y seccomp-bpf(se abre en una ventana nueva), un mecanismo del núcleo de Linux para filtrar llamadas al sistema. Una herramienta auxiliar interna llamada codex-linux-sandbox coordina la configuración. Al igual que sandbox-exec en macOS, recibe una configuración del entorno aislado seguida del comando que se ejecutará:
Cuando se necesita aislar el sistema de archivos o enrutar las conexiones a través de un proxy, codex-linux-sandbox invoca bwrap para crear el entorno aislado inicial. A continuación, bwrap inicia codex-linux-sandbox --apply-seccomp-then-exec dentro de él. Esta segunda invocación utiliza seccomp-bpf para aplicar restricciones adicionales antes de ejecutar el comando del usuario.
Para construir ese entorno aislado inicial, Codex utiliza bubblewrap para crear una vista del sistema de archivos en un espacio de nombres de montaje independiente que refleja las reglas del sistema de archivos del perfil de permisos. Como esto es fundamental para implementar el aislamiento, Codex incluye su propia copia de bwrap por si el usuario no ha instalado una, pero da preferencia a una instalación compatible de (se abre en una ventana nueva)bwrap(se abre en una ventana nueva) que encuentre en PATH, si está disponible. Hemos comprobado que algunas distribuciones de Linux desactivan de forma predeterminada el acceso a los espacios de nombres de usuario(se abre en una ventana nueva), pero hacen una excepción para el bwrap del sistema.
Al igual que sandbox-exec, bwrap recibe una configuración del entorno aislado seguida de un comando que se ejecutará dentro de él. En lugar de utilizar un lenguaje de configuración propio como SBPL, bwrap se configura mediante opciones individuales. Codex utiliza las siguientes opciones para crear la vista del sistema de archivos:
--bindpara especificar un archivo o directorio con acceso de escritura--ro-bindpara especificar un archivo o directorio de solo lectura--perms 000 --tmpfs DIR --remount-ro DIRpara denegar el acceso aDIR--perms 000 --ro-bind-data FD FILEpara denegar el acceso aFILE(dondeFDes un descriptor de archivo abierto que apunta a/dev/null)
Para aplicar patrones glob de denegación con estas opciones, Codex los expande a rutas concretas antes de iniciar cada comando. Las nuevas rutas que coincidan con esos patrones no se añaden automáticamente a las restricciones del entorno aislado de ese comando.
Codex también especifica opciones como --unshare-ipc y --unshare-pid para impedir que el entorno aislado acceda a otros tipos de recursos del sistema anfitrión, por lo que bubblewrap no solo afecta a la visibilidad de los archivos.
Al utilizar bubblewrap, Codex pasa --unshare-net siempre que la red está desactivada o las conexiones deben pasar por el proxy de red. Esto crea un nuevo espacio de nombres de red para el entorno aislado. Después utilizamos seccomp-bpf para aplicar restricciones adicionales a las llamadas al sistema de red y a las familias de sockets disponibles para el comando.
En concreto, utilizamos el crate seccompiler(se abre en una ventana nueva) para compilar dinámicamente un programa BPF a partir de los filtros deseados(se abre en una ventana nueva) y aplicarlo a un proceso lanzador dentro del entorno aislado, de modo que todo el árbol de procesos herede las restricciones. Por tanto, bwrap no ejecuta el comando del usuario, sino el lanzador codex-linux-sandbox con sus propios argumentos de configuración seguidos del comando del usuario:
Para aplicar filtros seccomp sin privilegios elevados, el lanzador activa el indicador no_new_privs de Linux(se abre en una ventana nueva). Los procesos hijo heredan este indicador, que les impide obtener privilegios adicionales al ejecutar otro programa, como un ejecutable setuid.
Los filtros seccomp dependen de la configuración de red. Cuando el acceso a la red está desactivado, bloqueamos varias llamadas al sistema relacionadas con la red, como connect(2) y bind(2). En cambio, cuando el proxy de red está activado en el entorno aislado, permitimos los sockets IP para que se pueda acceder al socket de escucha TCP creado por codex-linux-sandbox, pero bloqueamos de forma predeterminada la creación de sockets de dominio Unix independientes, ya que podrían permitir el acceso involuntario a recursos del sistema anfitrión.
Cuando la configuración del entorno aislado requiere el proxy de red, el arnés de Codex crea una instancia del proxy que se puede reutilizar en varias invocaciones de codex-linux-sandbox dentro del mismo hilo de Codex. Cada entorno aislado necesita una forma de acceder a ese proxy compartido desde su espacio de nombres de red aislado. Codex proporciona un socket de escucha TCP de bucle local dentro de ese espacio de nombres y configura un proceso externo al entorno aislado para que acepte sus conexiones y las retransmita al proxy.
Los siguientes diagramas ilustran esta configuración para un punto de acceso del proxy. El último muestra una conexión que pasa por él. Antes de iniciar bubblewrap, codex-linux-sandbox crea un par de sockets Unix que sirve de canal de control y se bifurca. El proceso hijo ejecuta run_host_bridge() y espera a recibir el descriptor de archivo del socket de escucha por ese canal:
En este ejemplo, el proceso padre utiliza exec para sustituir su imagen de programa por bwrap. Este configura el entorno aislado e inicia codex-linux-sandbox --apply-seccomp-then-exec dentro de él, al que pasa el descriptor de archivo del canal de control:
Dentro del espacio de nombres de red del entorno aislado, la segunda invocación de codex-linux-sandbox crea un socket de escucha TCP de bucle local y pasa su descriptor de archivo a través del socket. El socket de escucha sigue asociado al espacio de nombres de red del entorno aislado. Así, el proceso hijo que ha permanecido fuera puede aceptar conexiones de programas aislados y, a la vez, abrir sus conexiones de salida en el espacio de nombres de red del sistema anfitrión. Tras la transferencia, ambos procesos cierran sus descriptores del canal de control, y el proceso dentro del entorno aislado cierra su copia del socket de escucha.
Una vez que el socket de escucha TCP está listo, el proceso dentro del entorno aislado establece el valor adecuado de HTTP_PROXY(se abre en una ventana nueva) y de las variables de entorno relacionadas para que apunten a ese socket. A continuación, aplica seccomp antes de bifurcarse y ejecutar el comando del usuario:
El proceso externo al entorno aislado mantiene abierto el socket de escucha. Por cada conexión aceptada, abre una conexión con el proxy configurado y retransmite los datos en ambos sentidos.
Este mecanismo adicional proporciona al comando su propio espacio de nombres de red, con una interfaz de bucle local independiente. En macOS, Seatbelt permite que el comando se conecte directamente a puertos específicos de la interfaz de bucle local del sistema anfitrión. En Linux, en cambio, el comando se conecta a un socket de escucha dentro de su espacio de nombres aislado, y un proceso externo al entorno aislado retransmite esas conexiones al proxy configurado. La transferencia del descriptor permite esta conexión sin exponer al comando el espacio de nombres de red del sistema anfitrión.
A principios de este año, implementamos el aislamiento en Windows y publicamos un artículo sobre nuestro trabajo al respecto. Desde entonces, Microsoft ha publicado una biblioteca llamada MXC junto con nuevas funciones de aislamiento de procesos en el sistema operativo Windows. Actualmente estamos sustituyendo nuestro entorno aislado por otro que utiliza la biblioteca MXC.
MXC (Microsoft eXecution Container) es un sistema de ejecución de código en entornos aislados(se abre en una ventana nueva) de Microsoft que admite varios motores de aislamiento en Windows, Linux y macOS. Codex admite un entorno aislado basado en MXC en dispositivos Windows compatibles y utiliza el aislamiento nativo de procesos para restringir los comandos dentro del entorno existente del usuario.
Estamos migrando a MXC para mejorar la seguridad y la usabilidad y resolver varias limitaciones de nuestro entorno aislado actual para Windows:
Necesidad de privilegios elevados o de administrador para configurar el entorno aislado
Operaciones de comprobación y configuración de ACL costosas y lentas
Estado de configuración del entorno aislado que persiste en el equipo anfitrión, incluidos
ACL
Reglas del cortafuegos
Usuarios del entorno aislado
Archivos del plano de control
MXC expone un esquema de configuración JSON(se abre en una ventana nueva). Codex utiliza el SDK de MXC(se abre en una ventana nueva) para construir una solicitud de ejecución que sigue ese esquema y contiene el comando, el directorio de trabajo, el entorno y los permisos. Esos permisos abarcan el acceso al sistema de archivos y a la red, además de recursos de Windows como el escritorio y el portapapeles.
Codex utiliza ajustes fijos para varios controles con el fin de equilibrar la compatibilidad y la seguridad. Permite leer el registro y mantiene el acceso a Win32k y al escritorio que PowerShell necesita durante el inicio. El acceso al portapapeles, la inyección de entradas y los controles del escritorio y de la configuración del sistema están desactivados. Por último, se impide que MXC recurra a modificar los permisos del sistema de archivos del equipo anfitrión.
Codex convierte las reglas del sistema de archivos y de red del perfil de permisos en la configuración de MXC. Si usamos el perfil dev anterior y suponemos que:
C:\,D:\yZ:\son las únicas unidades locales del equipo.La raíz del espacio de trabajo y el directorio de trabajo son
C:\work\demo.El directorio personal del usuario es
D:\Users\dev, por lo que~/build-cachese resuelve comoD:\Users\dev\build-cache.El patrón glob de denegación solo coincide con
C:\work\demo\config\dev.envyC:\work\demo\config\prod.env.
Los ajustes de MXC correspondientes incluirían:
La política del sistema de archivos de MXC deniega el acceso de forma predeterminada. Por ello, Codex añade permisos de solo lectura para las raíces de las unidades locales a fin de ofrecer el amplio acceso de lectura que permite este perfil. Estos permisos se aplican de forma recursiva, sujetos a los permisos que el usuario ya tiene en el sistema operativo.
Hay una particularidad: los permisos de escritura en la raíz de una unidad no se aplican de forma recursiva, por lo que Codex los amplía para incluir los elementos directamente contenidos en ella que ya existen.
Las rutas más específicas prevalecen sobre los permisos de sus antecesoras, por lo que C:\work\demo puede permitir la escritura dentro de una unidad C:\ de solo lectura, mientras que C:\work\demo\.git sigue siendo de solo lectura.
Cuando distintas formas de escribir una ruta o alias mediante enlaces simbólicos o uniones de directorios apuntan a la misma ruta, MXC aplica el permiso más restrictivo: la denegación prevalece sobre la solo lectura, que a su vez prevalece sobre la lectura y escritura.
MXC solo acepta rutas concretas de denegación, por lo que Codex expande los patrones glob de denegación a los archivos y directorios coincidentes antes de iniciar el comando. Las nuevas rutas que coincidan con el patrón glob no se añaden automáticamente mientras se ejecuta el comando.
El proxy de red compartido de Codex descrito antes aplica las reglas de dominio, como *.openai.com. Codex ejecuta ese proxy fuera del entorno aislado y pasa sus direcciones al comando mediante las mismas variables de entorno estándar *_PROXY mencionadas antes. MXC bloquea las conexiones externas directas, pero permite las conexiones de bucle local del sistema anfitrión, incluido el acceso al proxy. Los demás servicios locales siguen siendo accesibles.
En macOS, Linux y Windows, el arnés utiliza la misma API de aislamiento para iniciar comandos con un perfil de permisos. Las implementaciones específicas de cada plataforma se encargan de la configuración necesaria para aplicar esas restricciones.
Escribir y ejecutar código ofrece a los agentes una forma flexible de resolver problemas más allá del desarrollo de software. El entorno aislado de Codex les permite utilizar esa capacidad en el entorno existente del usuario, con límites explícitos de acceso al sistema de archivos y a la red. Es un componente básico reutilizable dentro del arnés, y el comando codex sandbox permite incorporarlo a las herramientas que tú desarrolles.
A medida que los agentes asumen más tareas, queremos que el aislamiento resulte práctico para más herramientas y entornos. Esto implica facilitar la configuración de permisos y aprovechar las mejoras en las protecciones de los sistemas operativos a medida que estén disponibles. Nuestro objetivo es ampliar lo que pueden hacer los agentes sin que las personas pierdan el control sobre los recursos a los que estos pueden acceder.


