Mit dieser Anleitung aktivierst du Daybreak in Codex CLI, konfigurierst es für automatisierte Abläufe und SDK-Integrationen und behebst Probleme beim Zugriff oder bei der Ablehnung von Anfragen.

Um diese Änderungen nutzen zu können, musst du auf Codex CLI 0.163.0 oder höher aktualisieren. CLI-Updates erfolgen nur auf deine Initiative hin: Bestehende Installationen behalten ihr aktuelles Verhalten bei, bis du sie aktualisierst.

Wenn deine Automatisierung @openai/codex@latest installiert, kann sie diese Änderung bei der nächsten Installation oder Aktualisierung übernehmen. Wenn du Codex CLI mit npm global installiert hast, führe npm install -g @openai/codex@latest aus. Prüfe anschließend mit codex --version, ob das Update erfolgreich war.
Um die Änderung aufzuschieben, lege @openai/codex@0.162.0 als feste Version fest. Eine einmalige Installation mit @latest aktualisiert sich nicht selbst. Workflows, die auf ältere Versionen festgelegt sind, behalten ihr bisheriges Verhalten bei.
Aktualisiere für TypeScript-Integrationen @openai/codex-sdk und die mitgelieferte Laufzeitumgebung. Aktualisiere für Python-Integrationen openai-codex und die zugehörige Codex-Laufzeitumgebung. Ein Update der globalen CLI allein aktualisiert möglicherweise nicht die Laufzeitumgebung eines SDK. Wenn du einen benutzerdefinierten Pfad zu einer ausführbaren Datei konfigurierst, aktualisiere auch diese Datei.

Manuell konfigurierte Modell-IDs, die in einem ansonsten verfügbaren Katalog fehlen, werden in der CLI und in Codex Desktop weiterhin automatisch wie bisher behandelt, auch wenn Daybreak aktiviert ist. Allein ihr Fehlen im Katalog verhindert nicht, dass eine Anfrage erfolgreich ist.

Modelle für Cybersicherheit werden möglicherweise separat in der Modellauswahl bereitgestellt. Nach der Freischaltung ist kein weiterer Download nötig, um die neu verfügbaren Modelle zu sehen, sofern du bereits eine unterstützte Version verwendest. Öffne die Modellauswahl erneut oder starte Codex neu, um die Liste zu aktualisieren.

Daybreak in der interaktiven CLI aktivieren

Starte Codex mit deiner üblichen Authentifizierung.
Gib /daybreak ein, um Daybreak zu aktivieren.
Codex meldet dann Daybreak on. Applies to new turns.
Diese Einstellung gilt für den aktiven Thread und wird als Standard für neue Sitzungen gespeichert.
Um Daybreak zu deaktivieren, führe denselben Befehl (/daybreak) erneut aus.

Daybreak in der CLI ohne interaktive Oberfläche aktivieren

Headless-Workflows laufen ohne interaktive Benutzeroberfläche, meist über codex exec in Skripten, geplanten Aufträgen oder CI. Hier gibt es keine interaktive Abfrage „Daybreak aktivieren“ (/daybreak). Stattdessen hast du folgende Möglichkeiten:

Aktiviere Daybreak für einen bestimmten CLI-Lauf, indem du jedem Befehl, bei dem weniger Anfragen abgelehnt werden sollen, -c daybreak=true hinzufügst. Du könntest zum Beispiel Folgendes eingeben:

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

Behalte deinen bestehenden Prompt und die anderen Befehlsoptionen bei. Füge diese Einstellung jedem Aufruf hinzu, der Daybreak verwenden soll, auch Befehlen in Skripten, geplanten Aufträgen und der CI-Konfiguration.
Aktiviere Daybreak standardmäßig für neue CLI-Sitzungen und -Läufe, indem du daybreak=true zur Konfigurationsdatei hinzufügst, die Codex lädt.
Die standardmäßige Benutzerkonfiguration liegt in ~/.codex/config.toml. Wenn deine Automatisierung CODEX_HOME setzt, verwende stattdessen $CODEX_HOME/config.toml. Platziere die Einstellung auf der obersten Ebene, außerhalb von Abschnitten wie [features].
Nimm die Änderung in der Umgebung vor, in der die Automatisierung tatsächlich läuft. Wenn du die Konfiguration auf deinem Laptop aktualisierst, wird dadurch weder ein CI-Runner noch ein entfernter Rechner aktualisiert.
Die Einstellung gilt auch für neue interaktive Sitzungen, die dieselbe Konfiguration verwenden. Fortgesetzte und abgezweigte Sitzungen behalten ihre gespeicherte Daybreak-Auswahl bei. Ein neuer Standardwert in der Konfiguration ersetzt sie nicht.
Beachte, dass eine Befehlszeileneinstellung die gespeicherte Konfiguration für den jeweiligen Aufruf überschreibt. Du kannst daher daybreak = true in deiner Konfiguration beibehalten und für einen einzelnen Lauf -c daybreak=false verwenden.

Daybreak über das TypeScript SDK aktivieren

Übergib die Daybreak-Einstellung über die Client-Konfiguration:

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

Verwende daybreak: false, um Daybreak zu deaktivieren und das normale Ablehnungsverhalten zu nutzen. Behalte deine bestehende Authentifizierungskonfiguration bei.

Daybreak über den App-Server oder das Python SDK aktivieren

1. Lies die Werte für availableAccessPrograms.cyber des ausgewählten Modells aus model/list aus. Setze anschließend cyberAccessProgram in den Parametern von turn/start.

a. Für ein reguläres Modell und ein Konto mit Zugriff auf Daybreak Blue:

{ "cyberAccessProgram": "daybreakBlue" }

b. Für ein Modell für Cybersicherheit und ein Konto mit Zugriff auf Daybreak Red:

{ "cyberAccessProgram": "daybreakRed" }

c. Für das normale Ablehnungsverhalten:

{ "cyberAccessProgram": "standard" }

2. Übergib die Auswahl bei jedem Gesprächsschritt, der sie verwenden soll. Gehe nicht davon aus, dass Daybreak deaktiviert wird, wenn du den Parameter weglässt. Clients, die den App-Server direkt ansprechen, müssen bei der Initialisierung die Funktion experimentalApi aktivieren, um diesen Parameter zu verwenden.

3. Der Low-Level-Client CodexClient des Python SDK kann denselben Parameter übergeben:

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. Dieses Beispiel setzt voraus, dass Daybreak Blue für das ausgewählte Modell verfügbar ist. Der Python-Client aktiviert die experimentelle API-Funktion standardmäßig. Eine gespeicherte Thread-Einstellung allein legt kein Programm für einen Gesprächsschritt auf dem App-Server fest.

Wenn du vor diesen Änderungen einen lokalen Modellkatalog hinzugefügt hast

Wenn dir nach der Anmeldung mit einem API-Schlüssel bisher nicht die erwarteten Modelle angezeigt wurden, hast du möglicherweise über model_catalog_json in config.toml einen lokalen Katalog hinzugefügt. Codex verwendet diese lokale Datei anstelle des automatischen Katalogs. Dadurch kann deine Modellliste veralten. Sobald der automatische Katalog in deiner Umgebung unterstützt wird, kannst du mit diesen Schritten zurückwechseln:

Öffne config.toml. Öffne für Codex CLI ~/.codex/config.toml (oder $CODEX_HOME/config.toml, wenn du CODEX_HOME gesetzt hast). Gehe in Codex Desktop zu Einstellungen > Konfiguration und wähle dann config.toml öffnen.
Deaktiviere den lokalen Katalog vorübergehend. Füge am Anfang der Zeile mit model_catalog_json ein # ein, speichere die Datei und starte Codex mit demselben Konto oder API-Schlüssel neu. Behalte alle Katalog-URLs bei, die deine Organisation vorschreibt.
Prüfe deinen Zugriff. Starte in der CLI codex und gib dann innerhalb der Sitzung /daybreak ein. Öffne in Desktop die erweiterte Modellauswahl und aktiviere Daybreak. Wenn du Zugriff auf Daybreak Red hast, prüfe, ob ein erwartetes Modell für Cybersicherheit angezeigt wird und du damit eine Anfrage senden kannst.
Behalte die funktionierende Konfiguration bei. Wenn die Prüfung erfolgreich ist, lösche die deaktivierte Zeile und speichere die Datei. Wenn sie fehlschlägt, entferne das #, speichere die Datei und starte Codex neu, um deine vorherige Konfiguration wiederherzustellen.

Probleme mit Ablehnungen in der CLI beheben

Führe einen repräsentativen Auftrag mit denselben Anmeldedaten, demselben Modell und derselben Konfiguration aus, die deine Automatisierung verwendet.
Wenn Daybreak nicht verfügbar ist, prüfe Folgendes:
- Dein Konto oder API-Projekt hat Zugriff auf Daybreak.
- Das ausgewählte Modell unterstützt Daybreak.
Prüfe in der interaktiven CLI, ob Daybreak aktiviert ist. Wenn Daybreak verfügbar, aber deaktiviert ist, kann die interaktive CLI eine Ablehnungsmeldung anzeigen: Daybreak is currently off. If you’re doing authorized security work, turn it on and try your request again.
- Die Abfrage lautet Turn on Daybreak for your next request? und bietet Enable Daybreak oder Not now zur Auswahl.
- Wähle Daybreak aktivieren, um Daybreak für deine nächste Anfrage einzuschalten, und stelle die Anfrage dann erneut. Beachte, dass die abgelehnte Anfrage nicht automatisch wiederholt wird. Du musst sie erneut stellen. Manche Anfragen können auch bei aktiviertem Daybreak weiterhin abgelehnt werden.
- Wähle Nicht jetzt, um Daybreak deaktiviert zu lassen.
Prüfe bei Automatisierungen, ob daybreak=true tatsächlich an den Codex-Prozess übergeben wird und nicht durch eine andere Befehlszeileneinstellung überschrieben wird.