Codex bildirimleri: işi bittiğinde veya onay beklediğinde uyarı al

Codex bir turun bittiğini ve onayına ihtiyaç duyduğunu sana bildirebilir. Ama bir sorun var: yapılandırma dosyasındaki iki mekanizma farklı event'leri kapsıyor ve çoğu terminalde “masaüstü bildirimi” sessizce bir zile dönüşüyor.

Aslan, Pet Island ekibi · Güncellendi: 26 Eki 2026 · 3 dk okuma

KISA CEVAP

[tui] bölümünü kullan: notifications = ["agent-turn-complete", "approval-requested"] ve terminal odaktayken bile uyarı istiyorsan notification_condition = "always". Codex masaüstü bildirimini (OSC 9) sadece Ghostty, iTerm2, Kitty, Warp ve WezTerm'de gönderir. Windows Terminal dahil diğer her yerde zili çalar. Üst seviyedeki notify ayarı kendi programını çalıştırır, ama sadece agent-turn-complete için, onaylar için asla.

İki farklı ayar

	[tui] notifications	notify
Ne yapar	Codex CLI'dan terminal uyarısı	Seçtiğin bir programı çalıştırır
Tur tamamlandı	Evet (`agent-turn-complete`)	Evet (`agent-turn-complete`)
Onay istendi	Evet (`approval-requested`)	Hayır
Plan / soru istemleri	Evet (`plan-mode-prompt`, `async-question`)	Hayır
Varsayılan	Açık	Kapalı

Codex'in seni ne zaman beklediğini bilmek istiyorsan notify tek başına bunu asla yapmaz. Bunun için TUI bildirimlerini kullan.

TUI bildirimleri

OpenAI'ın örnek yapılandırmasının ilgili kısmı şu:

~/.codex/config.tomlKopyala

[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 veya bir event listesi. approval-requested komut, dosya düzenleme ve MCP onay isteklerini kapsar.
notification_condition: varsayılan olarak uyarılar sadece terminal odakta değilken tetiklenir. Terminali başka bir monitörde görünür tutuyorsan always ayarla.
notification_method: auto, osc9 veya bel.

Mesajlar “Approval requested: <command>”, “Codex wants to edit <file>” ve “Agent turn complete” gibi görünür.

Neden sadece bip sesi duyuyorsun (Windows Terminal ve diğerleri)

auto modunda Codex masaüstü bildirimini (OSC 9 kaçış dizisi) sadece Ghostty, iTerm2, Kitty, Warp veya WezTerm terminalini tanıdığında gönderir. Diğer tüm terminaller (Windows Terminal, VS Code terminali, Apple Terminal) terminal zilini alır. Bu bilgi Codex'in kaynak kodundan (tui/src/notifications/mod.rs) geliyor; dokümanlar sadece auto modunun “OSC 9'u tercih ettiğini” söylüyor.

Windows Terminal'de zili daha fark edilir yapabilirsin: profil ayarlarında bellStyle değerini all yaparak ses çalmasını ve görev çubuğu simgesinin yanıp sönmesini sağla (varsayılan audible).

Windows Terminal settings.json (profil)Kopyala

{

"bellStyle": "all"

}

notification_method = "osc9" ayarını zorlayabilirsin de; terminalinin bunu bir sistem bildirimine dönüştürüp dönüştürmeyeceği terminale bağlıdır.

notify ile kendi programını çalıştır

notify, bir tur tamamlandığında harici bir program çalıştırır ve ona type, thread-id, turn-id, cwd, input-messages ve last-assistant-message içeren tek bir JSON argümanı verir. Bu da onu telefona push bildirimi, bir webhook veya bir log için, yani terminalin ötesindeki her şey için uygun hâle getirir. Üst seviye bir anahtardır, bu yüzden herhangi bir [section] bölümünün üstüne koy:

~/.codex/config.tomlKopyala

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

OpenAI dokümanlarındakini temel alan minimal bir script:

~/.codex/notify.pyKopyala

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

Bir projenin .codex/config.toml dosyası notify ayarlayamaz. Kullanıcı yapılandırmanda olması gerekir.
Codex'in kaynak kodu notify ayarını eski (legacy) olarak işaretliyor ve onu hook'larla değiştirmeyi planlıyor. Bugün çalışıyor; değişiklik günlüğünü takip et.

Peki ya hook'lar?

Codex'in de hook'ları var. Varsayılan olarak açıktırlar, PermissionRequest ve Stop event'lerini içerirler, ~/.codex/hooks.json dosyasında veya bir [hooks] tablosunda yapılandırılırlar ve yönetilmeyen her hook'un çalışmadan önce /hooks ile incelenip güvenilir olarak işaretlenmesi gerekir. Notification event'i yoktur ve OpenAI'ın dokümanları bir bildirim hook'u göstermez. Uyarılar için belgelenmiş yol yukarıdaki TUI ayarıdır.

Codex uygulaması ve IDE eklentisi

Codex masaüstü uygulamasının kendi kontrolleri var: tur tamamlandı uyarıları asla, sadece uygulama arka plandayken veya her zaman olarak ayarlanabilir; ayrı anahtarlar da izin ve soru bildirimlerini açıp kapatır. IDE eklentisinin kendine ait bildirim ayarları yoktur. OpenAI'ın dokümanları bunun yerine seni notify ayarına yönlendirir.

ChatGPT uygulaması üzerinden telefonundan onay veriyorsan, #39346 numaralı issue, telefonun cevap verecek bir kart olmadan “approval waiting” gösterdiği bir durumu bildiriyor.

Görmek ve cevap vermek

Bir zil, bir terminalde bir şey olduğunu söyler. Pet Island, Codex'i ekranının üstündeki küçük bir adada gösterir (çalışıyor, bekliyor veya bitti) ve Codex bir komut çalıştırmak veya bir dosyayı düzenlemek istediğinde istek, komut veya diff ile birlikte orada görünür. Pencere değiştirmeden izin ver veya reddet; sorular için tek tık seni doğru terminale götürür. Claude Code, Cursor ve diğer ajanlarının yanında Codex CLI ve Codex uygulamasıyla çalışır.

SSS

Codex bittiğinde nasıl bildirim alırım?

Codex'in TUI bildirimleri agent-turn-complete için varsayılan olarak açıktır, ama varsayılan olarak sadece terminal odakta değilken tetiklenir. Odaktayken de istiyorsan [tui] içinde notification_condition = "always" ayarla.

Codex onaya ihtiyaç duyduğunda nasıl bildirim alırım?

~/.codex/config.toml dosyasının [tui] bölümündeki notifications listesine "approval-requested" ekle. notify ayarı onaylar için tetiklenmez.

Codex neden bildirim göstermek yerine sadece bip sesi çıkarıyor?

Auto modunda Codex masaüstü bildirimini sadece Ghostty, iTerm2, Kitty, Warp ve WezTerm'de gönderir. Windows Terminal dahil diğer terminaller zili alır.

notify ayarını projemin .codex/config.toml dosyasına koyabilir miyim?

Hayır. Proje yapılandırması notify ayarlayamaz; onu ~/.codex/config.toml dosyasına koy.

Codex'in Notification hook'u var mı?

Hayır. Codex hook'ları PermissionRequest ve Stop içerir, ama Notification event'i ve belgelenmiş bir bildirim hook'u yoktur.

Kaynaklar

Bu sayfadaki her ayar ve davranış 26 Ekim 2026 tarihinde bu sayfalarla karşılaştırılarak kontrol edildi. Ajanlar hızlı değişir; bir şey artık uyuşmuyorsa geçerli olan resmi sayfadır.

OKUMAYA DEVAM ET

Codex