Codex Security: instala el plugin, lanza tu primer escaneo y revisa cada cambio
Un walkthrough de Codex Security paso a paso capturado de una grabación real de pantalla: instala el plugin en la app de escritorio de ChatGPT, lanza un primer escaneo con gpt-5.6-sol a effort xhigh, sube a los deep scans y pon una revisión de seguridad delante de cada merge.
Codex Security en cinco líneas
- Codex Security es el agente de seguridad de aplicaciones de OpenAI: revisa código en busca de vulnerabilidades y reporta evidencia que puedes usar para investigarlas y corregirlas. Se distribuye como plugin de ChatGPT para repos locales, además de un CLI, un SDK de TypeScript y una cloud en research preview.
- Instálalo desde la página Plugins de la app de escritorio de ChatGPT (o /plugins en Codex CLI) y abre un chat nuevo sobre el repositorio — la regla del quickstart es no continuar nunca un chat existente.
- Para la mejor calidad de escaneo, la documentación especifica gpt-5.6-sol con reasoning effort xhigh. El primer escaneo es de solo lectura: tu código fuente queda intacto mientras el agente valida los hallazgos plausibles.
- Los deep scans ejecutan varios escaneos estándar independientes sobre el mismo repo y combinan sus hallazgos — menos variabilidad, mucho más tiempo de ejecución. Para diffs y pull requests usa $codex-security:security-diff-scan.
- Cada escaneo deja report.md, findings/<slug>/, hardening/ y manifiestos JSON. Mantén el directorio intacto y revisa el resumen de cobertura antes de fiarte de un resultado limpio.
Codex Security: Make Your App Safer
Canal: Software Engineer Meets AI3:59
Codex Security — OpenAI Codex documentation
Docs: developers.openai.com
Los fotogramas vienen de una grabación completa de pantalla del plugin de Codex Security en uso — sin cámara de cara ni subtítulos incrustados en ninguno de los fotogramas conservados. Los datos están cotejados contra la documentación oficial de Codex Security (quickstart del plugin, deep scans, code changes) y las notas de versión 0.163.0 y 0.164.0 de openai/codex. La grabación muestra chips de modelo como 5.6 Sol, en línea con la recomendación actual de gpt-5.6-sol de la documentación.
Los fotogramas del vídeo siguen siendo propiedad de sus creadores y se incrustan aquí como documentación paso a paso, con atribución y enlaces profundos.
De la instalación a tu primer report de Codex Security
Conocer el agente de seguridad
- 1
Saber qué hace Codex Security antes de instalarlo
Codex Security es el agente de seguridad de aplicaciones de OpenAI: revisa código en busca de vulnerabilidades y reporta evidencia que puedes usar para investigarlas y corregirlas. Llega en cuatro formas — un plugin para repositorios locales en Codex, un CLI para escaneos repetibles en terminal y CI, un SDK de TypeScript y una cloud en research preview que vigila los repositorios de GitHub conectados. Todo en esta guía usa el plugin.
La documentación presenta Codex Security como un agente para encontrar, confirmar y corregir vulnerabilidades a través de las superficies plugin, CLI, SDK y cloud. - 2
Entender el bucle Analyze, Understand, Threat Model
Cada escaneo recorre el mismo bucle. Codex analiza el repositorio, construye un entendimiento de cómo fluyen de verdad los datos y los límites de confianza por tu código, y genera después un modelo de amenazas que decide qué merece escrutinio. Por eso un escaneo tarda minutos en vez de segundos — y por eso la documentación te pide escanear solo código tuyo o cuya evaluación tengas permiso para hacer.
El modelo de un escaneo dibujado a mano en el vídeo: primero Analyze, después Understand, al final Threat Model. - 3
Instalar el plugin de Codex Security desde la página Plugins
En la app de escritorio de ChatGPT, abre Codex, luego abre Plugins y busca Codex Security. El plugin público aparece como Security scanning for your codebase — instálalo, confirma que está activado y una entrada Security aparece en la barra lateral. En el CLI el mismo movimiento es /plugins, buscar, Install plugin y luego /new.
Escribir codex se en la búsqueda de Plugins hace emerger la tarjeta del plugin público de Codex Security.
Lanzar tu primer escaneo
- 4
Abrir un chat nuevo sobre el repositorio que quieres evaluar
La regla del quickstart: abre el repositorio en Codex y empieza un chat nuevo — no continúes uno existente, o el contexto viejo contamina el escaneo. Elige el modelo que pide la documentación: gpt-5.6-sol con reasoning effort xhigh. El escaneo es de solo lectura; deja tu código intacto y guarda un report con evidencia y guías de remediación.
El quickstart del plugin cubre la instalación, un primer escaneo de solo lectura y la revisión del resultado en Codex. - 5
Configurar el escaneo: Codebase o Changes, alcance, contexto
Al iniciar un escaneo se abre el diálogo Set up security scan. El tipo de escaneo es Codebase para un repositorio o carpeta, o Changes para revisar un PR, commit o patch. Verifica el área de escaneo (toda la codebase o una carpeta), la rama actual y el último commit, y añade opcionalmente una guía de scoping del modelo de amenazas para que el agente priorice las superficies que te importan. Después pulsa Start scan.
El diálogo de escaneo fija el objetivo en codex-security-demo-commerce en la rama main antes de que corra nada. - 6
Leer los hallazgos: severidad, cobertura, evidencia
Un escaneo completado abre un workspace de Findings con recuentos de severidad, cobertura (28/28 archivos en la demo) y una fila por hallazgo reportable — aquí un authorization bypass / IDOR de severidad High en un endpoint de detalle de pedido. Cada hallazgo lleva evidencia del código fuente, prerrequisitos del atacante y validación, y la validación puede apoyarse en análisis del código sin ejecutar un reproductor.
El primer escaneo del repositorio demo saca un hallazgo High de IDOR sobre 28 archivos escaneados.
Profundizar con un deep scan
- 7
Decidir entre un escaneo estándar y un deep scan
Un escaneo estándar es una pasada de revisión sobre el repositorio o una carpeta acotada — correcto para primeras ejecuciones y comprobaciones rutinarias. Un deep scan ejecuta varios escaneos estándar independientes sobre el mismo objetivo y combina sus hallazgos, comprando menos variabilidad entre ejecuciones a costa de más tiempo de ejecución y más tokens. Los deep scans cubren solo repositorios y carpetas; los diffs se quedan en el workflow de revisión de cambios.
La tabla comparativa de la documentación: los deep scans compran menos variabilidad con tiempo de ejecución y recursos. - 8
Lanzar un deep scan desde el compositor del chat
La vía conversacional: envía "Use $codex-security:deep-security-scan to run a deep security scan of this repository.". Para un componente de un monorepo, sustituye this repository por la ruta a su carpeta. Codex abre primero la configuración del escaneo y espera tu acción de Start scan antes de inspeccionar nada.
El prompt de deep-security-scan tecleado en un chat nuevo de Codex sobre el repositorio clicksis. - 9
Confirmar la configuración y dejar correr el preflight
El skill Deep Security Scan abre el workspace de configuración: Deep scan activado, área de escaneo en Entire codebase, rama actual y último commit verificados, guía opcional de scoping del modelo de amenazas. Solo tu acción de Start scan suelta al plugin para ejecutar su preflight contra el runtime antes de que empiece la fase de discovery.
La configuración del deep scan espera un Start scan explícito antes de tocar el repositorio. - 10
Ver las fases: preflight, discovery, review, report
Los deep scans ejecutan discovery repetida más fases centralizadas de validación y reporting sin modificar archivos del repositorio. El panel Scan progress muestra dónde estás — comprobaciones de preflight, mapeo de la superficie de ataque, revisión de código, validación de hallazgos, trazado de impacto, construcción del report — y cuántos escaneos paralelos están activos.
Paso 3 de 4: preflight terminado, discovery en marcha, seis escaneos activos en segundo plano.
Revisar los cambios y conservar la evidencia
- 11
Revisar cambios sin commitear y rangos de PR
Antes de hacer merge, escanea el diff, no el repo. Para trabajo sin commitear: "Use $codex-security:security-diff-scan to review my current uncommitted changes for security regressions.". Para un rango de ramas, nombra ambas revisiones y añade una lista de foco: "Focus on authentication, authorization, input handling, filesystem access, network requests, and secrets."
Dos prompts de copiar y pegar cubren los cambios del working tree y los rangos de origin/main a HEAD. - 12
Conservar el directorio del escaneo: report.md y los artefactos JSON
Cada escaneo completado escribe report.md como punto de entrada legible, un directorio findings/<slug>/ con un report detallado de vulnerabilidad por hallazgo, propuestas en hardening/ cuando el escaneo tiene hallazgos reportables, y scan-manifest.json, findings.json y coverage.json estructurados para automatización. Comparte el directorio completo junto para que los enlaces de report.md sigan funcionando.
report.md es el punto de entrada; findings, hardening y los manifiestos JSON se sitúan a su lado.
Daybreak: el tier de confianza detrás del trabajo serio con Codex Security
La versión 0.163.0 de Codex CLI (15 de octubre de 2026) activó Daybreak por defecto para las cuentas elegibles — y si mueves workflows de seguridad por Codex, eso importa. Daybreak es el programa Trusted Access for Cyber de OpenAI: un tier de acceso por aprobación que relaja los rechazos de los modelos para trabajo de seguridad verificado y autorizado.
- 1Daybreak Blue es el tier defensivo: menos rechazos en los modelos mainline — GPT-5.5, GPT-5.6 Sol, GPT-6 Sol, GPT-6 Luna — para trabajo defensivo verificado como el triage de vulnerabilidades, la revisión de código seguro, la ingeniería de detección, la respuesta a incidentes y la validación de parches. Es el punto de partida recomendado para la mayoría de los equipos de seguridad.
- 2Daybreak Red es el tier ofensivo: acceso a modelos especializados en ciber como GPT-5.5-Cyber más menos rechazos en Astra, para penetration testing autorizado, red teaming y validación de exploits. Requiere aprobación aparte y está limitado a organizaciones business y enterprise.
- 3En Codex CLI lo activas con /daybreak en sesiones interactivas o daybreak=true en comandos headless. Las notas de la 0.163.0 afirman que viene activado por defecto para cuentas elegibles, y codex exec puede seleccionarlo con una API key de OpenAI cuando el servidor ofrece acceso.
- 4La aprobación sola no cambia nada — Daybreak también debe activarse para la petición desde los controles de tu workspace o proyecto de API, y el toggle está apagado por defecto en el selector avanzado de modelos de la app de Codex.
- 5El alcance es estricto: trabajo defensivo autorizado sobre sistemas que posees o cuyo testeo te está expresamente permitido. Nada de aplicaciones de cara al cliente, nada de acceso de terceros, nada de revender el acceso — las políticas de uso estándar siguen aplicando por encima.
- 6La 0.164.0 (23 de octubre de 2026) mantuvo esos valores por defecto y solo pulió bordes — los avisos de Daybreak ahora se renderizan tras la cabecera de sesión — así que la conclusión práctica es estar al día con las versiones del CLI y tratar Daybreak como el tier que pides cuando el triage de Codex Security sigue atascándose en hallazgos legítimos.
Para la mayoría de lectores la postura por defecto ya es la correcta: Codex Security funciona bien con los safeguards estándar y gpt-5.6-sol a effort xhigh. Daybreak existe para que los equipos aprobados no se atasquen a mitad de triage cuando una ruta de exploit legítima necesita análisis completo — pídelo cuando lo necesite tu workflow, no tu curiosidad.