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»
Quita del entorno de trabajo los secretos innecesarios. Para los archivos objetivo, considera usar deny para rechazar las lecturas.
Revisa quién aprueba. No amplíes el límite con Full access ni con permisos para ejecutar fuera del sandbox.
Revisa por separado el acceso a red de los comandos, el envío al modelo y el navegador, MCP, etc.
Índice
- 1. Diferencias entre los ajustes de solo lectura, aprobación y entrenamiento
- 2. Primero, separa los secretos del entorno de trabajo
- 3. Ejemplos de configuración que deniegan lecturas
- 4. Patrones de .env y ámbitos fáciles de pasar por alto
- 5. Qué se detiene al desactivar el acceso a red de los comandos y qué no
- 6. Diferencias en variables de entorno, sistema operativo y nube
- 7. Pasos para verificar con datos ficticios
- FAQ
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.
Modo que restringe la escritura. No es una función que bloquee el contenido de los archivos legibles como si fueran secretos.
Especifica dónde se puede editar. El alcance de lectura no se limita necesariamente al mismo lugar.
| Control | Principalmente decide | Lo que no garantiza por sí solo |
|---|---|---|
| Solo lectura | Si los archivos pueden modificarse | Que no se lean los archivos secretos accesibles |
| Política de aprobación | Quién revisa las operaciones que cruzan el límite | Que las lecturas dentro del alcance permitido se confirmen cada vez por una persona |
| deny de archivos | Denegar lecturas y escrituras en la ruta objetivo | Eliminar contenido ya pegado o accesos mediante otras herramientas |
| Límites de acceso a red de los comandos | Destinos de comunicación de los comandos dentro del sandbox | Detener todas las comunicaciones del modelo, la autenticación, el navegador, MCP, etc. |
| Ajustes de entrenamiento | Si los datos procesados se usan para mejorar los modelos | Detener 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
En lugar de datos de producción, usa una entrada pequeña que permita reproducir el problema.
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.
Mira si puede llegar a otras carpetas, al directorio personal, a almacenamiento compartido o a aplicaciones conectadas.
¿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: lecturaPermiso para leer el objetivo
write: ediciónPermite escribir en el objetivo
deny: denegaciónDeniega 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
~/.codex/config.toml
.codex/config.toml
Su ámbito y sus condiciones de carga son distintos. Los ajustes de proyecto solo se cargan en proyectos de confianza.
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 denegadosecrets/ y su contenidoObjetivo denegadosubcarpeta/.envComprobar aparte en este ejemploMismo secreto con otro nombre o copias en registrosComprobar aparte en este ejemploLas lecturas se deniegan con :root. Sin embargo, son excepciones :minimal, necesario para la ejecución, y los directorios temporales que permite el perfil heredado.
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ón | Objetivo previsto | Comprobar por separado |
|---|---|---|
.env | Archivo con el mismo nombre directamente en el área de trabajo | Subcarpetas y archivos cuyo nombre lleva un sufijo |
.env.production | Archivo de configuración de producción directamente en la raíz | Configuración de producción con otro nombre, o copias |
secrets | Ruta con el mismo nombre directamente en la raíz y lo que contiene | Copias en otras ubicaciones, como registros o copias de seguridad |
**/*.env | Archivos cuyo nombre termina en .env en varios niveles | Nombres 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
Comunicación de los comandos, scripts y sus procesos hijos.
Modelo y autenticación, búsqueda web, aplicaciones conectadas, MCP, navegador y Computer Use, tareas en la nube.
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 comandos | Proxy | Resultado |
|---|---|---|
| Desactivado | Cualquiera | No se permite el acceso a red de los comandos |
| Activado | Desactivado | Es posible la comunicación directa, y las reglas de dominio del perfil no se aplican |
| Activado | Activado | El 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
falseAplica esa exclusión automática
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.
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.
Modo anterior que tiene prioridad cuando MXC no está disponible. Requiere una preparación aprobada por un administrador.
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.
- 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
/statusy el estado seleccionado con/permissions. - 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.
- 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.
- 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.
- 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.
- 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.