Meldingen van Codex: krijg een seintje als het klaar is of op goedkeuring wacht

Codex kan je laten weten wanneer een beurt klaar is en wanneer het je goedkeuring nodig heeft. Het addertje: de twee mechanismen in het configuratiebestand dekken verschillende events, en in de meeste terminals wordt een “bureaubladmelding” ongemerkt gewoon een bel.

Door Aslan, Pet Island-team · Bijgewerkt op 26 okt. 2026 · 3 min lezen

KORT ANTWOORD

Gebruik de sectie [tui]: notifications = ["agent-turn-complete", "approval-requested"], en notification_condition = "always" als je ook meldingen wilt terwijl de terminal focus heeft. Codex verstuurt alleen in Ghostty, iTerm2, Kitty, Warp en WezTerm een bureaubladmelding (OSC 9). Overal elders, ook in Windows Terminal, laat het de bel klinken. De instelling notify op het hoogste niveau voert je eigen programma uit, maar alleen voor agent-turn-complete, nooit voor goedkeuringen.

Twee verschillende instellingen

	[tui] notifications	notify
Wat het doet	Terminalmelding vanuit de Codex CLI	Voert een programma naar keuze uit
Beurt klaar	Ja (`agent-turn-complete`)	Ja (`agent-turn-complete`)
Goedkeuring gevraagd	Ja (`approval-requested`)	Nee
Prompts voor plannen / vragen	Ja (`plan-mode-prompt`, `async-question`)	Nee
Standaard	Aan	Uit

Wil je weten wanneer Codex op je wacht, dan lukt dat nooit met alleen notify. Gebruik daarvoor de TUI-meldingen.

TUI-meldingen

Dit is het relevante deel van de voorbeeldconfiguratie van OpenAI:

~/.codex/config.tomlKopiëren

[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 of een lijst met events. approval-requested dekt goedkeuringsverzoeken voor commando’s, bestandsbewerkingen en MCP.
notification_condition: standaard gaan meldingen alleen af als de terminal geen focus heeft. Stel always in als je de terminal zichtbaar houdt op een andere monitor.
notification_method: auto, osc9 of bel.

De berichten zien eruit als “Approval requested: <command>”, “Codex wants to edit <file>” en “Agent turn complete”.

Waarom je alleen een piep hoort (Windows Terminal en andere)

In de modus auto verstuurt Codex alleen een bureaubladmelding (de escapereeks OSC 9) als het Ghostty, iTerm2, Kitty, Warp of WezTerm herkent. Elke andere terminal (Windows Terminal, de terminal van VS Code, Apple Terminal) krijgt de terminalbel. Dit komt uit de broncode van Codex (tui/src/notifications/mod.rs); de documentatie zegt alleen dat auto “prefers OSC 9”.

In Windows Terminal kun je de bel opvallender maken: zet bellStyle in de profielinstellingen op all om een geluid af te spelen en het taakbalkpictogram te laten knipperen (de standaard is audible).

settings.json van Windows Terminal (profiel)Kopiëren

{

"bellStyle": "all"

}

Je kunt ook notification_method = "osc9" afdwingen; of je terminal daar een systeemmelding van maakt, hangt af van de terminal.

Je eigen programma uitvoeren met notify

notify voert een extern programma uit als een beurt klaar is en geeft één JSON-argument mee met type, thread-id, turn-id, cwd, input-messages en last-assistant-message. Daardoor is het geschikt voor een pushmelding op je telefoon, een webhook of een log: alles buiten de terminal. Het is een sleutel op het hoogste niveau, dus zet hem boven elke [section]:

~/.codex/config.tomlKopiëren

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

Een minimaal script, naar het voorbeeld in de documentatie van OpenAI:

~/.codex/notify.pyKopiëren

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"'])

De .codex/config.toml van een project kan notify niet instellen. Het moet in je gebruikersconfiguratie staan.
De broncode van Codex markeert notify als verouderd en is van plan het te vervangen door hooks. Het werkt nu; houd de changelog in de gaten.

En hooks dan?

Codex heeft ook hooks. Die staan standaard aan en omvatten de events PermissionRequest en Stop, ingesteld in ~/.codex/hooks.json of een [hooks]-tabel, en elke niet-beheerde hook moet met /hooks worden beoordeeld en vertrouwd voordat hij draait. Er is geen Notification-event, en de documentatie van OpenAI toont geen meldingshook. Voor meldingen is de TUI-instelling hierboven de gedocumenteerde weg.

De Codex-app en de IDE-extensie

De Codex-desktopapp heeft eigen instellingen: meldingen voor een afgeronde beurt kun je instellen op nooit, alleen als de app op de achtergrond staat, of altijd, en aparte schakelaars zetten meldingen voor toestemmingen en vragen aan of uit. De IDE-extensie heeft geen eigen meldingsinstellingen. De documentatie van OpenAI verwijst je in plaats daarvan naar notify.

Keur je goed vanaf je telefoon via de ChatGPT-app, dan meldt issue #39346 een geval waarin de telefoon “approval waiting” toont zonder kaart om erop te antwoorden.

Zien en beantwoorden

Een bel vertelt je dat er in een of andere terminal iets is gebeurd. Pet Island toont Codex op een klein eiland bovenaan je scherm (bezig, wacht of klaar), en als Codex vraagt om een commando uit te voeren of een bestand te bewerken, verschijnt het verzoek daar met het commando of de diff. Sta het toe of weiger het zonder van venster te wisselen; bij vragen brengt één klik je naar de juiste terminal. Het werkt met de Codex CLI en de Codex-app, naast Claude Code, Cursor en je andere agents.

VEELGESTELDE VRAGEN

Hoe krijg ik een melding als Codex klaar is?

De TUI-meldingen van Codex staan standaard aan voor agent-turn-complete, maar gaan standaard alleen af als de terminal geen focus heeft. Zet notification_condition = "always" in [tui] als je ze ook wilt terwijl de terminal focus heeft.

Hoe krijg ik een melding als Codex goedkeuring nodig heeft?

Voeg "approval-requested" toe aan notifications in de sectie [tui] van ~/.codex/config.toml. De instelling notify gaat niet af bij goedkeuringen.

Waarom piept Codex alleen in plaats van een melding te tonen?

In de modus auto verstuurt Codex alleen een bureaubladmelding in Ghostty, iTerm2, Kitty, Warp en WezTerm. Andere terminals, waaronder Windows Terminal, krijgen de bel.

Kan ik notify in de .codex/config.toml van mijn project zetten?

Nee. Projectconfiguratie kan notify niet instellen; zet het in ~/.codex/config.toml.

Heeft Codex een Notification-hook?

Nee. De hooks van Codex omvatten PermissionRequest en Stop, maar er is geen Notification-event en geen gedocumenteerde meldingshook.

Bronnen

Elke instelling en elk gedrag op deze pagina is op 26 oktober 2026 gecontroleerd aan de hand van deze pagina’s. Agents veranderen snel; klopt er iets niet meer, dan geldt de officiële pagina.

VERDER LEZEN

Codex