Codex Security es un agente de seguridad que busca posibles vulnerabilidades en el código, comprueba las pruebas y ayuda a llegar a las correcciones. Primero conviene distinguir entre el plugin que usas en local con Codex y Codex Security Cloud, que se ejecuta en la nube conectado a GitHub. Aunque compartan nombre, se diferencian en cómo se configuran, dónde se ejecutan y dónde se consulta el precio. También existe una versión independiente de línea de comandos para integrar en CI y flujos similares (@openai/codex-security, «CLI independiente» más abajo).
Codex Security
Se ejecuta en la aplicación de escritorio o en el chat de Codex CLI. Elige el alcance del escaneo: todo el repositorio, una carpeta concreta o la diferencia de cambios.
Codex Security Cloud
Un plugin distinto. Escanea tu repositorio de GitHub conectado en la nube, con escaneos puntuales o supervisando los nuevos commits.
Este artículo explica cómo elegir entre ambas, el precio y los créditos gratuitos, el primer escaneo, la carga de los escaneos Deep, cómo leer los resultados y cómo comprobar las correcciones.
Fuente: OpenAI, Descripción general de Codex Security y Primeros pasos con el plugin local.
Elegir entre local, Cloud y revisión habitual
Para un cambio pequeño, puedes pasarle a Codex normal la diferencia y los criterios de revisión. Esto no significa que se adjunte automáticamente el resultado de un escáner especializado ni un registro del alcance analizado. Pedir que revise el código y ejecutar un escaneo de Codex Security son cosas que conviene distinguir. Sobre cómo elegir entre los propios productos de Codex, consulta el artículo sobre la comparativa entre Claude Code y Codex.
@openai/codex-security) y un SDK. Son distintos del plugin dentro de Codex CLI, así que revisa por separado el método de autenticación, los permisos de ejecución y el presupuesto.Cloud está en vista previa de investigación, y su uso requiere acceso al espacio de trabajo de destino. En el caso de la CLI independiente, también, que el paquete esté publicado y que tu cuenta tenga permiso de escaneo son cosas distintas. Según tu cuenta y tus repositorios, un escaneo completo podría requerir además «Trusted Access for Cyber». Que aparezca un nombre de plan como Pro no basta para asegurar que todas las vías estén disponibles. Si algo no aparece en pantalla, comprueba si el plugin está activado, tus permisos de uso y la configuración de administración de tu organización.
Fuente: OpenAI, Descripción general y requisitos de acceso y Revisión de seguridad de los cambios en el código.
Precio y créditos gratuitos: Pro también requiere una comprobación aparte
Los escaneos de Cloud no están incluidos en la cuota del plan habitual
La FAQ de Cloud de OpenAI explica que los escaneos de repositorios y los escaneos continuos configurados a partir del 1 de octubre de 2026, a las 12:53 (hora del Pacífico de EE. UU.), se cobran en créditos o en dólares estadounidenses según las tarifas de tokens del plan. No están incluidos en la cuota habitual del plan. En las cuentas que cumplen los requisitos, los créditos gratuitos de escaneo se usan antes que el uso de pago.
La monitorización existente que cumple los requisitos es gratuita hasta el 21 de octubre
Los escaneos añadidos después no están incluidos. Al terminar el periodo gratuito, la monitorización continúa si activas el uso de pago, y se pausa si no lo activas.
500 dólares estadounidenses de crédito gratuito para cuentas que cumplen los requisitos
Para cuentas que cumplen los requisitos. El mismo saldo se usa para escaneos puntuales y continuos, y se comparte en el espacio de trabajo. Según la FAQ, este crédito gratuito de escaneo no tiene fecha de caducidad.
Los 500 dólares estadounidenses son crédito de escaneo para cuentas que cumplen los requisitos. Cuando se agota, se aplica la estructura de facturación de esa cuenta o espacio de trabajo. Antes de empezar, comprueba en pantalla si cumples los requisitos, cuánto crédito gratuito te queda y las condiciones del uso de pago.
El «coste» que aparece en pantalla no siempre es lo que se cobra
En Cloud, puedes abrir el escaneo correspondiente desde «Scans» y consultar el número de tokens y el coste. Si colocas el cursor sobre el número de tokens, aparece el desglose de entrada, entrada en caché y salida. El coste mostrado es el importe antes de aplicar los créditos gratuitos o las exenciones de facturación, así que lee por separado el crédito gratuito aplicado y el cargo real. Los escaneos que muestran «Exempt from billing. No charges apply.» no se cobran.
Fuente de precios, créditos gratuitos y visualización: OpenAI, Codex Security Cloud FAQ (apartado «Billing»). Las horas se refieren a la hora del Pacífico de EE. UU., tal como indica la documentación oficial.
No apliques el crédito gratuito de Cloud al plugin local
El plugin local se ejecuta como una tarea de Codex. Según las condiciones generales de uso de Codex, el plan, el modelo, el volumen de procesamiento y el método de autenticación influyen en el consumo, y el trabajo local adicional con una clave de API se factura a tarifas de API. Por otro lado, en los pasos de inicio local, la documentación de escaneo estándar y Deep y la FAQ de la CLI que revisé, no hay un precio fijo por escaneo ni una tabla de precios específica del plugin. No supongas que «en local significa consumo cero» ni que «puede usarse el crédito de 500 dólares de Cloud».
La CLI independiente puede usar una clave de API aunque hayas iniciado sesión. Si en el entorno hay OPENAI_API_KEY o CODEX_API_KEY, en los escaneos no interactivos y con salida JSON/JSONL esa clave se selecciona por defecto. Si tienes tanto una clave de API del entorno como un inicio de sesión guardado en ChatGPT, los modos interactivo y de salida de texto te preguntan cuál usar. La documentación oficial ofrece la indicación explícita --auth chatgpt y --auth api-key, así que define antes de empezar quién será facturado.
Puedes consultar tu uso de Codex en la pantalla de uso, y con /status dentro de Codex CLI. El coste de los escaneos de Cloud también debe revisarse en el lado de Cloud. Para comparar planes, consulta el artículo sobre precios y cuotas de uso de Pro.
Fuente: OpenAI, Precios y uso de Codex y Work y Selección de autenticación de la CLI.
Pasos y prompt para el primer escaneo
A continuación, una descripción de los pasos oficiales. Limita los objetivos del escaneo al código que sea tuyo o que tengas permiso para analizar. En el primer escaneo, confirma la rama de destino, la revisión, el destino de salida y la autenticación que vas a usar. Empezar con Standard es la secuencia más sencilla.
Plugin local en la aplicación de escritorio
- Busca «Codex Security» en la lista de plugins e instálalo y actívalo. Cloud es un plugin aparte.
- Abre en la barra lateral «Security» → «Scans» → «+ Scan».
- Selecciona el repositorio. Para un escaneo completo, elige «Codebase»; en el primero, desactiva «Deep scan».
- Revisa la carpeta a examinar, la rama y la revisión actuales, y el modelo y el nivel de razonamiento.
- Solo si hace falta, añade en «Additional context» los puntos de entrada públicos, las condiciones de autorización y las operaciones importantes.
- Inicia con «Start scan», revisa el progreso de cada etapa y, al terminar, lee el alcance del escaneo y las pruebas.
Si lo usas dentro de Codex CLI, instálalo con /plugins y crea un chat nuevo para el repositorio de destino con /new. En lugar de decir simplemente «revisa la seguridad», indica el escaneo especializado y el objetivo; así queda constancia de lo que pediste.
Ejecuta un escaneo estándar de Codex Security centrado en services/billing.
Da prioridad a las entradas de los usuarios, a las comprobaciones de propiedad de la información de facturación y a las operaciones solo para administradores.
Esta vez, solo escanea e informa. No modifiques el código fuente, ni hagas commit, push o publicación, ni cambies la configuración de facturación.
Informa de la revisión de destino, del alcance analizado, de los ámbitos excluidos o incompletos y de las pruebas de cada reproducción.
Si hace falta cambiar la configuración, detente y muestra el cambio y el motivo.
Las prohibiciones escritas en el prompt no imponen permisos como lo haría un sandbox. Comprueba los permisos de ejecución por separado.
Versión en la nube con GitHub
- Instala «Codex Security Cloud» y confirma la conexión de GitHub con el repositorio de destino.
- En «Scan», selecciona el repositorio y el entorno. «Auto» crea un entorno al iniciar, así que si quieres usar un entorno preparado, revísalo en «Customize».
- Para una revisión puntual, elige «One-Time Scan». Para supervisar commits futuros, elige «Continuous Scanning».
- Revisa el precio, el saldo gratuito y los objetivos, y luego inicia con «Create».
Los escaneos continuos se aplican a la rama predeterminada del repositorio. Cuanto más largo sea el periodo de historial que se analiza, más tardará el escaneo inicial. Para detener la supervisión, ponla en pausa en «Repositories» → destino → «Monitoring settings» y guarda. Ten cuidado de no confundir cerrar la pantalla con detener la supervisión.
Fuente: OpenAI, Pasos para empezar con el plugin y Configuración y supervisión en Cloud.
Standard y Deep: ajustar alcance y carga
Standard
Un escaneo habitual de repositorio o carpeta. Determina qué se examina y qué tipo de pruebas aparecen, y úsalo como referencia para comparar los siguientes escaneos.
Deep
Un método que explora de forma más amplia y, por tanto, consume mucho tiempo y recursos. Usa trabajadores de escaneo independientes y los subagentes que dependen de ellos, y agrega los resultados según las condiciones.
En la configuración oficial de Deep, el número de trabajadores que se ejecutan a la vez por defecto es 4, el número de subagentes por trabajador es 3 y el tiempo máximo de ejecución es 96 horas. 96 horas es el límite máximo de configuración, no el tiempo habitual de ejecución. Para configurar un límite de tiempo se necesita el plugin en la versión 0.1.19 o posterior. Al alcanzar el límite, se detienen los trabajadores no terminados y se agregan los resultados completados. Si queda alguna parte sin examinar, esa parte se mantiene como tal.
Empieza acotando el objetivo a unidades de servicio con sentido, lee los resultados de Standard y luego decide si necesitas Deep. También puedes examinar a fondo solo áreas críticas, como pagos o autenticación. Reducir el número de trabajadores y los límites de tiempo disminuye la carga, pero es posible que aparezcan menos problemas, así que es importante registrar el alcance cubierto por un resultado más barato o más rápido.
Para analizar diferencias, usa «Changes». Puedes elegir cambios sin confirmar, un único commit, o una revisión base y una de destino, pero Deep no está disponible con Changes. Examina el código directamente relacionado con la diferencia y no se amplía automáticamente a una auditoría completa.
El límite de coste de la CLI independiente es una estimación. El --max-cost oficial decide cuándo detenerse según un coste estimado en dólares estadounidenses. Una solicitud que ya está en curso puede completarse por encima del límite, así que no es un tope estricto de pago. Combínalo con los límites de tiempo, el paralelismo y el alcance, y no trates como resultado completo un escaneo que se detuvo a medias.
Fuente: OpenAI, Standard y Deep, valores predeterminados, Alcance de Changes y Límites de coste estimados.
Leer el alcance y las pruebas, no solo el número de hallazgos
Solo el número de problemas encontrados no permite juzgar si un escaneo fue bueno. Un escaneo que apuntó al código equivocado, que se detuvo a medias o que no tuvo en cuenta las condiciones de autorización puede mostrar cero resultados y, aun así, no ser motivo de tranquilidad. Los pasos oficiales del escaneo estándar también te indican que primero leas la revisión, las áreas examinadas, las áreas aplazadas y cada prueba.
- ¿Es correcto el objetivo? Confirma el repositorio, la revisión y el alcance. No uses resultados de código antiguo como garantía de la versión actual.
- ¿Qué no se examinó? Revisa las áreas excluidas, retenidas o interrumpidas. No des por revisado todo solo porque aparezca como completado.
- ¿Se sostienen las pruebas? Revisa el camino desde la entrada hasta el procesamiento peligroso, las defensas existentes, y el método y el resultado de la reproducción.
- ¿Hay que corregirlo? Considera las condiciones reales para llegar a ese punto y su impacto, y luego corrige cada hallazgo aceptado de uno en uno.
El punto de entrada más fácil es report.md. El archivo estructurado coverage.json permite revisar las áreas examinadas y los aplazamientos, y findings.json sirve para comprobar la ubicación, la gravedad, las pruebas y la dirección de corrección de cada hallazgo. La carpeta findings/ puede contener informes detallados y archivos de reproducción. Al compartir, guarda juntos los archivos relacionados, no solo el informe.
Una afirmación que solo diga «no hay autorización» aporta muy poco para juzgar. Comprueba el endpoint de destino, las condiciones de inicio de sesión, qué ocurre al cambiar el ID de la información de facturación, dónde está la comprobación de propiedad y qué comprobaciones se ejecutan en otra capa.
Ejemplo que se sostiene: Se devolvieron datos con el ID de otro usuario, y se pudo reproducir en un entorno de prueba autorizado.
Ejemplo que requiere seguir investigando: Es posible que todavía exista una comprobación de propiedad antes del procesamiento, y aún no se han confirmado la ruta de llamada real ni la configuración.
En la CLI independiente, usa coverage.json para confirmar qué áreas no se examinaron (rutas excluidas y ubicaciones aplazadas). Aunque haya áreas no examinadas, el código de salida no cambia, así que el código de salida 0 no significa que se hayan examinado todos los archivos. Si un hallazgo desaparece en un escaneo posterior, no puedes darlo por «corregido» a menos que hayas examinado la ruta original. La validación automática de Cloud también es una función que intenta reproducir los problemas. Un resultado de «no validado» no significa «demostrado como seguro».
Fuente: OpenAI, Pasos de evaluación del escaneo estándar, Alcance del escaneo de la CLI y comparativa y Validación automática de Cloud.
Corregir, volver a verificar y manejar información sensible
Indicar quién puede hacer qué hace más fáciles de juzgar los informes
Incluye en el contexto del escaneo «quién debería poder hacer qué». Por ejemplo, «la información de facturación solo es accesible para el titular de la cuenta y para los administradores» o «solo el propietario puede publicar archivos». En los plugins locales, puedes usar SECURITY.md como política de seguridad continua y AGENTS.md para instrucciones como los pasos de compilación y verificación. En Cloud, revisa el modelo de amenazas generado y completa las carencias en los puntos de entrada públicos, las operaciones críticas y los límites de confianza.
Un modelo de amenazas es una breve descripción de la estructura de la aplicación y de las condiciones que debe proteger. Como las ediciones en Cloud se aplican a los escaneos futuros, corregir una suposición no cambia lo revisado en informes antiguos.
Corrige de uno en uno y confirma tanto la reproducción como el funcionamiento normal
- Acepta un hallazgo: comprueba las pruebas y el impacto real, y elige una incidencia para corregir.
- Crea una propuesta de corrección pequeña: en la interfaz local, elige «Patch» → «Generate patch». Generar la propuesta es un paso distinto de aplicarla al checkout de destino.
- Lee la diferencia: comprueba que no haya limpiezas no relacionadas ni cambios que debiliten otra defensa, y luego aplícala con «Apply patch».
- Vuelve a verificar: usa «Verify fix» para comprobar los pasos de reproducción originales y el funcionamiento normal. Si es posible, conserva también una prueba de regresión que falle antes de la corrección y pase después.
- Cierra el hallazgo: verificarlo no lo cierra automáticamente. Lee las pruebas que aún faltan y ciérralo indicando el motivo, o sigue investigando.
Cuando Cloud ofrezca una propuesta de corrección, revisa su contenido antes de crear un PR en borrador. Registra por separado si existe la propuesta, si se aplicó, si se volvió a verificar y si se publicó en producción. Usa también las comprobaciones previas a la publicación de aplicaciones creadas con IA, para no dejar todas las decisiones en manos de un único escáner.
«Local» no significa que no se envíe nada al exterior
Incluso en una vía que se ejecuta en local, revisa por separado las solicitudes de inferencia enviadas al modelo y la información usada para la verificación. Los pasos oficiales de la CLI independiente advierten de que los escaneos usan los permisos del sistema operativo local, no se detienen para aprobar cada acción y pueden heredar variables de entorno. No supongas que tienen los mismos permisos que un chat normal de Codex; prepara un entorno de escaneo que no tenga credenciales innecesarias.
Los registros guardados no siempre eliminan automáticamente los valores secretos, y pueden contener código fuente o credenciales. Los entregables también incluyen pasos de reproducción y detalles de vulnerabilidades, así que revisa su contenido y el alcance de compartirlos antes de publicar un enlace público o compartirlos con terceros. Sobre la configuración de uso para mejorar los modelos, consulta Uso de ChatGPT y Codex para entrenamiento y privacidad, que se explica por separado.
Fuente: OpenAI, SECURITY.md y AGENTS.md, Modelo de amenazas de Cloud, Corrección y verificación y Permisos, entregables y registros de la CLI independiente.
Lista de comprobación antes de empezar
- Vía: decide entre el plugin local, Cloud o la CLI independiente.
- Permisos: confirma que tienes permiso para analizar el código y permiso de escaneo en tu cuenta.
- Precio: no confundas tu cuota habitual de uso, el crédito gratuito de Cloud y la facturación de la API.
- Objetivo: fija la revisión y el alcance, y considera empezar con Standard.
- Juicio: lee el alcance del escaneo, las pruebas de reproducción y la incertidumbre que queda, no solo el recuento.
- Corrección: revisa cada diferencia y cada nueva verificación de uno en uno antes de aceptar una corrección.
Si es tu primera vez, empieza con un escaneo Standard del alcance necesario para comprobar si puedes juzgar los resultados por ti mismo. Si necesitas supervisión continua, considera Cloud; si quieres integrar los escaneos en procesos automatizados, considera la CLI independiente. Úsalo como una herramienta que complementa el descubrimiento y la verificación de problemas, no como una prueba de seguridad que sustituya el análisis estático (SAST) existente o la revisión humana.
Premisas de este artículo: redactado el 7 de octubre de 2026 a partir de la documentación oficial de OpenAI. Los periodos gratuitos y los códigos de salida de la CLI se volvieron a comprobar en la FAQ oficial el 19 de octubre. No ejecutamos escaneos del producto, así que compruébalos tú mismo probando la precisión de detección, el tiempo de ejecución y el consumo en una parte de tu propio repositorio.
Preguntas frecuentes
P. Si tengo ChatGPT Pro, ¿Codex Security Cloud está incluido sin coste adicional?
No se describe como incluido en la cuota habitual del plan. Los escaneos de Cloud se facturan a tarifas de tokens y, por separado, existen créditos gratuitos de escaneo para quienes cumplen los requisitos y periodos gratuitos para la monitorización continua existente. No te fíes solo del nombre del plan; comprueba tu saldo y las condiciones del uso de pago.
P. ¿No basta con pedirle a Codex normal que revise el código?
Depende del objetivo. La revisión habitual puede comprobar la implementación y las pruebas. Considera Codex Security cuando quieras un alcance de escaneo específico, hallazgos, pruebas de reproducción y supervisión continua.
P. Si un escaneo no encuentra nada, ¿puedo dar el código por seguro?
No. Primero comprueba la revisión, el objetivo, si el escaneo terminó antes de tiempo y qué áreas se excluyeron. Si el alcance estaba incompleto o no pudiste tener en cuenta las condiciones de autorización del negocio, podrías pasar por alto problemas. Úsalo junto con el análisis estático existente y la revisión humana.
P. Si elijo un escaneo Deep, ¿puedo escanear de forma fiable con una cuota de uso reducida?
No hay tal garantía. Deep explora de forma más amplia, así que usa más tiempo y recursos que Standard. Ajusta el objetivo, el paralelismo y los límites de tiempo, y si el escaneo se detiene, lee el alcance que llegó a cubrir. El límite de coste estimado de la CLI independiente tampoco es un tope estricto de pago.