SpyBara
Go Premium

routines.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 269 additions and 286 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Tue 6 23:59 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Wed 14 22:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Sun 25 23:58 Tue 27 22:59 Fri 30 23:01

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, Team, dan Enterprise. Buat dan kelola di claude.ai/code/routines, atau dari CLI dengan /schedule. Nama sebelumnya, routines, masih muncul di alamat web, CLI, dan API.

[!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) di Organization settings > Capabilities > Remote sessions. Ketika toggle dimatikan, tugas terjadwal yang ada berhenti berjalan dan anggota tidak dapat membuat yang baru.

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. Anda tidak memilih mode izin. Sesi menjalankan perintah shell, menggunakan skills yang di-commit ke repositori yang diklon, dan memanggil konektor apa pun yang Anda sertakan, semuanya tanpa berhenti untuk meminta persetujuan kecuali untuk beberapa tindakan artifact.

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. Jika sebuah menu terbuka terlebih dahulu, pilih Set up manually. Dialog New scheduled task akan terbuka. Opsi lain pada menu, Create with Claude, memungkinkan Anda mendeskripsikan tugas dalam obrolan dan meminta Claude membuatnya.

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. Pilih model di pemilih model pada input prompt. Claude menggunakannya pada setiap eksekusi.

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.

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.

GitHub event

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

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. 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. 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 setiap tool dari konektor yang disertakan, termasuk operasi tulis, tanpa meminta izin selama eksekusi.

7. 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.

Setiap eksekusi membuat sesi baru di samping sesi Anda yang lain, 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.

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. Sebelum v2.1.211, CLI melaporkan waktu eksekusi berikutnya pada tahun 1 untuk tugas-tugas ini.

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:

  • Zona waktu: waktu dimasukkan dalam zona lokal Anda dan dikonversi secara otomatis, sehingga tugas berjalan pada waktu jam dinding tersebut terlepas dari lokasi infrastruktur cloud.
  • 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 interval khusus seperti setiap dua jam, pilih preset terdekat di dialog, lalu jalankan /schedule update di CLI untuk menetapkan ekspresi cron tertentu. Interval minimum adalah satu jam; ekspresi yang berjalan lebih sering akan ditolak.

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, yang menawarkan One-time untuk tugas satu kali, dan atur waktu baru.

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

Konversi lokal-ke-UTC yang sama seperti jadwal berulang berlaku untuk stempel waktu satu kali.

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

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

Peristiwa Dipicu ketika
Pull request PR dibuka, ditutup, ditugaskan, diberi label, disinkronkan, atau diperbarui dengan cara lain
Release Rilis dibuat, dipublikasikan, diedit, atau dihapus

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:

Filter Mencocokkan
Author Nama pengguna GitHub penulis PR
Title Teks judul PR
Body Teks deskripsi PR
Base branch Branch yang dituju PR
Head branch Branch asal PR
Labels Label yang diterapkan pada PR
Is draft Apakah PR dalam status draf
Is merged Apakah PR telah di-merge

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.

[!NOTE]

Status hijau dalam daftar eksekusi berarti sesi dimulai dan berakhir tanpa error infrastruktur. Ini tidak berarti pekerjaan yang dijelaskan prompt Anda berhasil. Buka eksekusi untuk membaca transkrip dan memastikan apa yang sebenarnya dilakukan Claude. Permintaan jaringan yang diblokir, tool konektor yang hilang, dan kegagalan dalam pekerjaan itu sendiri semuanya muncul di sana, bukan di indikator status.

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 sehingga menjadi bagian dari repositori yang diklon

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.

Ketika eksekusi memublikasikan artifact tanpa bertanya

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.

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

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:

Tindakan Batas Dihitung untuk Melebihi batas
Eksekusi terjadwal, termasuk eksekusi satu kali 100 per jam Akun Anda Eksekusi menunggu sampai batas direset
Run now, pemicuan API, dan mengatur tugas satu kali untuk berjalan lagi 30 per jam Setiap tugas terjadwal, satu hitungan dibagi oleh ketiganya Tindakan gagal sampai batas direset
Run now dan mengatur tugas satu kali untuk berjalan lagi 100 per jam Akun Anda Sama
Pemicuan API 100 per jam Akun Anda, dihitung terpisah dari Run now Sama
Peristiwa GitHub Lihat Tambahkan pemicu GitHub

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:

  • 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)

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

Kecuali kebijakan organisasi Anda menonaktifkan tugas terjadwal atau sesi cloud, Anda dapat membuat dan mengelola tugas terjadwal di claude.ai/code/routines terlepas dari bagaimana CLI dikonfigurasi.

"Routines are disabled by your organization's policy"

Owner di organisasi Team atau Enterprise Anda kemungkinan telah mematikan toggle Scheduled tasks (Was Routines) di Organization settings > Capabilities > Remote sessions. Pada Claude Code v2.1.227 atau lebih baru, toggle yang sama juga menyembunyikan /schedule di CLI. Ini adalah pengaturan organisasi di sisi server, sehingga tidak dapat ditimpa dari konfigurasi lokal Anda. Minta Owner untuk mengaktifkan kembali tugas terjadwal untuk organisasi Anda.

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