Otomatisasi pekerjaan dengan tugas terjadwal

Jalankan Claude Code secara autopilot. Buat tugas terjadwal, sebelumnya bernama routine, yang berjalan di cloud sesuai jadwal, melalui panggilan API, atau pada peristiwa GitHub.

[!NOTE]

Tugas terjadwal berada dalam research preview. Perilaku, batas, dan surface API dapat berubah.

Tugas terjadwal cloud, sebelumnya bernama routine, adalah konfigurasi Claude Code yang disimpan: sebuah prompt, satu atau lebih repositori, dan serangkaian konektor, yang dikemas sekali dan dijalankan secara otomatis. Tugas terjadwal dieksekusi pada infrastruktur cloud yang dikelola Anthropic, atau pada lingkungan self-hosted organisasi Anda ketika dialihkan ke sana, sehingga tetap bekerja ketika laptop Anda ditutup.

Setiap tugas terjadwal dapat memiliki satu atau lebih pemicu yang terpasang padanya:

• Jadwal: berjalan dengan frekuensi berulang seperti per jam, setiap malam, atau mingguan, atau sekali pada waktu tertentu di masa depan
• API: dipicu sesuai permintaan dengan mengirim HTTP POST ke endpoint milik tugas tersebut dengan token bearer
• GitHub: berjalan secara otomatis sebagai respons terhadap peristiwa repositori seperti pull request atau rilis

Satu tugas terjadwal dapat menggabungkan beberapa pemicu. Misalnya, tugas review PR dapat berjalan setiap malam, dipicu dari skrip deployment, dan juga bereaksi terhadap setiap PR baru.

Tugas terjadwal tidak harus memiliki jadwal:

• Tugas yang hanya memiliki pemicu API berjalan ketika Anda memanggil endpoint-nya.
• Tugas yang hanya memiliki pemicu GitHub berjalan ketika peristiwa repositori yang cocok terjadi.

Tugas terjadwal tersedia pada paket Pro, Max, Ultra, Team, dan Enterprise. Buat dan kelola di claude.ai/code/routines, atau dari CLI dengan /schedule. Nama sebelumnya, routines, masih muncul.

[!NOTE]

Dua fitur lain menjadwalkan pekerjaan di mesin Anda alih-alih di cloud: tugas terjadwal Desktop dan /loop. Untuk memilih di antara ketiganya, lihat Bandingkan opsi penjadwalan.

Owner Team dan Enterprise dapat menonaktifkan tugas terjadwal untuk semua anggota dengan toggle Scheduled tasks (Was Routines) atau Routines di Organization settings > Capabilities > Remote sessions. Ketika toggle dimatikan, tugas terjadwal yang ada berhenti berjalan dan anggota tidak dapat membuat yang baru.

Jika organisasi Enterprise Anda mengelola akses Anda dengan peran kustom, Anda juga memerlukan peran yang mencakup izin tugas terjadwal. Owner dapat menambahkannya di bagian Remote sessions pada suatu peran di Organization settings > Roles.

Contoh kasus penggunaan

Setiap contoh memasangkan jenis pemicu dengan jenis pekerjaan yang cocok untuk tugas terjadwal: tanpa pengawasan, dapat diulang, dan terikat pada hasil yang jelas.

• Pemeliharaan backlog: pemicu jadwal berjalan setiap malam hari kerja di repositori Anda, dengan pelacak issue Anda ditambahkan sebagai konektor. Tugas terjadwal membaca issue yang dibuka sejak eksekusi terakhir, menerapkan label, dan menetapkan pemilik berdasarkan area kode yang direferensikan. Kemudian tugas tersebut memposting ringkasan ke Slack sehingga tim memulai hari dengan antrean yang sudah rapi.
• Triase peringatan: alat pemantauan Anda memanggil endpoint API tugas terjadwal ketika ambang batas error terlampaui, meneruskan isi peringatan sebagai text. Prompt tugas memberi tahu Claude untuk menyelidiki peringatan dalam payload pemicu, sehingga Claude mengambil stack trace dan mengorelasikannya dengan commit terbaru di repositori. Kemudian Claude membuka pull request draf dengan perbaikan yang diusulkan dan tautan kembali ke peringatan. Petugas on-call meninjau PR alih-alih memulai dari terminal kosong.
• Code review khusus: pemicu GitHub berjalan pada pull_request.opened. Tugas terjadwal menerapkan daftar periksa review milik tim Anda sendiri dan meninggalkan komentar inline untuk masalah keamanan, kinerja, dan gaya. Tugas tersebut juga menambahkan komentar ringkasan sehingga peninjau manusia dapat fokus pada desain alih-alih pemeriksaan mekanis.
• Verifikasi deployment: pipeline CD Anda memanggil endpoint API tugas terjadwal setelah setiap deployment produksi. Tugas menjalankan smoke check terhadap build baru, memindai log error untuk regresi, dan memposting keputusan go atau no-go ke saluran rilis sebelum jendela deployment ditutup.
• Dokumentasi yang tertinggal: pemicu jadwal berjalan mingguan. Tugas terjadwal memindai PR yang di-merge sejak eksekusi terakhir, menandai dokumentasi yang mereferensikan API yang berubah, dan membuka PR pembaruan terhadap repositori dokumentasi untuk ditinjau oleh editor.
• Port library: pemicu GitHub berjalan pada pull_request.closed yang difilter ke PR yang di-merge di satu repositori SDK. Tugas terjadwal mem-port perubahan ke SDK paralel dalam bahasa lain dan membuka PR yang sesuai, menjaga kedua library tetap selaras tanpa manusia mengimplementasikan ulang setiap perubahan.

Buat tugas terjadwal

Buat tugas terjadwal dari web di claude.ai/code/routines, dari aplikasi Desktop, atau dari CLI. Ketiga surface menulis ke akun cloud yang sama, sehingga tugas terjadwal yang Anda buat di salah satunya langsung muncul di yang lain. Di tab Code aplikasi Desktop, klik Scheduled di sidebar atau di menu More pada sidebar, lalu New task, dan lanjutkan dengan Buat dari web.

Tugas terjadwal berjalan secara otonom sebagai sesi cloud Claude Code penuh. Sesi menjalankan perintah shell, menggunakan skills, dan memanggil konektor apa pun yang Anda sertakan. Di luar thread milik sebuah proyek, skills tersebut mencakup skills yang di-commit ke repositori yang diklon. Anda tidak memilih mode izin saat membuat tugas: lihat Permintaan izin selama eksekusi untuk mengetahui kapan eksekusi berhenti untuk menunggu Anda.

Apa yang dapat dijangkau tugas terjadwal ditentukan oleh:

• Repositori yang Anda pilih
• Akses jaringan dan variabel lingkungan
• Konektor yang Anda sertakan

Batasi masing-masing sesuai yang dibutuhkan tugas.

Tugas terjadwal milik akun claude.ai individual Anda. Tugas tersebut tidak dibagikan dengan rekan tim, dan eksekusinya dihitung terhadap penggunaan dan batas akun Anda. Apa pun yang dilakukan tugas terjadwal melalui identitas GitHub atau konektor yang terhubung akan muncul sebagai Anda. Commit dan pull request membawa pengguna GitHub Anda, dan pesan Slack, tiket Linear, atau tindakan konektor lainnya menggunakan akun tertaut Anda untuk layanan tersebut.

Buat dari web

1. Buka dialog pembuatan

Buka claude.ai/code/routines dan klik New task untuk membuka dialog New scheduled task. Periksa layar-layar berikut sebelum Anda melanjutkan:

• Jika tombol bertuliskan New routine alih-alih New task, klik New routine dan lanjutkan dengan Formulir halaman penuh.
• Di aplikasi Desktop, jika menu dengan Local dan Cloud terbuka, buka Formulir halaman penuh.
• Jika menu terbuka dengan Create with Claude dan Set up manually, pilih Set up manually untuk membuka dialog. Create with Claude memungkinkan Anda mendeskripsikan tugas dalam obrolan dan meminta Claude membuatnya sebagai gantinya.
• Jika halaman penuh terbuka sebagai pengganti dialog, buka Formulir halaman penuh.

Jika Repositories dan Environment sudah ditampilkan saat dialog terbuka, lihat perbedaan dialog tersebut. Jika tidak, dialog ini juga membuat tugas terjadwal untuk obrolan claude.ai. Untuk menjadikan tugas Anda sebagai apa yang disebut dialog sebagai tugas Claude Code, pilih repositori atau tambahkan pemicu peristiwa GitHub atau API pada langkah-langkah berikutnya. Jenis tugas tersebut menjalankan Claude Code dalam sesi cloud.

2. Beri nama tugas dan tulis prompt

Berikan tugas terjadwal nama yang deskriptif dan tulis prompt yang dijalankan Claude setiap kali. Prompt adalah bagian terpenting: tugas berjalan secara otonom, sehingga prompt harus mandiri dan eksplisit tentang apa yang harus dilakukan dan seperti apa keberhasilan itu.

Ketika pemicu aktif, sesi menerima prompt yang disimpan sebagai tugasnya dan melaksanakannya, alih-alih memperlakukannya sebagai konten tidak tepercaya yang tiba di tengah percakapan. Pemicu hanya membuktikan bahwa prompt disimpan sebelumnya oleh sesi yang berwenang di akun Anda. Karena itu, prompt yang dipicu bukan input pengguna langsung dan tidak dapat berfungsi sebagai persetujuan atau izin untuk tindakan selama eksekusi. Konten yang diambil sesi selama eksekusi tetap ditangani seperti biasa.

3. Pilih pemicu

Di baris Trigger, pilih bagaimana tugas dimulai. Untuk menggabungkan beberapa pemicu, klik + di ujung baris.

[tab] Schedule

Pilih frekuensi preset untuk eksekusi berulang. Lihat Tambahkan pemicu jadwal untuk penanganan zona waktu, mulai yang terlambat, interval cron khusus, dan eksekusi satu kali.

[tab] GitHub event

Pilih repositori, peristiwa yang akan direspons, dan filter opsional. Lihat Tambahkan pemicu GitHub untuk daftar lengkap peristiwa dan kolom filter yang didukung.

[tab] API

Pilih API di sini. Saat Anda mengklik Create, dialog API token menampilkan token sekali, jadi salin sebelum Anda menutup dialog. Lihat Tambahkan pemicu API untuk menyalin URL atau membuat token baru.

4. Pilih repositori

Perluas Advanced settings. Di bawah Repository pada tab General, pilih satu atau lebih repositori GitHub tempat Claude akan bekerja.

Setiap repositori diklon di awal eksekusi. Claude membuat branch dengan awalan claude/ untuk perubahannya.

5. Pilih lingkungan

Setelah Anda memilih repositori, Cloud environment muncul di bawahnya. Pilih lingkungan cloud untuk tugas. Jika lingkungan sudah dipilih, Anda dapat mempertahankannya atau memilih yang lain. Lingkungan mengontrol apa yang dapat diakses oleh sesi cloud:

• Network access: atur tingkat akses internet yang tersedia selama setiap eksekusi
• Environment variables: sediakan nilai yang dapat digunakan Claude selama setiap eksekusi. Nilai tersebut terlihat oleh siapa pun yang menggunakan lingkungan, jadi di lingkungan yang di-host Anthropic, simpan kunci untuk API yang dipanggil Claude selama eksekusi sebagai network secrets. Bagian tersebut juga mencantumkan permintaan yang tidak pernah mendapatkan secret
• Setup script: instal dependensi dan alat yang dibutuhkan tugas. Hasilnya di-cache, sehingga skrip tidak dijalankan ulang pada setiap sesi

Lingkungan Default disediakan dengan akses jaringan Trusted, yang hanya mengizinkan allowlist default berupa registri paket, API penyedia cloud, registri kontainer, dan domain pengembangan umum melalui jaringan sesi. Konektor yang Anda tambahkan ke tugas menjangkau layanannya melalui server Anthropic, sehingga tidak memerlukan perubahan allowlist.

Jika tugas Anda perlu menjangkau layanan Anda sendiri secara langsung, atau domain di luar daftar tersebut, edit akses jaringan lingkungan sebelum menjalankan. Untuk menggunakan lingkungan terpisah, buat satu terlebih dahulu.

6. Pilih model dan tingkat effort

Pilih model di pemilih model pada input prompt untuk digunakan Claude pada setiap eksekusi. Untuk tugas Claude Code, jika model menawarkan tingkat effort, Effort di pemilih yang sama menampilkan tingkat saat ini. Untuk mengubahnya, pilih tingkat lain. Opsi Default pada pemilih tidak menawarkan tingkat apa pun.

7. Tinjau konektor

Beralih ke tab Connectors pada Advanced settings. Semua konektor MCP Anda yang terhubung disertakan secara default. Hapus yang tidak dibutuhkan tugas: Claude dapat menggunakan konektor yang disertakan selama eksekusi, termasuk operasi tulis. Untuk mengetahui kapan eksekusi berhenti untuk bertanya kepada Anda terlebih dahulu, lihat Permintaan izin selama eksekusi.

8. Buat tugas

Klik Create. Dialog tertutup dan halaman detail tugas baru terbuka. Tugas berjalan saat salah satu pemicunya cocok berikutnya. Untuk memulai eksekusi segera, klik Run now di halaman detail.

Untuk melihat apa yang dilakukan suatu eksekusi, klik eksekusi tersebut di daftar History pada halaman detail. Eksekusi terbuka sebagai sesi penuh, sesi baru untuk setiap eksekusi, tempat Anda dapat melihat apa yang dilakukan Claude, meninjau perubahan, dan membuat pull request.

Dialog dengan Repositories dan Environment di tampilan utama

Ikuti langkah-langkah untuk membuat dari web, dan isi setiap kolom di tampilan utama dialog alih-alih di bawah Advanced settings. Dialog ini hanya membuat tugas Claude Code.

Pilih repositori sebelum Anda menambahkan pemicu peristiwa GitHub, karena pemicu tersebut tidak tersedia sampai repositori dipilih.

Formulir halaman penuh

Di aplikasi Desktop, jika menu dengan Local dan Cloud terbuka, pilih Cloud. Halaman berjudul New routine atau New scheduled task akan terbuka. Isi kolom-kolomnya:

• Name: masukkan nama.
• Instructions: masukkan prompt. Di kotak yang sama, pilih model, tingkat effort jika model menawarkannya, repositori, dan lingkungan. Untuk mengetahui apa yang dikontrol masing-masing, lihat langkah-langkah di bawah Buat dari web.
• Select a trigger: pilih Schedule, GitHub event, atau API. Untuk jadwal, lihat Tambahkan pemicu jadwal. Untuk peristiwa GitHub, pilih repositori. Untuk pemicu API, salin token dari dialog API token yang terbuka setelah Anda mengklik Create, karena token hanya ditampilkan sekali. Untuk menggabungkan beberapa pemicu, klik Add another trigger.
• Connectors: semua konektor Anda yang terhubung disertakan secara default, jadi hapus yang tidak dibutuhkan tugas.

Jika Create tidak tersedia, arahkan kursor ke tombol tersebut untuk melihat apa yang masih dibutuhkan formulir. Klik Create, dan halaman detail tugas akan terbuka.

Buat dari CLI

Jalankan /schedule di sesi mana pun untuk membuat tugas terjadwal secara percakapan. Anda juga dapat meneruskan deskripsi secara langsung, untuk tugas berulang seperti /schedule daily PR review at 9am atau tugas satu kali seperti /schedule clean up feature flag in one week. Claude memandu melalui informasi yang sama yang dikumpulkan dialog web, lalu menyimpan tugas ke akun Anda. Perintah ini juga tersedia dengan alias /routines.

Awal yang berhasil terlihat seperti percakapan: Claude mengajukan pertanyaan lanjutan tentang jadwal, repositori, dan prompt sebelum menyimpan. Jika Claude justru menjawab bahwa Anda perlu melakukan autentikasi atau bahwa Claude tidak dapat terhubung ke akun claude.ai jarak jauh Anda, tidak ada tugas terjadwal yang dibuat; lihat Pemecahan masalah.

Tugas yang Anda buat dengan /schedule memiliki pemicu jadwal. Anda juga dapat menambahkan jenis pemicu lainnya:

• Pemicu API: edit tugas di web di claude.ai/code/routines
• Pemicu GitHub: edit tugas di web, atau minta Claude di CLI. Menambahkannya dari CLI memerlukan Claude Code v2.1.225 atau lebih baru

Tugas terjadwal tanpa pemicu jadwal, seperti yang hanya dimulai oleh panggilan API atau peristiwa GitHub, tidak memiliki waktu eksekusi berikutnya. CLI tidak menampilkannya ketika Claude menyimpan atau memperbaruinya.

Konfigurasi pemicu

Tugas terjadwal dimulai ketika salah satu pemicunya cocok. Tambahkan atau hapus pemicu tugas kapan saja di baris Trigger pada dialog edit tugas.

Ketika tugas memiliki dua pemicu atau lebih, masing-masing memiliki ikon tempat sampah di dialog tersebut. Untuk menghapus pemicu jadwal atau peristiwa GitHub, klik ikon tempat sampahnya, lalu Save changes. Untuk menghapus pemicu API, hapus tokennya.

Tambahkan pemicu jadwal

Pemicu jadwal menjalankan tugas dengan frekuensi berulang, atau sekali pada waktu tertentu di masa depan. Di dialog pembuatan atau edit tugas di web, pilih frekuensi preset seperti per jam, harian, atau mingguan:

• Eksekusi tepat pada jam: jika Anda menjadwalkan eksekusi tepat pada jam, seperti 9:00, eksekusi dapat dimulai beberapa menit terlambat. Untuk memulai mendekati waktu terjadwal, pilih beberapa menit setelah jam, misalnya 9:07.
• Interval khusus: untuk frekuensi yang tidak tersedia di preset, buat tugas lalu pilih Custom di dialog edit tugas tersebut. Kemudian masukkan ekspresi cron, seperti 0 */2 * * * untuk setiap dua jam. Untuk menetapkannya dari CLI, jalankan /schedule update. Ekspresi yang berjalan lebih sering dari sekali per jam akan ditolak.
• Zona waktu: saat Anda memilih frekuensi preset, masukkan waktu dalam zona waktu lokal Anda.
• Zona waktu ekspresi cron: jika ekspresi hanya terdiri dari lima kolom, tulis jam dalam UTC, sehingga 0 9 * * 1-5 berjalan pada pukul 9:00 AM UTC di hari kerja. Jika kolom diawali dengan prefiks CRON_TZ=, pertahankan prefiks tersebut dan tulis jam dalam zonanya, atau hapus prefiks tersebut dan tulis jam dalam UTC.

Jadwalkan eksekusi satu kali

Jadwal satu kali menjalankan tugas satu kali pada stempel waktu tertentu. Misalnya, gunakan untuk:

• Mengingatkan diri sendiri di akhir minggu
• Membuka PR pembersihan setelah rollout selesai
• Memulai pekerjaan lanjutan setelah perubahan upstream dirilis

Setelah tugas berjalan, tugas tersebut menonaktifkan dirinya sendiri dan UI web menandainya sebagai Completed. Untuk menjalankannya lagi, buka dialog edit tugas di web dan pilih One-time atau Once, sesuai label yang ditampilkan dialog Anda. Lalu atur tanggal dan waktu baru dalam zona waktu lokal Anda dan simpan.

Buat eksekusi satu kali dari CLI dengan mendeskripsikan waktu dalam bahasa alami. Claude menafsirkan frasa tersebut terhadap waktu saat ini dan mengonfirmasi stempel waktu absolut sebelum menyimpan.

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

Eksekusi satu kali dihitung terhadap batas per jam yang sama dengan eksekusi terjadwal lainnya. Lihat Penggunaan dan batas untuk detailnya.

Tambahkan pemicu API

Pemicu API memberikan tugas terjadwal endpoint HTTP khusus. Mengirim POST ke endpoint dengan token bearer tugas akan memulai sesi baru dan mengembalikan URL sesi. Gunakan ini untuk menghubungkan Claude Code ke sistem peringatan, pipeline deployment, alat internal, atau di mana pun Anda dapat membuat permintaan HTTP yang terautentikasi.

Tambahkan pemicu API di web, baik saat Anda membuat tugas maupun nanti dengan langkah-langkah di bawah. Anda tidak dapat menambahkan pemicu API atau mengelola tokennya dari CLI.

1. Buka tugas untuk diedit

Buka claude.ai/code/routines, klik tugas terjadwal yang ingin Anda picu melalui API, lalu buka menu di sebelah namanya dan pilih Edit. Dialog Edit scheduled task akan terbuka.

2. Tambahkan pemicu API

Di baris Trigger, klik + dan pilih API dari menu yang terbuka. Panel dengan Fire URL dan Token untuk tugas ini akan muncul.

3. Salin URL dan buat token

Salin Fire URL. Klik Generate token, lalu segera salin token dari dialog Token generated. Token ditampilkan sekali dan tidak dapat diambil kembali nanti, jadi simpan di tempat yang aman seperti penyimpanan secret alat peringatan Anda.

Pemicu API berlaku segera setelah Anda membuat token. Anda tidak perlu mengklik Save changes, jadi tutup dialog setelah selesai.

4. Panggil endpoint

Kirim token di header Authorization: Bearer saat Anda mengirim POST ke URL. Picu tugas terjadwal menunjukkan contoh lengkap.

Setiap tugas terjadwal memiliki tokennya sendiri, yang dibatasi hanya untuk memicu tugas tersebut. Untuk mematikan akses API atau merotasi token, buka kembali dialog Edit scheduled task tugas. Kedua kontrol berada di sebelah token pada panel pemicu API dan langsung berlaku:

• Matikan akses API: klik Delete token, ikon tempat sampah di sebelah Regenerate. Ini menghapus pemicu API
• Rotasi token: klik Regenerate. Token sebelumnya berhenti berfungsi, dan dialog Token generated menampilkan token baru sekali

Picu tugas terjadwal

Kirim permintaan POST ke endpoint /fire dengan token bearer di header Authorization. Body permintaan menerima kolom text opsional untuk konteks khusus eksekusi seperti isi peringatan atau log yang gagal, yang diteruskan ke tugas bersama prompt yang disimpannya. Nilainya berupa teks bebas dan tidak di-parse: jika Anda mengirim JSON atau payload terstruktur lainnya, tugas menerimanya sebagai string literal.

Nilai text tidak mencapai routine sebagai pesan polos. Nilai tersebut tiba dibungkus dalam blok <routine-fire-payload> yang melabelinya sebagai data tidak tepercaya dan memberi tahu Claude untuk tidak mengikuti instruksi di dalamnya kecuali prompt routine itu sendiri menyatakan demikian. Pembungkus yang sama berlaku untuk teks yang diberikan dengan Run now di UI web.

Ini berarti prompt yang disimpan pada routine harus secara eksplisit memilih untuk bertindak berdasarkan teks pemicu: tulis prompt yang mereferensikan payload secara eksplisit, misalnya "Investigate the alert described in the routine-fire-payload block", jika tidak routine memperlakukan teks tersebut sebagai konteks pasif. Siapa pun yang memegang token bearer dapat mengirim text, sehingga pembungkus membuat teks pemicu dari token yang bocor tiba dengan label data tidak tepercaya, bukan sebagai instruksi langsung ke routine Anda.

Contoh di bawah memicu tugas terjadwal dari shell. ID tugas dan token yang ditampilkan adalah placeholder: ganti dengan URL dan token yang Anda salin saat menambahkan pemicu API, atau permintaan akan gagal dengan error autentikasi 401:

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

Permintaan yang berhasil mengembalikan body JSON dengan ID dan URL sesi baru:

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

Buka URL sesi di browser untuk menyaksikan eksekusi secara real-time, meninjau perubahan, atau melanjutkan percakapan secara manual.

[!WARNING]

Endpoint /fire dirilis di bawah header beta experimental-cc-routine-2026-04-01. Bentuk permintaan dan respons, rate limit, dan semantik token dapat berubah selama fitur berada dalam research preview. Perubahan yang merusak dirilis di balik versi header beta bertanggal yang baru, dan dua versi header sebelumnya yang paling baru tetap berfungsi sehingga pemanggil memiliki waktu untuk bermigrasi.

Referensi API

Untuk referensi API lengkap, termasuk semua respons error, aturan validasi, dan batas kolom, lihat Trigger a routine through the API di dokumentasi Claude Platform.

Endpoint /fire hanya tersedia untuk pengguna claude.ai dan bukan bagian dari surface API Claude Platform.

Tambahkan pemicu GitHub

Pemicu GitHub memulai sesi baru secara otomatis ketika peristiwa yang cocok terjadi pada repositori yang terhubung. Claude Code tidak menggunakan kembali sesi di antara peristiwa, sehingga dua pembaruan PR menghasilkan dua sesi independen.

[!NOTE]

Peristiwa webhook GitHub tunduk pada batas per jam per tugas dan per akun. Peristiwa yang melebihi batas dibuang sampai jendela waktu direset.

Claude GitHub App harus diinstal pada repositori yang ingin Anda pantau, dari surface mana pun Anda mengonfigurasi pemicu.

• Konfigurasikan pemicu GitHub dari UI web, yang akan meminta Anda menginstal aplikasi jika belum ada. Ikuti langkah-langkah di bawah untuk mengonfigurasinya di web.
• Dari CLI, instal aplikasi dari halaman GitHub App terlebih dahulu, lalu minta Claude untuk memasang pemicu GitHub ke tugas terjadwal yang sudah ada, misalnya /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp. Jalur CLI memerlukan Claude Code v2.1.225 atau lebih baru. Ketika Claude menambahkan pemicu, Claude membalas dengan tautan ke tugas yang dipicu oleh pemicu tersebut.

1. Buka tugas untuk diedit

Buka claude.ai/code/routines, klik tugas terjadwal, lalu buka menu di sebelah namanya dan pilih Edit. Dialog Edit scheduled task akan terbuka.

2. Tambahkan pemicu peristiwa GitHub

Di baris Trigger, klik + dan pilih GitHub event dari menu yang terbuka.

[!NOTE]

Menjalankan /web-setup di CLI memberikan akses repositori untuk kloning, tetapi tidak menginstal Claude GitHub App dan tidak mengaktifkan pengiriman webhook.

3. Konfigurasikan pemicu

Ubah repositori jika perlu, pilih peristiwa dari daftar peristiwa yang didukung, dan secara opsional tambahkan filter. Lalu klik Save changes di bagian bawah dialog untuk menerapkan pemicu.

Peristiwa yang didukung

Pilih peristiwa dari salah satu kategori berikut. Dalam setiap kategori, Anda dapat memilih tindakan tertentu, seperti pull_request.opened, atau bereaksi terhadap semua tindakan dalam kategori tersebut.

Filter pull request

Gunakan filter untuk mempersempit pull request mana yang memulai sesi baru. Semua kondisi filter harus cocok agar tugas terjadwal terpicu. Kolom filter yang tersedia adalah:

Setiap filter memasangkan kolom dengan operator: equals, contains, starts with, is one of, is not one of, atau matches regex.

Operator matches regex menguji seluruh nilai kolom, bukan substring di dalamnya. Untuk mencocokkan judul apa pun yang mengandung hotfix, tulis .*hotfix.*. Tanpa .* di sekelilingnya, filter hanya mencocokkan judul yang persis hotfix tanpa apa pun sebelum atau sesudahnya. Untuk pencocokan substring literal tanpa sintaks regex, gunakan operator contains.

Beberapa contoh kombinasi filter:

• Review modul autentikasi: base branch main, head branch contains auth-provider. Mengirim setiap PR yang menyentuh autentikasi ke peninjau yang terfokus.
• Hanya yang siap direview: is draft adalah false. Melewati draf sehingga tugas hanya berjalan ketika PR siap untuk direview.
• Backport berbasis label: labels mencakup needs-backport. Memicu tugas port-ke-branch-lain hanya ketika maintainer memberi tag pada PR.

Kelola tugas terjadwal

Klik tugas terjadwal dalam daftar untuk membuka halaman detailnya. Halaman detail menampilkan repositori, konektor, prompt, jadwal, token API, pemicu GitHub tugas, serta daftar eksekusi sebelumnya.

Lihat dan berinteraksi dengan eksekusi

Klik eksekusi mana pun untuk membukanya sebagai sesi penuh. Dari sana Anda dapat melihat apa yang dilakukan Claude, meninjau perubahan, membuat pull request, atau melanjutkan percakapan. Setiap sesi eksekusi bekerja seperti sesi lainnya: gunakan menu dropdown di sebelah judul sesi untuk mengganti nama, mengarsipkan, atau menghapusnya.

Di bawah History pada halaman detail tugas, baris setiap eksekusi yang telah selesai diakhiri dengan Error jika eksekusi gagal, Cancelled jika eksekusi dibatalkan, dan tanpa kedua kata tersebut jika eksekusi berhasil. Filter Status menamai ketiga hasil yang sama tersebut Failed, Cancelled, dan Succeeded. Hasil-hasil ini menunjukkan bagaimana sesi berakhir, bukan apakah Claude menyelesaikan pekerjaan yang dijelaskan prompt Anda, jadi buka eksekusi dan baca transkripnya untuk melihat apa yang terjadi.

• Succeeded: sesi berakhir tanpa Claude Code melaporkan kegagalan. Permintaan jaringan yang diblokir, tool konektor yang hilang, dan pekerjaan yang tidak dapat diselesaikan Claude muncul di transkrip, bukan di baris tersebut
• Failed: sesi tidak selesai secara normal. Misalnya, sesi berhenti secara tidak terduga, berakhir dengan error, atau diarsipkan sebelum eksekusi dimulai
• Cancelled: eksekusi tidak gagal, dan sesinya diarsipkan. Jika Anda mengarsipkan sesi dari eksekusi yang berhasil, eksekusi tersebut berubah menjadi Cancelled. Tidak ada yang perlu diubah pada tugas

Jika peringatan muncul di bawah History, lihat Peringatan "The last run".

Edit dan kontrol tugas terjadwal

Dari halaman detail, Anda dapat:

• Klik Run now untuk memulai eksekusi segera tanpa menunggu waktu terjadwal berikutnya.
• Gunakan sakelar on/off di bagian atas halaman untuk menjeda atau melanjutkan jadwal. Tugas yang dijeda mempertahankan konfigurasinya tetapi tidak berjalan sampai Anda mengaktifkannya kembali.
• Buka menu di sebelah nama tugas dan pilih Edit untuk mengubah nama, prompt, repositori, lingkungan, konektor, atau pemicu tugas mana pun. Dialog Edit scheduled task terbuka dengan tata letak yang sama seperti dialog pembuatan. Untuk menambahkan pemicu, klik + di baris Trigger. Klik Save changes untuk menerapkan perubahan Anda. Tindakan token API langsung berlaku, tanpa Save changes.
• Buka menu yang sama dan pilih Delete untuk menghapus tugas.

Kelola tugas terjadwal dari CLI

Jalankan /schedule list untuk melihat tugas terjadwal Anda, /schedule update untuk mengubah salah satunya, atau /schedule run untuk memulainya segera.

Anda juga dapat menanyakan riwayat eksekusi tugas terjadwal, misalnya /schedule why did my nightly review do nothing this morning?. Claude mencantumkan eksekusi terbaru tugas beserta statusnya dan tautan untuk membuka setiap eksekusi di web. Claude juga membaca log eksekusi untuk menjelaskan apa yang terjadi, termasuk error tool, penolakan izin, dan hasil akhir. Memerlukan Claude Code v2.1.227 atau lebih baru.

Repositori dan izin branch

Tugas terjadwal memerlukan akses GitHub untuk mengklon repositori. Ketika Anda membuat tugas terjadwal dari CLI dengan /schedule, Claude memeriksa apakah akun Anda memiliki akses GitHub untuk repositori tempat Anda menjalankannya. Jika tidak, Claude menambahkan catatan penyiapan yang menjelaskan cara memberikannya.

[!NOTE]

Lihat Opsi autentikasi GitHub untuk dua cara memberikan akses. Pada paket Team dan Enterprise, seorang Owner organisasi Claude Anda harus mengaktifkan setiap metode sebelum Anda dapat menggunakannya; lihat Hubungkan GitHub.

Jika koneksi GitHub Anda hilang atau kedaluwarsa ketika eksekusi dijadwalkan, tugas terjadwal melewati eksekusi sampai Anda menghubungkan kembali, hingga 72 jam. Hubungkan kembali GitHub dalam jendela waktu tersebut dan tugas akan dilanjutkan dengan sendirinya. Setelah 72 jam tanpa koneksi, tugas akan nonaktif, dan Anda mengaktifkannya kembali setelah menghubungkan kembali GitHub.

Setiap repositori yang Anda tambahkan diklon pada setiap eksekusi. Claude memulai dari branch default repositori kecuali prompt Anda menentukan lain. Jika peristiwa pull request GitHub memicu eksekusi dan repositori pull request tersebut adalah repositori pertama tugas, repositori tersebut dimulai dari head commit pull request.

Claude melakukan push pekerjaannya ke branch dengan awalan claude/ kecuali prompt Anda mengarahkannya untuk melakukan push ke branch lain. Untuk mengontrol branch mana yang dapat menjadi tujuan push suatu eksekusi, gunakan aturan perlindungan branch atau ruleset di GitHub. Untuk eksekusi pada infrastruktur yang dikelola Anthropic, dan untuk eksekusi self-hosted yang melakukan push melalui proxy git Anthropic, GitHub menerapkannya pada akses GitHub yang Anda hubungkan, sehingga aturan yang dapat dilewati oleh akses tersebut tidak memblokir push suatu eksekusi. Eksekusi self-hosted yang melakukan push dengan kredensial git yang disediakan deployment Anda akan diperiksa terhadap kredensial tersebut. Lihat Konfigurasi git.

Konektor

Tugas terjadwal dapat menggunakan konektor MCP Anda yang terhubung untuk membaca dari dan menulis ke layanan eksternal selama setiap eksekusi. Misalnya, tugas yang melakukan triase permintaan dukungan dapat membaca dari channel Slack dan membuat issue di Linear.

Konektor adalah integrasi claude.ai di akun Anda. Server MCP yang Anda tambahkan secara lokal di CLI dengan claude mcp add disimpan di mesin Anda, bukan di akun claude.ai Anda, sehingga tidak muncul dalam daftar konektor. Untuk menggunakan salah satu server tersebut dalam tugas terjadwal:

• Sebagai konektor: tambahkan sebagai konektor di claude.ai/customize/connectors
• Di repositori: untuk tugas terjadwal dengan satu repositori, Anda dapat mendeklarasikan server dalam .mcp.json yang di-commit sebagai gantinya, kecuali tugas tersebut berjalan sebagai thread dalam proyek. Jika demikian, tambahkan server sebagai konektor.

Ketika Anda membuat tugas terjadwal, semua konektor Anda yang saat ini terhubung disertakan secara default. Hapus yang tidak diperlukan untuk membatasi tool mana yang dapat diakses Claude selama eksekusi. Anda juga dapat menambahkan konektor langsung dari dialog pembuatan atau edit tugas.

Untuk mengelola atau menambahkan konektor di luar dialog tersebut, kunjungi claude.ai/customize/connectors atau gunakan /schedule update di CLI.

Permintaan izin selama eksekusi

[!NOTE]

Untuk tugas yang berjalan di lingkungan self-hosted organisasi Anda, lihat Izin dan persetujuan tool.

Ketika eksekusi memulai sesi baru di cloud Anthropic, sesi tersebut dimulai dalam auto mode kecuali auto mode tidak tersedia. Dalam auto mode, model pengklasifikasi mengizinkan atau memblokir tindakan yang jika tidak demikian akan menunggu persetujuan Anda.

Eksekusi tetap berhenti dan menunggu jawaban dalam kasus seperti berikut:

• Tindakan yang tetap meminta izin bahkan dalam auto mode: misalnya, tindakan yang cocok dengan aturan ask. Lihat Cara auto mode mengevaluasi tindakan
• Pemblokiran berulang: satu pemblokiran tidak mengakhiri eksekusi. Setelah pemblokiran mencapai ambang pemblokiran berulang auto mode, permintaan izin muncul di sesi eksekusi dan menunggu sampai seseorang menjawabnya

Jika auto mode tidak tersedia, misalnya ketika organisasi Anda menonaktifkannya atau model tugas tidak mendukungnya, eksekusi mempertahankan mode izin saat eksekusi tersebut diluncurkan. Untuk menjawab permintaan izin yang sedang menunggu, buka eksekusi dari halaman detail tugas.

Dalam proyek, eksekusi dapat melanjutkan thread alih-alih memulai sesi baru. Eksekusi tersebut mempertahankan mode izin apa pun yang sedang digunakan thread pada saat itu. Ketika thread tersebut dibuat, thread dimulai dalam auto mode kecuali auto mode tidak tersedia. Untuk menjawab permintaan izin yang menunggu di thread tersebut, lihat Membuka blokir thread yang menunggu persetujuan.

Ketika eksekusi memublikasikan artifact tanpa bertanya

Selama eksekusi dalam auto mode, Claude memublikasikan artifact tanpa bertanya kepada Anda setelah pengklasifikasi mengizinkan publikasi tersebut. Anda tetap ditanya terlebih dahulu ketika, misalnya, publikasi cocok dengan aturan ask. Artifact baru hanya terlihat oleh Anda sampai Anda membagikannya. Aturan Accept edits berikut tidak berlaku dalam auto mode.

Ketika tugas terjadwal bertugas menjaga sebuah halaman tetap mutakhir, berikan artifact yang sudah Anda publikasikan.

Artifact dalam mode Accept edits

Ketika jadwal tugas terjadwal atau Run now memulai eksekusi, Claude dapat memublikasikan artifact baru tanpa bertanya. Artifact baru tersebut hanya terlihat oleh Anda sampai Anda membagikannya. Jika publikasi mendeklarasikan kapabilitas runtime untuk halaman tersebut, seperti panggilan konektor atau unduhan file, Claude akan bertanya terlebih dahulu.

Dalam eksekusi tersebut, Claude memublikasikan ulang artifact yang sudah ada tanpa bertanya hanya jika semua kondisi berikut terpenuhi:

• Anda dapat mengedit artifact tersebut dan artifact tersebut milik organisasi Anda sendiri
• Jika publikasi memuat lebih dari sekadar halaman, seperti file pendukung, Anda adalah pemilik artifact tersebut
• Artifact tidak dibagikan secara publik
• Jika artifact dibagikan dengan orang tertentu atau organisasi Anda, penontonnya tidak secara otomatis melihat setiap versi baru
• Publikasi tidak memaksa menimpa versi yang lebih baru
• Publikasi tidak mendeklarasikan kapabilitas runtime untuk halaman tersebut
• Halaman yang sudah ada tidak memiliki hak akses yang menjangkau di luar halaman, seperti panggilan konektor

Dalam semua kasus lainnya, termasuk eksekusi yang dimulai oleh pemicu API atau GitHub, Claude akan bertanya terlebih dahulu.

Lingkungan dan akses jaringan

Setiap tugas terjadwal menggunakan lingkungan cloud yang mengontrol akses jaringan, environment variable, dan skrip penyiapan. Tugas mewarisi kebijakan jaringan lingkungan pada setiap eksekusi.

Lingkungan Default menggunakan akses jaringan Trusted, yang hanya mengizinkan allowlist default melalui jaringan sesi. Permintaan pada jalur tersebut ke host di luar allowlist gagal dengan 403 dan x-deny-reason: host_not_allowed. Lalu lintas konektor MCP dirutekan melalui server Anthropic, bukan melalui jalur tersebut, sehingga konektor yang Anda tambahkan ke tugas berfungsi tanpa perlu menambahkan host-nya ke Allowed domains. Hapus konektor yang tidak Anda perlukan di bawah Konektor.

Untuk mengizinkan domain tambahan pada salah satu lingkungan Anda sendiri, ikuti langkah-langkah ini. Lingkungan yang dibagikan organisasi terbuka dalam mode read-only di sini, sehingga Owner mengubah akses jaringannya dari halaman Cloud environments di pengaturan admin.

1. Buka tugas untuk diedit

Buka claude.ai/code/routines, klik tugas terjadwal, lalu buka menu di sebelah namanya dan pilih Edit. Dialog Edit scheduled task akan terbuka.

2. Buka pemilih lingkungan

Buka Advanced settings > General > Cloud environment, dengan memperluas Advanced settings terlebih dahulu jika masih tertutup. Klik ikon cloud yang menampilkan nama lingkungan Anda, seperti Default.

3. Buka pengaturan lingkungan

Arahkan kursor ke lingkungan dalam daftar dan klik ikon pengaturan yang muncul di sebelah kanan.

4. Ubah tingkat akses jaringan

Dalam dialog Edit cloud environment, ubah Network access menjadi Custom dan masukkan domain Anda di Allowed domains. Centang Also include default list of common package managers untuk mempertahankan allowlist default bersama domain kustom Anda. Pilih Full sebagai gantinya untuk akses tanpa batasan.

5. Simpan

Klik Save changes di dialog Edit cloud environment, lalu tutup dialog Edit scheduled task di belakangnya. Kebijakan baru berlaku mulai eksekusi berikutnya.

Lihat Akses jaringan untuk detail tentang tingkat akses dan allowlist default.

Penggunaan dan batas

Tugas terjadwal menggunakan kuota langganan dengan cara yang sama seperti sesi interaktif. Lihat konsumsi Anda saat ini di claude.ai/settings/usage.

Terpisah dari penggunaan langganan, setiap cara memulai eksekusi memiliki batas per jam:

Tidak satu pun dari batas per jam ini memiliki overage.

Ketika tugas terjadwal mencapai batas penggunaan langganan Anda, organisasi yang mengaktifkan kredit penggunaan dapat terus menjalankan tugas terjadwal dengan overage terukur. Tanpa kredit penggunaan, eksekusi tambahan ditolak sampai jendela penggunaan Anda direset. Aktifkan kredit penggunaan di claude.ai/settings/usage. Pada paket Team dan Enterprise, admin mengaktifkannya untuk organisasi di claude.ai/admin-settings/usage.

Selama langganan Anda dijeda, tugas terjadwal Anda ditangguhkan dan tidak berjalan. Setelah langganan Anda aktif kembali, aktifkan kembali tugas-tugas tersebut.

Tempat nama routines masih muncul

Tugas terjadwal sebelumnya bernama routines, dan tempat-tempat berikut masih menggunakan nama lama tersebut. Masing-masing merujuk pada fitur yang sama:

• Aplikasi: pada beberapa akun, entri sidebar dan judul halaman bertuliskan Routines, tombolnya bertuliskan New routine, dan label lainnya menyebut routine. Untuk membuat tugas di sana, lihat Formulir halaman penuh.
• Alamat web: claude.ai/code/routines
• CLI: alias /routines untuk /schedule, deskripsi perintah, dan balasan Claude saat menyiapkan tugas
• API: path endpoint /fire, header beta-nya, type responsnya, tag <routine-fire-payload>, dan halaman referensi Trigger a routine through the API
• Pengaturan organisasi: toggle Scheduled tasks (Was Routines) atau Routines

Pemecahan masalah

/schedule menampilkan "Unknown command"

CLI menyembunyikan /schedule ketika salah satu persyaratannya tidak terpenuhi: menu perintah menampilkan No commands match "/schedule" saat Anda mengetik. Mengirimkannya mengembalikan Unknown command: /schedule, kecuali dalam kasus-kasus di bawah ini yang menyebutkan jawaban berbeda.

Penyebabnya biasanya salah satu dari berikut ini:

• Anda terautentikasi dengan kunci API Console, profil Anthropic atau kredensial federasi, atau penyedia cloud seperti Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry. /schedule memerlukan login langganan claude.ai. Dengan kunci API Console atau profil, dan pengambilan feature flag diaktifkan, mengirimkan /schedule justru menampilkan /schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access. Dengan login penyedia cloud, Anda tetap melihat Unknown command: /schedule. Jika ANTHROPIC_API_KEY atau ANTHROPIC_AUTH_TOKEN diatur di shell Anda, atau apiKeyHelper diatur di settings.json, hapus terlebih dahulu, karena ini diutamakan daripada login claude.ai. Profil atau kredensial federasi juga diutamakan, jadi matikan itu juga
• Anda sepenuhnya keluar, tanpa kunci API atau kredensial lainnya. Dengan pengambilan feature flag diaktifkan, mengirimkan /schedule menampilkan /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account. Sebelum v2.1.268, sesi yang sudah keluar menampilkan pesan Claude for Enterprise yang sama seperti kunci API Console
• Anda berada di dalam sesi cloud, di mana mengirimkan /schedule menjawab bahwa perintah tidak tersedia di lingkungan tersebut. Kelola tugas terjadwal dari UI web sebagai gantinya
• Kebijakan organisasi Anda menonaktifkan sesi cloud, yang dibutuhkan tugas terjadwal. Dalam kasus ini, mengirimkan /schedule justru menjawab Cloud sessions are disabled by your organization's policy. Sebelum v2.1.268, perintah ini mengembalikan Unknown command: /schedule
• Owner menonaktifkan tugas terjadwal untuk organisasi Team atau Enterprise Anda. Sebelum v2.1.227, perintah tetap muncul dalam kasus ini, dan claude.ai menolak tugas ketika Claude mencoba membuat atau menjalankannya
• Organisasi Enterprise Anda mengelola akses Anda dengan peran kustom, dan tidak ada peran Anda yang mencakup izin tugas terjadwal di bawah Remote sessions. Minta Owner untuk menambahkannya ke salah satu peran Anda

Jika penyebabnya adalah login CLI Anda atau karena Anda berada di dalam sesi cloud, Anda tetap dapat membuat dan mengelola tugas terjadwal di claude.ai/code/routines. Anda memerlukan akun Pro, Max, Ultra, Team, atau Enterprise di sana. Jika tugas terjadwal atau sesi cloud dinonaktifkan untuk organisasi Anda atau tidak ada dalam peran Anda, Anda juga tidak dapat membuatnya di web.

Tugas terjadwal dinonaktifkan untuk organisasi Anda

Tugas terjadwal cloud dinonaktifkan untuk organisasi Anda, dan Anda tidak dapat mengubahnya dari konfigurasi lokal Anda. Tanyakan kepada Owner Team atau Enterprise Anda apakah mereka dapat mengaktifkan toggle Scheduled tasks (Was Routines) atau Routines di Organization settings > Capabilities > Remote sessions.

Peringatan "The last run"

Ketika sebuah peringatan di bawah History diawali dengan "The last run", temukan peringatan tersebut di kolom pertama dan lakukan apa yang disebutkan di barisnya. Peringatan akan hilang setelah run berikutnya dimulai.

Sumber daya terkait

• /loop dan penjadwalan dalam sesi: jadwalkan tugas lokal dalam sesi CLI yang terbuka
• Tugas terjadwal Desktop: tugas terjadwal lokal yang berjalan di mesin Anda dengan akses ke file lokal
• Lingkungan cloud: konfigurasikan akses jaringan, environment variable, dan skrip penyiapan untuk sesi cloud
• Projects: pekerjaan berkelanjutan yang dikoordinasikan Claude di berbagai sesi cloud paralel; tugas terjadwal yang dibuat dari sebuah proyek muncul di tab Scheduled tasks
• Konektor MCP: hubungkan layanan eksternal seperti Slack, Linear, dan Google Drive
• GitHub Actions: jalankan Claude di pipeline CI Anda pada peristiwa repositori