Jadwalkan tugas berulang di Claude Code Desktop
Atur tugas terjadwal di Claude Code Desktop untuk menjalankan Claude secara otomatis pada basis berulang untuk tinjauan kode harian, audit dependensi, atau briefing pagi.
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 Scheduled tasks aplikasi Desktop mencantumkan tugas terjadwal lokal dan tugas terjadwal cloud, yang sebelumnya disebut routines:
- Tugas lokal: berjalan di mesin Anda dengan akses langsung ke file dan tool Anda, tetapi hanya berjalan saat aplikasi terbuka dan komputer Anda terjaga
- Tugas cloud: berjalan bahkan ketika komputer Anda mati, dan juga dapat dimulai oleh panggilan API atau peristiwa GitHub
Halaman ini mencakup tugas terjadwal lokal; untuk tugas terjadwal cloud dan opsi pemicunya, lihat Otomatiskan pekerjaan dengan tugas terjadwal.
Bandingkan opsi penjadwalan
Claude Code menawarkan tiga cara untuk menjadwalkan pekerjaan berulang atau sekali jalan:
| Cloud | Desktop | /loop |
|
|---|---|---|---|
| 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 |
| Akses ke file lokal | Tidak (klon segar) | Ya | Ya |
| Server MCP | Konektor dikonfigurasi per tugas | File konfigurasi dan konektor | Mewarisi dari sesi |
| Prompt izin | Tidak (berjalan secara otonom) | Dapat dikonfigurasi per tugas | Mewarisi dari sesi |
| Jadwal yang dapat disesuaikan | Ya | Ya | Ya |
| Interval minimum | 1 jam | 1 menit jika diatur oleh Claude, 1 jam di formulir | 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
/loopuntuk polling cepat selama sesi.
[!NOTE]
Secara default, tugas terjadwal lokal berjalan terhadap status apapun yang ada di direktori kerja Anda, termasuk perubahan yang belum di-commit. Untuk memberikan setiap run worktree Git terisolasi sendiri, pilih Worktree di formulir Edit tugas setelah Anda membuatnya. Kotak centang ini tersedia ketika folder tugas merupakan repositori Git.
Buat tugas terjadwal
Tugas terjadwal lokal memerlukan Claude Desktop 1.1.5368 atau yang lebih baru.
1. Buka halaman Scheduled tasks
Di tab Code, klik Scheduled di sidebar atau di menu More sidebar.
2. Mulai tugas baru
Klik New task. Jika menu terbuka dengan Create with Claude dan Set up manually, pilih Set up manually. Dialog New scheduled task terbuka. Jika Only on this computer berada di bagian atas dialog, buka Dialog dengan Only on this computer di bagian atas sebelum Anda memasukkan apa pun.
3. Beri nama tugas
Masukkan nama di bidang Name. Desktop mengonversinya ke kebab-case huruf kecil dan menggunakannya sebagai nama folder tugas di disk, sehingga nama tersebut harus unik di seluruh tugas Anda.
4. Tulis instruksi
Di kotak di bawah nama, masukkan apa yang harus dilakukan Claude saat tugas berjalan.
5. Aktifkan Only on this computer
Lewati kartu Trigger untuk saat ini dan perluas Advanced settings di bawahnya. Pada tab General, aktifkan Only on this computer. Saat diaktifkan, tugas berjalan di mesin Anda dalam folder lokal.
Jika sakelar tidak tersedia, hapus repositori atau trigger peristiwa GitHub atau API, karena hal-hal tersebut menjadikan tugas sebagai tugas terjadwal cloud.
6. Pilih folder lokal
Di baris Local folder, pilih folder. Create tetap tidak tersedia sampai Anda memilih salah satu.
7. Atur jadwal
Kembali ke kartu Trigger, pilih preset jadwal.
8. Pilih mode izin dan model
Di toolbar kotak instruksi, pilih mode izin dan model. Jika Anda membiarkannya tidak berubah, eksekusi menggunakan pengaturan Claude Code Anda dan model default.
9. Buat tugas
Klik Create. Jika Anda belum mempercayai folder tersebut, Desktop akan meminta Anda untuk mempercayainya pada tahap ini. Halaman detail tugas terbuka.
Di halaman detail, klik ikon pensil untuk membuka formulir Edit. Di sana Anda dapat mengubah Description yang diisi Desktop dari instruksi Anda, memilih Worktree, atau mengubah jadwal menjadi Manual atau Custom.
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. Permintaan seperti "ingatkan saya besok jam 3 sore untuk memeriksa deploy" membuat tugas satu kali yang menonaktifkan dirinya sendiri setelah dijalankan.
Dialog dengan Only on this computer di bagian atas
Jika Only on this computer berada di bagian atas dialog New scheduled task saat dialog terbuka, aktifkan sebelum Anda memasukkan apa pun. Saat Anda mengaktifkannya, formulir kosong terpisah untuk tugas lokal menggantikan formulir tersebut.
Kemudian isi bidang-bidang formulir lokal:
- Name: masukkan nama, seperti dalam langkah-langkah membuat tugas terjadwal.
- Description: masukkan deskripsi. Create tetap tidak tersedia sampai Anda melakukannya.
- Kotak instruksi: masukkan apa yang harus dilakukan Claude saat tugas berjalan. Pilih mode izin dan model dari menu di dalam kotak.
- Working folder: pilih folder tempat tugas berjalan. Create tetap tidak tersedia sampai Anda memilih salah satu.
- Trigger: pilih jadwal. Untuk preset, lihat Opsi jadwal.
Klik Create. Halaman detail tugas terbuka.
Opsi jadwal
Saat Anda mengaktifkan Only on this computer di bawah Advanced settings, kartu Trigger menawarkan Hourly, Daily, Weekdays, dan Weekly. Untuk mendapatkan Manual atau Custom bagi tugas seperti itu, buka formulir Edit tugas tersebut setelah Anda membuatnya. Formulir tersebut dan dialog dengan Only on this computer di bagian atas menawarkan enam opsi berikut:
- 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
- Manual: tidak ada jadwal, hanya berjalan saat Anda mengklik Run now. Berguna untuk menyimpan prompt yang Anda picu sesuai permintaan
- Custom: berjalan berdasarkan ekspresi cron yang Anda masukkan dan yang dievaluasi dalam waktu lokal Anda, seperti
0 9 * * *untuk pukul 9:00 pagi setiap hari. Tulis hari dalam seminggu dan bulan sebagai angka, karena namanya tidak diterima. Minggu adalah0, bukan7. Formulir menolak ekspresi yang berjalan lebih sering dari sekali per jam.
Anda juga dapat meminta Claude dalam sesi Desktop apa pun untuk mengatur jadwal. Claude tidak terikat pada batas sekali per jam dan dapat mengatur satu kali run pada waktu di masa depan. Misalnya, minta "jalankan rangkaian tes setiap 30 menit" atau "Senin depan pukul 9 pagi, rangkum pull request yang di-merge sejak hari Jumat."
Cara tugas terjadwal berjalan
Tugas terjadwal lokal 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.
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.
[!NOTE]
Untuk tugas yang perlu berjalan bahkan ketika komputer Anda mati, atau yang harus dipicu oleh panggilan API atau acara GitHub, buat tugas terjadwal cloud sebagai gantinya.
Menemukan sesi dari sebuah run
Untuk membuka sesi yang dimulai oleh sebuah run, buka halaman detail tugas tersebut dan klik baris run itu di daftar History.
Daftar sesi di sidebar juga dapat menampilkan grup Scheduled, dengan satu baris per tugas. Untuk membuka sesi dari run terbaru suatu tugas, klik baris tugas tersebut di grup itu. Untuk menampilkan grup tersebut, periksa tata letak yang Anda miliki:
- Tata letak saat ini: buka menu Group and sort, pilih Show, lalu pilih Scheduled. Grup ini awalnya dalam keadaan diciutkan, jadi klik judulnya untuk memperluasnya. Show mencantumkan Scheduled ketika setidaknya satu tugas Anda berstatus Active, yaitu Status yang ditampilkan di halaman detail tugas. Jika tidak tercantum, gunakan daftar History, yang berfungsi baik grup tersebut ditampilkan maupun tidak.
- Tata letak sebelumnya: grup sudah ada di daftar sesi tanpa perlu diaktifkan
Di sesi sebuah run, dengan cara apa pun Anda mencapainya, Anda dapat melihat apa yang dilakukan Claude, meninjau perubahan, dan merespons permintaan izin. Claude dapat mengedit file, menjalankan perintah, membuat commit, dan membuka pull request, sama seperti dalam sesi yang Anda mulai sendiri.
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 tool yang tidak memiliki izin, run terhenti sampai Anda menyetujuinya. Untuk menyetujuinya, temukan sesi run tersebut dan jawab permintaan izin di sana.
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 Scheduled di sidebar, lalu klik tugas dalam daftar 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. Sesi yang dibuat oleh tugas tersebut diarsipkan, bukan dihapus. Folder yang berisi file
SKILL.mdtugas tetap ada di disk di~/.claude/scheduled-tasks/<task-name>/, atau discheduled-tasks/<task-name>/di bawahCLAUDE_CONFIG_DIRjika Anda mengatur variabel tersebut. Untuk menghapus folder tersebut, hapus sendiri.
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.
Sumber daya terkait
- Tugas terjadwal cloud: jalankan tugas di cloud pada jadwal, melalui panggilan API, atau sebagai respons terhadap acara GitHub, bahkan ketika komputer Anda mati
- Run prompts on a schedule: penjadwalan scoped sesi dengan
/loopdi CLI - Claude Code GitHub Actions: jalankan Claude pada jadwal di CI alih-alih di mesin Anda
- Use Claude Code Desktop: panduan aplikasi Desktop lengkap