Sizsiz Çalışan Claude İş Akışları Nasıl Kurulur

Ajan tabanlı kodlamanın nereye gittiğini özetleyen bir ifade dolaşıyor: hedef daha iyi bir bilgi istemi değil, sizin izlemenize gerek kalmadan çalışan bir iş akışıdır. Çoğu kişi Claude'u bir sohbet penceresi gibi kullanır. Yazarsınız, beklersiniz, okursunuz, tekrar yazarsınız. Bu işe yarar ama çıktınızı aktif olarak ilgilendiğiniz tek bir ajanla sınırlarsınız. Claude'dan gerçek fayda sağlayan mühendisler başka bir şey inşa ettiler: belirli bir programa veya tetikleyiciye göre başlayan, işi yapan, kendi sonuçlarını kontrol eden ve yalnızca bir karara ihtiyaç duyulduğunda bir insana haber veren iş akışları.

button

TL;DR

Siz olmadan çalışan bir Claude iş akışı beş bölümden oluşur: kesin bir yazılı spesifikasyon, başsız (etkileşimli olmayan) yürütme, geçme veya kalmaya karar veren deterministik bir doğrulama geçidi, katı güvenlik önlemleri (izin beyaz listeleri, sınırlı yinelemeler, maliyet üst sınırları, bir kapatma anahtarı) ve bir insana bildiren veya başarısızlık durumunda uyarı veren bir devir. Claude Code'un başsız modu (claude -p), Claude Ajan SDK'sı, kancalar (hooks) ve bir zamanlayıcı (cron veya launchd) size bu beşini de sağlar. Riskli kısım ajan değildir. Onu bir geçit ve güvenlik önlemleri olmadan gözetimsiz çalıştırmak risklidir. Önce bunları inşa edin, sonra ellerinizi çekin.

Neden “siz olmadan çalışması” asıl hedeftir

Denetimli sohbetin katı bir tavanı vardır: siz. Her yineleme, çıktıyı okuması ve sonraki adıma karar vermesi için bir insanı bekler. Model saniyeler içinde üretir, sonra siz bağlam değiştirirken dakikalarca boşta bekler. Normalde hızlı olan bir sistemde darboğaz sizsiniz.

Gözetimsiz iş akışları bu tavanı kaldırır. Ajan çalışır, bir komut dosyası onu kontrol eder, hatalar otomatik olarak geri yönlendirilir ve siz yalnızca kenarlara müdahale edersiniz. Kazanç sadece hız değildir. Paralelliktir. Bir iş akışı denetimsiz çalıştığında, daha hızlı yazarak değil, iş akışları ekleyerek ölçeklenirsiniz. Bu, bir oturumun birçok paralel ajana yayıldığı Claude Code dinamik iş akışlarında ele aldığımız sıçramanın aynısıdır.

Ancak "siz olmadan çalışır" riskleri artırır. Kötü bir düzenleme yapan denetimli bir ajan, farkı okuduğunuzda yakalanır. Gözetimsiz bir ajan ise bunu işler, bir sonraki adımı çalıştırır ve devam eder. Bu nedenle disiplin, bilgi istemi oluşturmaktan sistem tasarımına kayar: kimse bakmıyorken doğru, sınırlı ve gözlemlenebilir olması gereken bir makine inşa ediyorsunuz. Anthropic'in etkili ajanlar oluşturma üzerine yazısı da aynı durumu ortaya koyuyor. Güç, modelin etrafındaki ortamdan gelir, daha akıllı tek bir mesajdan değil.

Her gözetimsiz iş akışının ihtiyaç duyduğu beş bölüm

Bunlardan herhangi birini atlarsanız, iş akışı ya kendinden emin bir şekilde yanlış bir şey yapar ya da asla durmaz.

Kesin bir spesifikasyon. Ajanın her çalıştırmanın başlangıcında okuduğu, tamamlanmış işin yazılı bir tanımı. Belirsiz spesifikasyonlar belirsiz işler üretir. "API'yi düzelt" başarısız olur; "POST /orders uç noktası 201 döndürür, gövdeyi şemaya göre doğrular, eksik alanları 422 ile reddeder" başarılı olur.
Başsız yürütme. Claude'un klavyede bir insan olmadan çalışması gerekir. Bu, sohbet arayüzü değil, etkileşimsiz mod anlamına gelir.
Bir doğrulama geçidi. Somut bir nedenle geçme veya kalma döndüren deterministik bir kontrol: testler, bir tür kontrolü, bir şema doğrulama, bir sözleşme testi. İş akışının modelin sözüne güvenmek yerine gerçekten bittiğine karar vermesini sağlayan budur.
Güvenlik önlemleri. İzin beyaz listeleri, maksimum yineleme sayısı, bir maliyet üst sınırı, günlükleme ve bir kapatma anahtarı. Bunlar, siz uyurken karışık bir çalıştırmanın zarar vermesini engeller.
Bir devir. İş akışı bittiğinde veya vazgeçtiğinde, birine haber verir. Bir bildirim, inceleme için bir taslak, bir hata uyarısı. Sessizlik başarı değildir.

Ortadaki üçü, çoğu kurulumun zayıf olduğu noktalardır. Claude'un size sunduğu araçlarla her birini inşa edelim.

Claude yapı taşları

Başsız mod (claude -p)

Claude Code'un yazdırma modu, bir istemi etkileşimsiz olarak çalıştırır ve çıkar. Bu, her gözetimsiz iş akışının temelidir. Ona bir görev verir, araçlarını kısıtlar, çıktıyı yakalar ve devam edersiniz.

claude -p "Implement the orders endpoint per spec.md, then run the test suite" \
  --allowedTools "Edit,Write,Bash" \
  --output-format json \
  >> run.log 2>&1

--allowedTools bayrağı göründüğünden daha önemlidir. Sohbet kullanıcı arayüzünde her eylemi elle onaylarsınız. Başsız modda onaylayacak kimse olmadığı için, izin beyaz listesi ajanın neye dokunabileceği üzerindeki tek kontrolünüzdür. Dar başlayın ve yalnızca çalıştırmaya güvendiğinizde genişletin. Tüm bayrak kümesi Claude Code belgelerinde yer almaktadır.

Claude Ajan SDK'sı

Bir kabuk komutu yeterli olmadığında, Claude Ajan SDK'sı Claude'u Python veya TypeScript'ten programatik olarak sürmenize olanak tanır. Döngüyü kod içinde elde edersiniz: bir görev gönderir, sonucu akışla aktarır, araç çağrılarını inceler, devam edip etmeyeceğinize karar verirsiniz. Ajan etrafına gerçek kontrol akışını bu şekilde sararsınız.

import { query } from "@anthropic-ai/claude-agent-sdk";

const MAX_ITERATIONS = 8;
let feedback = "";

for (let attempt = 0; attempt < MAX_ITERATIONS; attempt++) {
  for await (const msg of query({
    prompt: `${task}\n\nPrevious failures:\n${feedback}`,
    options: { allowedTools: ["Edit", "Write", "Bash"] },
  })) {
    // stream/log messages as the agent works
  }

  const gate = runVerification();      // your deterministic check
  if (gate.passed) break;              // done
  feedback = gate.failures;            // the next prompt writes itself
}

Kesin imzalar belgelerde yer alır, ancak önemli olan şekildir: ajanı son hata ile bir sonraki istem olarak yeniden çalıştıran bir döngü. Kendi döngünüzü oluşturmakla barındırılan bir seçenek arasında karar veriyorsanız, yönetilen ajanlar ve Ajan SDK'sı karşılaştırmamız, her birinin ne zaman mantıklı olduğunu açıklar.

Deterministik güvenlik önlemleri için kancalar (Hooks)

Kancalar, Claude'un yaşam döngüsündeki sabit noktalarda, modelin dahil olmadığı şekilde kendi komutlarınızı çalıştırır. Bunlar, ajanın etrafından dolaşamayacağı kuralları nasıl uygulayacağınızdır. Her dosya düzenlemesinden sonra test paketinin çalışmasını ister misiniz? Bir PostToolUse kancası bunu deterministik olarak yapar.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "npm test --silent" }]
      }
    ]
  }
}

Bir kanca, modele yapılan bir istek değil, düz kod olduğu için her zaman tetiklenir. Gözetimsiz bir çalıştırmada güvenlik önlemleri için istediğiniz özellik budur. Ajan onu atlamaya karar veremez.

Çalıştırmaları tetiklemek için bir zamanlayıcı

Siz olmadan çalışan bir iş akışının, sizi olmadan onu başlatacak bir şeye ihtiyacı vardır. Bir sunucuda bu cron'dur; bir Mac'te ise launchd'dir. Her iki durumda da başsız komutu bir program dahilinde tetiklersiniz.

# every weekday at 7am: run the maintenance workflow, log everything
0 7 * * 1-5  cd /srv/api && claude -p "$(cat tasks/nightly-maintenance.md)" \
  --allowedTools "Edit,Bash" >> logs/run-$(date +\%F).log 2>&1

Özerk bir kurulumun tüm omurgası budur: bir zamanlayıcı başsız Claude'u tetikler, ajan bir spesifikasyona karşı çalışır, kancalar ve bir geçit onu dürüst tutar ve günlükler size ne olduğunu söyler.

İstem yerine döngüyü tasarlayın

İşte bunu bir araya getiren zihniyet. "Claude'a ne söylemeliyim?" diye sormayı bırakın. "Claude'un kendine söylemesini sağlayacak hangi döngü olurdu?" diye sormaya başlayın. Ajan, doğru olup olmadığına dair güvenilir bir algısı olmayan hızlı bir jeneratördür. Döngü, bu algıyı geçit aracılığıyla sağlar. Kodlama ajanıza istem vermeyi bırakın, bunun yerine döngüyü inşa edin başlığında bu konuyu derinlemesine inceledik ve bu, gözetimsiz çalışma için yük taşıyan fikirdir: modelin güveni artık önemli değildir, sadece geçidin kararı önemlidir.

Bu aynı zamanda net bir spesifikasyonun akıllı bir istemden neden daha iyi olduğunu açıklar. Aynı spesifikasyon her yinelemeyi yönlendirir ve aynı zamanda dokümantasyon görevi görür. Niyet, kısıtlamalar ve tamamlanmış tanımını içeren bir design.md veya AGENTS.md dosyası, ajana her seferinde bağlamı yeniden açıklamak yerine her çalıştırmada sabit bir hedef verir.

Uygulamalı bir örnek: gözetimsiz API bakımı

Somutlaştıralım. Diyelim ki bir dizi API uç noktasını OpenAPI spesifikasyonlarıyla senkronize tutan, her sabah çalışan ve asla bozuk bir uç nokta dağıtmayan bir iş akışı istiyorsunuz. İşte şekli.

Spesifikasyon. Sözleşme bir OpenAPI dosyasında yer alır; davranış test senaryolarında yer alır. Ajan, çalıştırmanın başında her ikisini de okur.
Tetikleyici. Sabah 7'de bir cron işi, başsız Claude'u bakım göreviyle tetikler.
Oluşturma. Ajan, uygulamayı spesifikasyonla uzlaştırır: eksik uç noktaları ekler, uyuşmayan yanıt şekillerini düzeltir, doğrulamayı sıkılaştırır.
Geçit. İş akışı, çalışan hizmete karşı API test paketini çalıştırır. Durum iddiaları, her yanıtta JSON şema doğrulaması, spesifikasyona karşı sözleşme kontrolleri. Hatalar yapılandırılmış olarak geri döner: "Eksik customer_id için 422 bekleniyordu, 500 alındı." "Yanıt alan total bir dizedir, şema sayı diyor."
Döngü veya yükseltme. Kırmızı geçit mi? Yapılandırılmış hata bir sonraki istem olur ve ajan belirli boşluğu yineleme sınırına kadar yamalar. Yeşil mi? Bir taslak PR açar. Deneme hakkı bitti mi? Son hatayla bir uyarı dosyalar ve durur.
Devir. Bir insan ya incelenecek temiz bir PR alır ya da kesin bir hata raporu. Asla sessiz bir commit olmaz.

4. adımdaki geçit, her şeyi gözetimsiz çalıştırmak için güvenli kılan şeydir. O olmadan, ajan kodu düzenler ve kendi okumasına dayalı olarak başarı rapor eder, ki bozuk uç noktaların üretime nasıl ulaştığı tam da budur. Apidog'un özerk bir iş akışına uyduğu yer burasıdır: API tasarımı, şema, mock sunucu ve otomatik testler tek bir çalışma alanında yaşar, böylece geçit ve spesifikasyon varsayılan olarak senkronize kalır. Çalıştırmayı bir Apidog test senaryosuna yönlendirirsiniz ve ajan her yinelemede şema doğrulamalı geçme/kalma alır. Mock sunucu, çalışmayan bağımlılıkların yerine geçer, böylece sabah 3'teki bir çalıştırma dengesiz bir üçüncü tarafı bekleyerek engellenmez. Ajanın uç nokta erişimini Apidog AI ajan hata ayıklayıcısı aracılığıyla bağlayan ekipler, tıpkı bir insan test cihazının yapacağı gibi uç noktalara ulaşmasına ve incelemesine izin verir. Bir çalıştırıcıyı elle yazmak yerine geçidi görsel olarak oluşturmayı tercih ediyorsanız Apidog'u indirin.

Gözetimsiz çalıştırmaları güvenli hale getiren güvenlik önlemleri

Bu, gece boyunca güvendiğiniz bir iş akışını, sizi sabah 3'te uyandıran bir iş akışından ayıran kısımdır. Gözetimsiz bir ajan iyi niyetlere değil, katı sınırlamalara ihtiyaç duyar.

Dar izin beyaz listeleri. Başsız modda, beyaz liste ajanın yapabilecekleri üzerindeki tek geçidinizdir. Görevin ihtiyaç duyduğu minimum araçları verin. Bir sandbox olmadan gözetimsiz bir çalıştırmaya asla kısıtlamasız kabuk veya yıkıcı komutlar vermeyin.
Sınırlı yinelemeler. Döngüyü sınırlayın. N denemede yeşil bir geçide ulaşamayan bir çalıştırma sonsuza dek devam etmek yerine durmalı ve uyarı vermelidir.
Bir maliyet üst sınırı. Gözetimsiz döngüler bir insan fark etmeden jeton tüketir. Bir harcama limiti belirleyin ve çalıştırma başına harcamayı günlüğe kaydedin. Yakınsamayan bir döngü limiti aşmalı ve durmalıdır. Ajan jeton maliyetlerini düşürme konusundaki notlarımız doğrudan burada geçerlidir.
Geçidi koruyun. Test dosyalarını ve spesifikasyonu, ajanın düzenleyebileceği dosya kümesinin dışında tutun. Eğer testi geçecek şekilde yeniden yazabiliyorsa, ilerlemeyi taklit etmek için bir makine inşa etmiş olursunuz.
Bir sanal alan (sandbox). Gözetimsiz işleri ana dalda değil, izole bir çalışma alanında veya kapsayıcıda çalıştırın. Bir git worktree veya tek kullanımlık bir dal, kötü bir çalıştırmanın etki alanını sınırlar.
Günlükleme ve kapatma anahtarı. Her çalıştırmayı gerçekten okuduğunuz bir günlüğe kaydedin ve bir işi ortasında durdurmanın bir yolunu bulundurun. Kaydetmediğiniz şeyi hata ayıklayamazsınız.
Kenarlarda insan onayı. "Siz olmadan" demek "asla kimse olmadan" demek değildir. Bir kişiyi başlangıca (görevi onayla) veya sona (PR'yi onayla) koyun, ancak iç döngüye koymayın. Buradaki kablolama desenleri ve hata modları ajan tabanlı iş akışı aracı kablolaması ile uyumludur.

Bunların çoğu tek bir kurala dayanır: gözetimsiz bir ajan işini ve başka hiçbir şeyi yapabilmelidir. Araçları kısıtlayın, döngüyü sınırlayın, çalışma alanını izole edin ve her çalıştırmayı gözlemlenebilir hale getirin.

Sık yapılan hatalar

Birkaç kalıp, özerk iş akışlarını hızla batırır.

Geçit yok, sadece hisler. Tek kontrol "ajan, bitirdin mi?" ise, bir iş akışınız yok, gözetimsiz bir sohbet robotunuz var demektir. Geçit ajanın dışından olmalıdır.
Tek dev bir görev. "Tüm hizmeti sürdür" denilen bir çalıştırma nadiren yakınsar. Her biri kendi geçidine sahip, uç nokta boyutunda görevlere ayırın. Küçük çalıştırmalar biter; büyük olanlar sorun çıkarır.
Geniş açık izinler. Her aracı kullanışlı olduğu için vermek, kimse bakmadığında küçük bir hatayı büyük bir olaya dönüştürür. İzin beyaz listesini sıkı tutun.
Sessiz başarı veya sessiz hata. Kimseye haber vermeden işlem yapan veya uyarı vermeden ölen bir iş akışı, hiçbir iş akışından daha kötüdür. Her zaman devredin.
Modelin kendi raporuna güvenmek. Ajan bittiğini söyleyecektir. Bitip bitmediğine geçit karar verir. "Yapılmış gibi görünüyor" ve "yapıldı" arasındaki boşluk için inşa edin, çünkü gözetimsiz olduğunda onu yakalayacak kimse yoktur.

Bunları doğru yaparsanız, bir Claude iş akışı siz kahve içmeden önce bir günlük sınırlı, doğrulanmış işi yapar. Yanlış yaparsanız, kendinden emin, test edilmemiş kod üretimini otomatikleştirdiniz demektir. Fark, model değil, geçit ve güvenlik önlemleridir. Daha derin bir mimari istiyorsanız, ajan koşum tasarımı konusundaki analizimiz, parçaların büyük ölçekte nasıl bir araya geldiğini kapsar.

Özet

Siz olmadan çalışan Claude iş akışları oluşturmak, Claude'dan çok, etrafına sardığınız sistemle ilgilidir. Beş bölüm ağırlığı taşır: kesin bir spesifikasyon, başsız yürütme, deterministik bir doğrulama geçidi, katı güvenlik önlemleri ve temiz bir devir. Bunları doğru yaparsanız, model siz bakmadığınızda doğru, sınırlı ve gözlemlenebilir bir makinenin içinde hızlı bir çalışan haline gelir.

Tek bir iş akışı ile başlayın. Sıkı bir spesifikasyon yazın, hızlı bir doğrulama geçidine karşı başsız çalıştırın, araçları beyaz listeye alın, yinelemeleri sınırlayın, çalışma alanını izole edin ve bitiş veya başarısızlık durumunda sizi bilgilendirmesini sağlayın. API'lere dokunan her şey için, test süiteniz gözetimsiz çalıştırmaları güvenli kılan geçittir ve Apidog size onu inşa etmek için tasarım, mocklama ve otomatik testleri tek bir çalışma alanında sunar. Onu indirin, geçidi bağlayın ve siz başka bir şey yaparken iş akışının turlarını atmasına izin verin.