Skip to main content
Tugas terjadwal memulai sesi baru secara otomatis pada waktu dan frekuensi yang Anda pilih. Gunakan untuk pekerjaan berulang seperti tinjauan kode harian, pemeriksaan pembaruan dependensi, atau briefing pagi yang menarik dari kalender dan kotak masuk Anda. Halaman Routines aplikasi Desktop memungkinkan Anda membuat tugas terjadwal lokal dan routines jarak jauh. Tugas lokal berjalan di mesin Anda dengan akses langsung ke file dan alat Anda, tetapi hanya berfungsi saat aplikasi terbuka dan komputer Anda terjaga. Routine jarak jauh berjalan di cloud bahkan ketika komputer Anda mati, dan juga dapat dipicu oleh panggilan API atau acara GitHub. Halaman ini mencakup tugas terjadwal lokal; untuk routine jarak jauh dan opsi pemicu mereka, lihat Routines.

​
Bandingkan opsi penjadwalan

Claude Code menawarkan tiga cara untuk menjadwalkan pekerjaan berulang atau sekali jalan:
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.
Secara default, tugas terjadwal berjalan terhadap status apapun yang ada di direktori kerja Anda, termasuk perubahan yang belum di-commit. Aktifkan toggle worktree saat membuat tugas untuk memberikan setiap run worktree Git terisolasi sendiri, dengan cara yang sama seperti sesi paralel bekerja.

​
Buat tugas terjadwal

Pada Claude Desktop sebelum 1.1.5368, tugas terjadwal lokal tidak tersedia. Di tab Code, klik Routines di sidebar atau di menu More sidebar, kemudian klik New routine dan pilih Local. Konfigurasikan bidang-bidang ini: Folder diperlukan sebelum Anda dapat menyimpan tugas. Jika Anda belum mempercayai folder itu, Desktop akan meminta Anda untuk mempercayainya sebelum menyimpan. Anda juga dapat membuat tugas dengan mendeskripsikan apa yang Anda inginkan dalam sesi apa pun. Misalnya, “siapkan code review harian yang berjalan setiap pagi jam 9” membuat tugas berulang, dan “ingatkan saya besok jam 3 sore untuk memeriksa deploy” membuat tugas satu kali yang menonaktifkan dirinya sendiri setelah berfungsi.

​
Opsi jadwal

Pilih preset dari kontrol Schedule:
  • Manual: tidak ada jadwal, hanya berjalan saat Anda mengklik Run now. Berguna untuk menyimpan prompt yang Anda picu sesuai permintaan
  • Hourly: berjalan setiap jam
  • Daily: berjalan setiap hari pada waktu lokal yang Anda pilih
  • Weekdays: sama dengan Daily tetapi melewati Sabtu dan Minggu
  • Weekly: menampilkan pemilih waktu dan pemilih hari
Untuk interval yang tidak ditawarkan pemilih, seperti setiap 15 menit, hari pertama setiap bulan, atau run tunggal pada waktu masa depan tertentu, minta Claude dalam sesi Desktop apa pun untuk mengatur jadwal. Gunakan bahasa biasa; misalnya, “jadwalkan tugas untuk menjalankan semua tes setiap 6 jam.”

​
Cara tugas terjadwal berjalan

Tugas terjadwal berjalan di mesin Anda. Desktop memeriksa jadwal setiap menit saat aplikasi terbuka dan memulai sesi segar saat tugas jatuh tempo, independen dari sesi manual apa pun yang Anda buka. Setiap tugas mendapat penundaan kecil beberapa menit setelah waktu terjadwal untuk membagi lalu lintas API. Penundaan bersifat deterministik: tugas yang sama selalu dimulai pada offset yang sama. Saat tugas berfungsi, Anda mendapatkan notifikasi desktop dan sesi baru muncul di bawah bagian Scheduled di sidebar. Buka untuk melihat apa yang dilakukan Claude, tinjau perubahan, atau respons ke prompt izin. Claude dapat mengedit file, menjalankan perintah, membuat commit, dan membuka pull request, sama seperti dalam sesi yang Anda mulai sendiri, tetapi tidak dapat mengirim atau menerima pesan antar sesi desktop Anda melalui permukaan sesi aplikasi desktop. Tugas hanya berjalan saat aplikasi desktop berjalan dan komputer Anda terjaga. Jika komputer Anda tidur melalui waktu terjadwal, run dilewati. Untuk mencegah idle-sleep, aktifkan Keep computer awake di Settings > This computer > System. Menutup laptop lid masih membuatnya tidur. Untuk tugas yang perlu berjalan bahkan ketika komputer Anda mati, atau yang harus dipicu oleh panggilan API atau acara GitHub, buat routine jarak jauh sebagai gantinya.

​
Run yang terlewat

Saat aplikasi dimulai atau komputer Anda bangun, Desktop memeriksa apakah setiap tugas melewatkan run apa pun dalam tujuh hari terakhir. Jika demikian, Desktop memulai tepat satu run catch-up untuk waktu yang paling baru terlewat dan membuang apa pun yang lebih lama. Tugas harian yang melewatkan enam hari berjalan sekali saat bangun. Desktop menampilkan notifikasi saat run catch-up dimulai. Ingat ini saat menulis prompt. Tugas yang dijadwalkan untuk 9am mungkin berjalan pada 11pm jika komputer Anda tidur sepanjang hari. Jika waktu penting, tambahkan guardrail ke prompt itu sendiri, misalnya: “Hanya tinjau commit hari ini. Jika sudah lewat jam 5 sore, lewati tinjauan dan posting ringkasan tentang apa yang terlewat.”

​
Izin untuk tugas terjadwal

Setiap tugas memiliki mode izin sendiri, yang Anda atur saat membuat atau mengedit tugas. Aturan izin dari ~/.claude/settings.json juga berlaku untuk sesi tugas terjadwal. Jika tugas berjalan dalam Mode Manual dan perlu menjalankan alat yang tidak memiliki izin, run terhenti sampai Anda menyetujuinya. Sesi tetap terbuka di sidebar sehingga Anda dapat menjawab nanti. Untuk menghindari stall, klik Run now setelah membuat tugas, perhatikan prompt izin, dan pilih “always allow” untuk masing-masing. Run masa depan dari tugas itu auto-approve alat yang sama tanpa meminta. Anda dapat meninjau dan mencabut persetujuan ini dari halaman detail tugas. Alat MCP yang ditandai requiresUserInteraction meminta pada setiap panggilan dan tidak menawarkan opsi always-allow. Run yang memanggil alat ini terhenti setiap kali.

​
Kelola tugas terjadwal

Di tab Code, klik tugas dalam daftar Routines untuk membuka halaman detailnya. Dari sini Anda dapat:
  • Run now: mulai tugas segera tanpa menunggu waktu terjadwal berikutnya
  • Status: toggle antara Active dan Paused untuk menjeda atau melanjutkan run terjadwal tanpa menghapus tugas
  • Edit: ubah instruksi, jadwal, folder, atau pengaturan lainnya
  • Review history: lihat setiap run masa lalu, termasuk run yang dilewati. Arahkan entri yang dilewati untuk melihat mengapa: komputer Anda tidur, run sebelumnya masih berlangsung, atau tugas terjadwal lainnya sudah berjalan. Klik Show more untuk memuat entri yang lebih lama.
  • Review allowed permissions: lihat dan cabut persetujuan alat yang disimpan untuk tugas ini dari panel Always allowed
  • Delete: hapus tugas dan arsipkan semua sesi yang dibuatnya. Kotak centang Also delete files on disk muncul di dialog konfirmasi; centang untuk juga menghapus file SKILL.md tugas dan data terkait dari ~/.claude/scheduled-tasks/.
Anda juga dapat membuat daftar, membuat, mengedit, dan menjeda tugas dengan meminta Claude dalam sesi Desktop apa pun. Misalnya, “jeda tugas dependency-audit saya” atau “tampilkan tugas terjadwal saya.” Untuk menghapus tugas, gunakan tombol Delete di halaman detailnya. Tugas terjadwal juga dapat memodifikasi jadwal atau prompt sendiri dari dalam sesi yang berjalan menggunakan alat MCP update_scheduled_task. Ini memungkinkan tugas untuk menjadwalkan ulang dirinya sendiri berdasarkan apa yang ditemukannya, misalnya, menjadwalkan ulang tinjauan kode untuk berjalan lebih awal ketika mendeteksi cabang rilis telah dibuat. Untuk mengedit prompt tugas di disk, buka ~/.claude/scheduled-tasks/<task-name>/SKILL.md (atau di bawah CLAUDE_CONFIG_DIR jika diatur). File menggunakan frontmatter YAML untuk name dan description, dengan prompt sebagai body. Perubahan berlaku pada run berikutnya. Schedule, folder, model, dan enabled state tidak ada dalam file ini: ubah melalui formulir Edit atau minta Claude.