Claude Code Routines: bulutta ne çalışır, makinenizde ne kalır ve nasıl seçilir

Claude Code'un artık bir prompt'u siz yazmadan çalıştırmanın üç yolu var ve adları herkesin kafasını karıştıracak kadar iç içe geçiyor: Routines, masaüstü uygulamasının zamanlanmış görevleri ve /loop. Masaüstü uygulaması ilk ikisini aynı sayfadan oluşturuyor bile. İşi otomatikleştirirken önemli olan tek noktada ayrışıyorlar: ajanın nerede çalıştığı ve dolayısıyla neyi görebildiği.

Bu rehber üçünü belgelerde yazan sınırlarla ele alıyor (4 Ekim 2026'da doğrulandı; Routines research preview aşamasında ve Anthropic davranışın, sınırların ve API'nin değişebileceğini belirtiyor). Ardından kendimiz ne yaptığımızı anlatıyor: bizim tarafımızda her akşam yedi ajan başlıyor ve hiçbiri bir routine değil. Nedenler somut ve sizin için geçerli olabilir de olmayabilir de.

Routine nedir

Bir routine, kaydedilmiş bir Claude Code yapılandırmasıdır: bir prompt, bir ya da daha fazla GitHub deposu ve bir dizi bağlayıcı; bir kez paketlenir ve otomatik olarak çalıştırılır. Anthropic'in yönettiği bulut altyapısında ya da oraya yönlendirildiğinde kuruluşunuzun kendi barındırdığı ortamda çalışır. Dizüstünüz kapalı olabilir.

Her çalıştırma tam bir bulut oturumudur. Bundan dört sonuç çıkar ve akılda tutulması gerekenler bunlardır:

• Her seferinde yeni bir klon. Her depo, çalıştırmanın başında varsayılan branch'ten klonlanır. Prompt'unuz aksini söylemedikçe Claude işini claude/ önekli bir branch'e push eder. Makinenizde commit edilmemiş hiçbir şey routine için var olmaz.
• İzin istemi yok. İzin modu seçici yoktur. Oturum kabuk komutları çalıştırır, depoya commit edilmiş skill'leri kullanır ve dahil edilen her bağlayıcının her aracını, yazma işlemleri dahil, sormak için durmadan çağırır.
• Yerel MCP sunucularınız değil, bağlayıcılar. claude.ai hesabınızın tüm bağlayıcıları varsayılan olarak dahildir ve belgeler routine'in ihtiyaç duymadıklarını kaldırmanızı söyler. claude mcp add ile yerelde eklenen sunucular makinenizde yaşar ve listede yer almaz. Commit edilmiş bir .mcp.json diğer giriş yoludur.
• Sizin adınıza hareket eder. Routines bireysel hesabınıza aittir. Commit'ler ve pull request'ler GitHub kullanıcınızı taşır, Slack mesajları ve Linear ticket'ları bağlı hesaplarınızı kullanır.

Routines, Pro, Max, Team ve Enterprise planlarında kullanılabilir. Onları claude.ai/code/routines üzerinden, masaüstü uygulamasından (Code sekmesi, Routines, New routine, Cloud) ya da CLI'den oluşturursunuz.

Üç tetikleyici

Bir routine tek bir tetikleyici ya da aynı anda birkaç tetikleyici taşıyabilir.

Zamanlama. Yerel saatinize göre saatlik, günlük, hafta içi ya da haftalık, veya gelecekteki bir zamanda tek bir çalıştırma. En kısa aralık bir saattir. Belgelerden bilmeye değer bir ayrıntı: tam saat başına zamanlanmış bir çalıştırma birkaç dakika gecikmeyle başlayabilir, bu yüzden zamanlama önemliyse 9:00 yerine 9:07'yi seçin.

API. Her routine kendi uç noktasını ve kendi bearer token'ını alır; token web üzerinde oluşturulur (CLI token oluşturamaz ya da iptal edemez). Bir POST isteği bir oturum başlatır ve onun URL'sini döndürür:

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

text alanı routine'e bir talimat olarak ulaşmaz. Onu güvenilmeyen veri olarak etiketleyen bir bloğa sarılmış olarak gelir; bu yüzden kaydedilmiş prompt'un onu kullanmayı açıkça istemesi gerekir (“routine-fire-payload bloğunda anlatılan uyarıyı incele”), aksi hâlde metin etkisiz bir bağlam olarak kalır. Doğru varsayılan budur: token'a sahip olan herkes metin gönderebilir.

GitHub. Pull request olayları ve release olayları; yazar, başlık, gövde, temel branch, kaynak branch, etiketler, taslak durumu ve birleştirilmiş durumu üzerinde filtrelerle. Claude GitHub App depoda kurulu olmalıdır. Her olay kendi oturumunu başlatır ve saatlik sınırı aşan olaylar düşürülür.

CLI'den: /schedule

/schedule, sohbet yoluyla zamanlanmış bir routine oluşturur; /routines onun takma adıdır.

/schedule daily PR review at 9am
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
/schedule list
/schedule update
/schedule run

Özel bir cron ifadesi /schedule update ile girilir. CLI'den bir GitHub tetikleyicisi eklemek için Claude Code v2.1.225 veya sonrası gerekir; API tetikleyicileri yalnızca webde oluşturulur.

/schedule “Unknown command” yanıtını veriyorsa olağan neden kimlik doğrulamadır: komut bir claude.ai abonelik girişi gerektirir. Kabuğunuzdaki bir ANTHROPIC_API_KEY, settings.json içindeki bir apiKeyHelper ya da Bedrock veya Vertex girişi onu gizler.

Güvenmeden önce bilinmesi gereken sınırlar

Routines, her etkileşimli oturum gibi abonelik kullanımınızdan düşer. Bunun üstüne, bir çalıştırmayı başlatmanın her yolunun aşımı olmayan saatlik bir sınırı vardır:

Belgelerden, pratikte can yakan üç şey daha. Eksik ya da süresi dolmuş bir GitHub bağlantısı, routine'in çalıştırmalarını 72 saate kadar atlamasına, ardından kendini kapatmasına yol açar. Duraklatılmış bir abonelik Routines'i beklemeye alır. Ve yeşil bir çalıştırma görevin işe yaradığı anlamına gelmez: oturumun bir altyapı hatası olmadan başlayıp bittiği anlamına gelir.

İki yerel seçenek

Masaüstü uygulamasının zamanlanmış görevleri, aynı New routine düğmesindeki Local seçeneğidir. Worktree seçeneğini işaretlemediğiniz sürece makinenizde, dosyalarınızla oldukları gibi, commit edilmemiş değişiklikler dahil çalışırlar. Her görevin kendi izin modu vardır. Püf noktası belgelerdeki tek bir cümlede: görevler yalnızca masaüstü uygulaması çalışırken ve bilgisayarınız uyanıkken çalışır. Uyku sırasına denk gelen bir çalıştırma atlanır ve uyanınca uygulama, son yedi gün içinde kaçırılan en son zaman için tam olarak bir telafi çalıştırması başlatır. Prompt ~/.claude/scheduled-tasks/<task-name>/SKILL.md içinde yaşar.

/loop, açık tek bir CLI oturumunun içinde bir prompt'u tekrarlar: /loop 5m check the deploy. Oturumun izinlerini ve MCP sunucularını devralır, en fazla 50 görev tutar ve yinelenen bir görevin süresi yedi gün sonra dolar. Terminali kapatın, durur. Bir öğleden sonra boyunca bir build'e ya da bir pull request'e göz kulak olmak için yapılmıştır, gece işi için değil.

Belgelerin sunduğu şekliyle yan yana:

Nasıl seçilir

Üç soru meseleyi çözer.

İş tamamen depoda ve bağlayıcıların arkasında mı? Issue'ları etiketlemek, her yeni pull request'i incelemek, belgeleri birleştirilmiş değişikliklerle karşılaştırmak: doğru araç bir routine'dir. Uyanık tutulacak bir şey yoktur ve sonuç bir branch olarak gelir.

İşin yalnızca makinenizde var olan bir şeye ihtiyacı var mı? Bir VPN arkasındaki veritabanı, oturum açtığınız bir tarayıcı, commit edilmemiş dosyalar, yerel bir MCP sunucusu: yerelde kalın. Bir routine bunların hiçbirini içermeyen bir klondan başlardı.

Saatte birden daha sık çalışması ya da bir dakika içinde tepki vermesi mi gerekiyor? Yine yerel, ya da dış bir sistem çağırabiliyorsa API tetikleyicisi.

Yedi gece ajanımız neden Routines değil

Her akşam saat 20:00'de bir Mac mini üzerinde yedi zamanlanmış ajan çalıştırıyoruz. Günün commit'lerini okuyorlar, hataları düzeltiyorlar, bu web sitesini düzeltiyorlar, sosyal ağlarda paylaşım yapıyorlar ve e-postayla bir rapor gönderiyorlar. Kurulumun tamamı ve prompt'lar ayrı bir yazıda. Routines ortaya çıktığında bariz soruyu sorduk: neden bir makineyi açık tutalım?

Dört neden, hepsi yukarıdaki belgelerle doğrulandı.

1. Paylaşılan, commit edilmemiş bir ağaçta çalışıyorlar. Ajanlar pull yapıyor, birbirlerinin gece raporlarını okuyor ve ilerledikçe commit ediyor. Birkaçı aynı saat içinde aynı checkout'a dokunuyor. Her çalıştırmada yeni bir klon, aynı ekibin iki adımı arasındaki devir teslimi kaybederdi.
2. İçlerinden biri gerçek bir tarayıcıdan yayın yapıyor. Sosyal medya ajanı, üç ağda oturum açılmış bir Chrome oturumundan paylaşım yapıyor. O oturum makinede. Bir bulut VM'sinde böyle bir tarayıcı yok.
3. Yerel MCP araçları kullanıyorlar. Backlog, proje belleği, Prompt Kütüphanesi ve geliştirme komutları, o makinede çalışan uygulamanın MCP sunucuları. Bunlar claude.ai bağlayıcıları değil.
4. Hepsi Claude Code değil. Bir routine, Claude Code'u bir claude.ai aboneliği üzerinde çalıştırır. Bizim zamanlayıcımız görevin belirttiği CLI'yi başlatıyor.

Bu yüzden AgentsRoom'un zamanlanmış görevlerini kullanıyoruz: bir tetikleyici bir prompt, bir ajan ya da bir ekip ve bir sıklıktır; bizim seçtiğimiz bir makinede başlatılır. Bu bir sunucu değil, uygulama içi bir zamanlayıcıdır: AgentsRoom o makinede açıkken tetiklenir, kaçırılan bir çalıştırmayı bir sonraki açılışta telafi eder ve bir sonraki çalıştırma için işletim sisteminin uyandırma zamanlayıcısını kurabilir. Bu, Claude'un masaüstü zamanlanmış görevleriyle aynı kısıttır; farkı, ajanın Codex, Antigravity ya da başka herhangi bir CLI olabilmesi ve bir tetikleyicinin bir webhook ile ya da bir ticket teslim edildiğinde de tetiklenebilmesidir.

Bunların hiçbiri Routines'i yanlış bir seçim yapmaz. Gece işimiz “her pull request'i kontrol listemizle incele” olsaydı, onu GitHub tetikleyicili bir routine olarak çalıştırır ve Mac mini'yi kapatırdık. İhtiyaç yinelenen bir iş değil de tek bir görev için tek kullanımlık bir makineyse, bu yine başka bir araçtır ve “Claude remote agents” ifadesinin ne anlama geldiği yazısında anlatılıyor.

Sık sorulan sorular

Claude Code Routines ile zamanlanmış görevler aynı şey mi?

Tam olarak değil. Bir routine bulutta, deponuzun yeni bir klonu üzerinde tam bir Claude Code bulut oturumu olarak çalışır ve bir zamanlamaya göre, bir API çağrısıyla ya da bir GitHub olayıyla başlayabilir. Masaüstü uygulamasının zamanlanmış görevi kendi makinenizde, yerel dosyalarınızla çalışır; yalnızca Claude masaüstü uygulaması açıkken ve bilgisayar uyanıkken. /loop, açık tek bir CLI oturumunun içinde bir prompt'u tekrarlar. Masaüstü uygulamasındaki Routines sayfası ilk ikisini oluşturur: New routine, ardından Cloud ya da Local.

Bir Claude Code routine'i ne sıklıkla çalışabilir?

Bir zamanlama tetikleyicisinin en kısa aralığı bir saattir: daha sık tetiklenen bir cron ifadesi reddedilir. Hazır seçenekler saatlik, günlük, hafta içi ve haftalıktır; /schedule update ise özel bir cron ifadesi ayarlar. Abonelik kullanımınızdan ayrı olarak, bir hesap saatte 100 zamanlanmış çalıştırma başlatabilir; Run now ve API tetiklemeleri ise her routine için saatte 30 ile sınırlıdır. Masaüstü uygulamasının zamanlanmış görevleri ve /loop bir dakikaya kadar iner.

Routines için bilgisayarımın açık olması gerekir mi?

Hayır. Bir routine, Anthropic'in yönettiği bulut altyapısında ya da kuruluşunuz onu oraya yönlendirdiğinde kendi barındırdığı bir ortamda çalışır; bu yüzden dizüstü kapalıyken de çalışmaya devam eder. Bedeli, makinenizi görmemesidir: varsayılan branch'in yeni bir klonundan, claude.ai hesabınızın bağlayıcılarıyla ve bulut ortamının ağ erişimiyle başlar. claude mcp add ile yerelde eklediğiniz MCP sunucuları, onları bağlayıcı olarak eklemediğiniz ya da bir .mcp.json commit etmediğiniz sürece kullanılamaz.

Routines ek ücretli mi?

Belgelerde ayrı bir fiyat yok: Routines, Pro, Max, Team ve Enterprise planlarında, etkileşimli oturumlarla aynı şekilde abonelik kullanımınızdan düşer. Bir routine kullanım sınırınıza ulaştığında, sonraki çalıştırmalar pencere sıfırlanana kadar reddedilir; kullanım kredileri açıksa ise ölçülen aşım ücretiyle devam ederler. Saatlik çalıştırma sınırlarının aşımı yoktur.

Bir routine Codex, Antigravity ya da başka bir CLI çalıştırabilir mi?

Hayır. Bir routine, kaydedilmiş bir Claude Code yapılandırmasıdır ve /schedule bir claude.ai abonelik girişi gerektirir: Claude Code bir API anahtarıyla ya da bir bulut sağlayıcısı üzerinden kimlik doğruladığında komut gizlenir. Başka bir CLI'yi zamanlamak için Claude Code dışında bir zamanlayıcıya ihtiyacınız var: cron ve CLI'nin headless modu, bir CI zamanlaması ya da her CLI için ajan başlatan bir araç; AgentsRoom'un zamanlanmış görevlerinin yaptığı da budur.

Routine'im hiçbir şey yapmadığı hâlde neden yeşil görünüyor?

Çünkü durum görevi değil, oturumu anlatır. Belgeler bunu açıkça söylüyor: yeşil durum, oturumun bir altyapı hatası olmadan başlayıp bittiği anlamına gelir, prompt'unuzdaki görevin başarılı olduğu anlamına gelmez. Engellenen ağ istekleri, eksik bağlayıcı araçları ve görev düzeyindeki hatalar yalnızca transkriptte görünür. Çalıştırmayı açın ya da CLI'ye sorun: /schedule ve ardından routine hakkında bir soru, Claude Code v2.1.227 ve sonrasında, son çalıştırmalarını listeler ve günlüğü okur.