Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
- Terjadwal: berjalan dengan frekuensi berulang seperti per jam, malam hari, atau mingguan, atau sekali pada waktu masa depan tertentu
- 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
/schedule.
Admin Team dan Enterprise dapat menonaktifkan rutinitas untuk semua anggota dengan toggle Routines di claude.ai/admin-settings/claude-code. Ketika dinonaktifkan, rutinitas yang ada berhenti berjalan dan anggota tidak dapat membuat yang baru.
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 sebagaitext. 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 di claude.ai/code/routines, dari aplikasi Desktop, atau dari CLI. Ketiga permukaan menulis ke akun cloud yang sama, sehingga rutinitas yang Anda buat di satu tempat muncul di tempat lain segera. Di aplikasi Desktop, klik Routines di bilah sisi, lalu New routine, dan pilih Remote; memilih Local malah membuat tugas terjadwal Desktop, yang berjalan di mesin Anda daripada di cloud. 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
Buka formulir pembuatan
Beri nama rutinitas dan tulis prompt
Pilih repositori
claude/ untuk perubahannya.Pilih lingkungan
- 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
Pilih pemicu
- Schedule
- GitHub event
- API
Tinjau konektor dan izin
claude/.Buat rutinitas
Buat dari CLI
Jalankan/schedule dalam sesi apa pun untuk membuat rutinitas terjadwal secara percakapan. Anda juga dapat meneruskan deskripsi langsung, untuk rutinitas berulang seperti /schedule daily PR review at 9am atau satu kali seperti /schedule clean up feature flag in one week. 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.
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, atau sekali pada waktu masa depan tertentu. 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.
Jadwalkan jalankan sekali
Jadwal sekali menjalankan rutinitas satu kali pada stempel waktu tertentu. Gunakan untuk mengingatkan diri sendiri nanti dalam minggu ini, untuk membuka PR pembersihan setelah rollout selesai, atau untuk memulai tugas tindak lanjut ketika perubahan upstream tiba. Setelah rutinitas dijalankan, rutinitas secara otomatis menonaktifkan dan UI web menandainya sebagai Ran. Untuk menjalankannya lagi, edit rutinitas dan atur waktu sekali baru. Buat jalankan sekali dari CLI dengan mendeskripsikan waktu dalam bahasa alami. Claude menyelesaikan frasa terhadap waktu saat ini dan mengonfirmasi stempel waktu absolut sebelum menyimpan.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.Buka rutinitas untuk diedit
Tambahkan pemicu API
Salin URL dan hasilkan token
Panggil titik akhir
Authorization: Bearer ketika Anda POST ke URL. Bagian Trigger a routine di bawah menunjukkan contoh lengkap.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:
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.Buka rutinitas untuk diedit
Tambahkan pemicu peristiwa GitHub
Instal Aplikasi GitHub Claude
/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.Konfigurasi pemicu
Peristiwa yang didukung
Pemicu GitHub dapat berlangganan salah satu dari kategori peristiwa berikut. Dalam setiap kategori Anda dapat memilih tindakan spesifik, sepertipull_request.opened, atau bereaksi terhadap semua tindakan dalam kategori.
| Peristiwa | Dipicu ketika |
|---|---|
| Pull request | PR dibuka, ditutup, ditugaskan, diberi label, disinkronkan, atau diperbarui sebaliknya |
| Release | Rilis 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:| Filter | Cocok |
|---|---|
| Author | Nama pengguna GitHub penulis PR |
| Title | Teks judul PR |
| Body | Teks deskripsi PR |
| Base branch | Cabang yang ditargetkan PR |
| Head branch | Cabang yang berasal dari PR |
| Labels | Label yang diterapkan pada PR |
| Is draft | Apakah PR dalam status draf |
| Is merged | Apakah PR telah digabungkan |
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 berisiauth-provider. Mengirim PR apa pun yang menyentuh autentikasi ke peninjau yang fokus. - 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. Konektor adalah integrasi claude.ai di akun Anda. Server MCP yang Anda tambahkan secara lokal di CLI denganclaude mcp add disimpan di mesin Anda daripada akun claude.ai Anda, jadi mereka tidak muncul dalam daftar konektor. Untuk menggunakan salah satu server tersebut dalam rutinitas, tambahkan sebagai konektor di claude.ai/customize/connectors, atau deklarasikan dalam .mcp.json yang berkomitmen sehingga itu adalah bagian dari repositori yang diklon.
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 dan akses jaringan
Setiap rutinitas berjalan dalam lingkungan cloud yang mengontrol akses jaringan, variabel lingkungan, dan skrip penyiapan. Rutinitas mewarisi kebijakan jaringan lingkungan pada setiap jalankan. Lingkungan Default menggunakan akses jaringan Trusted: daftar allowlist default dari registri paket, API penyedia cloud, registri kontainer, dan domain pengembangan umum dapat dijangkau, tetapi domain arbitrer tidak. Permintaan keluar ke host lain gagal dengan403 dan x-deny-reason: host_not_allowed. Lalu lintas konektor MCP dirutekan melalui server Anthropic, jadi konektor yang Anda tambahkan ke rutinitas bekerja tanpa menambahkan host mereka ke Allowed domains. Hapus konektor apa pun yang tidak Anda butuhkan di bawah Konektor.
Untuk memungkinkan domain tambahan:
Buka rutinitas untuk diedit
Buka pemilih lingkungan
Buka pengaturan lingkungan
Ubah tingkat akses jaringan
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. Jalankan sekali saja tidak dihitung terhadap batas jalankan rutinitas harian. Mereka mengurangi penggunaan langganan reguler Anda seperti sesi lainnya, tetapi mereka dikecualikan dari tunjangan jalankan rutinitas harian per akun.Pemecahan masalah
”Rutinitas dinonaktifkan oleh kebijakan organisasi Anda”
Admin Team atau Enterprise Anda mungkin telah mematikan toggle Routines di claude.ai/admin-settings/claude-code. Ini adalah pengaturan organisasi sisi server, jadi tidak dapat ditimpa dari konfigurasi lokal Anda. Hubungi admin Anda untuk meminta agar rutinitas diaktifkan untuk organisasi Anda.Sumber daya terkait
/loopand in-session scheduling: jadwalkan tugas lokal dalam sesi CLI terbuka- Desktop scheduled tasks: tugas terjadwal lokal yang berjalan di mesin Anda dengan akses ke file lokal
- Cloud environment: konfigurasi lingkungan runtime untuk sesi cloud
- MCP connectors: hubungkan layanan eksternal seperti Slack, Linear, dan Google Drive
- GitHub Actions: jalankan Claude dalam saluran pipa CI pada peristiwa repositori