Langsung ke konten utama
Rutinitas berada dalam pratinjau penelitian. Perilaku, batas, dan permukaan API mungkin berubah.
Rutinitas adalah konfigurasi Claude Code yang disimpan: prompt, satu atau lebih repositori, dan serangkaian konektor, dikemas sekali dan dijalankan secara otomatis. Rutinitas dijalankan pada infrastruktur cloud yang dikelola Anthropic, sehingga terus bekerja ketika laptop Anda ditutup. Setiap rutinitas dapat memiliki satu atau lebih pemicu yang terpasang padanya:
  • Terjadwal: berjalan dengan frekuensi berulang seperti per jam, malam hari, atau mingguan
  • API: dipicu sesuai permintaan dengan mengirim POST HTTP ke titik akhir per-rutinitas dengan token pembawa
  • GitHub: berjalan secara otomatis sebagai respons terhadap peristiwa repositori seperti permintaan tarik atau rilis
Satu rutinitas dapat menggabungkan pemicu. Misalnya, rutinitas tinjauan PR dapat berjalan malam hari, dipicu dari skrip penyebaran, dan juga bereaksi terhadap setiap PR baru. Rutinitas tersedia pada paket Pro, Max, Team, dan Enterprise dengan Claude Code di web diaktifkan. Buat dan kelola di claude.ai/code/routines, atau dari CLI dengan /schedule. Halaman ini mencakup pembuatan rutinitas, mengonfigurasi setiap jenis pemicu, mengelola jalankan, dan bagaimana batas penggunaan berlaku.

Contoh kasus penggunaan

Setiap contoh memasangkan jenis pemicu dengan jenis pekerjaan yang cocok untuk rutinitas: tanpa pengawasan, dapat diulang, dan terikat pada hasil yang jelas. Pemeliharaan backlog. Pemicu jadwal berjalan setiap malam kerja terhadap pelacak masalah Anda melalui konektor. Rutinitas membaca masalah yang dibuka sejak jalankan terakhir, menerapkan label, menetapkan pemilik berdasarkan area kode yang direferensikan, dan memposting ringkasan ke Slack sehingga tim memulai hari dengan antrian yang terawat. Triase peringatan. Alat pemantauan Anda memanggil titik akhir API rutinitas ketika ambang batas kesalahan terlampaui, meneruskan badan peringatan sebagai text. Rutinitas menarik jejak tumpukan, menghubungkannya dengan komit terbaru di repositori, dan membuka permintaan tarik draf dengan perbaikan yang diusulkan dan tautan kembali ke peringatan. On-call meninjau PR alih-alih memulai dari terminal kosong. Tinjauan kode khusus. Pemicu GitHub berjalan pada pull_request.opened. Rutinitas menerapkan daftar periksa tinjauan tim Anda sendiri, meninggalkan komentar sebaris untuk masalah keamanan, kinerja, dan gaya, dan menambahkan komentar ringkasan sehingga peninjau manusia dapat fokus pada desain alih-alih pemeriksaan mekanis. Verifikasi penyebaran. Saluran pipa CD Anda memanggil titik akhir API rutinitas setelah setiap penyebaran produksi. Rutinitas menjalankan pemeriksaan asap terhadap build baru, memindai log kesalahan untuk regresi, dan memposting go atau no-go ke saluran rilis sebelum jendela penyebaran ditutup. Hanyut dokumentasi. Pemicu jadwal berjalan mingguan. Rutinitas memindai PR yang digabungkan sejak jalankan terakhir, menandai dokumentasi yang mereferensikan API yang berubah, dan membuka PR pembaruan terhadap repositori dokumen untuk editor ditinjau. Port perpustakaan. Pemicu GitHub berjalan pada pull_request.closed disaring ke PR yang digabungkan di satu repositori SDK. Rutinitas memindahkan perubahan ke SDK paralel dalam bahasa lain dan membuka PR yang cocok, menjaga kedua perpustakaan tetap sinkron tanpa manusia mengimplementasikan ulang setiap perubahan. Bagian di bawah ini menjelaskan cara membuat rutinitas dan mengonfigurasi setiap jenis pemicu ini.

Buat rutinitas

Buat rutinitas dari web, aplikasi Desktop, atau CLI. Ketiga permukaan menulis ke akun cloud yang sama, sehingga rutinitas yang Anda buat di CLI muncul di claude.ai/code/routines segera. Di aplikasi Desktop, klik New task dan pilih New remote task; memilih New local task malah membuat tugas terjadwal Desktop lokal, yang berjalan di mesin Anda dan bukan rutinitas. Formulir pembuatan menyiapkan prompt rutinitas, repositori, lingkungan, konektor, dan pemicu. Rutinitas berjalan secara otonom sebagai sesi cloud Claude Code penuh: tidak ada pemilih mode izin dan tidak ada prompt persetujuan selama jalankan. Sesi dapat menjalankan perintah shell, menggunakan skills yang berkomitmen pada repositori yang diklon, dan memanggil konektor apa pun yang Anda sertakan. Apa yang dapat dijangkau rutinitas ditentukan oleh repositori yang Anda pilih dan pengaturan push cabang mereka, lingkungan akses jaringan dan variabel, dan konektor yang Anda sertakan. Cakupan masing-masing ke apa yang benar-benar dibutuhkan rutinitas. Rutinitas milik akun claude.ai individual Anda. Mereka tidak dibagikan dengan rekan kerja, dan mereka dihitung terhadap tunjangan jalankan harian akun Anda. Apa pun yang dilakukan rutinitas melalui identitas GitHub yang terhubung atau konektor muncul sebagai Anda: komit dan permintaan tarik 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 formulir pembuatan

Kunjungi claude.ai/code/routines dan klik New routine.
2

Beri nama rutinitas dan tulis prompt

Berikan rutinitas nama deskriptif dan tulis prompt yang Claude jalankan setiap kali. Prompt adalah bagian paling penting: rutinitas berjalan secara otonom, jadi prompt harus mandiri dan eksplisit tentang apa yang harus dilakukan dan seperti apa kesuksesan itu.Input prompt mencakup pemilih model. Claude menggunakan model yang dipilih pada setiap jalankan.
3

Pilih repositori

Tambahkan satu atau lebih repositori GitHub untuk Claude kerjakan. Setiap repositori diklon di awal jalankan, dimulai dari cabang default. Claude membuat cabang dengan awalan claude/ untuk perubahannya. Untuk memungkinkan push ke cabang apa pun, aktifkan Allow unrestricted branch pushes untuk repositori tersebut.
4

Pilih lingkungan

Pilih lingkungan cloud untuk rutinitas. Lingkungan mengontrol apa yang dapat diakses sesi cloud:
  • Network access: atur tingkat akses internet yang tersedia selama setiap jalankan
  • Environment variables: sediakan kunci API, token, atau rahasia lainnya yang dapat digunakan Claude
  • Setup script: instal dependensi dan alat yang dibutuhkan rutinitas. Hasilnya di-cache, jadi skrip tidak berjalan ulang pada setiap sesi
Lingkungan Default disediakan. Untuk menggunakan lingkungan khusus, buat satu sebelum membuat rutinitas.
5

Pilih pemicu

Di bawah Select a trigger, pilih bagaimana rutinitas dimulai. Anda dapat memilih satu jenis pemicu atau menggabungkan beberapa.
Pilih frekuensi preset: per jam, harian, hari kerja, atau mingguan. Lihat Add a schedule trigger untuk penanganan zona waktu, stagger, dan interval cron khusus.
6

Tinjau konektor

Semua konektor MCP yang terhubung disertakan secara default. Hapus yang tidak dibutuhkan rutinitas. Konektor memberi Claude akses ke layanan eksternal seperti Slack, Linear, atau Google Drive selama setiap jalankan.
7

Buat rutinitas

Klik Create. Rutinitas muncul dalam daftar dan berjalan saat salah satu pemicunya cocok. Untuk memulai jalankan segera, klik Run now di halaman detail rutinitas.Setiap jalankan membuat sesi baru bersama sesi lainnya, di mana Anda dapat melihat apa yang dilakukan Claude, meninjau perubahan, dan membuat permintaan tarik.

Buat dari CLI

Jalankan /schedule dalam sesi apa pun untuk membuat rutinitas terjadwal secara percakapan. Anda juga dapat meneruskan deskripsi langsung, seperti /schedule daily PR review at 9am. Claude menjalani informasi yang sama yang dikumpulkan formulir web, lalu menyimpan rutinitas ke akun Anda. /schedule di CLI hanya membuat rutinitas terjadwal. Untuk menambahkan pemicu API atau GitHub, edit rutinitas di web di claude.ai/code/routines. CLI juga mendukung pengelolaan rutinitas yang ada. Jalankan /schedule list untuk melihat semua rutinitas, /schedule update untuk mengubah satu, atau /schedule run untuk memicunya segera.

Buat dari aplikasi Desktop

Buka halaman Schedule di aplikasi Desktop, klik New task, dan pilih New remote task. Aplikasi Desktop menampilkan tugas terjadwal lokal dan rutinitas dalam grid yang sama. Lihat Desktop scheduled tasks untuk detail tentang opsi lokal.

Konfigurasi pemicu

Rutinitas dimulai ketika salah satu pemicunya cocok. Anda dapat melampirkan kombinasi apa pun dari pemicu jadwal, API, dan GitHub ke rutinitas yang sama, dan menambah atau menghapusnya kapan saja dari bagian Select a trigger formulir edit rutinitas.

Tambahkan pemicu jadwal

Pemicu jadwal menjalankan rutinitas dengan frekuensi berulang. Pilih frekuensi preset di bagian Select a trigger: per jam, harian, hari kerja, atau mingguan. Waktu dimasukkan dalam zona lokal Anda dan dikonversi secara otomatis, sehingga rutinitas berjalan pada waktu dinding jam itu terlepas dari di mana infrastruktur cloud berada. Jalankan mungkin dimulai beberapa menit setelah waktu terjadwal karena stagger. Offset konsisten untuk setiap rutinitas. Untuk interval khusus seperti setiap dua jam atau tanggal pertama setiap bulan, pilih preset terdekat dalam formulir, lalu jalankan /schedule update di CLI untuk menetapkan ekspresi cron spesifik. Interval minimum adalah satu jam; ekspresi yang berjalan lebih sering ditolak.

Tambahkan pemicu API

Pemicu API memberikan rutinitas titik akhir HTTP khusus. POSTing ke titik akhir dengan token pembawa rutinitas memulai sesi baru dan mengembalikan URL sesi. Gunakan ini untuk menghubungkan Claude Code ke sistem peringatan, saluran pipa penyebaran, alat internal, atau di mana pun Anda dapat membuat permintaan HTTP yang diautentikasi. Pemicu API ditambahkan ke rutinitas yang ada dari web. CLI saat ini tidak dapat membuat atau mencabut token.
1

Buka rutinitas untuk diedit

Buka claude.ai/code/routines, klik rutinitas yang ingin Anda picu melalui API, lalu klik ikon pensil untuk membuka Edit routine.
2

Tambahkan pemicu API

Gulir ke bagian Select a trigger di bawah prompt, klik Add another trigger, dan pilih API.
3

Salin URL dan hasilkan token

Modal menampilkan URL untuk rutinitas ini bersama dengan contoh perintah curl. Salin URL, lalu klik Generate token dan salin token segera. Token ditampilkan sekali dan tidak dapat diambil nanti, jadi simpan di tempat yang aman seperti penyimpanan rahasia alat peringatan Anda.
4

Panggil titik akhir

Kirim token di header Authorization: Bearer ketika Anda POST ke URL. Bagian Trigger a routine di bawah menunjukkan contoh lengkap.
Setiap rutinitas memiliki token sendiri, dibatasi untuk memicu rutinitas itu saja. Untuk memutar atau mencabut, kembali ke modal yang sama dan klik Regenerate atau Revoke.

Picu rutinitas

Kirim permintaan POST ke titik akhir /fire dengan token pembawa di header Authorization. Badan permintaan menerima bidang text opsional untuk konteks spesifik jalankan seperti badan peringatan atau log yang gagal, diteruskan ke rutinitas bersama prompt yang disimpannya. Nilainya adalah teks freeform dan tidak diuraikan: jika Anda mengirim JSON atau muatan terstruktur lainnya, rutinitas menerimanya sebagai string literal. Contoh di bawah memicu rutinitas dari shell:
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 badan JSON dengan ID sesi baru dan URL:
{
  "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 menonton jalankan secara real-time, meninjau perubahan, atau melanjutkan percakapan secara manual.
Titik akhir /fire dikirim di bawah header beta experimental-cc-routine-2026-04-01. Bentuk permintaan dan respons, batas laju, dan semantik token mungkin berubah saat fitur berada dalam pratinjau penelitian. Perubahan yang merusak dikirim di balik versi header beta bertanggal baru, dan dua versi header sebelumnya paling baru terus bekerja sehingga pemanggil memiliki waktu untuk bermigrasi.

Referensi API

Untuk referensi API lengkap, termasuk semua respons kesalahan, aturan validasi, dan batas bidang, lihat Trigger a routine via API dalam dokumentasi Platform Claude. Titik akhir /fire tersedia untuk pengguna claude.ai saja dan bukan bagian dari permukaan API Platform Claude.

Tambahkan pemicu GitHub

Pemicu GitHub memulai sesi baru secara otomatis ketika peristiwa yang cocok terjadi pada repositori yang terhubung. Setiap peristiwa yang cocok memulai sesinya sendiri.
Selama pratinjau penelitian, peristiwa webhook GitHub tunduk pada batas per jam per-rutinitas dan per-akun. Peristiwa di luar batas dijatuhkan sampai jendela direset. Lihat batas saat ini Anda di claude.ai/code/routines.
Pemicu GitHub dikonfigurasi dari UI web saja.
1

Buka rutinitas untuk diedit

Buka claude.ai/code/routines, klik rutinitas, lalu klik ikon pensil untuk membuka Edit routine.
2

Tambahkan pemicu peristiwa GitHub

Gulir ke bagian Select a trigger, klik Add another trigger, dan pilih GitHub event.
3

Instal Aplikasi GitHub Claude

Aplikasi GitHub Claude harus diinstal pada repositori yang ingin Anda berlangganan. Penyiapan pemicu meminta Anda untuk menginstalnya jika belum.
Menjalankan /web-setup di CLI memberikan akses repositori untuk kloning, tetapi tidak menginstal Aplikasi GitHub Claude dan tidak mengaktifkan pengiriman webhook. Pemicu GitHub memerlukan penginstalan Aplikasi GitHub Claude, yang diminta penyiapan pemicu untuk dilakukan.
4

Konfigurasi pemicu

Pilih repositori, pilih peristiwa dari daftar peristiwa yang didukung, dan secara opsional tambahkan filter. Simpan pemicu.

Peristiwa yang didukung

Pemicu GitHub dapat berlangganan salah satu dari kategori peristiwa berikut. Dalam setiap kategori Anda dapat memilih tindakan spesifik, seperti pull_request.opened, atau bereaksi terhadap semua tindakan dalam kategori.
PeristiwaDipicu ketika
Pull requestPR dibuka, ditutup, ditugaskan, diberi label, disinkronkan, atau diperbarui sebaliknya
ReleaseRilis dibuat, dipublikasikan, diedit, atau dihapus

Filter permintaan tarik

Gunakan filter untuk mempersempit permintaan tarik mana yang memulai sesi baru. Semua kondisi filter harus cocok agar rutinitas dipicu. Bidang filter yang tersedia adalah:
FilterCocok
AuthorNama pengguna GitHub penulis PR
TitleTeks judul PR
BodyTeks deskripsi PR
Base branchCabang yang ditargetkan PR
Head branchCabang yang berasal dari PR
LabelsLabel yang diterapkan pada PR
Is draftApakah PR dalam status draf
Is mergedApakah PR telah digabungkan
From forkApakah PR berasal dari fork
Setiap filter memasangkan bidang dengan operator: sama dengan, berisi, dimulai dengan, adalah salah satu, bukan salah satu, atau cocok regex. Operator matches regex menguji seluruh nilai bidang, bukan substring di dalamnya. Untuk mencocokkan judul apa pun yang berisi hotfix, tulis .*hotfix.*. Tanpa .* di sekitarnya, filter hanya cocok dengan judul yang tepat hotfix tanpa apa pun sebelum atau sesudah. Untuk pencocokan substring literal tanpa sintaks regex, gunakan operator contains sebagai gantinya. Beberapa contoh kombinasi filter:
  • Auth module review: base branch main, head branch berisi auth-provider. Mengirim PR apa pun yang menyentuh autentikasi ke peninjau yang fokus.
  • External contributor triage: from fork adalah true. Merutekan setiap PR berbasis fork melalui tinjauan keamanan dan gaya ekstra sebelum manusia melihatnya.
  • Ready-for-review only: is draft adalah false. Melewati draf sehingga rutinitas hanya berjalan ketika PR siap untuk ditinjau.
  • Label-gated backport: labels termasuk needs-backport. Memicu rutinitas port-ke-cabang-lain hanya ketika pengelola memberi tag PR.

Bagaimana sesi memetakan ke peristiwa

Setiap peristiwa GitHub yang cocok memulai sesi baru. Penggunaan ulang sesi di seluruh peristiwa tidak tersedia untuk rutinitas yang dipicu GitHub, jadi dua pembaruan PR menghasilkan dua sesi independen.

Kelola rutinitas

Klik rutinitas dalam daftar untuk membuka halaman detailnya. Halaman detail menampilkan repositori rutinitas, konektor, prompt, jadwal, token API, pemicu GitHub, dan daftar jalankan masa lalu.

Lihat dan berinteraksi dengan jalankan

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

Edit dan kontrol rutinitas

Dari halaman detail rutinitas Anda dapat:
  • Klik Run now untuk memulai jalankan segera tanpa menunggu waktu terjadwal berikutnya.
  • Gunakan toggle di bagian Repeats untuk menjeda atau melanjutkan jadwal. Rutinitas yang dijeda menyimpan konfigurasi mereka tetapi tidak berjalan sampai Anda mengaktifkan kembali.
  • Klik ikon pensil untuk membuka Edit routine dan ubah nama, prompt, repositori, lingkungan, konektor, atau pemicu rutinitas apa pun. Bagian Select a trigger adalah tempat Anda menambah atau menghapus jadwal, token API, dan pemicu peristiwa GitHub.
  • Klik ikon hapus untuk menghapus rutinitas. Sesi masa lalu yang dibuat oleh rutinitas tetap dalam daftar sesi Anda.

Repositori dan izin cabang

Rutinitas memerlukan akses GitHub untuk mengklon repositori. Ketika Anda membuat rutinitas dari CLI dengan /schedule, Claude memeriksa apakah akun Anda memiliki GitHub yang terhubung dan meminta Anda menjalankan /web-setup jika tidak. Lihat GitHub authentication options untuk dua cara memberikan akses. Setiap repositori yang Anda tambahkan diklon pada setiap jalankan. Claude dimulai dari cabang default repositori kecuali prompt Anda menentukan sebaliknya. Secara default, Claude hanya dapat push ke cabang dengan awalan claude/. Ini mencegah rutinitas secara tidak sengaja memodifikasi cabang yang dilindungi atau jangka panjang. Untuk menghapus pembatasan ini untuk repositori spesifik, aktifkan Allow unrestricted branch pushes untuk repositori tersebut saat membuat atau mengedit rutinitas.

Konektor

Rutinitas dapat menggunakan konektor MCP yang terhubung untuk membaca dari dan menulis ke layanan eksternal selama setiap jalankan. Misalnya, rutinitas yang melakukan triase permintaan dukungan mungkin membaca dari saluran Slack dan membuat masalah di Linear. Ketika Anda membuat rutinitas, semua konektor yang saat ini terhubung disertakan secara default. Hapus yang tidak diperlukan untuk membatasi alat mana yang dapat diakses Claude selama jalankan. Anda juga dapat menambahkan konektor langsung dari formulir rutinitas. Untuk mengelola atau menambahkan konektor di luar formulir rutinitas, kunjungi Settings > Connectors di claude.ai atau gunakan /schedule update di CLI.

Lingkungan

Setiap rutinitas berjalan dalam lingkungan cloud yang mengontrol akses jaringan, variabel lingkungan, dan skrip penyiapan. Konfigurasi lingkungan sebelum membuat rutinitas untuk memberi Claude akses ke API, menginstal dependensi, atau membatasi cakupan jaringan. Lihat cloud environment untuk panduan penyiapan lengkap.

Penggunaan dan batas

Rutinitas mengurangi penggunaan langganan dengan cara yang sama seperti sesi interaktif. Selain batas langganan standar, rutinitas memiliki batas harian tentang berapa banyak jalankan yang dapat dimulai per akun. Lihat konsumsi saat ini dan jalankan rutinitas harian yang tersisa di claude.ai/code/routines atau claude.ai/settings/usage. Ketika rutinitas mencapai batas harian atau batas penggunaan langganan Anda, organisasi dengan penggunaan ekstra yang diaktifkan dapat terus menjalankan rutinitas pada overage terukur. Tanpa penggunaan ekstra, jalankan tambahan ditolak sampai jendela direset. Aktifkan penggunaan ekstra dari Settings > Billing di claude.ai.

Sumber daya terkait