Codex-Benachrichtigungen: Hinweis erhalten, wenn es fertig ist oder auf Freigabe wartet

Codex kann dir sagen, wann ein Turn fertig ist und wann es deine Freigabe braucht. Der Haken: Die beiden Mechanismen in der Konfigurationsdatei decken unterschiedliche Events ab, und in den meisten Terminals wird aus der „Desktop-Benachrichtigung“ stillschweigend eine Glocke.

Von Aslan, Pet-Island-Team · Aktualisiert am 26. Okt. 2026 · 3 Min. Lesezeit

KURZE ANTWORT

Verwende den Abschnitt [tui]: notifications = ["agent-turn-complete", "approval-requested"] und notification_condition = "always", wenn du Hinweise auch bei fokussiertem Terminal willst. Codex sendet eine Desktop-Benachrichtigung (OSC 9) nur in Ghostty, iTerm2, Kitty, Warp und WezTerm. Überall sonst, auch in Windows Terminal, läutet es die Glocke. Die Einstellung notify auf oberster Ebene startet dein eigenes Programm, aber nur bei agent-turn-complete, nie bei Freigaben.

Zwei verschiedene Einstellungen

	[tui] notifications	notify
Was sie macht	Terminalhinweis aus der Codex CLI	Startet ein Programm deiner Wahl
Turn abgeschlossen	Ja (`agent-turn-complete`)	Ja (`agent-turn-complete`)
Freigabe angefordert	Ja (`approval-requested`)	Nein
Plan- / Frage-Abfragen	Ja (`plan-mode-prompt`, `async-question`)	Nein
Standard	An	Aus

Wenn du wissen willst, wann Codex auf dich wartet, schafft notify allein das nie. Nutze dafür die TUI-Benachrichtigungen.

TUI-Benachrichtigungen

Das ist der relevante Teil aus OpenAIs Beispielkonfiguration:

~/.codex/config.tomlKopieren

[tui]

# Desktop notifications from the TUI: boolean or filtered list. Default: true

notifications = ["agent-turn-complete", "approval-requested"]

# Notification mechanism for terminal alerts: auto | osc9 | bel. Default: "auto"

notification_method = "auto"

# When notifications fire: unfocused (default) | always

notification_condition = "unfocused"

notifications: true, false oder eine Liste von Events. approval-requested deckt Freigabeanfragen für Befehle, Dateiänderungen und MCP ab.
notification_condition: Standardmäßig lösen Hinweise nur aus, wenn das Terminal nicht fokussiert ist. Setz always, wenn du das Terminal auf einem anderen Monitor sichtbar hast.
notification_method: auto, osc9 oder bel.

Die Meldungen lauten etwa „Approval requested: <command>“, „Codex wants to edit <file>“ und „Agent turn complete“.

Warum du nur einen Piep hörst (Windows Terminal und andere)

Im Modus auto sendet Codex eine Desktop-Benachrichtigung (die Escape-Sequenz OSC 9) nur, wenn es Ghostty, iTerm2, Kitty, Warp oder WezTerm erkennt. Jedes andere Terminal (Windows Terminal, das VS-Code-Terminal, Apple Terminal) bekommt die Terminalglocke. Das stammt aus dem Quellcode von Codex (tui/src/notifications/mod.rs); die Doku sagt nur, dass auto „OSC 9 bevorzugt“.

In Windows Terminal kannst du die Glocke auffälliger machen: Setz in den Profileinstellungen bellStyle auf all, damit ein Ton abgespielt wird und das Taskleistensymbol blinkt (Standard ist audible).

Windows Terminal settings.json (Profil)Kopieren

{

"bellStyle": "all"

}

Du kannst auch notification_method = "osc9" erzwingen; ob dein Terminal daraus eine Systembenachrichtigung macht, hängt vom Terminal ab.

Dein eigenes Programm mit notify starten

notify startet ein externes Programm, wenn ein Turn abgeschlossen ist, und übergibt ein JSON-Argument mit type, thread-id, turn-id, cwd, input-messages und last-assistant-message. Damit eignet es sich für einen Push aufs Handy, einen Webhook oder ein Log: alles über das Terminal hinaus. Es ist ein Schlüssel auf oberster Ebene, gehört also über jeden [section]-Abschnitt:

~/.codex/config.tomlKopieren

notify = ["python3", "/Users/you/.codex/notify.py"]

Ein minimales Skript nach dem Vorbild aus OpenAIs Doku:

~/.codex/notify.pyKopieren

import json, subprocess, sys

notification = json.loads(sys.argv[1])

if notification.get("type") == "agent-turn-complete":

message = (notification.get("last-assistant-message") or "Turn complete")[:120]

# macOS: a system notification. On Linux use ["notify-send", "Codex", message].

subprocess.run(["osascript", "-e", f'display notification {json.dumps(message)} with title "Codex"'])

Die .codex/config.toml eines Projekts kann notify nicht setzen. Es muss in deiner Benutzerkonfiguration stehen.
Der Quellcode von Codex markiert notify als Legacy und plant, es durch Hooks zu ersetzen. Heute funktioniert es; behalte den Changelog im Auge.

Und Hooks?

Codex hat auch Hooks. Sie sind standardmäßig aktiv und umfassen die Events PermissionRequest und Stop, werden in ~/.codex/hooks.json oder einer [hooks]-Tabelle konfiguriert, und jeder nicht verwaltete Hook muss mit /hooks geprüft und als vertrauenswürdig markiert werden, bevor er läuft. Es gibt kein Notification-Event, und OpenAIs Doku zeigt keinen Benachrichtigungs-Hook. Für Hinweise ist die TUI-Einstellung oben der dokumentierte Weg.

Die Codex-App und die IDE-Erweiterung

Die Codex-Desktop-App hat eigene Steuerelemente: Hinweise zum Turn-Ende lassen sich auf nie, nur wenn die App im Hintergrund ist, oder immer stellen, und separate Schalter aktivieren oder deaktivieren Berechtigungs- und Fragebenachrichtigungen. Die IDE-Erweiterung hat keine eigenen Benachrichtigungseinstellungen. OpenAIs Doku verweist stattdessen auf notify.

Wenn du über die ChatGPT-App vom Handy aus freigibst: Issue #39346 meldet einen Fall, in dem das Handy „approval waiting“ anzeigt, ohne Karte, über die man antworten kann.

Es sehen und darauf antworten

Eine Glocke sagt dir, dass in irgendeinem Terminal etwas passiert ist. Pet Island zeigt Codex auf einer kleinen Insel oben auf deinem Bildschirm (arbeitet, wartet oder fertig), und wenn Codex einen Befehl ausführen oder eine Datei bearbeiten will, erscheint die Anfrage dort mit dem Befehl oder dem Diff. Erlaube oder verweigere sie, ohne das Fenster zu wechseln; bei Fragen bringt dich ein Klick ins richtige Terminal. Es funktioniert mit der Codex CLI und der Codex-App, neben Claude Code, Cursor und deinen anderen Agenten.

FAQ

Wie bekomme ich eine Benachrichtigung, wenn Codex fertig ist?

Die TUI-Benachrichtigungen von Codex sind für agent-turn-complete standardmäßig an, lösen aber standardmäßig nur aus, wenn das Terminal nicht fokussiert ist. Setz notification_condition = "always" in [tui], wenn du sie auch bei fokussiertem Terminal willst.

Wie werde ich benachrichtigt, wenn Codex eine Freigabe braucht?

Füge "approval-requested" zu notifications im Abschnitt [tui] von ~/.codex/config.toml hinzu. Die Einstellung notify löst bei Freigaben nicht aus.

Warum piept Codex nur, statt eine Benachrichtigung anzuzeigen?

Im Modus auto sendet Codex eine Desktop-Benachrichtigung nur in Ghostty, iTerm2, Kitty, Warp und WezTerm. Andere Terminals, auch Windows Terminal, bekommen die Glocke.

Kann ich notify in die .codex/config.toml meines Projekts schreiben?

Nein. Die Projektkonfiguration kann notify nicht setzen; trag es in ~/.codex/config.toml ein.

Hat Codex einen Notification-Hook?

Nein. Codex-Hooks umfassen PermissionRequest und Stop, aber es gibt kein Notification-Event und keinen dokumentierten Benachrichtigungs-Hook.

Quellen

Jede Einstellung und jedes Verhalten auf dieser Seite wurde am 26. Oktober 2026 mit diesen Seiten abgeglichen. Agenten ändern sich schnell; wenn etwas nicht mehr passt, gilt die offizielle Seite.

WEITERLESEN

Codex