Inicia 23 novCohorte 3 en vivo de Vibe Coding y Agentes IA: 3 semanas, 9 clases en directoCohorte 3 (23.11) →
LanzamientoCódigo / SDK · Listo para usarOpenAI Blog→ original

OpenAI muestra cómo el sandbox de Codex limita los comandos del agente en tu ordenador

Un agente que ejecuta comandos en tu portátil necesita límites, y OpenAI ha explicado cómo los fija el sandbox de Codex. En lugar de Docker, usa las herramientas integradas de macOS, Linux y Windows, de modo que el agente trabaja en el entorno habitual del desarrollador. Por defecto, solo puede escribir en la carpeta de trabajo y la red está desactivada. Por eso conviene crear un perfil de permisos para cada tarea en lugar de conceder acceso completo.

Procesado por IA desde OpenAI Blog; editado por Hamidun News
OpenAI muestra cómo el sandbox de Codex limita los comandos del agente en tu ordenador
Fuente: OpenAI Blog. Collage: Hamidun News.
Escuchar artículo
Ficha técnica y cifras clave
ParámetroDatos
Fuente originalOpenAI Blog ↗
Editor jefe
Perfiles de permisos en config.tomlread, write o deny para cada ruta
Dato clave #2Los administradores fijan los perfiles permitidos mediante requirements.toml
Dato clave #3El comando codex sandbox ejecuta cualquier proceso con el mismo perfil

Lo más arriesgado que hace un agente de programación es ejecutar comandos en tu ordenador. Un rm desafortunado o una subida silenciosa de archivos a un servidor ajeno, y las consecuencias se notan al instante. Michael Bolin, ingeniero de OpenAI, ha desglosado cómo funciona el sandbox de Codex. Este limita a qué pueden acceder los comandos del agente y lo hace sin máquinas virtuales.

Por qué no Docker

La forma habitual de aislar un programa es un contenedor o una máquina virtual. OpenAI ha tomado otro camino: Codex usa las herramientas de sandbox del propio sistema operativo y restringe los comandos dentro de tu entorno de siempre.

El argumento del equipo es práctico. El portátil de un desarrollador es un conjunto de ajustes personales y herramientas, y reproducirlo en Docker no es sencillo. El ejemplo del artículo: estás escribiendo una aplicación para iOS en un Mac.

Dentro de un contenedor, Codex no podría lanzar la compilación nativa ni el simulador de iPhone. Se pueden delegar esas operaciones al host, pero entonces se ejecutarían fuera del sandbox y necesitarían sus propias restricciones. Por eso OpenAI apuesta por el aislamiento a nivel de sistema en cada plataforma.

Para macOS, Linux y Windows existe una interfaz de programación única: se le pasa el comando y el perfil de permisos y, si se permite un acceso limitado a la red, también un proxy de red. Todos los procesos hijo heredan las restricciones del proceso padre, incluso los que sobreviven al comando original.

Qué está permitido por defecto

El perfil integrado :workspace elige valores prudentes con los que el agente aún puede trabajar:

  • La escritura solo está permitida en la carpeta de trabajo del proyecto. Los directorios .git y .codex permanecen en modo de solo lectura, así que el agente no puede sustituir los hooks de Git ni la configuración de Codex.
  • La lectura está permitida casi en todas partes, dentro de los permisos habituales del sistema operativo. Los compiladores y los sistemas de compilación necesitan bibliotecas fuera del repositorio. El artículo reconoce abiertamente la contrapartida: los archivos con claves de API ubicados en otros lugares también pueden ser legibles.
  • La red está desactivada. Esto cierra la exfiltración directa de datos, pero también impide descargar dependencias.

OpenAI admite sin rodeos que la protección es incompleta. En teoría, el agente puede introducir código dañino en un paquete local, por ejemplo node_modules/prettier. Git suele ignorar esas carpetas, y si el editor ejecuta ese Prettier al guardar un archivo, el código se ejecutará ya fuera del sandbox. Por eso la compañía describe su enfoque como «defensa en profundidad»: el sandbox limita el acceso, mientras que el entrenamiento y el alineamiento del modelo determinan cómo usa ese acceso.

Cómo configurar los perfiles

Los permisos se describen en config.toml mediante perfiles con nombre. Para cada ruta se indica read, write o deny, y un perfil puede heredar de uno integrado. En el ejemplo, el perfil dev amplía :workspace: concede escritura en ~/build-cache, deja .vscode y .devcontainer en solo lectura y bloquea por completo los archivos .env y la carpeta secrets.

Para la red hay tres opciones: desactivarla del todo (por defecto), abrirla por completo (perfil :danger-full-access) o canalizar el tráfico a través de un proxy con reglas por dominio. En las reglas funcionan los nombres exactos y las máscaras, y un deny explícito prevalece sobre allow. Las solicitudes al resto de dominios se bloquean o requieren confirmación.

Para las empresas hay una configuración por capas. Las tablas de distintos config.toml se fusionan de forma recursiva, mientras que los arrays se sustituyen por completo. Mediante requirements.toml, el administrador define la lista de perfiles admitidos; por ejemplo, permite :read-only y prohíbe :danger-full-access. Los requisitos en la nube tienen prioridad sobre el archivo local /etc/codex/requirements.toml, y el usuario no puede saltarse la prohibición.

El modelo también puede pedir más permisos para un comando concreto: acceso ampliado dentro del sandbox o ejecución fuera de él. Quien decide no es el modelo, sino la capa que lo envuelve (harness): preguntará al usuario o enviará la solicitud a una revisión automática.

Un sandbox para tus propias herramientas

El comando codex sandbox merece una mención aparte. Ejecuta cualquier proceso con un perfil de la configuración de Codex y resulta útil para probar tus propias reglas. En el ejemplo, un intento de escribir un .vscode/settings.json malicioso con el perfil dev en macOS termina con el error «Operation not permitted».

La segunda idea es aislar los servidores MCP. Codex no intenta restringirlos por sí mismo: no sabe a qué archivos ni redes necesita acceder el servidor. Por eso, un arranque mediante npx funciona con todos los permisos del usuario. OpenAI propone envolver el comando en codex sandbox con el perfil memory-mcp: escritura solo en ~/mcp-data y ~/.npm, sin red, con el paquete fijado por versión y lanzado mediante npx --offline. El directorio de datos y la caché de npm hay que prepararlos de antemano.

La conclusión para los equipos: no dejéis al agente con acceso completo. Crea un perfil para cada tarea, protege los secretos con deny y comprueba las reglas con comandos deliberadamente maliciosos. Si esta configuración te parece excesiva, recuerda el caso de Prettier: el sandbox reduce el riesgo, pero no lo elimina por completo.

Historia

Preguntas frecuentes sobre la noticia

¿Qué se sabe sobre Por qué no Docker?

La forma habitual de aislar un programa es un contenedor o una máquina virtual. OpenAI ha tomado otro camino: Codex usa las herramientas de sandbox del propio sistema operativo y restringe los comandos dentro de tu entorno de siempre. El argumento del equipo es práctico. El portátil de un desarrollador es un conjunto de ajustes personales y herramientas, y reproducirlo en Docker no es sencillo. El ejemplo del artículo: estás escribiendo una aplicación para iOS en un Mac.

¿Qué se sabe sobre Qué está permitido por defecto?

El perfil integrado :workspace elige valores prudentes con los que el agente aún puede trabajar: La escritura solo está permitida en la carpeta de trabajo del proyecto. Los directorios .git y .codex permanecen en modo de solo lectura, así que el agente no puede sustituir los hooks de Git ni la configuración de Codex. La lectura está permitida casi en todas partes, dentro de los permisos habituales del sistema operativo. Los compiladores y los sistemas de compilación necesitan bibliotecas fuera del repositorio.

Cómo configurar los perfiles?

Los permisos se describen en config.toml mediante perfiles con nombre. Para cada ruta se indica read, write o deny, y un perfil puede heredar de uno integrado. En el ejemplo, el perfil dev amplía :workspace: concede escritura en ~/build-cache, deja .vscode y .devcontainer en solo lectura y bloquea por completo los archivos .env y la carpeta secrets.

ZK
Zhemal Khamidun — CPO de Alpina Digital, product manager de AlpinaGPT. Crea productos de IA desde 2019. Hamidun News es un proyecto personal que creció hasta ser un agregador en producción con más de 6.000 lectores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
¿Qué te parece?
Cargando comentarios…