Notifikasi Claude Code di Mac: Tahu Kapan Agen Selesai

Dapatkan notifikasi macOS saat Claude Code atau Codex selesai atau butuh input: lewat hooks Claude Code, notify di Codex, atau bunyi bawaan Vibe Console.

Inti dari Claude Code justru proses agen yang berjalan lama: Anda serahkan tugas, lalu kerjakan hal lain. Masalahnya, kapan harus kembali? Terlalu sering mengecek, waktu yang dihemat jadi hilang; terlambat mengecek, agen ternyata sudah menunggu izin sejak menit kedua.

Ada tiga cara mengatasinya di Mac, dari hook buatan sendiri sampai fitur bawaan.

Dua momen yang perlu Anda tahu

Apa pun caranya, ada dua momen berbeda yang ingin Anda dengar:

Selesai. Agen sudah menyelesaikan gilirannya dan menunggu pesan Anda berikutnya.
Butuh input. Agen berhenti di tengah tugas, biasanya untuk meminta izin menjalankan perintah atau mengedit file.

Yang kedua lebih penting. Agen yang tertahan di permintaan izin sama sekali tidak membuat kemajuan.

Opsi 1: hooks Claude Code

Claude Code bisa menjalankan perintah shell saat event tertentu terjadi. Dua event hook mencakup momen di atas:

Stop berjalan saat Claude selesai merespons.
Notification berjalan saat Claude butuh perhatian Anda, misalnya permintaan izin atau menunggu input terlalu lama.

Tambahkan ke ~/.claude/settings.json (untuk semua proyek) atau .claude/settings.json di satu proyek. Contoh ini memakai osascript, yang sudah bawaan macOS:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Task finished\" with title \"Claude Code\" sound name \"Glass\"'"
          }
        ]
      }
    ],
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Waiting for your input\" with title \"Claude Code\" sound name \"Funk\"'"
          }
        ]
      }
    ]
  }
}

Restart Claude Code dan jalankan tugas singkat untuk mengujinya. Pertama kali, macOS mungkin bertanya apakah Script Editor boleh menampilkan notifikasi.

Keterbatasan cara ini: notifikasinya tidak menyebutkan dari proyek atau terminal mana asalnya, mengkliknya tidak membawa Anda ke sana, dan Anda perlu setup serupa untuk setiap agen lain. Cek dokumentasi hooks Claude Code untuk daftar event terbaru.

Opsi 2: `notify` di Codex

Codex CLI bisa menjalankan program setelah setiap giliran agen. Di ~/.codex/config.toml, isi notify dengan sebuah perintah; Codex akan mengirimkan deskripsi event dalam format JSON:

notify = ["osascript", "-e", "display notification \"Codex finished\" with title \"Codex\""]

Versi Codex terbaru juga mendukung hooks, termasuk event Stop, yang dikonfigurasi di hooks.json atau tabel [hooks] di config.toml. Opsinya berubah antarversi, jadi cek dokumentasi hooks Codex untuk versi Anda.

Opsi 3: bawaan Vibe Console

Vibe Console memantau setiap terminal agen untuk Anda, untuk kedelapan agen yang didukung, tanpa konfigurasi:

Titik status di setiap tab menunjukkan apakah agennya sedang berjalan atau diam, jadi grid berisi banyak agen bisa dibaca sekilas.
Saat agen selesai, aplikasi memutar suara (Glass secara default) dan sebentar membuka notch MacBook di sesi tersebut, menunjukkan agen dan terminal mana.
Saat agen berhenti untuk menunggu Anda, aplikasi memutar suara lain (Funk secara default), jadi Anda bisa membedakan “selesai” dan “tertahan” tanpa melihat layar.
Kedua suara bisa diganti, atau dimatikan.

Aplikasi juga mengirim notifikasi macOS saat penggunaan Claude Code atau Codex Anda melewati 80% dan 100% dari sebuah jendela. Lihat batas penggunaan Claude Code.

Fitur ini paling terasa saat Anda menjalankan beberapa agen sekaligus. Lihat cara menjalankan banyak agen Claude Code secara paralel.

Mana yang sebaiknya dipakai?

	Hooks / notify	Vibe Console
Biaya	Gratis	Sudah termasuk di aplikasi
Setup	Per agen, JSON atau TOML	Tidak perlu
Membedakan selesai dan tertahan	Ya, dengan dua hook	Ya, dua suara
Menunjukkan terminal mana	Tidak	Ya, di notch
Berlaku untuk kedelapan agen	Hanya yang punya hooks	Ya

Kalau Anda hanya menjalankan satu sesi Claude Code dalam satu waktu, hooks sudah cukup. Kalau Anda menjalankan beberapa agen di beberapa proyek, workspace yang tahu terminal mana yang mana paling banyak menghemat waktu.

FAQ

Kenapa hook Claude Code saya tidak jalan?

Pastikan JSON-nya valid, file-nya ada di lokasi yang benar, dan Claude Code sudah di-restart. Jalankan perintah osascript-nya langsung di terminal untuk memastikan notifikasi diizinkan.

Bisakah notifikasinya masuk ke HP?

Hooks bisa memanggil perintah apa pun, termasuk layanan push. Claude Code juga mendukung remote control dari aplikasi mobile-nya, jadi Anda bisa mengecek sesi saat jauh dari meja.

Coba bunyi notifikasi bawaan gratis selama 14 hari: unduh Vibe Console.