Usa esta guía para habilitar Daybreak en Codex CLI, configurarlo para flujos de trabajo automatizados e integraciones con SDK, y resolver problemas de acceso o de rechazo de solicitudes.

Ten en cuenta que, para acceder a estos cambios, debes actualizar Codex CLI a la versión 0.163.0 o posterior. Las actualizaciones de la CLI son opcionales: las instalaciones existentes conservan su comportamiento actual hasta que las actualices.

Si tu automatización instala @openai/codex@latest, puede incorporar este cambio en la próxima instalación o actualización. Si instalaste Codex CLI de forma global con npm, ejecuta npm install -g @openai/codex@latest y luego ejecuta codex --version para confirmar la actualización.
Para posponer el cambio, fija la versión en @openai/codex@0.162.0. Una instalación realizada una sola vez con @latest no se actualiza por sí sola. Los flujos de trabajo que tienen fijadas versiones anteriores conservan su comportamiento previo.
Para las integraciones de TypeScript, actualiza @openai/codex-sdk y el entorno de ejecución que incluye. Para las integraciones de Python, actualiza openai-codex y su entorno de ejecución de Codex. Actualizar solo la CLI global puede no actualizar el entorno de ejecución de un SDK. Si configuras una ruta personalizada para un ejecutable, actualiza también ese ejecutable.

Los ID de modelo configurados manualmente que no figuren en un catálogo disponible seguirán recibiendo el mismo tratamiento automático en la CLI y en Codex Desktop, incluso cuando Daybreak esté activado. Su ausencia del catálogo, por sí sola, no impide que una solicitud se complete correctamente.

Los modelos de ciberseguridad podrían incorporarse al selector de modelos en un despliegue independiente. Una vez que se habiliten, quienes ya usen una versión compatible no necesitarán otra descarga para ver los nuevos modelos disponibles. Vuelve a abrir el selector de modelos o reinicia Codex para actualizar la lista.

Activar Daybreak en la CLI interactiva

Inicia Codex con tu método de autenticación habitual.
Para activar Daybreak, ingresa /daybreak.
Codex mostrará Daybreak on. Applies to new turns.
Esto se aplicará al hilo activo y se guardará como opción predeterminada para las nuevas sesiones.
Para desactivar Daybreak, vuelve a ejecutar el mismo comando (/daybreak).

Habilita Daybreak en la CLI sin interfaz interactiva

Los flujos de trabajo sin interfaz interactiva suelen ejecutarse mediante codex exec en scripts, tareas programadas o procesos de integración continua (CI). Aquí no aparece un mensaje interactivo para “Habilitar Daybreak” (/daybreak). En su lugar, puedes:

Agregar Daybreak a una ejecución específica de la CLI añadiendo -c daybreak=true a cada comando que deba ejecutarse con menos rechazos. Por ejemplo, podrías ingresar:

codex exec -c daybreak=true "Review the changes in this repository."

Conserva tu prompt actual y las demás opciones del comando. Agrega este ajuste a cada invocación que deba usar Daybreak, incluidos los comandos en scripts, tareas programadas y la configuración de CI.
Establecer Daybreak como opción predeterminada para nuevas sesiones y ejecuciones de la CLI añadiendo daybreak=true al archivo de configuración que carga Codex.
El archivo de configuración de usuario predeterminado es ~/.codex/config.toml. Si tu automatización define CODEX_HOME, usa $CODEX_HOME/config.toml en su lugar. Coloca el ajuste en el nivel superior, fuera de secciones como [features].
Haz el cambio en el entorno donde realmente se ejecuta la automatización. Actualizar la configuración de tu laptop no actualiza la de un ejecutor de CI ni la de una máquina remota.
El ajuste también se aplica a las nuevas sesiones interactivas que usan la misma configuración. Las sesiones reanudadas y bifurcadas conservan la opción de Daybreak guardada; un nuevo valor predeterminado en la configuración no la reemplaza.
Ten en cuenta que un ajuste en la línea de comandos tiene prioridad sobre la configuración guardada para esa invocación. Por lo tanto, puedes mantener daybreak = true en tu configuración y usar -c daybreak=false para una ejecución individual.

Habilitar Daybreak con un proveedor de inferencia a través de un proxy

Puedes usar Daybreak en Codex CLI y, al mismo tiempo, enrutar las solicitudes de inferencia a través de tu proxy actual. Codex realiza una consulta independiente al catálogo de modelos para determinar qué modelos admiten Daybreak en tu proyecto.

Antes de comenzar, asegúrate de tener un proveedor de proxy que funcione en Codex CLI, una clave de API de OpenAI de un proyecto con acceso a Daybreak y al modelo que quieres usar, y la versión v0.167.0 de Codex CLI.Documentación de OpenAI sobre el acceso de proyectos a Daybreak

Actualiza tu proveedor de proxy: abre ~/.codex/config.toml y busca la sección [model_providers.<id>] de tu proxy. Agrega las últimas dos líneas del siguiente ejemplo a esa sección. Conserva el ID del proveedor, la URL del proxy y los ajustes de autenticación actuales.

[model_providers.proxy]
name = "Proxied with Cyber"
base_url = "https://<your-proxy>/v1"
model_catalog_url = "<https://chatgpt.com/backend-api/codex/models>"
capabilities.cyber_access_programs = true

Si tu configuración ya tiene una sección [model_providers.<id>.capabilities], coloca cyber_access_programs = true allí y mantén model_catalog_url en la sección principal del proveedor.Referencia de configuración de Codex
Autentica la consulta al catálogo eligiendo la opción que corresponda a las credenciales que usa tu CLI.
1. Si Codex usa una clave de API de OpenAI, conserva la URL del catálogo de OpenAI del paso 1. Ejecuta Codex con la clave de tu proyecto con Daybreak habilitado para que pueda autenticarse directamente en el catálogo.
2. Si Codex usa las credenciales de tu proxy, establece model_catalog_url en la URL completa de una ruta de catálogo en tu proxy. Configura esa ruta para que haga lo siguiente:
  1. Autenticar la solicitud de la CLI con tus credenciales habituales del proxy.
  2. Reenviar la solicitud a https://chatgpt.com/backend-api/codex/models con la clave de API de OpenAI de tu proyecto con Daybreak habilitado.
  3. Devolver la respuesta del catálogo a Codex.
Activa Daybreak iniciando una nueva sesión de Codex CLI con tu proveedor de proxy. Selecciona un modelo que admita Daybreak y luego ingresa /daybreak para activarlo.
1. Si Daybreak no está disponible, revisa primero la consulta al catálogo. La inferencia puede funcionar incluso si falla la solicitud al catálogo. Verifica que la solicitud llegue a OpenAI con una clave del proyecto correcto y que el proyecto tenga acceso tanto a Daybreak como al modelo seleccionado.

Activar Daybreak mediante el SDK de TypeScript

Pasa el ajuste de Daybreak a través de la configuración del cliente:

import { Codex } from "@openai/codex-sdk";
const codex = new Codex({
config: { daybreak: true },
});
const thread = codex.startThread();
const result = await thread.run("Review the changes in this repository.");
console.log(result.finalResponse);

Usa daybreak: false para desactivar Daybreak y aplicar el comportamiento habitual de rechazo de solicitudes. Conserva tu configuración de autenticación actual.

Activar Daybreak mediante el servidor de aplicaciones o el SDK de Python

1. Lee los valores de availableAccessPrograms.cyber del modelo seleccionado en model/list y luego establece cyberAccessProgram en los parámetros de turn/start.

a. Para un modelo de la línea principal y una cuenta con acceso a Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Para un modelo de ciberseguridad y una cuenta con acceso a Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Para aplicar el comportamiento habitual de rechazo de solicitudes:

{ "cyberAccessProgram": "standard" }

2. Incluye la selección en cada turno que deba usarla; no supongas que omitir el parámetro desactiva Daybreak. Los clientes que se conectan directamente al servidor de aplicaciones deben habilitar la capacidad experimentalApi durante la inicialización para usar este parámetro.

3. El cliente de bajo nivel CodexClient del SDK de Python puede pasar el mismo parámetro:

from openai_codex.client import CodexClient
with CodexClient() as client:
client.initialize()
thread = client.thread_start()
turn = client.turn_start(
thread.thread.id,
"Review the changes in this repository.",
params={"cyberAccessProgram": "daybreakBlue"},
)
client.wait_for_turn_completed(turn.turn.id)

4. Este ejemplo supone que Daybreak Blue está disponible para el modelo seleccionado. El cliente de Python habilita la capacidad de API experimental de forma predeterminada. Una preferencia guardada en el hilo, por sí sola, no selecciona un programa para un turno del servidor de aplicaciones.

Si agregaste un catálogo local de modelos antes de estos cambios

Si antes no veías los modelos que esperabas al iniciar sesión con una clave de API, es posible que hayas agregado un catálogo local mediante model_catalog_json en config.toml. Codex usa ese archivo local en lugar del catálogo automático, por lo que tu lista de modelos puede quedar desactualizada. Cuando tu entorno admita el catálogo automático, sigue estos pasos para volver a usarlo:

Abre config.toml. Para Codex CLI, abre ~/.codex/config.toml (o $CODEX_HOME/config.toml si configuraste CODEX_HOME). En Codex Desktop, ve a Ajustes > Configuración y luego selecciona Abrir config.toml.
Desactiva temporalmente el catálogo local. Agrega # al principio de la línea model_catalog_json, guarda el archivo y reinicia Codex con la misma cuenta o clave de API. Conserva cualquier URL de catálogo que tu organización requiera.
Verifica tu acceso. En la CLI, inicia codex y luego ingresa /daybreak dentro de la sesión. En Desktop, abre el selector avanzado de modelos y activa Daybreak. Si tienes acceso a Daybreak Red, confirma que aparezca un modelo de ciberseguridad que esperas ver y que puedas enviar una solicitud con él.
Conserva la configuración que funcione. Si la verificación es exitosa, elimina la línea que desactivaste y guarda el archivo. Si falla, elimina el #, guarda el archivo y reinicia Codex para restaurar tu configuración anterior.

Solucionar problemas de rechazo de solicitudes en la CLI

Ejecuta una tarea representativa con las mismas credenciales, modelo y configuración que usa tu automatización.
Si Daybreak no está disponible, confirma lo siguiente:
- Tu cuenta o proyecto de API tiene acceso a Daybreak.
- El modelo seleccionado es compatible con Daybreak.
En la CLI interactiva, verifica que Daybreak esté activado. La CLI interactiva puede mostrar un mensaje de rechazo cuando Daybreak está disponible pero desactivado: Daybreak is currently off. If you’re doing authorized security work, turn it on and try your request again.
- El mensaje pregunta Turn on Daybreak for your next request? y ofrece las opciones Enable Daybreak o Not now.
- Selecciona Activar Daybreak para activarlo en tu próxima solicitud y luego vuelve a enviar la solicitud. Ten en cuenta que la solicitud rechazada no se reintenta automáticamente; debes volver a enviarla. Algunas solicitudes pueden seguir rechazándose con Daybreak activado.
- Selecciona Ahora no para dejar Daybreak desactivado.
En las automatizaciones, confirma que daybreak=true llegue al proceso de Codex que se ejecuta y que otro ajuste de la línea de comandos no lo anule.

Usa Daybreak con Codex Security CLI

Codex Security CLI usa @openai/codex-security para realizar análisis de seguridad. Sus opciones de programas de acceso son independientes de los ejemplos generales de Codex CLI que se muestran arriba.

Para autenticarte con una clave de API, usa una clave de un proyecto de API con Daybreak habilitado y selecciona explícitamente el programa aprobado para ese proyecto. Para Daybreak Blue:

npx @openai/codex-security scan . --auth api-key --cyber-access-program daybreak_blue

Usa daybreak_red solo si tu proyecto está aprobado para Daybreak Red, o standard para aplicar las medidas de protección estándar. Seleccionar un programa no otorga acceso a ese programa ni a modelos adicionales.

Consulta la referencia de Codex Security CLI para conocer las opciones de autenticación y análisis.

Usa Daybreak con el SDK de Codex Security

El SDK de Codex Security para TypeScript (@openai/codex-security) ejecuta análisis de seguridad desde una aplicación o herramienta de desarrollo. Es independiente del SDK general de Codex descrito arriba.

Usa las credenciales de tu cuenta o proyecto de API aprobados. Algunas solicitudes de ciberseguridad y algunos hallazgos protegidos requieren Trusted Access for Cyber. Instalar el SDK o seleccionar un modelo no otorga acceso a Daybreak.

Sigue la guía del SDK de Codex Security para conocer los métodos de autenticación compatibles, la configuración y ejemplos de análisis.

Usar Daybreak en Codex CLI