Se connecterTélécharger

Notifications de Codex : être averti quand il termine ou attend une approbation

Codex peut vous prévenir quand un tour est terminé et quand il a besoin de votre approbation. Le piège : les deux mécanismes du fichier de configuration couvrent des événements différents, et sur la plupart des terminaux la « notification de bureau » devient discrètement une sonnerie.

Par Aslan, équipe Pet Island · Mis à jour le 26 oct. 2026 · 3 min de lecture

RÉPONSE COURTE

Utilisez la section [tui] : notifications = ["agent-turn-complete", "approval-requested"], et notification_condition = "always" si vous voulez des alertes même quand le terminal a le focus. Codex n’envoie une notification de bureau (OSC 9) que dans Ghostty, iTerm2, Kitty, Warp et WezTerm. Partout ailleurs, y compris dans Windows Terminal, il fait sonner le terminal. Le paramètre de premier niveau notify exécute votre propre programme, mais uniquement pour agent-turn-complete, jamais pour les approbations.

Deux paramètres différents

[tui] notificationsnotify
Ce qu’il faitAlerte dans le terminal, émise par la CLI CodexExécute un programme de votre choix
Fin du tourOui (agent-turn-complete)Oui (agent-turn-complete)
Approbation demandéeOui (approval-requested)Non
Demandes de plan / questionsOui (plan-mode-prompt, async-question)Non
Par défautActivéDésactivé

Si vous voulez savoir quand Codex vous attend, notify seul n’y arrivera jamais. Utilisez pour cela les notifications de la TUI.

Les notifications de la TUI

Voici la partie concernée de l’exemple de configuration d’OpenAI :

~/.codex/config.tomlCopier
[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 ou une liste d’événements. approval-requested couvre les demandes d’approbation de commandes, de modifications de fichiers et MCP.
  • notification_condition : par défaut, les alertes ne se déclenchent que lorsque le terminal n’a pas le focus. Choisissez always si votre terminal reste visible sur un autre écran.
  • notification_method : auto, osc9 ou bel.

Les messages ressemblent à « Approval requested: <command> », « Codex wants to edit <file> » et « Agent turn complete ».

Pourquoi vous n’entendez qu’un bip (Windows Terminal et autres)

En mode auto, Codex n’envoie une notification de bureau (la séquence d’échappement OSC 9) que lorsqu’il reconnaît Ghostty, iTerm2, Kitty, Warp ou WezTerm. Tous les autres terminaux (Windows Terminal, le terminal de VS Code, Apple Terminal) reçoivent la sonnerie du terminal. Cela vient du code source de Codex (tui/src/notifications/mod.rs) ; la documentation dit seulement que auto « prefers OSC 9 » (privilégie OSC 9).

Dans Windows Terminal, vous pouvez rendre la sonnerie plus visible : définissez bellStyle sur all dans les paramètres du profil pour émettre un son et faire clignoter l’icône dans la barre des tâches (la valeur par défaut est audible).

settings.json de Windows Terminal (profil)Copier
{
"bellStyle": "all"
}

Vous pouvez aussi forcer notification_method = "osc9" ; c’est le terminal qui décide s’il la transforme en notification système.

Exécuter votre propre programme avec notify

notify exécute un programme externe à la fin d’un tour et lui transmet un argument JSON contenant type, thread-id, turn-id, cwd, input-messages et last-assistant-message. C’est donc idéal pour une notification push sur téléphone, un webhook ou un journal : tout ce qui dépasse le terminal. C’est une clé de premier niveau, placez-la donc au-dessus de toute [section] :

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

Un script minimal, inspiré de celui de la documentation d’OpenAI :

~/.codex/notify.pyCopier
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"'])
  • Le .codex/config.toml d’un projet ne peut pas définir notify. Il doit se trouver dans votre configuration utilisateur.
  • Le code source de Codex marque notify comme hérité et prévoit de le remplacer par des hooks. Il fonctionne aujourd’hui ; surveillez le changelog.

Et les hooks ?

Codex a aussi des hooks. Ils sont activés par défaut et comprennent les événements PermissionRequest et Stop, configurés dans ~/.codex/hooks.json ou dans une table [hooks], et chaque hook non géré doit être examiné et approuvé avec /hooks avant de s’exécuter. Il n’existe pas d’événement Notification, et la documentation d’OpenAI ne montre aucun hook de notification. Pour les alertes, le paramètre de la TUI ci-dessus est la méthode documentée.

L’application Codex et l’extension IDE

L’application de bureau Codex a ses propres réglages : les alertes de fin de tour peuvent être réglées sur jamais, uniquement quand l’application est en arrière-plan, ou toujours, et des interrupteurs distincts activent ou désactivent les notifications d’autorisation et de question. L’extension IDE n’a pas de paramètres de notification propres. La documentation d’OpenAI vous renvoie plutôt à notify.

Si vous approuvez depuis votre téléphone via l’application ChatGPT, l’issue #39346 signale un cas où le téléphone affiche « approval waiting » sans carte permettant d’y répondre.

Voir la demande, et y répondre

Une sonnerie vous dit que quelque chose s’est passé dans un terminal quelconque. Pet Island affiche Codex sur une petite île en haut de votre écran (au travail, en attente ou terminé), et quand Codex demande à exécuter une commande ou à modifier un fichier, la demande s’y affiche avec la commande ou le diff. Autorisez-la ou refusez-la sans changer de fenêtre ; pour les questions, un clic vous mène au bon terminal. Pet Island fonctionne avec la CLI Codex et l’application Codex, aux côtés de Claude Code, Cursor et vos autres agents.

FAQ

Comment recevoir une notification quand Codex a terminé ?

Les notifications de la TUI de Codex sont activées par défaut pour agent-turn-complete, mais ne se déclenchent par défaut que lorsque le terminal n’a pas le focus. Définissez notification_condition = "always" dans [tui] si vous les voulez aussi quand il a le focus.

Comment être averti quand Codex a besoin d’une approbation ?

Ajoutez "approval-requested" à notifications dans la section [tui] de ~/.codex/config.toml. Le paramètre notify ne se déclenche pas pour les approbations.

Pourquoi Codex se contente-t-il d’un bip au lieu d’afficher une notification ?

En mode auto, Codex n’envoie une notification de bureau que dans Ghostty, iTerm2, Kitty, Warp et WezTerm. Les autres terminaux, y compris Windows Terminal, reçoivent la sonnerie.

Puis-je mettre notify dans le .codex/config.toml de mon projet ?

Non. La configuration du projet ne peut pas définir notify ; placez-le dans ~/.codex/config.toml.

Codex a-t-il un hook Notification ?

Non. Les hooks de Codex comprennent PermissionRequest et Stop, mais il n’existe ni événement Notification ni hook de notification documenté.

Sources

Chaque paramètre et chaque comportement décrits sur cette page ont été vérifiés dans ces pages le 26 octobre 2026. Les agents évoluent vite : si quelque chose ne correspond plus, c’est la page officielle qui fait foi.

À LIRE AUSSI

Codex

Codex demande sans cesse une approbation ? Stratégies d’approbation, bac à sable et « don’t ask again » expliqués

Lire →Claude Code

Notifications de Claude Code : savoir s’il attend ou s’il a terminé

Lire →Gemini CLI

Notifications de Gemini CLI : un son ou une alerte quand il termine ou a besoin de vous

Lire →

Répondez à tous vos agents depuis le haut de votre écran.

Windows et Mac · 7 jours gratuits, puis 8,99 $ une seule fois · 1 $ de chaque vente nourrit des animaux errants

Essayer Pet Island gratuitement