MasukUnduh

Notifikasi Codex: dapatkan peringatan saat ia selesai atau menunggu persetujuan

Codex dapat memberi tahu Anda saat sebuah giliran selesai dan saat ia membutuhkan persetujuan Anda. Masalahnya: dua mekanisme di file konfigurasi mencakup event yang berbeda, dan di sebagian besar terminal, “notifikasi desktop” diam-diam berubah menjadi bunyi bel.

Oleh Aslan, tim Pet Island · Diperbarui 26 Okt 2026 · 3 menit baca

JAWABAN SINGKAT

Gunakan bagian [tui]: notifications = ["agent-turn-complete", "approval-requested"], dan notification_condition = "always" jika Anda ingin peringatan tetap muncul saat terminal sedang fokus. Codex mengirim notifikasi desktop (OSC 9) hanya di Ghostty, iTerm2, Kitty, Warp, dan WezTerm. Di tempat lain, termasuk Windows Terminal, Codex membunyikan bel. Pengaturan tingkat atas notify menjalankan program Anda sendiri, tetapi hanya untuk agent-turn-complete, tidak pernah untuk persetujuan.

Dua pengaturan yang berbeda

[tui] notificationsnotify
FungsinyaPeringatan terminal dari Codex CLIMenjalankan program pilihan Anda
Giliran selesaiYa (agent-turn-complete)Ya (agent-turn-complete)
Persetujuan dimintaYa (approval-requested)Tidak
Prompt rencana / pertanyaanYa (plan-mode-prompt, async-question)Tidak
DefaultAktifNonaktif

Jika Anda ingin tahu kapan Codex menunggu Anda, notify saja tidak akan pernah cukup. Gunakan notifikasi TUI untuk itu.

Notifikasi TUI

Ini bagian yang relevan dari contoh konfigurasi OpenAI:

~/.codex/config.tomlSalin
[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, atau daftar event. approval-requested mencakup permintaan persetujuan perintah, pengeditan file, dan MCP.
  • notification_condition: secara default, peringatan hanya muncul saat terminal tidak sedang fokus. Setel always jika Anda membiarkan terminal tetap terlihat di monitor lain.
  • notification_method: auto, osc9, atau bel.

Pesannya terlihat seperti “Approval requested: <command>”, “Codex wants to edit <file>”, dan “Agent turn complete”.

Mengapa Anda hanya mendengar bunyi bip (Windows Terminal dan lainnya)

Dalam mode auto, Codex mengirim notifikasi desktop (escape sequence OSC 9) hanya saat mengenali Ghostty, iTerm2, Kitty, Warp, atau WezTerm. Terminal lainnya (Windows Terminal, terminal VS Code, Apple Terminal) mendapatkan bel terminal. Ini berasal dari kode sumber Codex (tui/src/notifications/mod.rs); dokumentasinya hanya menyebutkan bahwa auto “lebih mengutamakan OSC 9”.

Di Windows Terminal, Anda dapat membuat bel lebih mudah diperhatikan: setel bellStyle ke all di pengaturan profil untuk memutar suara dan membuat ikon taskbar berkedip (default-nya audible).

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

Anda juga dapat memaksa notification_method = "osc9"; apakah terminal Anda mengubahnya menjadi notifikasi sistem bergantung pada terminalnya.

Jalankan program Anda sendiri dengan notify

notify menjalankan program eksternal saat sebuah giliran selesai dan meneruskan satu argumen JSON berisi type, thread-id, turn-id, cwd, input-messages, dan last-assistant-message. Karena itu, notify cocok untuk push ke ponsel, webhook, atau log: apa pun di luar terminal. Ini adalah kunci tingkat atas, jadi letakkan di atas [section] mana pun:

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

Skrip minimal, mengikuti contoh di dokumentasi OpenAI:

~/.codex/notify.pySalin
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"'])
  • .codex/config.toml milik proyek tidak dapat menyetel notify. Pengaturan ini harus ada di konfigurasi pengguna Anda.
  • Kode sumber Codex menandai notify sebagai legacy dan berencana menggantinya dengan hook. Saat ini masih berfungsi; pantau terus changelog-nya.

Bagaimana dengan hook?

Codex juga memiliki hook. Hook aktif secara default dan mencakup event PermissionRequest dan Stop, dikonfigurasi di ~/.codex/hooks.json atau tabel [hooks], dan setiap hook yang tidak terkelola harus ditinjau dan dipercayai dengan /hooks sebelum berjalan. Tidak ada event Notification, dan dokumentasi OpenAI tidak menunjukkan hook notifikasi. Untuk peringatan, pengaturan TUI di atas adalah jalur yang terdokumentasi.

Aplikasi Codex dan ekstensi IDE

Aplikasi desktop Codex memiliki kontrolnya sendiri: peringatan giliran selesai dapat disetel ke tidak pernah, hanya saat aplikasi berada di latar belakang, atau selalu, dan sakelar terpisah mengaktifkan atau menonaktifkan notifikasi izin dan pertanyaan. Ekstensi IDE tidak memiliki pengaturan notifikasi sendiri. Dokumentasi OpenAI mengarahkan Anda ke notify sebagai gantinya.

Jika Anda memberi persetujuan dari ponsel melalui aplikasi ChatGPT, issue #39346 melaporkan kasus ketika ponsel menampilkan “approval waiting” tanpa kartu untuk menjawabnya.

Melihatnya, dan menjawabnya

Bel memberi tahu Anda bahwa sesuatu terjadi di salah satu terminal. Pet Island menampilkan Codex di sebuah island kecil di bagian atas layar Anda (sedang bekerja, menunggu, atau selesai), dan saat Codex meminta izin untuk menjalankan perintah atau mengedit file, permintaannya muncul di sana beserta perintah atau diff-nya. Izinkan atau tolak tanpa berpindah jendela; untuk pertanyaan, sekali klik membawa Anda ke terminal yang tepat. Pet Island bekerja dengan Codex CLI dan aplikasi Codex, berdampingan dengan Claude Code, Cursor, dan agen Anda lainnya.

FAQ

Bagaimana cara mendapatkan notifikasi saat Codex selesai?

Notifikasi TUI Codex aktif secara default untuk agent-turn-complete, tetapi secara default hanya muncul saat terminal tidak sedang fokus. Setel notification_condition = "always" di [tui] jika Anda menginginkannya saat terminal sedang fokus.

Bagaimana cara mendapatkan notifikasi saat Codex membutuhkan persetujuan?

Tambahkan "approval-requested" ke notifications di bagian [tui] pada ~/.codex/config.toml. Pengaturan notify tidak terpicu untuk persetujuan.

Mengapa Codex hanya berbunyi bip alih-alih menampilkan notifikasi?

Dalam mode auto, Codex mengirim notifikasi desktop hanya di Ghostty, iTerm2, Kitty, Warp, dan WezTerm. Terminal lain, termasuk Windows Terminal, mendapatkan bel.

Bisakah saya meletakkan notify di .codex/config.toml proyek saya?

Tidak. Konfigurasi proyek tidak dapat menyetel notify; letakkan di ~/.codex/config.toml.

Apakah Codex memiliki hook Notification?

Tidak. Hook Codex mencakup PermissionRequest dan Stop, tetapi tidak ada event Notification dan tidak ada hook notifikasi yang terdokumentasi.

Sumber

Setiap pengaturan dan perilaku di halaman ini telah dicocokkan dengan halaman-halaman berikut pada 26 Oktober 2026. Agen berubah dengan cepat; jika ada yang tidak lagi sesuai, halaman resmi yang berlaku.

BACA JUGA

Codex

Codex terus meminta persetujuan? Penjelasan approval policy, sandbox, dan “don’t ask again”

Baca →Claude Code

Notifikasi Claude Code: ketahui kapan ia menunggu dan kapan ia selesai

Baca →Gemini CLI

Notifikasi Gemini CLI: dapatkan suara atau peringatan saat ia selesai atau membutuhkan Anda

Baca →

Jawab setiap agen dari bagian atas layar Anda.

Windows dan Mac · Gratis 7 hari, lalu $8.99 sekali bayar · $1 dari setiap penjualan memberi makan hewan jalanan

Coba Pet Island gratis