Codex bildirimleri (Mac): onay gerektiğinde veya iş bittiğinde haberin olsun.

Codex’in Mac’te sana bildirim göndermesinin dört yolu var. Bir tur, tek bir çalışma döngüsüdür: bir mesaj gönderirsin, Codex çalışır, ardından durur ve seni bekler. Bir kanca, Codex’in belirli bir anda, örneğin onayını istemeden hemen önce çalıştırdığı bir komuttur.

Sık karşılaşılan bir karışıklık, notify ayarını yapıp hiç gelmeyecek bir onay bildirimini beklemektir. OpenAI’ın yapılandırma belgelerine göre notify şimdilik yalnızca agent-turn-complete için tetiklenir. Onay istekleri için diğer üç satırdaki seçeneklerden birini kullan.

Codex’in terminal bildirimleri varsayılan olarak açıktır, bu yüzden bunları zaten alıyor olabilirsin. Yalnızca terminal (Terminal veya iTerm2 gibi, Codex’in çalıştığı uygulama) ön planda değilken tetiklenirler. Bildirim almak istediğin olayları kendin seçmek için yapılandırma dosyanda ayarla.

~/.codex/config.toml dosyasına ekle. Dosyada zaten bir [tui] bölümü varsa bu anahtarları o bölümün altına koy; ikinci bir [tui] başlığı ekleme. Yorum satırındaki terminal listesi Codex’in belgelerinden değil, kaynak kodundan alınmıştır (aşağıya bak).

[tui]
notifications = ["agent-turn-complete", "approval-requested"]
notification_method = "auto"        # osc9 in iTerm2/Ghostty/Kitty/Warp/WezTerm; bel elsewhere
notification_condition = "unfocused" # or "always"

notification_method değeri auto olduğunda Codex nasıl haber vereceğini seçer: osc9, bazı terminallerin masaüstü bildirimine dönüştürdüğü özel bir kod (bir kaçış dizisi) gönderir; bel ise terminal zilini çalar. Terminale bakarken de bildirim almak istiyorsan notification_condition değerini "always" olarak ayarla.

Terminal neden yalnızca zil çalar.

OpenAI belgeleri, hangi terminallerin bildirim başlığı gösterdiğini belirtmez. Codex’in herkese açık kaynak koduna göre (bu nedenle değişebilir), bildirim başlığı dizisi Ghostty, iTerm2, Kitty, Warp ve WezTerm’e gönderilir. macOS ile gelen Terminal uygulaması dahil diğer tüm terminallere yalnızca zil sinyali gönderilir. Zil tek başına bildirim başlığı oluşturmaz. Terminal’de Settings > Profiles > Advanced > Bell bölümünde görsel zil, Dock rozeti ve pencere arka plandayken zıplayan Dock simgesi seçenekleri bulunur. Terminal’de gerçek bir bildirim başlığı için aşağıdaki kancayı kullan.

tmux içinde Codex’in bildirim başlığı dizisi yalnızca allow-passthrough açıkken iletilir: on ile yalnızca görünür bir bölmeden, all ile gizli bölmelerden de iletilir (tmux kılavuzu). Şu satırı ~/.tmux.conf dosyasına ekle veya gizli bölmelerden de bildirim almak için on yerine all yaz:

set -g allow-passthrough on

notify, bir tur tamamlandığında tek bir program çalıştırır ve ayrıntıları ona tek bir JSON argümanı olarak iletir. Her terminalde aynı şekilde çalışır. OpenAI’ın örneği, macOS ile gelmeyen üçüncü taraf bir Homebrew aracı olan terminal-notifier’ı kullanır. Aşağıdaki betik yalnızca macOS ile gelen araçları kullanır: Codex’in son yanıtının başlangıcını ve proje klasörünü gösterir, Glass sesini çalar.

1. adım. Bunu yeni bir dosya olarak kaydet: ~/.codex/notify-macos.js:

// Codex notify -> macOS banner + sound. Codex appends one JSON argument.
function run(argv) {
  var n = {};
  try { n = JSON.parse(argv[argv.length - 1] || "{}"); } catch (e) {}
  if (n.type && n.type !== "agent-turn-complete") return;
  var app = Application.currentApplication();
  app.includeStandardAdditions = true;
  var msg = String(n["last-assistant-message"] || "Turn complete").slice(0, 180);
  var folder = String(n.cwd || "").split("/").pop();
  app.displayNotification(msg, { withTitle: "Codex finished", subtitle: folder, soundName: "Glass" });
}

2. adım. Bu satırı mevcut ~/.codex/config.toml dosyana, ilk [section] başlığının üstüne ekle. YOUR_NAME yerine ana klasörünün adını yaz: Codex bu listeyi yazıldığı gibi çalıştırır, bu yüzden ~ tam yola dönüştürülmez (bu bilgi Codex’in belgelerinden değil, kaynak kodundan alınmıştır).

notify = ["/usr/bin/osascript", "-l", "JavaScript", "/Users/YOUR_NAME/.codex/notify-macos.js"]

Bildirim başlığı görünmüyorsa Sistem Ayarları > Bildirimler bölümünü aç. Anthropic’in kanca rehberine göre osascript ile gönderilen bildirim başlıkları burada Script Editor altında listelenir. Buna izin vermen gerekir ve macOS önceden sana sormaz. Mac’inde gördüğün ad farklı olabilir.

Kancalar, Terminal dahil her terminalde gerçek bir onay bildirimi başlığı sağlar. Codex, bir şeyi onaylamanı istemeden hemen önce PermissionRequest kancasını, bir tur bittiğinde ise Stop kancasını çalıştırır. PermissionRequest, onay gerektirmeyen komutlar için tetiklenmez.

~/.codex/hooks.json dosyasına mevcut içerikle birleştirerek ekle. Dosya zaten varsa üzerine yazma: başka araçların girdileri orada bulunabilir (Cowork Island’da Codex’i açtığında onun girdileri de burada tutulur). Aşağıdaki her girdiyi "hooks" içindeki ilgili listeye ekle. Liste yoksa oluştur ve her girdiyi kendi süslü parantezleri içinde tut.

{
  "hooks": {
    "PermissionRequest": [
      { "hooks": [ { "type": "command", "async": true, "timeout": 10,
        "command": "/usr/bin/osascript -e 'display notification \"Codex needs your approval\" with title \"Codex\" sound name \"Funk\"' >/dev/null 2>&1" } ] }
    ],
    "Stop": [
      { "hooks": [ { "type": "command", "async": true, "timeout": 10,
        "command": "/usr/bin/osascript -e 'display notification \"Codex finished\" with title \"Codex\" sound name \"Glass\"' >/dev/null 2>&1" } ] }
    ]
  }
}

1. Dosyayı kaydet, Codex’i aç ve /hooks yaz.
2. İki yeni girdinin de güvenilir olduğunu onayla. Codex, sen güvenilir olduklarını onaylayana kadar yeni veya değiştirilmiş kancaları atlar. Bu yüzden güvenilir olarak onaylanmamış bir kanca çalışmıyor gibi görünür.
3. Sondaki >/dev/null 2>&1 bölümünü koru: bir Stop kancası ya JSON çıktısı vermeli ya da hiç çıktı vermemelidir.

Bunun yerine sesli bir cümle veya telefon bildirimi istiyorsan bildirim yapılandırma oluşturucusu girdiyi tarayıcında oluşturur ve hangi dosyaya ekleneceğini belirtir.

9 Temmuz 2026’dan bu yana Codex uygulaması, macOS’te ChatGPT masaüstü uygulamasının bir parçasıdır. Bildirim ayarları yapılandırma dosyalarında değil, uygulamadadır:

• Settings > Notifications (Cmd+,): tur tamamlanma bildirimlerini hiç gösterme, yalnızca ChatGPT arka plandayken göster veya her zaman göster. İzin ve soru bildirimleri için ayrı anahtarlar bulunur.
• Sound: tamamlanan görevler, izin istekleri ve sorular için tek bir bildirim sesi kullanılır. Default, Classic veya None seçeneğini seç; macOS’te bir sistem sesi veya içe aktardığın bir dosya da kullanılabilir.
• Activity: kullanılabildiği yerlerde, kenar çubuğundaki zil veya Cmd+Option+U, okunmamış, çalışmaya devam eden veya seni bekleyen sohbetleri listeler.

Yukarıdaki [tui] anahtarları, terminalde çalışan Codex içindir. OpenAI belgeleri, notify ayarının veya kendi kancalarının masaüstü uygulamasındaki sohbetlerde çalışıp çalışmadığını belirtmez. Bu yüzden orada bunlara güvenme.

• OpenAI: Gelişmiş yapılandırma
• OpenAI: Yapılandırma başvuru belgesi
• OpenAI: Örnek yapılandırma
• OpenAI: Kancalar
• OpenAI: Bildirimler
• OpenAI: Ayarlar başvuru belgesi
• OpenAI: Değişiklik günlüğü
• openai/codex kaynak kodu (yalnızca terminal listesi için)
• Apple: Terminal profilinin Advanced ayarları
• Apple: Bildirimleri gösterme
• tmux kılavuzu
• Anthropic: Claude Code kanca rehberi (Script Editor)

Kaynaklar 18 Ekim 2026’da kontrol edildi. Bu rehber, Cowork Island’ın yapımcısı tarafından yazılmıştır. Düzeltmeler için support@coworkisland.com adresine e-posta gönder ya da GitHub’da bir kayıt (issue) aç.