Claude Code push notifications: ketahui saat tugas selesai

Claude Code bisa bekerja sendiri selama dua puluh menit. Masalahnya ada pada sisa dua puluh menit itu: Anda harus terus memantau terminal, atau Anda pergi dan kembali menemukan bahwa sejak menit ketiga ia sudah menunggu permintaan izin.
Hook mengatasi kedua hal itu. Claude Code menjalankan perintah shell pada titik-titik tertentu dalam siklus hidupnya, dan tiga titik di antaranya persis yang Anda butuhkan di ponsel:
- Stop: Claude selesai merespons. Tugasnya sudah selesai, atau ia punya pertanyaan.
- Notification: Claude membutuhkan Anda. Ada permintaan izin, atau ia menganggur menunggu input.
- StopFailure: giliran berakhir karena error API, misalnya rate limit atau masalah tagihan.
Panduan ini menghubungkan ketiga event tersebut ke Pocket Alert dengan satu skrip. Pengaturannya memakan waktu sekitar lima menit.
Yang Anda butuhkan
- Claude Code, versi terbaru apa pun.
jqdancurl. Keduanya sudah tersedia di sebagian besar distribusi Linux; di macOS, jalankanbrew install jq.- Akun Pocket Alert dan kunci API dari Kunci API. Paket gratis sudah cukup.
- Aplikasi Pocket Alert di iPhone atau Android Anda, sudah masuk.
Langkah 1. Skrip hook
Claude Code mengirim setiap hook sebuah objek JSON lewat stdin. Field yang Anda perlukan adalah hook_event_name, cwd, last_assistant_message pada Stop, message pada Notification, dan error pada StopFailure. Skrip mengubahnya menjadi push:
#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.cwd' <<<"$payload")")
case "$(jq -r '.hook_event_name' <<<"$payload")" in
Stop)
title="Claude finished · $project"
message=$(jq -r '.last_assistant_message // "Task complete"' <<<"$payload")
level=default ;;
Notification)
title="Claude needs you · $project"
message=$(jq -r '.message' <<<"$payload")
level=high ;;
StopFailure)
title="Claude stopped · $project"
message=$(jq -r '"API error: " + (.error // "unknown")' <<<"$payload")
level=high ;;
*) exit 0 ;;
esac
jq -n --arg t "$title" --arg m "${message:0:300}" --arg l "$level" \
'{title: $t, message: $m, level: $l}' |
curl -sS --max-time 10 https://api.pocketalert.app/v1/messages \
-H "Token: $POCKETALERT_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- >/dev/null || true
exit 0
Simpan sebagai ~/.claude/hooks/pocketalert.sh lalu jadikan executable:
mkdir -p ~/.claude/hooks
chmod +x ~/.claude/hooks/pocketalert.sh
Dua baris di dalamnya lebih penting daripada kelihatannya:
jq -nmembuat JSON. Pesan terakhir Claude penuh dengan tanda kutip, backtick, dan baris baru. Menempelkannya ke string JSON secara manual akan rusak di tanda kutip pertama;jqmelakukan escape dengan benar.exit 0di akhir, dan|| truesetelah curl. Untuk hook Stop, exit code 2 berarti "jangan berhenti, lanjutkan". Hook notifikasi tidak boleh menghentikan Claude, bahkan saat jaringan Anda mati.
Atau dengan CLI Pocket Alert
Jika CLI Pocket Alert 2.0 atau yang lebih baru sudah terpasang, blok curl menjadi satu perintah. CLI melakukan escape teks sendiri dan mengambil kunci dari POCKETALERT_API_KEY (blok env di bawah mengaturnya) atau dari pocketalert auth:
pocketalert send -t "$title" -m "${message:0:300}" -l "$level" -q >/dev/null 2>&1 || true
Gunakan -t dan -m, bukan argumen posisional: balasan yang diawali tanda hubung, seperti daftar Markdown, akan terbaca sebagai opsi.
Langkah 2. Daftarkan hook
Tambahkan hook ke ~/.claude/settings.json agar berlaku untuk setiap proyek. Jika file sudah punya key hooks, gabungkan entri ini ke dalamnya:
{
"env": {
"POCKETALERT_API_KEY": "YOUR_API_KEY"
},
"hooks": {
"Stop": [
{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }] }
],
"StopFailure": [
{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }] }
],
"Notification": [
{
"matcher": "permission_prompt|idle_prompt",
"hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }]
}
]
}
}
Blok env memberikan kunci API ke hook tanpa menaruhnya di profil shell Anda. Jika Anda sudah mengekspor POCKETALERT_API_KEY di tempat lain, hapus blok ini.
matcher pada Notification menyaring berdasarkan jenis notifikasi. permission_prompt aktif ketika permintaan izin sudah menunggu sekitar enam detik tanpa jawaban, dan idle_prompt sekitar satu menit setelah Claude selesai jika Anda belum mengetik apa pun. Dalam sesi terminal, keduanya hanya aktif saat Anda tampak sedang tidak di depan layar, jadi keduanya tidak akan menggetarkan ponsel saat Anda sedang mengawasi. Stop tidak punya matcher: ia aktif setiap kali Claude selesai merespons.
Untuk membatasi hook ke satu repositori, letakkan blok hooks yang sama di .claude/settings.json dalam repositori tersebut, atau di .claude/settings.local.json agar tidak masuk git.
Langkah 3. Uji coba
Claude Code biasanya otomatis membaca perubahan pada file pengaturan (mulai sesi baru jika /hooks belum menampilkannya). Berikan tugas kecil:
> List the files in this directory and stop.
Saat Claude selesai, ponsel Anda menampilkan Claude finished · your-project dengan awal balasannya. Jalankan /hooks di dalam Claude Code untuk melihat hook yang terdaftar jika tidak ada yang masuk.
Untuk menguji skrip secara terpisah, berikan event palsu:
echo '{"hook_event_name":"Stop","cwd":"/tmp/demo","last_assistant_message":"Hook test"}' \
| POCKETALERT_API_KEY=YOUR_API_KEY ~/.claude/hooks/pocketalert.sh
Yang masuk ke ponsel Anda
| Event | Title | Body | Level |
|---|---|---|---|
| Tugas selesai | Claude finished · api | 300 karakter pertama dari balasan terakhir Claude | default |
| Permintaan izin | Claude needs you · api | Claude needs your permission | high |
| Menunggu input | Claude needs you · api | Claude is waiting for your input | high |
| Error API | Claude stopped · api | API error: rate_limit | high |
high tiba sebagai time-sensitive di iPhone, sehingga permintaan izin akan lolos dari Fokus sementara pesan "selesai" rutin tetap senyap. Setiap push juga tersimpan di riwayat aplikasi dan dasbor web, sehingga Anda bisa menelusuri kembali apa yang dilakukan Claude semalam.
Sesuaikan dengan kebutuhan Anda
Hanya saat Anda pergi. Stop aktif setelah setiap respons, termasuk respons singkat yang sedang Anda awasi. Tambahkan saklar di bagian atas skrip:
[ -f ~/.claude/away ] || exit 0
Lalu jalankan touch ~/.claude/away saat Anda meninggalkan meja dan rm ~/.claude/away saat kembali. Permintaan izin tetap layak diterima dalam kondisi apa pun, jadi Anda bisa meletakkan pengecekan ini di dalam cabang Stop) saja.
Kelompokkan per proyek. Buat satu aplikasi per proyek di Pocket Alert dan tambahkan application_id ke JSON. Aplikasi kemudian akan memfilter per proyek dan Anda bisa memberi setiap proyek level default sendiri.
Jangan pernah menghambat Claude. Tambahkan "async": true di samping "type": "command" dan hook berjalan di latar belakang. Lewati pada eksekusi headless (claude -p): hook latar belakang dihentikan saat sesi berakhir, dan push mungkin tidak pernah terkirim.
Lanjutkan dari ponsel. Pada paket berbayar, tombol aksi copy dengan ID sesi memungkinkan Anda menyalin claude --resume <id> dari ponsel dan menempelkannya saat sudah kembali.
Atau biarkan Claude mengirimnya lewat MCP
Hook bersifat deterministik: ia aktif apa pun yang diingat Claude. Jalur lainnya adalah memberi Claude sebuah alat notifikasi dan membiarkannya memutuskan kapan menggunakannya. Tambahkan server MCP Pocket Alert:
claude mcp add --transport http pocketalert https://mcp.pocketalert.app/mcp \
--scope user --header "Authorization: Bearer YOUR_API_KEY"
Sekarang Anda bisa berkata "jalankan migrasi dan kirimi saya jumlah barisnya saat selesai", dan Claude memanggil create_message dengan pesan yang ia tulis untuk kesempatan itu. Alat ini juga menerima level dan actions, dan list_messages memungkinkan Claude membaca kembali apa yang pernah ia kirim.
Gunakan keduanya: hook untuk "selesai" dan "butuh Anda" yang pasti terkirim, MCP untuk pesan dengan konten yang berarti. Untuk persetujuan sebelum langkah berisiko, lihat Notifikasi human-in-the-loop.
Jika tidak ada yang masuk
- Periksa kuncinya. Jalankan perintah uji di atas. Respons
401dari curl berarti kunci API salah; hapus>/dev/nulluntuk melihat responsnya. - Periksa hook sudah termuat. Jalankan
/hooks. Perubahan pada file pengaturan biasanya terbaca dalam hitungan detik; jika hook tidak tercantum, mulai ulang Claude Code. - Periksa
jqada di PATH yang digunakan Claude Code. Hook berjalan dengan environment Claude, dan editor yang dijalankan lewat GUI mungkin tidak melihat/opt/homebrew/binmilik Homebrew. - Periksa batas harian. Paket gratis mengirim 50 pesan per hari. Sesi panjang dengan banyak giliran pendek bisa menghabiskannya; saklar away di atas membantu.
FAQ
Apakah ini berfungsi di ekstensi VS Code dan JetBrains?
Ya. Ekstensi tersebut menjalankan Claude Code di baliknya dan membaca ~/.claude/settings.json yang sama, sehingga hook juga aktif di sana.
Bisakah Claude melihat kunci API?
Tidak dalam percakapan: hook berjalan di luar percakapan, dan output-nya untuk Stop dan Notification tidak ditampilkan ke model. Namun blok env berlaku untuk seluruh sesi, sehingga perintah Bash yang dijalankan Claude bisa membaca variabel tersebut. Jika itu penting, simpan kunci di file yang hanya bisa dibaca Anda, misalnya ~/.config/pocketalert/key dengan mode 600, lalu gunakan -H "Token: $(cat ~/.config/pocketalert/key)" di dalam skrip.
Apa bedanya dengan bel terminal?
Bel dan notifikasi desktop mengharuskan Anda berada di depan komputer. Push sampai ke ponsel di mana pun Anda berada, menyimpan riwayat, dan bisa diatur untuk menembus Fokus pada permintaan yang memblokir Claude.
Bisakah saya mendapatkan seluruh balasan, bukan 300 karakter?
Push membawa hingga sekitar 3.000 karakter teks. Naikkan batas 0:300, tetapi push ditujukan untuk memutuskan apakah Anda perlu kembali ke meja, bukan untuk membaca jawaban lengkap.
Apakah gratis?
Ya. Hook adalah bagian dari Claude Code, dan paket Gratis Pocket Alert mencakup 50 pesan per hari untuk satu perangkat. Paket berbayar menambah jumlah pesan, perangkat, dan tombol aksi.
Dapatkan kunci API, pasang skripnya, dan biarkan Claude memberi tahu Anda kapan giliran Anda tiba.