📅 7 Nisan 2026 Lokasyon: claude.ai/code/routines, /schedule Anthropic docs ↗

Masaüstü Görevleri

Routines (beta) ile Çalışmayı Otomatikleştirme

Claude Code'u otopilota alın. Zamanlanmış görevler, API çağrıları veya GitHub olaylarına tepki olarak çalışan rutinler tanımlayın. Tüm bunlar Anthropic tarafından yönetilen bulut altyapısında çalışır.

Not: Routines araştırma önizlemesindedir. Davranış, sınırlar ve API yüzeyi değişebilir.

Bir routine, kaydedilmiş bir Claude Code yapılandırmasıdır: bir prompt, bir veya daha fazla repository ve bir dizi connector. Tek seferde paketlenir ve otomatik olarak çalıştırılır. Routines, Anthropic tarafından yönetilen bulut altyapısında çalıştığı için dizüstü bilgisayarınız kapalıyken bile çalışmaya devam eder.

Her routine'e bir veya daha fazla trigger eklenebilir:

Tek bir routine birden fazla trigger'ı birleştirebilir. Örneğin, bir PR inceleme routine'i gece çalışabilir, bir deploy script'inden tetiklenebilir ve ayrıca her yeni PR'a tepki verebilir.

Routines, Claude Code on the web özelliği etkin olan Pro, Max, Team ve Enterprise planlarında kullanılabilir. claude.ai/code/routines adresinden veya CLI üzerinden /schedule komutuyla oluşturulup yönetilebilir. Team ve Enterprise yöneticileri, claude.ai/admin-settings/claude-code adresindeki Routines anahtarıyla tüm üyeler için routines'i devre dışı bırakabilir. Devre dışı bırakıldığında, mevcut routines çalışmayı durdurur ve üyeler yeni routines oluşturamaz.

Örnek Kullanım Durumları (Example use cases)

Her örnek, bir trigger türünü routines'in uygun olduğu iş türüyle eşleştirir: gözetimsiz, tekrarlanabilir ve net bir sonuca bağlı.

Routine Oluşturma (Create a routine)

Web üzerinden claude.ai/code/routines adresinde, Desktop uygulamasından veya CLI'dan bir routine oluşturun. Her üç yüzey de aynı bulut hesabına yazar, bu nedenle birinde oluşturulan routine diğerlerinde hemen görünür.

Desktop uygulamasında, kenar çubuğunda Routines'e, ardından New routine'e tıklayın ve Remote'u seçin; Local seçeneği, makinenizde çalışan bir masaüstü zamanlanmış görevi oluşturur.

Oluşturma formu, routine'in prompt'unu, repository'lerini, ortamını, connector'larını ve trigger'larını ayarlar. Routines, tam Claude Code bulut oturumları olarak özerk bir şekilde çalışır: izin modu seçici veya çalışma sırasında onay prompt'ları yoktur. Oturum, shell komutları çalıştırabilir, kopyalanan repository'ye işlenmiş becerileri kullanabilir ve eklediğiniz connector'ları çağırabilir.

Routines, bireysel claude.ai hesabınıza aittir. Takım arkadaşlarınızla paylaşılmaz ve hesabınızın günlük çalıştırma kotasına dahil edilir. Routine'in bağlı GitHub kimliğiniz veya connector'larınız aracılığıyla yaptığı her şey siz olarak görünür: commit'ler ve PR'lar GitHub kullanıcınızı taşır; Slack mesajları, Linear ticket'ları veya diğer connector eylemleri, bu hizmetler için bağlı hesaplarınızı kullanır.

Web'den Oluşturma (Create from the web)

  1. Oluşturma formunu açın: claude.ai/code/routines adresini ziyaret edin ve New routine'e tıklayın.
  2. Routine'i adlandırın ve prompt'u yazın: Routine'e açıklayıcı bir ad verin ve Claude'un her seferinde çalıştıracağı prompt'u yazın. Prompt en önemli kısımdır: routine özerk çalışır, bu nedenle prompt kendi kendine yeten ve ne yapılacağı ile başarının neye benzediği konusunda açık olmalıdır. Prompt girişi bir model seçici içerir. Claude, her çalıştırmada seçilen modeli kullanır.
  3. Repository'leri seçin: Claude'un çalışması için bir veya daha fazla GitHub repository'si ekleyin. Her repository, bir çalıştırmanın başında varsayılan branch'ten başlayarak kopyalanır. Claude, değişiklikleri için claude/ ön ekli branch'ler oluşturur.
  4. Bir ortam seçin: Routine için bir bulut ortamı seçin. Ortamlar, bulut oturumunun neler erişebileceğini kontrol eder: ağ erişimi, ortam değişkenleri ve kurulum script'i. Varsayılan bir ortam, Güvenilir ağ erişimiyle sağlanır.
  5. Bir trigger seçin: Select a trigger altında, routine'in nasıl başlayacağını seçin. Schedule, GitHub event veya API seçeneklerinden birini veya birkaçını birleştirebilirsiniz.
  6. Connector'ları ve izinleri gözden geçirin: Formun altındaki Connectors ve Permissions sekmeleri, routine'in neler erişebileceğini kontrol eder. Connectors altında, bağlı tüm MCP connector'lar varsayılan olarak dahil edilir. Claude, bir çalıştırma sırasında izin istemeden dahil edilen her connector'daki tüm araçları kullanabilir. Permissions altında, Claude'un yalnızca claude/ ön ekli branch'ler yerine mevcut branch'lere push yapabilmesi gereken herhangi bir repository için Allow unrestricted branch pushes seçeneğini etkinleştirin.
  7. Routine'i oluşturun: Create'e tıklayın. Routine listede görünür ve trigger'larından biri eşleştiğinde bir sonraki sefer çalışır. Hemen bir çalıştırma başlatmak için routine'in detay sayfasında Run now'a tıklayın.

CLI'dan Oluşturma (Create from the CLI)

Herhangi bir oturumda /schedule komutunu çalıştırarak konuşma yoluyla zamanlanmış bir routine oluşturun. Doğrudan bir açıklama da iletebilirsiniz, örneğin /schedule daily PR review at 9am veya /schedule clean up feature flag in one week. Claude, web formunun topladığı aynı bilgileri adım adım toplar ve routine'i hesabınıza kaydeder.

CLI'da /schedule yalnızca zamanlanmış routines oluşturur. API veya GitHub trigger'ı eklemek için routine'i web'de claude.ai/code/routines adresinde düzenleyin. CLI ayrıca mevcut routines'i yönetmeyi de destekler: /schedule list tüm routines'i gösterir, /schedule update birini değiştirir ve /schedule run hemen tetikler.

Trigger'ları Yapılandırma (Configure triggers)

Bir routine, trigger'larından biri eşleştiğinde başlar. Aynı routine'e herhangi bir kombinasyonda schedule, API ve GitHub trigger'ları ekleyebilir ve routine'in düzenleme formundaki Select a trigger bölümünden istediğiniz zaman ekleyip kaldırabilirsiniz.

Schedule Trigger Ekleme (Add a schedule trigger)

Bir schedule trigger, routine'i tekrarlayan bir döngüde veya belirli bir gelecek zamanda bir kez çalıştırır. Select a trigger bölümünde önceden ayarlanmış bir sıklık seçin: saatlik, günlük, hafta içi veya haftalık. Saatler yerel saat diliminizde girilir ve otomatik olarak dönüştürülür, böylece routine bulut altyapısının nerede olduğuna bakılmaksızın o duvar saati zamanında çalışır.

Çalıştırmalar, stagger nedeniyle planlanan saatten birkaç dakika sonra başlayabilir. Ofset her routine için tutarlıdır. Her iki saatte bir veya ayın ilk günü gibi özel bir aralık için, formda en yakın ön ayarı seçin, ardından CLI'da /schedule update komutunu çalıştırarak belirli bir cron ifadesi ayarlayın. Minimum aralık bir saattir; daha sık çalışan ifadeler reddedilir.

Tek Seferlik Çalıştırma Planlama (Schedule a one-off run)

Tek seferlik bir schedule, routine'i belirli bir zaman damgasında bir kez çalıştırır. Routine çalıştıktan sonra otomatik olarak devre dışı kalır ve web UI'da Ran olarak işaretlenir. Tekrar çalıştırmak için routine'i düzenleyin ve yeni bir tek seferlik zaman ayarlayın.

CLI'dan, zamanı doğal dilde tanımlayarak tek seferlik bir çalıştırma oluşturun. Claude, ifadeyi geçerli saate göre çözer ve kaydetmeden önce mutlak zaman damgasını onaylar.

/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag

Tek seferlik çalıştırmalar, günlük routine çalıştırma kotasına dahil edilmez. Planınızın normal abonelik kullanımını diğer oturumlar gibi tüketirler.

API Trigger Ekleme (Add an API trigger)

Bir API trigger, routine'e özel bir HTTP endpoint'i verir. Endpoint'e routine'in bearer token'ı ile POST yapmak yeni bir oturum başlatır ve bir oturum URL'si döndürür. Bunu, Claude Code'u alert sistemlerine, deploy pipeline'larına, dahili araçlara veya kimliği doğrulanmış HTTP isteği yapabileceğiniz her yere bağlamak için kullanın.

API trigger'ları, web'den mevcut bir routine'e eklenir. CLI şu anda token oluşturamaz veya iptal edemez.

  1. Routine'i düzenleme için açın: claude.ai/code/routines adresine gidin, API ile tetiklemek istediğiniz routine'e tıklayın, ardından kalem simgesine tıklayarak Edit routine'i açın.
  2. Bir API trigger'ı ekleyin: Instructions kutusunun altındaki Select a trigger bölümüne gidin, Add another trigger'a tıklayın ve API'yi seçin.
  3. URL'yi kopyalayın ve bir token oluşturun: Modal, bu routine için URL'yi ve örnek bir curl komutunu gösterir. URL'yi kopyalayın, ardından Generate token'a tıklayın ve token'ı hemen kopyalayın. Token yalnızca bir kez gösterilir ve daha sonra alınamaz.
  4. Endpoint'i çağırın: POST yaparken token'ı Authorization: Bearer başlığında gönderin.

Bir Routine'i Tetikleme (Trigger a routine)

/fire endpoint'ine, Authorization başlığında bearer token ile bir POST isteği gönderin. İstek gövdesi, run-specific bağlam için isteğe bağlı bir text alanı kabul eder. Bu değer, kaydedilen prompt'un yanında routine'e iletilir.

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."}'

Başarılı bir istek, yeni oturum ID'si ve URL'si ile bir JSON gövdesi döndürür:

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

API Referansı (API reference)

Tam API referansı için, tüm hata yanıtları, doğrulama kuralları ve alan sınırlamaları dahil olmak üzere, Claude Platform dokümantasyonundaki "Trigger a routine via API" bölümüne bakın. /fire endpoint'i yalnızca claude.ai kullanıcılarına açıktır ve Claude Platform API yüzeyinin bir parçası değildir.

GitHub Trigger Ekleme (Add a GitHub trigger)

Bir GitHub trigger, bağlı bir repository'de eşleşen bir olay meydana geldiğinde otomatik olarak yeni bir oturum başlatır. Her eşleşen olay kendi oturumunu başlatır. Araştırma önizlemesi sırasında, GitHub webhook olayları routine başına ve hesap başına saatlik kotaya tabidir. Sınırın ötesindeki olaylar, pencere sıfırlanana kadar atılır.

GitHub trigger'ları yalnızca web UI'dan yapılandırılır.

  1. Routine'i düzenleme için açın.
  2. Bir GitHub event trigger'ı ekleyin: Select a trigger bölümüne gidin, Add another trigger'a tıklayın ve GitHub event'i seçin.
  3. Claude GitHub Uygulamasını yükleyin: Claude GitHub Uygulaması, abone olmak istediğiniz repository'ye yüklenmelidir. Trigger kurulumu, yüklü değilse yüklemenizi ister. /web-setup komutu repository erişimi verir ancak Claude GitHub Uygulamasını yüklemez ve webhook teslimatını etkinleştirmez.
  4. Trigger'ı yapılandırın: Repository'yi seçin, desteklenen olaylar listesinden bir olay seçin ve isteğe bağlı olarak filtreler ekleyin.

Desteklenen Olaylar (Supported events)

Olay Tetikleyen durum
Pull request Bir PR açıldığında, kapatıldığında, atandığında, etiketlendiğinde, senkronize edildiğinde veya başka şekilde güncellendiğinde
Release Bir release oluşturulduğunda, yayınlandığında, düzenlendiğinde veya silindiğinde

Pull Request'leri Filtreleme (Filter pull requests)

Hangi PR'ların yeni bir oturum başlatacağını daraltmak için filtreler kullanın. Routine'in tetiklenmesi için tüm filtre koşulları eşleşmelidir.

Filtre Eşleşen
Author PR yazarının GitHub kullanıcı adı
Title PR başlık metni
Body PR açıklama metni
Base branch PR'in hedef aldığı branch
Head branch PR'in geldiği branch
Labels PR'a uygulanan etiketler
Is draft PR'in taslak durumunda olup olmadığı
Is merged PR'in birleştirilip birleştirilmediği

Her filtre, bir alanı bir operatörle eşleştirir: equals, contains, starts with, is one of, is not one of veya matches regex. matches regex operatörü, tüm alan değerini test eder, bir alt dizeyi değil. hotfix içeren herhangi bir başlığı eşleştirmek için .*hotfix.* yazın. Regex sözdizimi olmadan tam alt dize eşleştirme için contains operatörünü kullanın.

Routine'leri Yönetme (Manage routines)

Listede bir routine'e tıklayarak detay sayfasını açın. Detay sayfası, routine'in repository'lerini, connector'larını, prompt'unu, schedule'ını, API token'larını, GitHub trigger'larını ve geçmiş çalıştırmaların bir listesini gösterir.

Çalıştırmaları Görüntüleme ve Etkileşim (View and interact with runs)

Herhangi bir çalıştırmaya tıklayarak tam bir oturum olarak açın. Buradan Claude'un ne yaptığını görebilir, değişiklikleri inceleyebilir, bir PR oluşturabilir veya konuşmaya devam edebilirsiniz. Her çalıştırma oturumu diğer oturumlar gibi çalışır: oturum başlığının yanındaki açılır menüyü kullanarak yeniden adlandırabilir, arşivleyebilir veya silebilirsiniz.

Çalıştırma listesindeki yeşil durum, oturumun bir altyapı hatası olmadan başladığı ve sona erdiği anlamına gelir. Prompt'unuzdaki görevin başarılı olduğu anlamına gelmez. Claude'un gerçekte ne yaptığını görmek için çalıştırmayı açın ve transkripti okuyun.

Routine'leri Düzenleme ve Kontrol Etme (Edit and control routines)

Routine detay sayfasından şunları yapabilirsiniz:

Repository'ler ve Branch İzinleri (Repositories and branch permissions)

Routines, repository'leri kopyalamak için GitHub erişimine ihtiyaç duyar. CLI'da /schedule ile bir routine oluşturduğunuzda, Claude hesabınızın GitHub'a bağlı olup olmadığını kontrol eder ve bağlı değilse /web-setup komutunu çalıştırmanızı ister.

Eklediğiniz her repository, her çalıştırmada kopyalanır. Claude, prompt'unuz aksi belirtmedikçe repository'nin varsayılan branch'inden başlar. Varsayılan olarak, Claude yalnızca claude/ ön ekli branch'lere push yapabilir. Bu, routines'in korumalı veya uzun ömürlü branch'leri yanlışlıkla değiştirmesini önler. Bu kısıtlamayı belirli bir repository için kaldırmak üzere, routine'i oluştururken veya düzenlerken o repository için Allow unrestricted branch pushes seçeneğini etkinleştirin.

Connector'lar

Routines, her çalıştırma sırasında harici hizmetlerden okumak ve yazmak için bağlı MCP connector'larınızı kullanabilir. Connector'lar, hesabınızdaki claude.ai entegrasyonlarıdır. CLI'da claude mcp add ile yerel olarak eklediğiniz MCP sunucuları, makinenizde depolanır, bu nedenle connector'lar listesinde görünmezler. Bu sunuculardan birini bir routine'de kullanmak için, claude.ai/customize/connectors adresinde bir connector olarak ekleyin veya kopyalanan repository'nin parçası olması için bir .mcp.json dosyasında bildirin.

Bir routine oluşturduğunuzda, mevcut tüm bağlı connector'lar varsayılan olarak dahil edilir. Çalıştırma sırasında Claude'un hangi araçlara erişebileceğini sınırlamak için gerekmeyenleri kaldırın.

Ortamlar ve Ağ Erişimi (Environments and network access)

Her routine, ağ erişimini, ortam değişkenlerini ve kurulum script'lerini kontrol eden bir bulut ortamında çalışır. Routine, her çalıştırmada ortamın ağ politikasını devralır.

Varsayılan ortam, Güvenilir ağ erişimi kullanır: varsayılan izin listesindeki paket kayıt defterleri, bulut sağlayıcı API'leri, konteyner kayıt defterleri ve yaygın geliştirme alanlarına erişilebilir, ancak rastgele alan adlarına erişilemez. Diğer ana bilgisayarlara giden giden istekler, 403 ve x-deny-reason: host_not_allowed ile başarısız olur.

MCP connector trafiği, Anthropic'in sunucuları üzerinden yönlendirilir, bu nedenle routine'e eklediğiniz connector'lar, ana bilgisayarlarını Allowed domains'e eklemeden çalışır.

Ek alan adlarına izin vermek için:

  1. Routine'i düzenleme için açın.
  2. Instructions kutusunun altındaki ortam seçiciyi açın (bulut simgesi).
  3. Listedeki ortamın üzerine gelin ve sağda görünen ayarlar simgesine tıklayın.
  4. Update cloud environment iletişim kutusunda, Network access'i Custom olarak değiştirin ve alan adlarınızı Allowed domains'e girin. Varsayılan izin listesini özel alan adlarınızın yanında tutmak için Also include default list of common package managers seçeneğini işaretleyin. Sınırsız erişim için Full'ı seçin.
  5. Save changes'e tıklayın. Yeni politika bir sonraki çalıştırmadan itibaren geçerli olur.

Kullanım ve Sınırlar (Usage and limits)

Routines, etkileşimli oturumlarla aynı şekilde abonelik kullanımını tüketir. Standart abonelik sınırlarına ek olarak, routines'in hesap başına günlük kaç çalıştırmanın başlayabileceğine dair bir günlük kotası vardır. Mevcut tüketiminizi ve kalan günlük routine çalıştırmalarınızı claude.ai/code/routines veya claude.ai/settings/usage adresinde görebilirsiniz.

Bir routine günlük kotaya veya abonelik kullanım sınırına ulaştığında, ekstra kullanımı etkin olan kuruluşlar, ölçülen aşımda routines çalıştırmaya devam edebilir. Ekstra kullanım olmadan, pencere sıfırlanana kadar ek çalıştırmalar reddedilir. Ekstra kullanımı claude.ai üzerinde Settings > Billing'den etkinleştirin.

Tek seferlik çalıştırmalar günlük routine kotasına dahil edilmez. Normal abonelik kullanımını diğer oturumlar gibi tüketirler, ancak hesap başına günlük routine çalıştırma kotasından muaftırlar.

Sorun Giderme (Troubleshooting)

"Routines are disabled by your organization's policy"

Team veya Enterprise yöneticiniz, claude.ai/admin-settings/claude-code adresindeki Routines anahtarını devre dışı bırakmış olabilir. Bu, sunucu tarafı bir kuruluş ayarıdır, bu nedenle yerel yapılandırmanızdan geçersiz kılınamaz. Kuruluşunuz için routines'in etkinleştirilmesini talep etmek üzere yöneticinizle iletişime geçin.

İlgili Kaynaklar (Related resources)


Örnek Kullanım Senaryosu

Senaryo: Bir ekip, her sabah işe başlamadan önce backlog'larının temizlenmesini ve dün birleştirilen PR'ların özetlenmesini istiyor. Ayrıca, production'da bir hata alert'i geldiğinde Claude'un otomatik olarak bir düzeltme PR'ı hazırlamasını istiyorlar.

Adımlar:

  1. Routine'i oluşturma: Geliştirici, claude.ai/code/routines adresine gidip New routine'e tıklar. Routine'e "Daily Backlog Cleanup & Alert Triage" adını verir.

  2. Prompt'u yazma: Prompt kutusuna şunu yazar:

    Her sabah, dün birleştirilen PR'ları tara. Her PR için:
    - İlgili issue'ları bul ve "reviewed" etiketi ekle.
    - Eğer PR bir API değişikliği içeriyorsa, ilgili dokümantasyon dosyasını güncellemek için bir issue aç.
    - Slack kanalına (#team-updates) kısa bir özet gönder.
    
  3. Repository'leri seçme: Projenin ana repository'sini ekler.

  4. Ortamı yapılandırma: Varsayılan ortamı kullanır, ancak Custom ağ erişimine geçip şirketin iç Slack API'sinin ve issue tracker'ının alan adlarını Allowed domains listesine ekler.

  5. Trigger'ları ekleme:

    • Schedule trigger: "weekdays" seçer, saat 09:00 olarak ayarlar.
    • API trigger: Ekler, token oluşturur ve token'ı güvenli bir yere kaydeder.
  6. Connector'ları ayarlama: Slack ve Linear connector'larını ekler, gerekmeyenleri kaldırır.

  7. Routine'i kaydetme: Create'e tıklar.

  8. Alert entegrasyonu: Monitoring aracına (örneğin Sentry), yeni bir alert geldiğinde aşağıdaki komutu çalıştıracak bir webhook ekler:

    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 PROD-1234: High error rate in /api/users endpoint. Stack trace: ..."}'
    
  9. Sonuç: Her sabah 09:00'da routine otomatik çalışır, backlog'u temizler ve ekibi bilgilendirir. Production'da bir hata alert'i geldiğinde ise Claude, stack trace'i analiz eder, ilgili kodu bulur ve bir düzeltme PR'ı hazırlar. Geliştirici, claude.ai/code/routines sayfasından routine'in detayına tıklayarak geçmiş çalıştırmaları görebilir ve her birini bir oturum olarak açıp Claude'un ne yaptığını inceleyebilir.