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

Ten en cuenta que, para acceder a estos cambios, debes actualizar a Codex CLI 0.163.0 o posterior. Las actualizaciones de la CLI son opcionales: las instalaciones existentes mantienen 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, después, codex --version para confirmar la actualización.
Para aplazar el cambio, fija la versión en @openai/codex@0.162.0. Una instalación puntual con @latest no se actualiza por sí sola. Los flujos de trabajo que usan versiones anteriores fijas mantienen 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 a 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 con Daybreak activado. Su ausencia del catálogo no impide por sí sola que una solicitud se complete correctamente.

Los modelos de ciberseguridad pueden incorporarse al selector de modelos en un despliegue independiente. Una vez habilitados, si ya usas una versión compatible, no necesitas 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, introduce /daybreak.
Codex mostrará Daybreak activado. Se aplica a los nuevos turnos.
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 entornos de integración continua (CI). Aquí no aparece ningún aviso interactivo para «Habilitar Daybreak» (/daybreak). En su lugar, puedes:

Añadir Daybreak a una ejecución concreta de la CLI añadiendo -c daybreak=true a cada comando que deba usar un nivel reducido de rechazos. Por ejemplo, puedes introducir:

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

Conserva tu prompt y las demás opciones del comando. Añade este ajuste a cada invocación que deba usar Daybreak, incluidos los comandos de scripts, tareas programadas y configuraciones de CI.
Establecer Daybreak como opción predeterminada para las nuevas sesiones y ejecuciones de la CLI añadiendo daybreak=true al archivo de configuración que carga Codex.
La configuración de usuario predeterminada está en ~/.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 se ejecuta realmente la automatización. Actualizar la configuración de tu portátil 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 usen la misma configuración. Las sesiones reanudadas y bifurcadas conservan su opción guardada de Daybreak; un nuevo valor predeterminado en la configuración no la sustituye.
Ten en cuenta que un ajuste de la línea de comandos tiene prioridad sobre la configuración guardada para esa invocación. Por tanto, puedes mantener daybreak = true en tu configuración y usar -c daybreak=false para una ejecución concreta.

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

Puedes usar Daybreak en la CLI de Codex y seguir enviando las solicitudes de inferencia a través de tu proxy actual. Codex consulta por separado el catálogo de modelos para determinar qué modelos admiten Daybreak en tu proyecto.

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

Actualiza tu proveedor de proxy: abre ~/.codex/config.toml y busca la sección [model_providers.<id>] de tu proxy. Añade las dos últimas líneas del ejemplo siguiente 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 en ella y mantén model_catalog_url en la sección superior 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 ante el catálogo.
2. Si Codex usa las credenciales de tu proxy, establece model_catalog_url en la URL completa de una ruta del catálogo en tu proxy. Configura esa ruta para:
  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 la CLI de Codex con tu proveedor de proxy. Selecciona un modelo que admita Daybreak y, a continuación, introduce /daybreak para activarlo.
1. Si Daybreak no está disponible, comprueba primero la consulta al catálogo. La inferencia puede funcionar aunque falle la solicitud al catálogo. Verifica que la solicitud llegue a OpenAI con una clave del proyecto correcto y que ese 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. Mantén tu configuración de autenticación actual.

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

1. Consulta los valores de availableAccessPrograms.cyber del modelo seleccionado en model/list y, después, 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 el comportamiento habitual de rechazo de solicitudes:

{ "cyberAccessProgram": "standard" }

2. Incluye la selección en cada turno que deba usarla; no des por hecho 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 presupone 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 no basta para seleccionar un programa para un turno del servidor de aplicaciones.

Si añadiste un catálogo local de modelos antes de estos cambios

Si antes no aparecían los modelos que esperabas al iniciar sesión con una clave de API, es posible que añadieras 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 quedarse desactualizada. Cuando tu entorno sea compatible con el catálogo automático, sigue estos pasos para volver a usarlo:

Abre config.toml. En Codex CLI, abre ~/.codex/config.toml (o $CODEX_HOME/config.toml si has definido CODEX_HOME). En Codex Desktop, ve a Ajustes > Configuración y selecciona Abrir config.toml.
Desactiva temporalmente el catálogo local. Añade # 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 exija tu organización.
Comprueba tu acceso. En la CLI, inicia codex y, después, introduce /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 uno de los modelos de ciberseguridad que esperas y que puedas enviar una solicitud con él.
Conserva la configuración que funcione. Si la comprobación es satisfactoria, 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, comprueba que Daybreak esté activado. La CLI interactiva puede mostrar un mensaje de rechazo cuando Daybreak está disponible, pero desactivado: Daybreak está desactivado. Si estás realizando tareas de seguridad autorizadas, actívalo y vuelve a enviar tu solicitud.
- El mensaje pregunta ¿Activar Daybreak para tu próxima solicitud? y ofrece las opciones Activar Daybreak o Ahora no.
- Selecciona Activar Daybreak para activarlo en tu próxima solicitud y, después, vuelve a enviarla. Ten en cuenta que la solicitud rechazada no se reintenta automáticamente; debes enviarla de nuevo. 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 ningún otro ajuste de la línea de comandos lo anule.

Usa Daybreak con la CLI de Codex Security

La CLI de Codex Security usa @openai/codex-security para realizar análisis de seguridad. Sus opciones de programas de acceso son independientes de los ejemplos generales de la CLI de Codex anteriores.

Para autenticarte con una clave de API, usa una clave de un proyecto de API con Daybreak habilitado y selecciona explícitamente el programa autorizado 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á autorizado para Daybreak Red, o standard para aplicar las medidas de protección estándar. Seleccionar un programa no te da acceso a ese programa ni a modelos adicionales.

Consulta la referencia de la CLI de Codex Security 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 anteriormente.

Usa las credenciales de tu cuenta o proyecto de API autorizados. Algunas solicitudes de ciberseguridad y algunos hallazgos protegidos requieren Trusted Access for Cyber. Instalar el SDK o seleccionar un modelo no te da 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 los ejemplos de análisis.

Usar Daybreak en Codex CLI