Claude Code oturumları tamamlandığında zaman aşımına uğrar veya durur, insan yanıtları gerektirir veya dahili sınırlara ulaşır. Çoğu geliştiricinin karşılaştığı sorun, Claude Code'un doğal bir "tamamlandı" durumuna ulaştığında veya girdi istediğinde çalışmayı durdurmasıdır! Bu, kısa süreli işler için harikadır ancak uzun süreli özerk görevler (örneğin, kod yeniden düzenleme, CI/CD otomasyonu, tam proje geliştirme) istediğinizde kötüdür. Bu kılavuz, minimal gözetimle Claude Code'u Sürekli Çalışır Durumda tutmak için kanıtlanmış teknikleri göstermektedir.
Konsept: Standart Claude Code Oturumları Neden Gözetim Gerektiriyor?
Standart Claude Code oturumları operasyonel açıdan durumsuzdur: model bir isteme yanıt verir, ardından hedefe ulaşıldığına inandığında durur. Yeni girdileri manuel olarak beslemeniz veya devamlılığı sağlamanız gerekir. Bu, tek seferlik etkileşimler için uygun olsa da, sürekli veya yinelemeli geliştirme için yetersizdir.
Çözüm, sonlandırma koşullarını algılayan ve otomatik olarak yeniden başlatan veya devam ettiren bir döngüye veya ajanik iş akışına Claude Code'u sarmaktır. Bu, çıkış kodlarını ve yinelemeleri işleyen eklentiler (Ralph gibi) aracılığıyla veya durumu harici olarak yöneten (örneğin, yapılacaklar listeleri ve alt ajanlar) ajan iş akışları aracılığıyla yapılabilir. Bu teknikler, belirli kriterler karşılanana kadar Claude'u bir sorun üzerinde etkin bir şekilde çalışır durumda tutar.
Yöntem 1: Ralph Wiggum Eklentisi — Otonom Claude Döngüleri
Ralph Wiggum eklentisi, kalıcı döngü davranışı oluşturmak için Claude Code ile entegre olur. Claude'u bir kez çalıştırıp durdurmak yerine, Ralph çıkış koşullarını yakalar ve görev gerçekten tamamlanana veya güvenlik sınırlarına ulaşılana kadar istemi tekrar beslemeye devam eder. Bu, birden fazla Claude Code çalıştırmasında iyileştirme gerektiren yinelemeli görevler (örneğin, özellik ekleme, kod yeniden düzenleme) için özellikle kullanışlıdır.
Nasıl Çalışır?
Arka planda, eklenti Claude Code'un durdurma kancalarını ve yinelemeli döngü stratejisini kullanır. Claude Code çıkmaya çalıştığında (örneğin, işinin bittiğini düşündüğü için), Ralph bunu algılar ve istemi yeniden çağırır—bağlamı, artımlı çıktıları ve dosya değişikliklerini korur. Kontrolden çıkan döngüleri önlemek için yineleme limitleri veya tamamlama vaatleri belirleyebilirsiniz.
Ralph Kurulumu
# Clone and install the Ralph plugin from the repo
git clone https://github.com/frankbria/ralph-claude-code.git
cd ralph-claude-code
./install.sh
Bu, yolunuza ralph ve ralph-monitor gibi genel komutları ekler.
Otonom Bir Döngü Çalıştırma
# Start a loop with max iterations
/ralph-loop "Implement continuous CI/CD pipeline automation" --max-iterations 50
# Start with a promise to stop once output contains "ALL TESTS PASSING"
/ralph-loop "Implement full test suite coverage" --max-iterations 100 --completion-promise "ALL TESTS PASSING"
Aktif bir döngüyü de iptal edebilirsiniz:
/cancel-ralph
Bu kurulum, --completion-promise aracılığıyla öngörülebilir kontrol noktalarına sahip basit, yinelemeli döngüler için idealdir.
En İyi Kullanım Senaryoları
| Görev Türü | Önerilen |
|---|---|
| Yinelemeli kod iyileştirme | ✔️ |
| Çoklu geçişlerle yeniden düzenleme | ✔️ |
| Sağlam çok adımlı görevler | ⚠️ (Ajan yöntemiyle kullanın) |
| Karmaşık durum gerektiren görevler | ⚠️ (Ajanlarla daha iyi) |
Döngü mantığınızın token tüketimini, aşırı maliyeti ve takılmaları önlemek için yineleme limitleri veya sonlandırma anahtar kelimeleri ile kontrol edilebildiği durumlarda Ralph'i kullanın.
Yöntem 2: Ajanlar ve Eğik Çizgi Komutları — Motlin Yöntemi
Basit bir döngüye güvenmek yerine, Claude Code eğik çizgi komutları ve ajanlar kullanarak özerk yürütmeyi bir görev zamanlayıcı gibi yapılandırabilirsiniz. Eğik çizgi komutları, yeniden kullanılabilir görevler (/todo, /todo-all) tanımlamanıza olanak tanır ve alt ajanlar (örneğin, @do-todo) izole bağlamlarda çalışarak ayrıntılı günlüklerin, derlemelerin veya hataların ana oturumu şişirmesini veya bağlam pencerenizi doldurmasını engeller.
Eğik Çizgi Komutları ve Görev Dosyaları
Görevleri Markdown veya yapılacaklar dosyalarında tanımlarsınız. Örneğin:
echo "- Fix bug #1234" >> todo.md
echo "- Write unit tests for new feature" >> todo.md
Ardından .claude/commands içinde todo.md adında, bir sonraki yapılacak öğeyi seçen basit bir Eğik Çizgi Komutu dosyası oluşturun.
# .claude/commands/todo.md
Find and describe the next task from todo.md, then mark it complete.
Çağırmak:
/todo
bunu Claude Code'da çalıştırır. Ancak, tek bir eğik çizgi komutu yine de manuel tekrarlar gerektirir.
Ajanları Tanıtma
Manuel döngüler yerine, eğik çizgi komut mantığınızı (/todo, /todo-all) bir ajanlar filosu haline dönüştürün:
/todo-all → tüm todo.md girdileri tamamlanana kadar @do-todo ajanını başlatır.
Her bir @do-todo ajanı:
- Bir sonraki görevi getirir (
todo-get) - Görevi uygular
- Derlemeleri/testleri gerçekleştirir
- Görevi tamamlandı olarak işaretler (
todo-complete) - Hiçbir görev kalmayana kadar döngüye devam eder (motlin.com)
Bu yaklaşım Bağlam İzolasyonu kullanır: her ajan kendi bağlamında çalışır, böylece büyük kayıtlar, günlükler ve derleme çıktıları ana oturumu kirletmez veya bağlam penceresini aşırı yüklemez.
Bir Örnek İş Akışı
# Ana döngü komutunu çalıştır
/todo-all
# Sahne arkasında:
# @do-todo ajanı her görevi sırayla çalıştırır
Ajanlar görev yürütmeyi düzenler, durumu korur ve todo.md ve @taskstatus.md gibi dosyalara kalıcı olarak kaydeder, böylece tüm bir liste tamamlanana kadar Claude Code'u sürekli çalıştırabilirsiniz.
İzleme ve Bildirimler
Uzun süreli otonom döngülerin gözlemlenebilirliğe ihtiyacı vardır:
Bitiş/Başarısızlık Durumunda Uyarılar
Döngü çalıştırıcıları veya ajan betiklerini webhook/bildirimlerle genişletebilirsiniz:
Bir Bash Kanca Betiği Kullanmak
#!/bin/bash
# Döngü bittikten sonra
pushover_message="Claude döngüsü $(date) tarihinde sona erdi"
curl -s \
-F "token=$PUSHOVER_TOKEN" \
-F "user=$PUSHOVER_USER" \
-F "message=$pushover_message" \
https://api.pushover.net/1/messages.json
Bu, döngüler bittiğinde veya başarısız olduğunda telefonunuza bildirim gönderir.
Günlük Kaydı ve İzleme
- Döngü betiklerinizde
ralph-monitorveya özel günlükler kullanın. - Pano için döngü durumunu periyodik olarak JSON'a dökün.
- Yinelemeler, API kullanımı ve hatalar gibi metrikleri izleyin.
Güvenlik ve Maliyet Hususları
Otonom döngüler hızlı bir şekilde çok sayıda token tüketebilir:
- Sınırsız döngüler yüksek fatura riski taşır.
- Her zaman yineleme limitleri veya tamamlama kriterleri belirleyin.
- Arızalarda duraklatmak/uyarmak için izleme ile birleştirin.
Ayrıca, Claude Code'un yerleşik sandboxing ve izin istemi mekaniklerinin, uygun şekilde yapılandırılmadığı takdirde sürekli etkileşimli olmayan döngüleri bozabileceğini unutmayın.
API Yoğun Projelerde Sürekli Claude Code'u Apidog ile Kullanma
Büyük, API merkezli geliştirme projelerinde (e-ticaret platformları, sipariş yönetim sistemleri, kullanıcı panelleri, SaaS arka uçları, IoT hizmetleri vb.) Claude Code Sürekli Çalışan döngüleri çalıştırırken, genellikle çok sayıda uç nokta ve hizmet oluşturur veya değiştirirsiniz. Bu projeler genellikle kullanıcı kimlik doğrulama API'leri, ürün katalogları, sepet ve ödeme akışları, arama ve öneri hizmetleri ve daha fazlasını içerir.
Zorluk, Claude'u yalnızca çekirdek geliştirme görevlerinde otonom olarak çalıştırmakla kalmayıp, aynı zamanda bu API'lerin geliştikçe güvenilir ve uyumlu olmasını sağlamaktır. Sürekli Claude döngülerini Apidog gibi özel bir API test platformuyla eşleştirmek, gerçek değer kattığı yer burasıdır:
- Otomatik API doğrulama: Apidog, yapay zeka tarafından oluşturulan kod değişiklikleriniz geliştikçe yanıtları, hata işlemeyi ve uç durumları doğrulayarak tüm ana uç noktaları (işlevsel, regresyon, entegrasyon) kapsayan yapılandırılmış test senaryoları kurmanıza olanak tanır.
- CI/CD entegrasyonu: Bu API testlerini her commit veya dağıtımda otomatik olarak çalıştırabilirsiniz, böylece bozuk veya hatalı hizmetleri döngünün mümkün olan en erken aşamasında yakalarsınız.
- Sahte hizmetler ve veriye dayalı kontroller: Claude yeni API işleyicileri oluştururken veya mantığı değiştirirken, Apidog bağımlı hizmetleri simüle edebilir veya çeşitli veri setleri enjekte ederek akışlarınızı üretime ulaşmadan önce stres testinden geçirebilir. apidog
Sürekli Claude Code döngülerini Apidog testleriyle birleştirerek, API'lere dayalı karmaşık uygulamalar geliştiren ekipler hem sürekli geliştirme verimliliği hem de sağlam otomatik test kapsamı elde eder, böylece manuel QA darboğazlarını azaltır ve sürüm güvenini artırır.
Sıkça Sorulan Sorular
S1. Bu, token cinsinden ne kadara mal olur?
Maliyetler, Claude Code çağrılarının sayısına ve uzunluğuna orantılıdır. Otonom döngüler, limitler olmadan pahalı olabilir—--max-iterations veya bütçe kısıtlamaları kullanın.
S2. Döngü takılırsa ne olur?
Hem Ralph hem de ajan desenleri, hareketsizliği veya mantıksal çıkış kodlarını algılayabilir. Döngülerden düzgün bir şekilde çıkmak için zaman aşımı ve devre kesiciler uygulayabilirsiniz.
S3. Claude Code süresiz çalışabilir mi?
Gerçekten süresiz olarak değil—bağlam pencere boyutları, oturum zaman aşımları ve API kotaları gibi platform limitleri hala geçerlidir. Bu desenler çalışma süresini önemli ölçüde uzatır, ancak sonsuza kadar değil.
S4. Kontrolden çıkan bir döngüyü nasıl durdururum?
Ralph ile: /cancel-ralph. Ajanlarla: ajan işlemini sonlandırın veya CLI'yi kesin. Döngüleri her zaman önce küçük görevler üzerinde test edin.
S5. Güvenlik riskleri var mı?
Evet. Otonom yapay zeka döngüleri, dosya sisteminizde veya altyapınızda istenmeyen eylemler gerçekleştirebilir. Sandboxing ve katı allowed-tools ayarları kullanın.
Sonuç
Gözetimsiz olarak Claude Code'u Sürekli Çalışır Durumda tutmak için iki ana seçeneğiniz vardır:
- Ralph Wiggum eklentisi: net tamamlama sinyalleri olan kontrollü döngüler için en iyisi.
- Ajanlar ve Eğik Çizgi Komutları: durum takibi ve bağlam izolasyonu gerektiren yapılandırılmış otonom iş akışları için en iyisi.
Her ikisi de Claude Code'un doğal davranışını otonom yürütmeye genişletir—sadece karmaşıklığınıza ve güvenlik gereksinimlerinize uyan deseni seçin.