# Claude routines push notification: ketahui saat run cloud membutuhkan Anda

> Claude routines berjalan di cloud Anthropic sesuai jadwal, panggilan API, atau event GitHub, dan tidak memberi tahu siapa pun saat selesai. Berikut cara mendapatkan push notification ke ponsel saat run selesai, gagal, atau menemukan sesuatu.

*18.10.2026*

<!-- source: https://pocketalert.app/id/blog/claude-routines-notifications -->

Claude routines adalah bagian dari Claude Code yang berjalan tanpa Anda. Anda menyimpan prompt dan repository sekali saja, lalu cloud Anthropic memulai sesi Claude Code baru setiap malam, pada setiap pull request baru, atau setiap kali monitoring Anda memanggil sebuah endpoint. Laptop Anda boleh dalam keadaan tertutup.

Masalahnya, routine tidak melaporkan hasilnya ke siapa pun. Hasilnya hanya ada di dalam sesi di claude.ai sampai Anda membukanya sendiri, dan daftar run pun tidak banyak membantu: status hijau hanya berarti sesi berjalan dan keluar tanpa error infrastruktur, bukan berarti pekerjaannya berhasil. Pemeriksaan dependensi malam hari yang menemukan build rusak terlihat sama persis dengan yang tidak menemukan apa-apa.

Panduan ini membuat routine mengirim push ke ponsel Anda lewat Pocket Alert: notifikasi senyap saat semuanya baik-baik saja, dan notifikasi keras saat ada yang membutuhkan perhatian Anda.

## Apa itu Claude routines, secara singkat

Anthropic sekarang menyebutnya **scheduled tasks**. "Routines" adalah nama sebelumnya dan masih muncul di alamat web (`claude.ai/code/routines`), alias CLI `/routines`, serta API. Fiturnya sama, dan saat ini masih dalam research preview.

Routine adalah konfigurasi Claude Code yang disimpan: sebuah prompt, satu atau beberapa repository GitHub, lingkungan cloud, dan sekumpulan connector. Setiap run adalah sesi cloud lengkap yang bisa menjalankan perintah shell, mengedit kode, push ke branch `claude/`, dan memanggil connector. Run dimulai dari trigger, dan satu routine bisa memiliki beberapa trigger:

- **Schedule**: preset per jam, harian, mingguan, ekspresi cron kustom (tidak lebih sering dari sekali per jam), atau run sekali pada waktu tertentu.
- **API**: POST ke endpoint `/fire` milik routine dengan bearer token. Anda bisa mengirim field `text`, misalnya isi alert, yang diterima run sebagai konteks.
- **GitHub**: event pull request, release, atau issue pada repository yang sudah memasang Claude GitHub App, dengan filter pull request berdasarkan author, branch, label, status draft, dan lainnya.

Anda membuat routine di [claude.ai/code/routines](https://claude.ai/code/routines) dengan **New task**, di aplikasi Desktop, atau dengan `/schedule` di Claude Code CLI, misalnya `/schedule daily PR review at 9am`. Routine memerlukan paket Pro, Max, Team, atau Enterprise, dan run mengurangi kuota langganan Anda seperti sesi interaktif.

## Yang Anda butuhkan

- Akun Pocket Alert, kunci API dari [API Keys](/account/apikeys), dan aplikasi di ponsel [iPhone atau Android](/get-app) Anda. Paket Gratis sudah cukup.
- Sebuah routine, atau rencana untuk membuatnya.

Ada dua cara agar run bisa sampai ke ponsel Anda: `curl` dari sesi ke API Pocket Alert, atau [server MCP Pocket Alert](/tools/mcp) yang ditambahkan sebagai connector. Mulailah dengan curl. Cara ini bekerja di setiap paket yang memiliki routines, dan kunci tidak pernah masuk ke dalam sesi.

## Pengaturan: curl dengan network secret

Lingkungan cloud routine memakai akses jaringan **Trusted** secara default: registry paket, API GitHub dan penyedia cloud, dan tidak ada yang lain. `api.pocketalert.app` tidak termasuk dalam daftar itu, jadi `curl` biasa akan gagal dengan `403` dan `x-deny-reason: host_not_allowed`.

**Network secret** menyelesaikan masalah jaringan sekaligus masalah kunci. Anda menyimpan kunci di lingkungan, dan proxy Anthropic menambahkannya ke permintaan untuk host yang Anda daftarkan setelah permintaan keluar dari VM sesi. Host yang memakai network secret dapat dijangkau berapa pun tingkat aksesnya, dan Claude tidak pernah melihat kuncinya.

1. Buka routine di [claude.ai/code/routines](https://claude.ai/code/routines), pilih **Edit**, lalu **Advanced settings > General > Cloud environment**. Arahkan kursor ke lingkungan tersebut dan klik ikon pengaturannya.
2. Di **Network secrets**, klik **Add secret** dan biarkan tipenya **Bearer**.
3. **Name**: `Pocket Alert`. **Allowed websites**: `api.pocketalert.app`.
4. Di bagian **Custom headers**, ubah nama header dari `Authorization` menjadi `Token`, hapus awalan `Bearer`, lalu tempel kunci API Anda sebagai nilainya.
5. Klik **Add**. Secret tersimpan seketika dan tidak bisa dilihat lagi.

Sekarang permintaan tidak perlu kunci sama sekali. Tambahkan ini di akhir prompt routine:

```text
When you are done, send exactly one push notification with curl:

curl -sS https://api.pocketalert.app/v1/messages \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'EOF'
{"title": "<routine name>: <one-line result>", "message": "<2-3 sentence summary>", "level": "<level>"}
EOF

Do not add any auth header; the environment adds it. Build valid JSON.
Pick the level:
- "low" if the run finished and nothing needs my attention.
- "default" if you opened a pull request or found something worth reading today.
- "high" only if the work failed, tests are broken, or you found a real problem.
Include the session link from:
echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
```

Baris terakhir berasal dari dokumentasi Anthropic: setiap sesi cloud dapat membaca ID-nya sendiri dari `CLAUDE_CODE_REMOTE_SESSION_ID`, dan perintah itu mengubahnya menjadi URL transkrip. Dengan link ini di dalam pesan, Anda bisa langsung dari push ke run dengan satu ketukan.

Klik **Run now** di halaman routine untuk mengujinya sebelum run terjadwal pertama.

Jika dialog lingkungan Anda tidak memiliki baris **Custom headers** (pada paket Team tanpa peran admin, formulirnya hanya meminta host dan nilai), atur **Network access** ke **Custom**, tambahkan `api.pocketalert.app` ke **Allowed domains** dengan daftar default tetap dipertahankan, lalu simpan kunci dalam variabel lingkungan seperti `POCKETALERT_KEY`, dan kirim sebagai `-H "Token: $POCKETALERT_KEY"`. Perlu diingat bahwa variabel lingkungan bisa dibaca oleh siapa pun yang menggunakan lingkungan tersebut, itulah sebabnya secret adalah pilihan yang lebih baik.

## Atau pasang server MCP sebagai connector

Routines dapat memakai connector claude.ai Anda, dan lalu lintas connector melewati server Anthropic, jadi tidak perlu mengubah daftar izin sama sekali. Prompt cukup berbunyi "call the pocketalert `create_message` tool" dengan title, message, dan level.

Batasannya ada pada autentikasi. Server MCP Pocket Alert menerima kunci API sebagai `Authorization: Bearer KEY`, dan di claude.ai sebuah custom connector hanya bisa mengirim kunci tetap melalui bagian **Request headers** pada dialog **Add custom connector**. Anthropic menandai bagian itu sebagai beta yang tersedia untuk sejumlah organisasi terbatas. Jika Anda melihatnya (pada paket Team dan Enterprise, Owner menambahkan connector di **Organization settings > Connectors**):

1. Buka [claude.ai/customize/connectors](https://claude.ai/customize/connectors) dan klik **Add custom connector**.
2. URL: `https://mcp.pocketalert.app/mcp`. Authentication: **No sign-in**.
3. Di **Request headers**, pilih `authorization` dan isi `Bearer YOUR_API_KEY`.

Routine baru menyertakan semua connector Anda secara default, jadi periksa tab **Connectors** pada routine dan simpan hanya yang dibutuhkan. Perintah `claude mcp add` di Claude Code CLI tidak membantu di sini: server yang ditambahkan dengan cara itu hanya ada di mesin Anda dan tidak muncul di routines. Jika Anda juga memakai Claude Code secara lokal, pengaturannya ada di [push notification Claude Code](/blog/claude-code-push-notifications); untuk opsi MCP lainnya lihat [server notifikasi MCP terbaik](/blog/best-mcp-notification-servers).

## Lapisan kedua: push yang tidak bergantung pada model

Kedua cara di atas mengandalkan Claude untuk mengikuti paragraf terakhir prompt Anda. Biasanya memang begitu. Namun run yang terkena rate limit atau error API tidak akan pernah sampai ke paragraf itu, padahal run seperti itulah yang paling ingin Anda ketahui.

Hooks juga berjalan di routines: sesi cloud dengan satu repository membaca `.claude/settings.json` milik repository tersebut. Hook `Stop` aktif saat Claude selesai, dan `StopFailure` aktif sebagai gantinya ketika giliran berakhir karena error API seperti `rate_limit` atau `server_error`. Commit file ini sebagai `.claude/settings.json`:

```json
{
  "hooks": {
    "Stop": [
      { "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify.sh done" }] }
    ],
    "StopFailure": [
      { "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify.sh failed" }] }
    ]
  }
}
```

Dan skripnya, `.claude/hooks/notify.sh`, dengan izin executable:

```bash
#!/usr/bin/env bash
[ "$CLAUDE_CODE_REMOTE" = "true" ] || exit 0

payload=$(cat)
last=$(jq -r '.last_assistant_message // ""' <<<"$payload")
link="https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

if [ "$1" = "failed" ]; then
  title="Claude run failed: $(jq -r '.error // "unknown"' <<<"$payload")"
  level=high
else
  title="Claude run finished · $(basename "$CLAUDE_PROJECT_DIR")"
  level=low
fi

jq -n --arg t "$title" --arg m "${last:0:300}
$link" --arg l "$level" '{title: $t, message: $m, level: $l}' |
  curl -sS --max-time 10 https://api.pocketalert.app/v1/messages \
    -H 'Content-Type: application/json' --data-binary @- >/dev/null 2>&1 || true
```

Pemeriksaan `CLAUDE_CODE_REMOTE` membuat hook tetap diam di laptop Anda, karena variabel itu tidak pernah bernilai `true` di sana. `jq` sudah terpasang di sesi cloud, dan network secret dari bagian pertama menyediakan kuncinya. Gunakan push berbasis prompt untuk isinya ("3 paket usang, PR dibuka") dan hook sebagai sinyal "sudah selesai" yang pasti, atau pilih salah satu saja.

Hook aktif untuk setiap sesi cloud pada repository itu, bukan hanya run routine, jadi bersiaplah menerima push saat Anda memakai Claude Code di web pada repository tersebut.

## Level dan tombol

Prompt di atas sudah memakai bagian yang paling penting: level. `low` datang dengan senyap dan tetap tersimpan di riwayat, `high` tampil sebagai time-sensitive di iPhone dan lolos dari Fokus. Aturan "high hanya untuk masalah" mencegah Anda membisukan semuanya setelah seminggu. `critical` juga tersedia dan menembus Jangan Ganggu pada paket berbayar, tetapi routine malam hari jarang membutuhkannya. Lihat [level prioritas](https://info.pocketalert.app/features/priority-levels.html) untuk perilaku tiap level di iOS dan Android.

Pada paket berbayar, sebuah pesan dapat memuat hingga tiga [tombol aksi](https://info.pocketalert.app/features/action-buttons.html). Yang paling berguna di sini adalah tombol `view` dengan URL sesi, ditambahkan ke JSON sebagai:

```json
"actions": [{"type": "view", "label": "Open run", "value": "https://claude.ai/code/session_..."}]
```

Setiap push juga masuk ke riwayat aplikasi dan dasbor web, bersama alert dari server dan CI Anda, sehingga seminggu run malam hari cukup dilihat dalam satu kali gulir.

## Batasan yang jujur

- **Prompt adalah permintaan, bukan jaminan.** Claude biasanya mengirim push, tetapi bisa saja melewatkannya, mengirim dua kali, atau menulis JSON yang salah. Gunakan hook jika Anda membutuhkan kepastian.
- **Run bisa berhenti dan menunggu.** Routines dimulai dalam mode auto, tetapi sebuah aksi yang cocok dengan aturan ask, atau pemblokiran berulang, membuat run menunggu jawaban di dalam sesinya. Baik prompt maupun `Stop` tidak akan memberi tahu Anda tentang jeda ini. Jika sebuah routine biasanya mengirim ping pada pukul 7.10 dan kali ini tidak, periksa langsung.
- **Batas penggunaan berlaku.** Run dihitung terhadap langganan Anda. Tanpa kredit penggunaan, run tambahan ditolak setelah Anda mencapai batas, dan run yang tidak pernah dimulai tidak mengirim apa pun. Ada juga batas per jam: 100 run terjadwal per akun, 30 Run now atau API fire per routine.
- **Research preview.** Anthropic menyatakan perilaku, batasan, dan API masih bisa berubah.
- **Paket Gratis.** 50 pesan per hari di satu perangkat. Routine per jam yang mengirim satu push per run masih muat; satu push per file yang disentuhnya tidak.

## Jika tidak ada yang masuk

1. **Buka run-nya.** Setiap run di **History** routine terbuka sebagai sesi lengkap. Cari `api.pocketalert.app` di transkrip dan baca output curl.
2. **`403` dengan `host_not_allowed`.** Secret tidak ada di lingkungan yang dipakai routine ini, atau host-nya salah ketik. Periksa **Allowed websites**.
3. **`401`.** "No token provided" berarti tidak ada kunci yang sampai ke API: secret belum terpasang atau nama header salah ketik. "token contains an invalid number of segments" berarti header masih `Authorization`; ubah menjadi `Token`. "Invalid token" berarti awalan `Bearer` masih ada atau kunci sudah dicabut.
4. **`400`.** Body bukan JSON yang valid, biasanya karena tanda kutip yang tidak di-escape dari ringkasan. Versi hook membangun JSON dengan `jq`, sehingga masalah ini terhindar.
5. **Hook tidak pernah berjalan.** Pastikan `.claude/settings.json` sudah di-commit pada branch default, skripnya executable, dan routine hanya memiliki satu repository.

## FAQ

### Apakah Claude routines dan scheduled tasks itu sama?

Ya. Anthropic mengganti nama routines menjadi scheduled tasks; alamat web, alias `/routines`, dan API tetap memakai nama lama.

### Apakah routine bisa melihat kunci API Pocket Alert saya?

Tidak jika memakai network secret. Proxy menambahkan header setelah permintaan keluar dari sesi, jadi kunci tidak ada di variabel lingkungan atau file mana pun yang bisa dibaca Claude. Dengan variabel lingkungan, kunci bisa dibaca di dalam sesi.

### Bisakah routine membangunkan saya di malam hari?

Ya, dengan `"level": "critical"` pada paket berbayar. Simpan untuk routine yang memantau produksi, misalnya routine yang dipicu API oleh monitoring Anda saat terjadi lonjakan error.

### Bagaimana dengan penjadwalan lokal memakai /loop atau scheduled tasks Desktop?

Keduanya berjalan di mesin Anda, sehingga hook Claude Code lokal dan server MCP bekerja seperti biasa. Pengaturannya ada di [push notification Claude Code](/blog/claude-code-push-notifications). Untuk pola agen AI lainnya, lihat [alert agen AI](/use-cases/ai-agent-alerts).

[Buat akun gratis](/signup), tambahkan secret, dan biarkan routine besok pagi memberi tahu Anda bagaimana hasilnya.
