Powiadomienia Codex: alert, gdy skończy lub czeka na zatwierdzenie

Codex może dać ci znać, kiedy tura się skończyła i kiedy potrzebuje twojego zatwierdzenia. Haczyk: dwa mechanizmy w pliku konfiguracyjnym obejmują różne zdarzenia, a w większości terminali „powiadomienie na pulpicie” po cichu zamienia się w dzwonek.

Autor: Aslan, zespół Pet Island · Zaktualizowano 26 paź 2026 · 3 min czytania

KRÓTKA ODPOWIEDŹ

Użyj sekcji [tui]: notifications = ["agent-turn-complete", "approval-requested"] oraz notification_condition = "always", jeśli chcesz dostawać alerty także wtedy, gdy terminal jest aktywny. Codex wysyła powiadomienie na pulpicie (OSC 9) tylko w Ghostty, iTerm2, Kitty, Warp i WezTerm. Wszędzie indziej, także w Windows Terminal, używa dzwonka. Ustawienie notify najwyższego poziomu uruchamia twój własny program, ale tylko dla agent-turn-complete, nigdy dla zatwierdzeń.

Dwa różne ustawienia

	[tui] notifications	notify
Co robi	Alert w terminalu z Codex CLI	Uruchamia wybrany przez ciebie program
Tura zakończona	Tak (`agent-turn-complete`)	Tak (`agent-turn-complete`)
Prośba o zatwierdzenie	Tak (`approval-requested`)	Nie
Monity planu / pytania	Tak (`plan-mode-prompt`, `async-question`)	Nie
Domyślnie	Włączone	Wyłączone

Jeśli chcesz wiedzieć, kiedy Codex na ciebie czeka, samo notify nigdy tego nie zapewni. Użyj do tego powiadomień TUI.

Powiadomienia TUI

To odpowiedni fragment przykładowej konfiguracji OpenAI:

~/.codex/config.tomlKopiuj

[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 lub lista zdarzeń. approval-requested obejmuje prośby o zatwierdzenie poleceń, edycji plików i MCP.
notification_condition: domyślnie alerty pojawiają się tylko wtedy, gdy terminal nie jest aktywny. Ustaw always, jeśli terminal jest widoczny na innym monitorze.
notification_method: auto, osc9 lub bel.

Komunikaty wyglądają tak: „Approval requested: <command>”, „Codex wants to edit <file>” i „Agent turn complete”.

Dlaczego słyszysz tylko sygnał dźwiękowy (Windows Terminal i inne)

W trybie auto Codex wysyła powiadomienie na pulpicie (sekwencję ucieczki OSC 9) tylko wtedy, gdy rozpozna Ghostty, iTerm2, Kitty, Warp lub WezTerm. Każdy inny terminal (Windows Terminal, terminal VS Code, Apple Terminal) dostaje dzwonek terminala. Wynika to z kodu źródłowego Codex (tui/src/notifications/mod.rs); dokumentacja mówi tylko, że auto „prefers OSC 9”.

W Windows Terminal możesz sprawić, że dzwonek będzie bardziej zauważalny: ustaw bellStyle na all w ustawieniach profilu, żeby odtwarzać dźwięk i migać ikoną na pasku zadań (domyślnie jest audible).

settings.json Windows Terminal (profil)Kopiuj

{

"bellStyle": "all"

}

Możesz też wymusić notification_method = "osc9"; to, czy terminal zamieni to w powiadomienie systemowe, zależy od terminala.

Uruchamianie własnego programu przez notify

notify uruchamia zewnętrzny program po zakończeniu tury i przekazuje jeden argument JSON z polami type, thread-id, turn-id, cwd, input-messages i last-assistant-message. Dzięki temu nadaje się do powiadomień push na telefon, webhooka lub logu: wszystkiego poza terminalem. To klucz najwyższego poziomu, więc umieść go nad każdą [section]:

~/.codex/config.tomlKopiuj

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

Minimalny skrypt, wzorowany na tym z dokumentacji OpenAI:

~/.codex/notify.pyKopiuj

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

Plik .codex/config.toml projektu nie może ustawiać notify. Musi się ono znaleźć w konfiguracji użytkownika.
Kod źródłowy Codex oznacza notify jako przestarzałe i planuje zastąpić je hookami. Na razie działa; śledź listę zmian.

A co z hookami?

Codex też ma hooki. Są domyślnie włączone i obejmują zdarzenia PermissionRequest oraz Stop, konfigurowane w ~/.codex/hooks.json lub tabeli [hooks], a każdy niezarządzany hook trzeba przejrzeć i oznaczyć jako zaufany za pomocą /hooks, zanim się uruchomi. Nie ma zdarzenia Notification, a dokumentacja OpenAI nie pokazuje hooka powiadomień. Do alertów udokumentowaną drogą jest powyższe ustawienie TUI.

Aplikacja Codex i rozszerzenie IDE

Aplikacja desktopowa Codex ma własne ustawienia: alerty o zakończeniu tury można ustawić na nigdy, tylko gdy aplikacja działa w tle, lub zawsze, a osobne przełączniki włączają lub wyłączają powiadomienia o prośbach o zgodę i o pytaniach. Rozszerzenie IDE nie ma własnych ustawień powiadomień. Dokumentacja OpenAI odsyła zamiast tego do notify.

Jeśli zatwierdzasz z telefonu przez aplikację ChatGPT, zgłoszenie #39346 opisuje przypadek, w którym telefon pokazuje „approval waiting” bez karty, na której można odpowiedzieć.

Jak to zobaczyć i odpowiedzieć

Dzwonek mówi ci, że coś się stało w którymś terminalu. Pet Island pokazuje Codex na małej wyspie u góry ekranu (pracuje, czeka lub skończył), a gdy Codex prosi o uruchomienie polecenia lub edycję pliku, prośba pojawia się tam razem z poleceniem lub diffem. Zezwól lub odmów bez przełączania okien; w przypadku pytań jedno kliknięcie przenosi cię do właściwego terminala. Działa z Codex CLI i aplikacją Codex, obok Claude Code, Cursor i twoich innych agentów.

CZĘSTE PYTANIA

Jak dostać powiadomienie, gdy Codex skończy?

Powiadomienia TUI w Codex są domyślnie włączone dla agent-turn-complete, ale domyślnie pojawiają się tylko wtedy, gdy terminal nie jest aktywny. Ustaw notification_condition = "always" w [tui], jeśli chcesz je dostawać także przy aktywnym terminalu.

Jak dostać powiadomienie, gdy Codex potrzebuje zatwierdzenia?

Dodaj "approval-requested" do notifications w sekcji [tui] pliku ~/.codex/config.toml. Ustawienie notify nie reaguje na zatwierdzenia.

Dlaczego Codex tylko wydaje sygnał dźwiękowy, zamiast pokazać powiadomienie?

W trybie auto Codex wysyła powiadomienie na pulpicie tylko w Ghostty, iTerm2, Kitty, Warp i WezTerm. Inne terminale, w tym Windows Terminal, dostają dzwonek.

Czy mogę umieścić notify w pliku .codex/config.toml projektu?

Nie. Konfiguracja projektu nie może ustawiać notify; umieść je w ~/.codex/config.toml.

Czy Codex ma hook Notification?

Nie. Hooki Codex obejmują PermissionRequest i Stop, ale nie ma zdarzenia Notification ani udokumentowanego hooka powiadomień.

Źródła

Każde ustawienie i zachowanie opisane na tej stronie zostało sprawdzone z tymi stronami 26 października 2026. Agenci szybko się zmieniają; jeśli coś przestało się zgadzać, obowiązuje strona oficjalna.

CZYTAJ DALEJ

Codex