> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Jalankan prompt sesuai jadwal

> Gunakan /loop dan alat penjadwalan cron untuk menjalankan prompt berulang kali, polling status, atau mengatur pengingat sekali jalan dalam sesi Claude Code.

Tugas terjadwal memungkinkan Claude menjalankan kembali prompt secara otomatis pada interval tertentu. Gunakan untuk polling deployment, mengawasi PR, memeriksa build yang berjalan lama, atau mengingatkan diri sendiri untuk melakukan sesuatu nanti dalam sesi. Untuk bereaksi terhadap peristiwa saat terjadi daripada polling, lihat [Channels](/docs/id/channels): CI Anda dapat mendorong kegagalan ke dalam sesi secara langsung. Untuk menjaga sesi tetap bekerja giliran demi giliran sampai kondisi terpenuhi daripada pada interval, lihat [`/goal`](/docs/id/goal).

Tugas bersifat session-scoped. Saat Anda melanjutkan dengan `--resume` atau `--continue`, Claude Code memulihkan tugas yang belum [kedaluwarsa](#seven-day-expiry), kecuali yang tercantum di bawah [Limitations](#limitations). Untuk penjadwalan yang bertahan secara independen dari sesi apa pun, gunakan [Routines](/docs/id/routines) untuk membuat routine di cloud, atur [Desktop scheduled task](/docs/id/desktop-scheduled-tasks), atau gunakan [GitHub Actions](/docs/id/github-actions).

<h2 id="compare-scheduling-options">
  Bandingkan opsi penjadwalan
</h2>

Claude Code menawarkan tiga cara untuk menjadwalkan pekerjaan berulang atau sekali jalan:

| | [Cloud](/docs/id/routines) | [Desktop](/docs/id/desktop-scheduled-tasks) | [`/loop`](/docs/id/scheduled-tasks) |
| :- | :- | :- | :- |
| Berjalan di | Cloud, dikelola Anthropic secara default | Mesin Anda | Mesin Anda |
| Memerlukan mesin aktif | Tidak | Ya | Ya |
| Memerlukan sesi terbuka | Tidak | Tidak | Ya |
| Persisten di seluruh restart | Ya | Ya | Dipulihkan pada `--resume`, dengan [pengecualian](/docs/id/scheduled-tasks#limitations) |
| Akses ke file lokal | Tidak (klon segar) | Ya | Ya |
| Server MCP | Konektor dikonfigurasi per tugas | [File konfigurasi](/docs/id/mcp) dan konektor | Mewarisi dari sesi |
| Prompt izin | Tidak (berjalan secara otonom) | Dapat dikonfigurasi per tugas | Mewarisi dari sesi |
| Jadwal yang dapat disesuaikan | Via `/schedule` di CLI | Ya | Ya |
| Interval minimum | 1 jam | 1 menit | 1 menit |

<Tip>
  Gunakan **tugas cloud** untuk pekerjaan yang harus berjalan dengan andal tanpa mesin Anda. Gunakan **tugas Desktop** ketika Anda memerlukan akses ke file dan alat lokal. Gunakan **`/loop`** untuk polling cepat selama sesi.
</Tip>

<h2 id="run-a-prompt-repeatedly-with-/loop">
  Jalankan prompt berulang dengan /loop
</h2>

Skill `/loop` [bundled skill](/docs/id/commands) adalah cara tercepat untuk menjalankan prompt berulang sementara sesi tetap terbuka. Baik interval maupun prompt bersifat opsional, dan apa yang Anda berikan menentukan bagaimana loop berperilaku.

| Apa yang Anda berikan | Contoh | Apa yang terjadi |
| :- | :- | :- |
| Interval dan prompt | `/loop 5m check the deploy` | Prompt Anda berjalan pada [jadwal tetap](#run-on-a-fixed-interval) |
| Hanya prompt | `/loop check the deploy` | Prompt Anda berjalan pada [interval yang dipilih Claude](#let-claude-choose-the-interval) setiap iterasi |
| Hanya interval, atau tidak ada apa-apa | `/loop` | [Prompt pemeliharaan bawaan](#run-the-built-in-maintenance-prompt) berjalan, atau `loop.md` Anda jika ada |

Anda juga dapat melewatkan skill sebagai prompt, misalnya `/loop 20m /review-pr 1234`, untuk menjalankan kembali skill tersebut setiap iterasi. Penjadwalan yang terpicu hanya menjalankan skill yang Claude [diizinkan untuk memanggil sendiri](/docs/id/skills#control-who-invokes-a-skill). Berikut ini mencapai Claude sebagai teks biasa daripada dieksekusi:

* Perintah bawaan seperti `/permissions`, `/model`, atau `/clear`
* Skill yang ditandai [`disable-model-invocation: true`](/docs/id/skills#frontmatter-reference), termasuk skill bundled `/verify`
* Skill yang ditahan dari Claude oleh pengaturan [`skillOverrides`](/docs/id/skills#override-skill-visibility-from-settings) atau aturan [deny](/docs/id/skills#restrict-claude%E2%80%99s-skill-access) `Skill`
* [MCP prompts](/docs/id/mcp#use-mcp-prompts-as-commands) seperti `/mcp__github__list_prs`

<h3 id="run-on-a-fixed-interval">
  Jalankan pada interval tetap
</h3>

Ketika Anda memberikan interval, Claude mengonversinya ke ekspresi cron, menjadwalkan job, dan mengonfirmasi cadence dan ID job.

```text theme={null}
/loop 5m check if the deployment finished and tell me what happened
```

Interval dapat memimpin prompt sebagai token bare seperti `30m`, atau mengikutinya sebagai klausa seperti `every 2 hours`. Unit yang didukung adalah `s` untuk detik, `m` untuk menit, `h` untuk jam, dan `d` untuk hari.

Detik dibulatkan ke menit terdekat karena cron memiliki granularitas satu menit. Interval yang tidak memetakan ke langkah cron yang bersih, seperti `7m` atau `90m`, dibulatkan ke interval terdekat yang bersih dan Claude memberi tahu Anda apa yang dipilihnya.

<h3 id="let-claude-choose-the-interval">
  Biarkan Claude memilih interval
</h3>

Ketika Anda menghilangkan interval, Claude memilih satu secara dinamis daripada berjalan pada jadwal cron tetap. Setelah setiap iterasi, Claude memilih penundaan antara satu menit dan satu jam berdasarkan apa yang diamatinya: menunggu pendek saat build selesai atau PR aktif, menunggu lebih lama ketika tidak ada yang tertunda. Penundaan yang dipilih dan alasan untuk itu dicetak di akhir setiap iterasi.

Contoh di bawah memeriksa CI dan komentar review, dengan Claude menunggu lebih lama di antara iterasi setelah PR menjadi tenang:

```text theme={null}
/loop check whether CI passed and address any review comments
```

Dalam sesi di mana [Monitor tool tersedia](/docs/id/tools-reference#monitor-tool), Claude dapat menggunakannya secara langsung ketika Anda meminta jadwal `/loop` dinamis. Monitor menjalankan skrip latar belakang dan mengalirkan setiap baris output kembali, yang menghindari polling sama sekali dan sering lebih efisien token dan responsif daripada menjalankan kembali prompt pada interval.

Loop yang dijadwalkan secara dinamis muncul dalam [daftar tugas terjadwal](#manage-scheduled-tasks) Anda seperti tugas lainnya, jadi Anda dapat membuat daftar atau membatalkannya dengan cara yang sama. Aturan [jitter](#jitter) tidak berlaku untuk itu, tetapi [kedaluwarsa tujuh hari](#seven-day-expiry) berlaku.

<span id="loop-provider-differences" />

<Note>
  Interval yang dipilih secara dinamis dan [prompt pemeliharaan bawaan](#run-the-built-in-maintenance-prompt) bekerja di setiap provider, dan dengan [feature-flag fetching](/docs/id/env-vars#features-that-need-feature-flag-fetching) dimatikan. Di Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, dan Microsoft Foundry, atau dengan fetching dimatikan, keduanya memerlukan Claude Code v2.1.248 atau lebih baru.
</Note>

<h3 id="run-the-built-in-maintenance-prompt">
  Jalankan prompt pemeliharaan bawaan
</h3>

Ketika Anda menghilangkan prompt, Claude menggunakan prompt pemeliharaan bawaan daripada yang Anda berikan. Pada setiap iterasi, Claude bekerja melalui hal-hal berikut, secara berurutan:

* lanjutkan pekerjaan yang belum selesai dari percakapan
* urus pull request cabang saat ini: komentar review, CI runs yang gagal, merge conflicts
* jalankan pass pembersihan seperti bug hunts atau simplification ketika tidak ada yang tertunda

Claude tidak memulai inisiatif baru di luar cakupan itu, dan tindakan yang tidak dapat diubah seperti pushing atau deleting hanya dilanjutkan ketika mereka melanjutkan sesuatu yang sudah diotorisasi transkrip.

```text theme={null}
/loop
```

Bare `/loop` menjalankan prompt ini pada [interval yang dipilih secara dinamis](#let-claude-choose-the-interval). Tambahkan interval, misalnya `/loop 15m`, untuk menjalankannya pada jadwal tetap sebagai gantinya. Untuk mengganti prompt bawaan dengan prompt default Anda sendiri, lihat [Customize the default prompt with loop.md](#customize-the-default-prompt-with-loop-md).

<h3 id="customize-the-default-prompt-with-loop-md">
  Sesuaikan prompt default dengan loop.md
</h3>

Buat file `loop.md` untuk mengganti [prompt pemeliharaan bawaan](#run-the-built-in-maintenance-prompt) dengan instruksi Anda sendiri. File ini mendefinisikan satu prompt default tunggal untuk bare `/loop`, bukan daftar tugas terjadwal terpisah, dan Claude Code mengabaikannya setiap kali Anda memberikan prompt pada baris perintah. Untuk menjadwalkan prompt tambahan bersama dengannya, gunakan `/loop <prompt>` atau [minta Claude secara langsung](#manage-scheduled-tasks).

Claude mencari file di dua lokasi dan menggunakan yang pertama ditemukannya.

| Path | Scope |
| :- | :- |
| `.claude/loop.md` | Project-level. Mengambil prioritas ketika kedua file ada. |
| `~/.claude/loop.md` | User-level. Berlaku di proyek apa pun yang tidak mendefinisikan miliknya sendiri. |

File adalah Markdown biasa tanpa struktur yang diperlukan. Tulislah seolah-olah Anda mengetik prompt `/loop` secara langsung. Contoh berikut menjaga cabang rilis tetap sehat:

```markdown title=".claude/loop.md" theme={null}
Check the `release/next` PR. If CI is red, pull the failing job log,
diagnose, and push a minimal fix. If new review comments have arrived,
address each one and resolve the thread. If everything is green and
quiet, say so in one line.
```

Edit ke `loop.md` berlaku pada iterasi berikutnya, jadi Anda dapat menyempurnakan instruksi saat loop berjalan. Ketika tidak ada `loop.md` yang ada di lokasi mana pun, loop kembali ke prompt pemeliharaan bawaan. Jaga file tetap ringkas: konten di luar 25.000 byte dipotong.

<h3 id="stop-a-loop">
  Hentikan loop
</h3>

Untuk menghentikan [self-paced `/loop`](#let-claude-choose-the-interval) saat menunggu iterasi berikutnya, tekan `Esc`. Ini menghapus wakeup yang tertunda sehingga loop tidak berjalan lagi. Tugas yang Anda jadwalkan dengan [meminta Claude secara langsung](#manage-scheduled-tasks) tidak terpengaruh oleh `Esc` dan tetap ada sampai Anda menghapusnya.

Dalam [mode self-paced](#let-claude-choose-the-interval), Claude juga dapat mengakhiri loop dengan sendirinya setelah tugas selesai. Claude memanggil tool [`ScheduleWakeup`](/docs/id/tools-reference) dengan `stop: true`, yang membatalkan wakeup yang tertunda segera. Jika iterasi berakhir tanpa menjadwalkan ulang atau menghentikan, Claude Code menjadwalkan satu wakeup fallback sekitar 20 menit kemudian dan mengakhiri loop ketika iterasi itu tidak menjadwalkan ulang juga.

Loop pada interval tetap terus berjalan sampai Anda [membatalkannya seperti tugas terjadwal lainnya](#manage-scheduled-tasks) atau [tujuh hari berlalu](#seven-day-expiry).

<h2 id="set-a-one-time-reminder">
  Atur pengingat sekali jalan
</h2>

Untuk pengingat sekali jalan, jelaskan apa yang Anda inginkan dalam bahasa alami daripada menggunakan `/loop`. Claude menjadwalkan tugas single-fire yang menghapus dirinya sendiri setelah berjalan.

```text theme={null}
remind me at 3pm to push the release branch
```

```text theme={null}
in 45 minutes, check whether the integration tests passed
```

Claude menyematkan waktu berjalan ke menit dan jam tertentu menggunakan ekspresi cron dan mengonfirmasi kapan akan berjalan.

<h2 id="manage-scheduled-tasks">
  Kelola tugas terjadwal
</h2>

Minta Claude dalam bahasa alami untuk membuat daftar atau membatalkan tugas, atau referensikan alat yang mendasarinya secara langsung.

```text theme={null}
what scheduled tasks do I have?
```

```text theme={null}
cancel the deploy check job
```

Ini adalah alat yang mendasari yang digunakan Claude:

| Alat | Tujuan |
| :- | :- |
| `CronCreate` | Jadwalkan tugas baru. Menerima ekspresi cron 5-field, prompt untuk dijalankan, dan apakah itu berulang atau berjalan sekali. |
| `CronList` | Buat daftar semua tugas terjadwal dengan ID, jadwal, dan prompt mereka. |
| `CronDelete` | Batalkan tugas berdasarkan ID. |

Setiap tugas terjadwal memiliki ID 8-karakter yang dapat Anda berikan ke `CronDelete`. Sesi dapat menampung hingga 50 tugas terjadwal sekaligus.

<h2 id="how-scheduled-tasks-run">
  Bagaimana tugas terjadwal berjalan
</h2>

Penjadwal memeriksa setiap detik untuk tugas yang jatuh tempo dan memasukkannya ke antrian dengan prioritas rendah. Prompt terjadwal berjalan di antara giliran Anda, bukan saat Claude sedang merespons. Jika Claude sibuk saat tugas jatuh tempo, prompt menunggu sampai giliran saat ini berakhir.

Semua waktu ditafsirkan dalam zona waktu lokal Anda. Ekspresi cron seperti `0 9 * * *` berarti 9am di mana pun Anda menjalankan Claude Code, bukan UTC.

<h3 id="jitter">
  Jitter
</h3>

Tugas terjadwal dapat berjalan pada waktu yang berbeda dari yang tertera pada jadwalnya. Jika tugas setiap sesi berjalan tepat sesuai jadwal, banyak di antaranya akan memanggil API pada saat yang sama, sehingga Claude Code menggeser waktu berjalan setiap tugas. Tugas berulang berjalan terlambat, dan tugas sekali jalan yang dijadwalkan tepat pada jam atau setengah jam berjalan sedikit lebih awal.

<h4 id="how-late-a-recurring-task-runs">
  Seberapa terlambat tugas berulang berjalan
</h4>

Saat Anda membuat tugas berulang, Claude Code memberinya penundaan tetap dan menambahkan penundaan tersebut ke setiap kali tugas berjalan. Penundaan dihitung dari ID tugas, sehingga tugas yang sama berjalan terlambat dengan jumlah menit yang sama setiap kali, termasuk saat sesi sedang idle dan tidak ada hal lain yang berjalan.

Tugas yang berjalan lebih sering mendapatkan penundaan yang lebih singkat, dan 30 menit adalah penundaan terlama yang dapat diperoleh suatu tugas. Berikut adalah rentang penundaan untuk beberapa jadwal umum:

| Tugas berjalan | Penundaan berada di antara |
| :- | :- |
| Setiap 10 menit | 0 dan 5 menit |
| Setiap 30 menit | 0 dan 15 menit |
| Setiap jam, atau lebih jarang seperti harian | 0 dan 30 menit |

Misalnya, `7,37 * * * *` menjadwalkan tugas pada `:07` dan `:37`, yang berjarak 30 menit, sehingga penundaannya berada di antara 0 dan 15 menit. Jika penundaan tugas ini adalah 14 menit, tugas berjalan pada `:21` dan `:51` setiap jam. Mengubah jadwal ke menit yang berbeda akan memindahkan waktu berjalan, dan penundaan tetap ditambahkan di atasnya.

<h4 id="when-a-one-shot-task-runs-early">
  Kapan tugas sekali jalan berjalan lebih awal
</h4>

Tugas sekali jalan yang dijadwalkan pada `:00` atau `:30` berjalan hingga 90 detik lebih awal. Claude Code tidak menggeser tugas sekali jalan yang dijadwalkan pada menit lainnya, jadi jika ketepatan waktu penting, jadwalkan di luar jam tepat dan setengah jam: `3 9 * * *` alih-alih `0 9 * * *`.

<h3 id="seven-day-expiry">
  Kedaluwarsa tujuh hari
</h3>

Tugas berulang secara otomatis kedaluwarsa 7 hari setelah pembuatan. Tugas berjalan satu kali terakhir, kemudian menghapus dirinya sendiri. Ini membatasi berapa lama loop yang terlupakan dapat berjalan. Jika Anda memerlukan tugas berulang untuk bertahan lebih lama, batalkan dan buat ulang sebelum kedaluwarsa, atau gunakan [Routines](/docs/id/routines) atau [Desktop scheduled tasks](/docs/id/desktop-scheduled-tasks) untuk penjadwalan yang tahan lama.

<h2 id="cron-expression-reference">
  Referensi ekspresi cron
</h2>

`CronCreate` menerima ekspresi cron standar 5-field: `minute hour day-of-month month day-of-week`. Semua field mendukung wildcard (`*`), nilai tunggal (`5`), langkah (`*/15`), rentang (`1-5`), dan daftar yang dipisahkan koma (`1,15,30`).

| Contoh | Arti |
| :- | :- |
| `*/5 * * * *` | Setiap 5 menit |
| `0 * * * *` | Setiap jam pada jam |
| `7 * * * *` | Setiap jam pada 7 menit lewat |
| `0 9 * * *` | Setiap hari pada jam 9 pagi lokal |
| `0 9 * * 1-5` | Hari kerja pada jam 9 pagi lokal |
| `30 14 15 3 *` | 15 Maret pada jam 2:30 sore lokal |

Day-of-week menggunakan `0` atau `7` untuk Minggu hingga `6` untuk Sabtu. Sintaks yang diperluas seperti `L`, `W`, `?`, dan alias nama seperti `MON` atau `JAN` tidak didukung.

Ketika day-of-month dan day-of-week keduanya dibatasi, tanggal cocok jika salah satu field cocok. Ini mengikuti semantik vixie-cron standar.

<h2 id="disable-scheduled-tasks">
  Nonaktifkan tugas terjadwal
</h2>

Atur `CLAUDE_CODE_DISABLE_CRON=1` di lingkungan Anda untuk menonaktifkan penjadwal sepenuhnya. Alat cron dan `/loop` menjadi tidak tersedia, dan tugas yang sudah terjadwal berhenti berjalan. Lihat [Environment variables](/docs/id/env-vars) untuk daftar lengkap flag disable.

<h2 id="limitations">
  Keterbatasan
</h2>

Penjadwalan session-scoped memiliki batasan yang melekat:

* Tugas hanya berjalan saat Claude Code berjalan dan idle. Menutup terminal atau membiarkan sesi keluar menghentikan semuanya. [Backgrounding sesi](/docs/id/agent-view#from-inside-a-session) membawa tugas `/loop` ke sesi latar belakang, yang terus berjalan tanpa terminal.
* Tidak ada catch-up untuk fire yang terlewat. Jika waktu terjadwal tugas berlalu saat Claude sibuk dengan permintaan yang berjalan lama, itu berjalan sekali saat Claude menjadi idle, bukan sekali per interval yang terlewat.
* Saat Anda melanjutkan sesi dengan `claude --resume` atau `claude --continue`, Claude Code memulihkan tugas yang dijadwalkan dengan `CronCreate`, kecuali tugas berulang yang telah [kedaluwarsa](#seven-day-expiry) dan tugas sekali jalan yang waktu terjadwalnya telah berlalu. Sebuah `/loop` [yang berjalan sendiri](#let-claude-choose-the-interval) tidak dipulihkan, jadi jalankan `/loop` lagi untuk memulainya kembali. Tugas Bash latar belakang dan monitor tidak pernah dipulihkan pada resume.
* Dengan [feature-flag fetching off](/docs/id/env-vars#features-that-need-feature-flag-fetching), Claude Code menyimpan tugas yang Anda minta untuk disimpan di seluruh sesi dalam file `.claude/scheduled_tasks.json` proyek. Ketika direktori `.claude` atau file tersebut adalah symlink, Claude Code mengembalikan error alih-alih menjadwalkan tugas. Tugas yang disimpan hanya berjalan di folder proyek tempat Anda membuatnya. Jika Anda menyalin file ke folder lain, seperti worktree baru, sesi di sana menampilkan tugas yang disalin tetapi tidak menjalankannya, jadi buat tugas lagi di folder tersebut.

Untuk otomasi yang didorong cron yang perlu berjalan tanpa pengawasan:

* [Routines](/docs/id/routines): berjalan di cloud pada jadwal, melalui panggilan API, atau pada peristiwa GitHub
* [GitHub Actions](/docs/id/github-actions): gunakan trigger `schedule` dalam CI
* [Desktop scheduled tasks](/docs/id/desktop-scheduled-tasks): berjalan secara lokal di mesin Anda