Segueix aquesta guia per activar Daybreak a Codex CLI, configurar-lo per a fluxos de treball automatitzats i integracions amb l'SDK, i resoldre problemes d'accés o de rebuig de sol·licituds.

Tingues en compte que, per accedir a aquests canvis, hauràs d'actualitzar Codex CLI a la versió 0.163.0 o posterior. Les actualitzacions de la CLI són opcionals: les instal·lacions existents mantenen el comportament actual fins que les actualitzis.

Si la teva automatització instal·la @openai/codex@latest, pot incorporar aquest canvi en la pròxima instal·lació o actualització. Si has instal·lat Codex CLI globalment amb npm, executa npm install -g @openai/codex@latest i després codex --version per confirmar l'actualització.
Per ajornar el canvi, fixa la versió a @openai/codex@0.162.0. Una instal·lació puntual amb @latest no s'actualitza automàticament. Els fluxos de treball fixats a versions anteriors mantenen el comportament previ.
Per a les integracions de TypeScript, actualitza @openai/codex-sdk i l'entorn d'execució que inclou. Per a les integracions de Python, actualitza openai-codex i el seu entorn d'execució de Codex. Actualitzar només la CLI global pot no actualitzar l'entorn d'execució d'un SDK. Si configures un camí personalitzat a un executable, actualitza també aquest executable.

Els identificadors de model configurats manualment que no figurin en un catàleg que sí que estigui disponible continuaran rebent el mateix tractament automàtic a la CLI i a Codex Desktop, fins i tot amb Daybreak activat. El fet que no figurin al catàleg no impedeix, per si sol, que una sol·licitud es completi correctament.

La disponibilitat dels models de ciberseguretat al selector de models es pot desplegar per separat. Un cop habilitada, els usuaris que ja tinguin una versió compatible no hauran de fer cap altra baixada per veure els nous models disponibles. Torna a obrir el selector de models o reinicia Codex per actualitzar la llista.

Activa Daybreak a la CLI interactiva

Inicia Codex amb l'autenticació habitual.
Per activar Daybreak, introdueix /daybreak.
Codex mostrarà Daybreak activat. S'aplica als nous torns.
Aquesta opció s'aplicarà al fil actiu i es desarà com a valor per defecte per a les noves sessions.
Per desactivar Daybreak, torna a executar la mateixa ordre (/daybreak).

Activa Daybreak a la CLI sense interfície interactiva

Els fluxos de treball no interactius s'executen sense una interfície d'usuari interactiva, habitualment mitjançant codex exec en scripts, tasques programades o integració contínua (CI). Aquí no apareix cap missatge interactiu per "Activar Daybreak" (/daybreak). En lloc d'això, pots:

Afegir Daybreak a una execució concreta de la CLI afegint -c daybreak=true a cada ordre que hagi d'aplicar un nivell reduït de negatives a respondre. Per exemple, pots introduir:

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

Mantén la indicació i les altres opcions de l'ordre que ja fas servir. Afegeix aquest paràmetre a cada invocació que hagi de fer servir Daybreak, incloses les ordres en scripts, tasques programades i configuracions de CI.
Establir Daybreak com a opció predeterminada per a les noves sessions i execucions de la CLI afegint daybreak=true al fitxer de configuració que carrega Codex.
El fitxer de configuració d'usuari predeterminat és ~/.codex/config.toml. Si la teva automatització defineix CODEX_HOME, fes servir $CODEX_HOME/config.toml. Col·loca el paràmetre al nivell superior, fora de seccions com ara [features].
Fes el canvi a l'entorn on s'executa realment l'automatització. Actualitzar la configuració del teu portàtil no actualitza la d'un executor de CI ni la d'una màquina remota.
El paràmetre també s'aplica a les noves sessions interactives que fan servir la mateixa configuració. Les sessions represes i bifurcades conserven l'opció de Daybreak que tenien desada; un nou valor predeterminat a la configuració no la substitueix.
Tingues en compte que un paràmetre de la línia d'ordres té prioritat sobre la configuració desada per a aquella invocació. Per tant, pots mantenir daybreak = true a la configuració i fer servir -c daybreak=false per a una execució concreta.

Activació de Daybreak amb un proveïdor d'inferència a través d'un servidor intermediari

Pots fer servir Daybreak a Codex CLI i continuar encaminant les sol·licituds d'inferència a través del teu servidor intermediari actual. Codex fa una consulta independent al catàleg de models per descobrir quins models admeten Daybreak per al teu projecte.

Abans de començar, assegura't que tens un proveïdor amb servidor intermediari que funcioni a Codex CLI, una clau d'API d'OpenAI d'un projecte amb accés a Daybreak i al model que vols fer servir, i la versió v0.167.0 de Codex CLI.Documentació d'OpenAI sobre l'accés dels projectes a Daybreak

Actualitza el proveïdor del teu servidor intermediari: obre ~/.codex/config.toml i cerca la secció [model_providers.<id>] corresponent al teu servidor intermediari. Afegeix les dues últimes línies de l'exemple següent a aquesta secció. Mantén l'ID del proveïdor, l'URL del servidor intermediari i els paràmetres d'autenticació actuals.

[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 la configuració ja té una secció [model_providers.<id>.capabilities], posa-hi cyber_access_programs = true i mantén model_catalog_url a la secció superior del proveïdor.Referència de configuració de Codex
Autentica la consulta al catàleg triant l'opció que correspongui a les credencials que fa servir la teva CLI.
1. Si Codex fa servir una clau d'API d'OpenAI, mantén l'URL del catàleg d'OpenAI del pas 1. Executa Codex amb la clau del teu projecte amb Daybreak habilitat perquè es pugui autenticar directament al catàleg.
2. Si Codex fa servir les credencials del teu servidor intermediari, estableix model_catalog_url amb l'URL complet d'una ruta de catàleg del teu servidor intermediari. Configura aquesta ruta perquè faci el següent:
  1. Autenticar la sol·licitud de la CLI amb les teves credencials habituals del servidor intermediari.
  2. Reenviar la sol·licitud a https://chatgpt.com/backend-api/codex/models amb la clau d'API d'OpenAI del teu projecte amb Daybreak habilitat.
  3. Retornar la resposta del catàleg a Codex.
Activa Daybreak iniciant una nova sessió de Codex CLI amb el proveïdor del teu servidor intermediari. Selecciona un model compatible amb Daybreak i introdueix /daybreak per activar-lo.
1. Si Daybreak no està disponible, comprova primer la consulta al catàleg. La inferència pot funcionar encara que la sol·licitud al catàleg falli. Comprova que la sol·licitud arriba a OpenAI amb una clau del projecte correcte i que aquest projecte té accés tant a Daybreak com al model seleccionat.

Activa Daybreak amb l'SDK de TypeScript

Passa el paràmetre de Daybreak mitjançant la configuració del client:

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);

Fes servir daybreak: false per desactivar Daybreak i aplicar el comportament habitual de rebuig de sol·licituds. Mantén la configuració d'autenticació actual.

Activa Daybreak amb el servidor d'aplicacions o l'SDK de Python

1. Consulta els valors d'availableAccessPrograms.cyber del model seleccionat a model/list i defineix cyberAccessProgram als paràmetres de turn/start.

a. Per a un model de la línia principal i un compte amb accés a Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Per a un model de ciberseguretat i un compte amb accés a Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Per al comportament habitual de rebuig de sol·licituds:

{ "cyberAccessProgram": "standard" }

2. Inclou la selecció en cada torn que l'hagi de fer servir; no donis per fet que ometre el paràmetre desactiva Daybreak. Els clients que es connecten directament al servidor d'aplicacions han d'activar la funcionalitat experimentalApi durant la inicialització per poder fer servir aquest paràmetre.

3. El client de baix nivell CodexClient de l'SDK de Python pot passar el mateix paràmetre:

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. Aquest exemple pressuposa que Daybreak Blue està disponible per al model seleccionat. El client de Python activa per defecte la funcionalitat de l'API experimental. Una preferència desada al fil no selecciona, per si sola, cap programa per a un torn del servidor d'aplicacions.

Si vas afegir un catàleg local de models abans d'aquests canvis

Si abans no es mostraven els models que esperaves en iniciar sessió amb una clau d'API, potser vas afegir un catàleg local mitjançant model_catalog_json a config.toml. Codex fa servir aquest fitxer local en lloc del catàleg automàtic, de manera que la llista de models pot quedar desactualitzada. Quan el teu entorn admeti el catàleg automàtic, segueix aquests passos per tornar-lo a fer servir:

Obre config.toml. A Codex CLI, obre ~/.codex/config.toml (o $CODEX_HOME/config.toml si has definit CODEX_HOME). A Codex Desktop, ves a Ajustos > Configuració i selecciona Obre config.toml.
Desactiva temporalment el catàleg local. Afegeix # al principi de la línia model_catalog_json, desa el fitxer i reinicia Codex amb el mateix compte o la mateixa clau d'API. Mantén qualsevol URL de catàleg que exigeixi la teva organització.
Comprova el teu accés. A la CLI, inicia codex i introdueix /daybreak dins de la sessió. A Desktop, obre el selector avançat de models i activa Daybreak. Si tens accés a Daybreak Red, confirma que apareix un dels models de ciberseguretat esperats i que pots enviar una sol·licitud amb aquest model.
Mantén la configuració que funcioni. Si la comprovació és satisfactòria, suprimeix la línia que has desactivat i desa el fitxer. Si falla, elimina el #, desa el fitxer i reinicia Codex per restaurar la configuració anterior.

Resol problemes de rebuig de sol·licituds a la CLI

Executa una tasca representativa amb les mateixes credencials, el mateix model i la mateixa configuració que fa servir la teva automatització.
Si Daybreak no està disponible, confirma que:
- El teu compte o projecte de l'API té accés a Daybreak.
- El model seleccionat és compatible amb Daybreak.
A la CLI interactiva, comprova que Daybreak estigui activat. La CLI interactiva pot mostrar un missatge de rebuig quan Daybreak està disponible però desactivat: Daybreak està desactivat. Si estàs fent tasques de seguretat autoritzades, activa'l i torna a enviar la sol·licitud.
- El missatge pregunta Vols activar Daybreak per a la pròxima sol·licitud? i ofereix les opcions Activa Daybreak o Ara no.
- Selecciona Activa Daybreak per activar-lo per a la pròxima sol·licitud i torna a enviar-la. Tingues en compte que la sol·licitud rebutjada no es torna a enviar automàticament; l'has de tornar a enviar tu. Algunes sol·licituds es poden continuar rebutjant amb Daybreak activat.
- Selecciona Ara no per deixar Daybreak desactivat.
En les automatitzacions, confirma que daybreak=true arriba al procés de Codex que s'executa i que cap altre paràmetre de la línia d'ordres no l'anul·la.

Fes servir Daybreak amb Codex Security CLI

Codex Security CLI fa servir @openai/codex-security per fer anàlisis de seguretat. Les seves opcions de programa d'accés són independents de les dels exemples generals de Codex CLI anteriors.

Per autenticar-te amb una clau d'API, fes servir una clau d'un projecte d'API amb Daybreak habilitat i selecciona explícitament el programa autoritzat per a aquest projecte. Per a Daybreak Blue:

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

Fes servir daybreak_red només si el teu projecte està autoritzat per a Daybreak Red, o standard per aplicar les mesures de protecció estàndard. Seleccionar un programa no dona accés a aquest programa ni a models addicionals.

Consulta la referència de Codex Security CLI per conèixer les opcions d'autenticació i d'anàlisi.

Fes servir Daybreak amb l'SDK de Codex Security

L'SDK de Codex Security per a TypeScript (@openai/codex-security) executa anàlisis de seguretat des d'una aplicació o una eina de desenvolupament. És independent de l'SDK general de Codex descrit anteriorment.

Fes servir les credencials del teu compte o projecte d'API autoritzat. Algunes sol·licituds de ciberseguretat i troballes protegides requereixen Trusted Access for Cyber. Instal·lar l'SDK o seleccionar un model no dona accés a Daybreak.

Segueix la guia de l'SDK de Codex Security per conèixer les opcions d'autenticació i configuració compatibles i veure exemples d'anàlisi.

Com fer servir Daybreak a Codex CLI