Un entorno de trabajo sin secretos + ajustes que rechacen las lecturas. Primero, combina estos dos elementos.

Los ajustes de solo lectura, aprobación y entrenamiento cumplen funciones distintas. Comprueba por separado si realmente pueden impedir el acceso a los archivos secretos.

Comprueba por separado «leer», «ejecutar» y «enviar»

Alcance de lectura

Quita del entorno de trabajo los secretos innecesarios. Para los archivos objetivo, considera usar deny para rechazar las lecturas.

Operaciones que cruzan el límite

Revisa quién aprueba. No amplíes el límite con Full access ni con permisos para ejecutar fuera del sandbox.

Comunicación y otras herramientas

Revisa por separado el acceso a red de los comandos, el envío al modelo y el navegador, MCP, etc.

Leer, ejecutar y enviar se detienen con ajustes separados.

1. Diferencias entre los ajustes de solo lectura, aprobación y entrenamiento

«No poder modificar un archivo» y «no poder leer un archivo» son cosas distintas.

read-only

Modo que restringe la escritura. No es una función que bloquee el contenido de los archivos legibles como si fueran secretos.

workspace-write

Especifica dónde se puede editar. El alcance de lectura no se limita necesariamente al mismo lugar.

ControlPrincipalmente decideLo que no garantiza por sí solo
Solo lecturaSi los archivos pueden modificarseQue no se lean los archivos secretos accesibles
Política de aprobaciónQuién revisa las operaciones que cruzan el límiteQue las lecturas dentro del alcance permitido se confirmen cada vez por una persona
deny de archivosDenegar lecturas y escrituras en la ruta objetivoEliminar contenido ya pegado o accesos mediante otras herramientas
Límites de acceso a red de los comandosDestinos de comunicación de los comandos dentro del sandboxDetener todas las comunicaciones del modelo, la autenticación, el navegador, MCP, etc.
Ajustes de entrenamientoSi los datos procesados se usan para mejorar los modelosDetener el procesamiento o el envío en sí

on-request sigue permitiendo que los comandos dentro del alcance permitido se ejecuten sin aprobación adicional. Si quieres confirmación humana, revisa tanto la política de aprobación como quién revisa.

Diferencia con la revisión automática por IA

approvals_reviewer = "auto_review" es un ajuste que envía la revisión de los objetivos a la IA. No es confirmación humana, ni tampoco un ajuste que añada revisión a todas las operaciones que ya estaban permitidas.

Fuente: OpenAI: límites de aprobación y sandbox. Sobre el entrenamiento, consulta por separado Ajustes de entrenamiento de ChatGPT y Codex e información confidencial.

2. Primero, separa los secretos del entorno de trabajo

Para corregir una pantalla, puede bastar con el código fuente y datos ficticios. No hace falta tener en el mismo entorno las claves API de producción, los datos de clientes ni los documentos familiares.

Mover los archivos a otra carpeta no basta. Si queda un permiso de lectura amplio, es posible que aún se pueda llegar a los archivos movidos.

En la copia de trabajo, solo lo necesario

1
Prepara el código fuente y datos ficticios

En lugar de datos de producción, usa una entrada pequeña que permita reproducir el problema.

2
No introduzcas valores secretos

En los ejemplos de configuración, incluye solo los nombres de las claves. Revisa también los registros, las copias de seguridad y el historial.

3
Comprueba los permisos de ese entorno

Mira si puede llegar a otras carpetas, al directorio personal, a almacenamiento compartido o a aplicaciones conectadas.

Incluso en una copia de trabajo, un usuario distinto o un contenedor, si existen una carpeta compartida o credenciales entregadas, revisa ese alcance por separado.
¿Los ajustes de ignorar de Git pueden detener las lecturas?

.gitignore especifica los archivos no rastreados que Git ignora. No es un mecanismo que elimine el permiso de lectura del sistema operativo. Aunque una herramienta de búsqueda normalmente los ignore, eso no garantiza que se rechacen las lecturas por ruta directa. Además, los ajustes de ignorar añadidos después no surten efecto por sí solos en archivos que Git ya rastrea. Git oficial: qué cubre gitignore.

Diferencia entre una instrucción y un rechazo técnico

Escribir «no leas secretos» en AGENTS.md es útil como instrucción de trabajo. Sin embargo, por sí solo no crea una restricción de acceso a nivel del sistema operativo. Lo básico es combinar las instrucciones con un rechazo técnico. Para ver ejemplos concretos de anonimización de entradas, consulta también Precauciones al introducir información en una IA.

3. Ejemplos de configuración que deniegan lecturas

Permission profiles es una función beta. Antes de usarla, comprueba el entorno compatible y la configuración seleccionada en la sesión actual.

read: lectura

Permiso para leer el objetivo

write: edición

Permite escribir en el objetivo

deny: denegación

Deniega la lectura y la escritura del objetivo

Cuidado con la combinación con la configuración de sandbox anterior
Si quedan ajustes antiguos, es posible que Permission profiles no se use.

Revisa los ajustes en conflicto y los controles del administrador

No mezclar con la configuración anterior: default_permissions y [permissions] no son un método para usarse junto con sandbox_mode y [sandbox_workspace_write] de la configuración anterior. Normalmente, si la configuración cargada contiene sandbox_mode, o si al iniciar se pasa --sandbox, se usa el método antiguo. El control mediante allowed_permission_profiles del administrador es una condición aparte.

A continuación, un ejemplo de configuración que combina el ejemplo oficial de limitación del área de trabajo con la denegación de archivos secretos y la aprobación humana. No reemplaces por completo tu configuración existente: verifica la versión compatible, las restricciones de la organización y las rutas de ejecución que necesites, y compruébalo en un entorno ficticio.

Dónde escribir los ajustes: de usuario y de proyecto
Ajustes de usuario

~/.codex/config.toml

Ajustes de proyecto

.codex/config.toml

Su ámbito y sus condiciones de carga son distintos. Los ajustes de proyecto solo se cargan en proyectos de confianza.

Ejemplo de configuración: denegar archivos secretos y desactivar el acceso a red de los comandos
default_permissions = "project-private"
approval_policy = "on-request"
approvals_reviewer = "user"

[permissions.project-private]
extends = ":workspace"

[permissions.project-private.filesystem]
":root" = "deny"
":minimal" = "read"

[permissions.project-private.filesystem.":workspace_roots"]
".env" = "deny"
".env.production" = "deny"
"secrets" = "deny"

[permissions.project-private.network]
enabled = false

¿Qué queda cubierto por este ejemplo de configuración?

Se aplica al área de trabajo actual y a cada área de trabajo añadida

.envObjetivo denegado
.env.productionObjetivo denegado
secrets/ y su contenidoObjetivo denegado
subcarpeta/.envComprobar aparte en este ejemplo
Mismo secreto con otro nombre o copias en registrosComprobar aparte en este ejemplo
Diagrama conceptual que muestra el alcance de las reglas de denegación.
Fuera del área de trabajo

Las lecturas se deniegan con :root. Sin embargo, son excepciones :minimal, necesario para la ejecución, y los directorios temporales que permite el perfil heredado.

Dentro del área de trabajo

Hereda :workspace para permitir la edición y deniega las rutas específicas indicadas arriba. No es un ejemplo que detecte secretos incrustados en la salida.

Notas sobre el nombre del ajuste, varios alcances y archivos temporales

project-private es el nombre que se le dio en este ejemplo. :workspace_roots se aplica al área de trabajo actual y a las áreas añadidas, e indica las rutas objetivo directamente bajo cada una. secrets se refiere al archivo o subárbol con el mismo nombre.

No es una configuración que impida leer todo lo que esté fuera del área de trabajo. También necesitas una práctica de no copiar secretos a áreas temporales.

Fuente: OpenAI: configuración, denegación y alcance de Permission profiles.

4. Patrones de .env y ámbitos fáciles de pasar por alto

Especificar la ruta exacta encaja con los secretos en ubicaciones fijas. Si usas patrones, ten en cuenta que *.env y .env.* son cosas distintas. No te fíes solo del ejemplo oficial **/*.env para pensar que .env.production también puede denegarse con la misma condición.

Ejemplo de patrónObjetivo previstoComprobar por separado
.envArchivo con el mismo nombre directamente en el área de trabajoSubcarpetas y archivos cuyo nombre lleva un sufijo
.env.productionArchivo de configuración de producción directamente en la raízConfiguración de producción con otro nombre, o copias
secretsRuta con el mismo nombre directamente en la raíz y lo que contieneCopias en otras ubicaciones, como registros o copias de seguridad
**/*.envArchivos cuyo nombre termina en .env en varios nivelesNombres con sufijos; profundidad de búsqueda y cambios tras el inicio

Comprobar la profundidad y las adiciones tras el inicio

En Linux, WSL y Windows nativo, los patrones de denegación que incluyen ** sin límite pueden necesitar una expansión limitada al alcance antes del inicio. La documentación oficial explica cómo establecer glob_scan_max_depth en 1 o más, o cómo indicar la profundidad de forma explícita, como en *.env, */*.env o */*/*.env. Si usas niveles profundos, debes comprobar hasta esa profundidad.

Los archivos creados después pueden seguir siendo legibles. Según la explicación oficial, en Linux, WSL y Windows (MXC o elevated), los archivos que coinciden con los patrones de denegación se enumeran al iniciar cada proceso. Los archivos coincidentes creados mientras ese proceso está en marcha no entran en la denegación y pueden leerse si otros permisos lo permiten. Por ejemplo, una shell o un servidor de desarrollo que ya estén en ejecución pueden leer un .env creado después. Como la enumeración se vuelve a hacer al iniciar un proceso nuevo, si creas un archivo secreto, reinicia los procesos en marcha.

¿Qué prevalece cuando se solapan permisos?

Una ruta más específica puede sobrescribir una más amplia. Para la misma ruta prevalece deny, pero también es posible crear un permiso estrecho dentro de una denegación amplia. Revisa también las capas adicionales de configuración y la herencia de los perfiles padre.

Fuentes: OpenAI: denegar lecturas por ruta exacta o patrón, orden de carga de la configuración. El .codex/config.toml del proyecto solo se carga en proyectos de confianza. Distingue entre lo que está escrito en el archivo y lo que está activo en la sesión actual.

5. Qué se detiene al desactivar el acceso a red de los comandos y qué no

Al desactivar el acceso a red de los comandos, puedes restringir el uso de red de los programas que se ejecutan dentro del sandbox correspondiente. Sin embargo, las solicitudes de modelo y autenticación del cliente de Codex son independientes del control de red de los comandos. No supongas que la ruta por la que el código leído pasa al contexto del modelo queda bloqueada solo porque el acceso a red de los comandos está desactivado.

Alcance que alcanza la restricción de red de los comandos

Objetivo: dentro del sandbox

Comunicación de los comandos, scripts y sus procesos hijos.

Gestión aparte: otras rutas

Modelo y autenticación, búsqueda web, aplicaciones conectadas, MCP, navegador y Computer Use, tareas en la nube.

Las herramientas gestionadas aparte deben revisarse con sus propios controles de conexión, permisos y entorno.

Para permitir el acceso a red y, al mismo tiempo, limitar los destinos, necesitas activar el proxy de red además de las reglas de dominio. Escribir dominios permitidos en un perfil no surte efecto por sí solo.

Acceso a red de los comandosProxyResultado
DesactivadoCualquieraNo se permite el acceso a red de los comandos
ActivadoDesactivadoEs posible la comunicación directa, y las reglas de dominio del perfil no se aplican
ActivadoActivadoEl proxy aplica las reglas de dominio y rechaza los destinos externos que no estén permitidos

Incluso un destino permitido puede recibir secretos. Limitar los dominios no equivale a inspeccionar lo que se envía. Si apruebas la ejecución fuera del sandbox, no supongas que los ajustes de denegación actuales te siguen protegiendo; revisa qué amplía esa aprobación. OpenAI: condiciones de permisos de red y proxy.

6. Diferencias en variables de entorno, sistema operativo y nube

Los secretos no están solo en archivos. Si una clave API está en la shell, es posible que se use el valor de las variables de entorno transmitidas a los procesos hijos, aunque hayas denegado los archivos. La herencia de variables de entorno se gestiona aparte con shell_environment_policy.

Exclusión automática de variables de entorno: true y false

true (valor predeterminado)

No excluye automáticamente las variables cuyo nombre incluya KEY, SECRET o TOKEN

false

Aplica esa exclusión automática

Compara los valores de ignore_default_excludes. Es un control distinto del deny de archivos y, como la exclusión se basa en el nombre de la variable, no es un mecanismo que detecte todos los secretos.

No protege variables con otro nombre ni valores que un programa obtiene de otro lugar. set se aplica después del procesamiento de exclusión y puede restaurar variables excluidas. OpenAI: herencia de variables de entorno y prioridad.

Windows: comprueba también el modo del sandbox

Los Permission profiles locales se describen para macOS, Linux, WSL y Windows nativo, pero las implementaciones no son iguales. Windows tiene tres modos.

MXC (recomendado)

Microsoft Execution Containers. Es el modo recomendado en los dispositivos compatibles. No requiere preparación aprobada por el administrador ni una cuenta de Windows dedicada, y está disponible en las versiones compatibles de Windows 11 24H2 y 25H2.

elevated (respaldo prioritario)

Modo anterior que tiene prioridad cuando MXC no está disponible. Requiere una preparación aprobada por un administrador.

unelevated (otro respaldo)

El aislamiento de comunicación es débil y no admite rutas en las que se deniegan las lecturas. Los ajustes de protección de archivos secretos de este artículo no funcionan con este modo.

Fuente: OpenAI: Windows sandbox. Una política que no se puede admitir se rechaza al ejecutarla. Esto no significa que puedas cambiar a Full access solo porque apareció un error. OpenAI: cómo se aplica en cada sistema operativo.

Cloud: no reutilices la configuración local tal cual

Codex Cloud revisa por separado la configuración de su entorno en la nube. Un perfil local no se aplica automáticamente a toda la nube ni a dot (el agente de IA persistente de ChatGPT) en el lado de la nube. No reutilices tal cual los ejemplos de configuración local de este artículo como configuración para la nube. Las diferencias de ubicación de ejecución se explican en Condiciones de conexión de Codex Remote, Cloud y PC.

7. Pasos para verificar con datos ficticios

«Le indicamos que no leyera», «guardamos el ajuste» y «realmente fue rechazado» son pruebas distintas. No hace falta hacer que lea secretos reales para comprobarlo. Lo siguiente son los pasos de verificación que realiza el usuario o el administrador.

  1. Registra el objetivo: Anota la versión de Codex, el sistema operativo, la ubicación de ejecución y los permisos seleccionados. En la CLI, comprueba el alcance de trabajo con /status y el estado seleccionado con /permissions.
  2. Revisa los conflictos de configuración: Revisa los ajustes de usuario, los ajustes de proyecto de confianza, el perfil seleccionado, las marcas de inicio y las restricciones del administrador. Para el diagnóstico, no pegues en la conversación archivos de configuración completos ni valores secretos.
  3. Prepara datos ficticios: En un área de trabajo independiente que no contenga secretos, crea los archivos que se permitirán y los que se denegarán. Usa el contenido como marca de prueba.
  4. Comprueba tanto lo permitido como lo denegado: Confirma que el objetivo permitido se puede leer por la misma ruta de ejecución y que la lectura del objetivo denegado produce un error. Que Codex no haya leído algo por iniciativa propia no sirve como prueba de un rechazo técnico.
  5. Prueba las diferencias de ubicación: Revisa datos ficticios directamente en la raíz, en subcarpetas, con sufijos y creados después del inicio. No concedas aprobaciones que superen un rechazo. Si algo se puede leer de forma inesperada, deja de usar ese entorno e investiga la causa.
  6. Revisa también la ruta de salida: Comprueba si las pruebas o compilaciones escriben secretos en los registros, y si la misma información llega a otros MCP, navegadores o aplicaciones conectadas.

Lo que se puede verificar varía según la versión y la pantalla de la CLI, así que mira la pantalla real, no solo el nombre del comando. La CLI oficial también tiene una forma de comprobar por sistema operativo con codex sandbox. Sin embargo, confirma que la configuración probada con ese comando auxiliar coincide con la que está activa en tu sesión habitual de escritorio o IDE antes de confiar en ella.OpenAI: cómo probar el sandbox.

Lo que ya se leyó no se puede deshacer añadiendo un deny después. Revisa por separado las conversaciones anteriores, los registros, el almacenamiento de archivos y los ajustes de entrenamiento. No concluyas que la información se filtró a terceros solo porque un archivo era legible. Decide por separado qué se leyó, a dónde llegó y si las credenciales necesitan medidas.

Los usuarios han pedido excluir archivos secretos en un issue público de Codex. Para el comportamiento actual, consulta la documentación oficial de Permissions presentada arriba.

Premisa de este artículo: se escribió el 8 de octubre de 2026, principalmente sobre los comandos dentro del sandbox local, a partir de la documentación oficial de OpenAI sobre Permissions, Sandbox, aprobaciones y seguridad, y configuración. El modo de tratar los archivos creados después se volvió a comprobar en la documentación oficial el 19 de octubre, y los modos de Windows el 16 de octubre. El ejemplo de configuración no se ha aplicado en un entorno real, así que antes de usarlo, comprueba el rechazo con datos ficticios siguiendo los pasos anteriores.

Artículos relacionados: si quieres detener los cambios en el código fuente, consulta Cómo usar Codex y Claude Code en modo de solo lectura; si quieres que el trabajo continúe dentro del alcance permitido, consulta El modo Goal de Codex y cómo reducir las esperas de aprobación.

FAQ

¿Si es de solo lectura, .env no se enviará igualmente?

Sí, puede enviarse. La solo lectura solo limita los cambios. Para evitar que un .env legible llegue al contexto del modelo, comprueba por separado que la lectura del objetivo esté denegada y que el entorno de trabajo no contenga secretos.

¿Bastan .gitignore y AGENTS.md por sí solos?

No reemplazan el rechazo técnico de lecturas. Los ajustes de ignorar de Git, las instrucciones de trabajo y los permisos que aplica el sistema operativo son mecanismos distintos. Verifica con datos ficticios que deny funciona en tu entorno de ejecución actual.

Si desactivo el acceso a red, ¿Codex funciona por completo en el dispositivo?

No. La restricción de red de los comandos no es un ajuste que detenga la comunicación con el modelo y la autenticación. Los ajustes del navegador, MCP, las aplicaciones conectadas y la nube también son independientes.

Con este ejemplo de configuración, ¿puedo proteger completamente los secretos también en Windows?

Este ejemplo de configuración por sí solo no es suficiente. Revisa la compatibilidad de la función beta, el modo del sandbox (unelevated no admite la denegación de lecturas), las capas de configuración reales, las rutas y las herramientas que ejecutas, y verifica el rechazo con datos ficticios antes de usarlo.