Claude Code Workflow'ları: Nedir ve Ne Zaman Gerçekten İhtiyaç Duyarsınız?

Claude Code Workflow'ları: Nedir ve Ne Zaman Gerçekten İhtiyaç Duyarsınız?

Claude Code v2.1.154 sürümüne güncelleme yapınca /config ekranında Dynamic workflows adlı yeni bir satır görürsünüz. Bunu açtığınızda Claude, aynı anda 16 agenta kadar iş dağıtabilen bir JavaScript script'i yazabiliyor. Herkesin fısıldayarak konuştuğu özellik bu. Resmi belgeler ne yaptığını anlatıyor. Ama asıl önemsediğiniz soruyu yanıtlamıyor: buna gerçekten ihtiyacınız var mı, yoksa elinizde halihazırda bulunan subagent'lar yeterli mi?

İşte tam bu boşluk. Claude Code workflow'ları araştırma önizlemesi olarak yayımlandı; belgeler tavsiye niteliği taşımıyor, yalnızca referans bilgisi veriyor. Bu yüzden biz pakette gelen tek workflow olan /deep-research'ü kendi içerik pipeline'ımızda çalıştırdık, gerçek sayıları kaydettik ve dürüst kararımızı yazdık. Kısa yanıt: agentları hâlâ elle takip edebiliyorsanız workflow'a henüz ihtiyacınız yok. Ama içinizde gerçekten ihtiyaç duyanlar var. Hangisi olduğunuzu birlikte anlayalım.

Temel çıkarımlar:

• Claude Code workflow'u, subagent'ları büyük ölçekte yöneten ve Claude'un yazdığı bir JavaScript script'idir (araştırma önizlemesi, v2.1.154+, tüm ücretli planlar).
• Bir workflow'a yalnızca bir konuşmanın koordine edemeyeceği kadar çok agent gerektiren görevlerde ihtiyaç duyarsınız. Aksi hâlde subagent'lar yeterlidir.
• Bugün için tek bir workflow yayımlanmış durumda: /deep-research. Oturum açık kalırken arka planda çalışıyor.
• Workflow'lar token açısından oldukça maliyetlidir. Önermeden önce gerçek bir çalıştırma ölçümü yaptık (sayılar aşağıda).

Claude Code Workflow Nedir?

Claude Code workflow'u subagent'ları büyük ölçekte yöneten bir JavaScript script'idir. Görevi tanımlarsınız, Claude script'i yazar ve bir çalışma zamanı onu arka planda yürütürken oturum ekranınız yanıt vermeye devam eder. Claude Code'da araştırma önizlemesi olarak sunulan bu özellik Claude Code v2.1.154+ gerektirir ve tüm ücretli planlarda (Pro, Max, Team, Enterprise, ayrıca API ve Bedrock/Vertex/Foundry) çalışır.

Gündelik hayattan bir örnek verelim. Bir mutfak tezgâhının önüne geçip istediğiniz yemeği tarif ettiğinizi düşünün. Şef bir tarif yazıyor, bunu arka mutfaktaki aşçılara veriyor; onlar çalışırken siz tezgâhta sohbet etmeye devam ediyorsunuz. Her aşçıyı tek tek yönlendirmiyorsunuz; tarif yönlendiriyor. İşte o tarif workflow, aşçılar subagent'lar ve arka planda çalışan mutfak da çalışma zamanı.

Bir workflow başka bir agent değildir. Agentlarınıza ne yapacaklarını, hangi sırayla yapacaklarını ve sonuçlarla ne yapılacağını söyleyen script'tir. Bu ayrım, bu yazıdaki her şeyden daha önemli ve bir sonraki bölümde somutlaştıracağız.

Hızlıca gidermemiz gereken bir karışıklık var. "Claude code workflows" araması yaparsanız GitHub repo'larına, eklentilere ve Ruflo, claude-flow, wshobson/agents gibi topluluk swarm araçlarıyla dolu bir marketplace'e ulaşırsınız. Bunlar üçüncü taraf yöneticilerdir. Anthropic'in resmi Dynamic workflows özelliği bunlardan farklı, yerleşik bir özelliktir. v2.1.154+'da /config ekranında görünmüyorsa resmi olan değildir.

Bu özellik, fast mode araştırma önizlemesi gibi Anthropic'in diğer araştırma önizlemeleriyle aynı kategoride: erken yayımlanmış, bir geçiş düğmesiyle açılıyor ve hâlâ geliştirilme aşamasında. Bunu bir önizleme olarak değerlendirin, çünkü öyle. Tam özellik listesi resmi workflow belgelerinde yer alıyor.

Workflow, Subagent ve Skill: Planı Kim Tutuyor?

Bu üçünü birbirinden ayırmanın en pratik yolu tek bir soruyu sormaktır: planı kim tutuyor? Skill, Claude'un talep üzerine yüklediği paketlenmiş talimatlar ve bilgi bütünüdür. Subagent, delege edilmiş tek bir işi kendi ayrı bağlamında yürüten bir yapıdır. Workflow ise subagent'ları büyük ölçekte, aynı anda 16'ya kadar koordine eden yönetim script'idir. Aynı araç kutusu, üç farklı iş.

Resmi belgenin ima ettiği ama hiç yan yana koymadığı karşılaştırma şöyle:

Tek bir Claude konuşması tüm planı aklında tutabiliyorsa subagent istiyorsunuz, workflow değil. Kim ne yapıyor, hangi sırayla yapıyor sorularını insan olarak siz takip edemez hale geldiğinizde plan konuşmanın sınırlarını aşmış demektir. İşte workflow o sınırı geçer.

İlk adımı daha derinlemesine incelemek ister misiniz? Skill eğitimimiz Claude'un talep üzerine yüklediği bilgi paketlemeyi ele alıyor. Yerel yönetim yerine tam bir agent framework kullanmayı düşünüyorsanız o karşılaştırma da yardımcı olur. Dürüst görüşümüz şu: yerel primitifler, bir framework'ün değer kazanmadan öncesine kadar tahmin ettiğinizden çok daha uzağa gidiyor.

Claude Code Workflow'a Ne Zaman Gerçekten İhtiyaç Duyarsınız?

Bir Claude Code workflow'una şu durumlarda ihtiyaç duyarsınız: (a) görev, tek bir konuşmanın koordine edemeyeceği kadar çok agent gerektiriyorsa, (b) yönetimi tek seferlik bir komut istemi yerine yeniden çalıştırılabilir kod olarak kaydetmek istiyorsanız veya (c) birden fazla agentin birbirinin çalışmasını denetlediği çapraz kontrol gerektiriyorsa. Bunların hiçbiri geçerli değilse subagent'lar yeterlidir. Kendinize karşı dürüst olun.

Belgenin açıkça söylemeyeceği şeyi biz söyleyelim: muhtemelen henüz workflow'a ihtiyacınız yok. Normal bir konuşmada koordine edilen bir avuç subagent gündelik işleri karşılıyor. Workflow'lar mezun olduğunuzda geçtiğiniz bir üst seviye değil. Tek bir beyin tarafından takip edilemeyecek kadar çok agent gerektiren belirli bir problem biçimine özgü bir araçtır.

Bu kontrol listesini kendinize uygulayın. Aşağıdakilerden en az birine evet yanıtı veriyorsanız muhtemelen workflow gerekiyor:

• Görev, tek bir konuşmanın takip edemeyeceği kadar çok agent gerektiriyor.
• Yönetimi her seferinde yeniden yazmak yerine yeniden çalıştırılabilir kod olarak kaydetmek istiyorsunuz.
• Çapraz kontrol veya karşılıklı doğrulama gerekiyor (birden fazla agentin birbirini denetlemesi).
• Periyodik kod tabanı denetimi veya 500 dosya göçü gibi aynı çok-agent işini tekrar tekrar çalıştıracaksınız.

Dördüne de hayır mı dediniz? Subagent'larla devam edin. Token tasarrufu yaparsınız, her şeyi hata ayıklanabilir tutarsınız ve hiçbir şeyi kaybetmezsiniz. Spec odaklı çalışanlar bu kalıbı CLAUDE.md en iyi uygulamalarında tanıyacak: planı bir kez yazın, yeniden çalıştırılabilir yapın, sürekli yeniden yazmayı bırakın. Bir workflow, planın kendisinin yürütülmesi için bir çalışma zamanına ihtiyaç duyduğu noktaya itilmiş bu fikirdir.

Elinizde Hazır Olan Tek Workflow: /deep-research

/deep-research, önizlemede gelen tek paket workflow'dur. Bir soruyla çağırın; subagent'ları konuyu paralel araştırmak üzere dağıtır, bulgularını birbirleriyle çapraz kontrol eder ve tek bir sentezlenmiş yanıtı bağlamınıza döndürür; tüm bunlar arka planda gerçekleşirken oturumunuz kullanılabilir kalır.

/deep-research Claude Code'da çok-agent araştırmanın gerçek token maliyeti nedir?

Arayüzün tamamı bu kadar. Arka planda aşamalar halinde ilerliyor: sorunuzu araştırma iş parçacıklarına ayırıyor, her birini takip etmek için agent'lar üretiyor, ajanların zayıf iddiaları birbirini yakalayacak şekilde bir çapraz kontrol veya inceleme aşaması çalıştırıyor, ardından nihai bir yanıt sentezleyerek sohbetinize geri gönderiyor. Çalışırken müdahale edemezsiniz. Sorarsınız, çalışır, rapor eder.

Öğleden sonranızı kaybedecek karmaşık araştırma sorularında gerçekten işe yarıyor. Araştırma altyapısını zaten kuruyorsanız en iyi MCP sunucuları rehberimiz bu tür dağılımlı araştırmayla iyi eşleşiyor. Ama "yararlı" ile "token maliyetine değer" aynı şey değil; tam olarak ölçmeye çalıştığımız şey buydu.

Kendi Pipeline'ımızda Bir Workflow Çalıştırdığımızda Ne Oldu

/deep-research çalıştırmamız 4 aşamada 9 subagent üretti, yaklaşık 1 milyon token tüketti ve duvar saatiyle yaklaşık 8 dakika sürdü. Değer mi verdi? Kısa bir soru için kesinlikle hayır. Yoksa altı agent üzerinde elle koordine edeceğimiz bir araştırma görevi için maliyetini karşıladı. İşte dürüst döküm.

Pipeline'ımızda, okuduğunuz bu yazının kendisi de zaten bir çok-agent sistemi tarafından üretildi: araştırma, brief, yazım, doğrulama, çeviri ve yayımlama her biri ayrı subagent'lar olarak çalışıyor. Dolayısıyla biz zaten yukarıdaki kontrol listesindeki "tek bir konuşma için çok fazla agent" dünyasında yaşıyoruz. Bu da bizi kurgulanmış değil, gerçek bir test vakası yaptı.

Zaten araştırdığımız canlı bir anahtar kelimede /deep-research çalıştırdık ve tüm çalıştırmayı kaydettik:

Bizi en çok şaşırtan şey çapraz kontrol aşaması oldu. Bir agentin ürettiği birkaç erken iddia, başka bir agent itiraz ettikten sonra sessizce düzeltildi; bu tam da tek bir konuşmanın genellikle görmezden geldiği türden bir şey. O çatışmalı adım, ham paralellikten çok daha değerli. Ama token maliyeti gerçekten yüksek; üstelik o agentlar Opus katmanı modellerde çalışıyor (bunun faturaya ne kadar yansıdığını anlamak için Opus 4.8 yeniliklerine bakın). İki komut istemiyle yanıtlayabileceğiniz bir soru için 1 milyon token kötü bir trade. Gerçekten altı kaynağı uzlaştırması gereken bir soru için ise zamanınız açısından kârlı.

Bu tam olarak Techsy'de müşteriler için kurduğumuz yönetim türü; bu yüzden nerede işe yaradığı ve nerede sadece bütçe yaktığı konusunda güçlü bir ön bilgimiz vardı. Görüşümüz: zor sorularda çalıştırın, kolay soruları atlayın.

Kendi Workflow'unuzu Nasıl Yazarsınız ve Kaydedersiniz

Kendi workflow'unuzu oluşturmak için workflow anahtar kelimesini kullanarak görevi sade dille Claude'a tarif edin, ürettiği script'i inceleyin ve onaylayın, ardından yeniden kullanılabilir bir /command olarak kaydedin. Daha yüksek çaba için /effort ultracode ayarlayın; Claude kendi başına bir workflow planlıyor. Sizden JavaScript bilgisi gerekmiyor; script'i Claude yazıyor, siz onaylıyorsunuz.

Takip ediyorsanız adımlar olarak da kullanabileceğiniz tam döngü şöyle:

1. Dynamic workflows'u etkinleştirin. Pro planında /config açın ve Dynamic workflows satırını açın. (v2.1.154+ kullanıyorsunuz, değil mi?)

   bash

   /config
   # ardından "Dynamic workflows" satırını etkinleştirin

2. workflow anahtar kelimesiyle görevi tarif edin. workflow sözcüğünü komut isteminizin herhangi bir yerine ekleyin; örneğin: "Bu repo'daki her route dosyasını eksik auth kontrolleri için denetleyen bir workflow çalıştır." Claude Code sözcüğü vurgular ve adım adım çalışmak yerine bir script yazar. Claude'un kendisi karar versin ister misiniz? /effort ultracode ayarlayın; bu, tüm önemli görevler için xhigh akıl yürütmeyi otomatik workflow yönetimiyle eşleştirir (ve daha fazla token yakar; rutin işler için /effort high'a dönün).

3. Üretilen script'i inceleyin ve onaylayın. Claude, herhangi bir şey çalıştırmadan önce JavaScript yönetimini size gösterir. Okuyun. İstediğinizden geniş bir dağılımı yakalamak için bu fırsatı kullanın.

4. Yeniden kullanım için /command olarak kaydedin. Çalışınca workflow'u özel bir slash command olarak kaydedin; böylece gelecek çeyrekteki denetim tek tuşla gerçekleşir.

Yeniden kullanılabilirlik sessiz kazanç. Tek seferlik /deep-research kullanışlı, ama "tüm route'larda auth'u denetle" veya "bu dizini yeni API'ye taşı" için kaydedilen bir workflow, saatler süren bir koordinasyon işini tekrarlanabilir tek bir komuta dönüştürüyor. Token maliyeti her çalıştırmaya bölünmeye başladığında, bir kez acı verip bitmek yerine kendini amorti etmeye başlıyor.

Limitler, Maliyet ve Workflow'ları Nasıl Kapatırsınız

Workflow'lar en fazla 16 eşzamanlı agent çalıştırır, çalıştırma başına 1.000 agent sabit üst sınırı vardır, çalışırken girdi kabul etmez ve yalnızca aynı oturum içinde devam ettirilebilir. Her agent kendi bağlamını tükettiğinden tasarım gereği token açısından maliyetlidir. Özelliği disableWorkflows config seçeneğiyle veya CLAUDE_CODE_DISABLE_WORKFLOWS ortam değişkeniyle tamamen devre dışı bırakabilirsiniz.

Bu limitlerin her biri göreviniz için bir anlam taşıyor. Çalışırken girdi yok demek, bir kez başladıktan sonra yön değiştiremezsiniz; belirsiz bir komut istemi tam çalıştırma değerinde tokeni çöpe atar. Yalnızca aynı oturumda devam ettirilebilir demek, terminalinizi kapattığınızda çalıştırma gitmiş demektir. Çalıştırma başına 1.000 agent devasa görünüyor, ama Opus katmanı ücretleriyle geniş bir dağılım gerçek para demektir; 16 eşzamanlı varsayılanı zorlayacak bir tavan değil, bir güvenlik özelliği olarak değerlendirin.

Kapatmak için:

export CLAUDE_CODE_DISABLE_WORKFLOWS=1
# veya config'de "disableWorkflows": true ayarlayın

Sık karşılaşılan bir sorun: /config ekranında Dynamic workflows satırını görmüyorsanız v2.1.154 altındasınızdır. Önce güncelleme yapın. Bu tür agent pipeline'larını gerçek işler için kuruyorsanız ve gerçekten işe yaramasını istiyorsanız, B2B ekipleri için agent pipeline'ları kuruyoruz. Yönetim bir darboğaza dönüşüyorsa ücretsiz danışmanlık alın →.

Sonuç

Tüm yazıyı beş satırda özetleyelim. Claude Code workflow'u, subagent'ları büyük ölçekte yönetmek için Claude'un yazdığı bir JavaScript script'idir; v2.1.154 sürümünde araştırma önizlemesi olarak yayımlandı. Bugün mevcut olan tek workflow /deep-research'tür. Bir workflow'a yalnızca görev tek bir konuşmanın koordine edemeyeceği sınırı aştığında, yeniden çalıştırılabilir yönetim istediğinizde ya da agentların birbirini çapraz kontrol etmesine ihtiyaç duyduğunuzda gerek var. Gerçek çalıştırmamız 8 dakikada 9 agent için yaklaşık 1M token harcadı; kolay sorular için fazla, zor araştırmalar için değerli. Muhtemelen henüz ihtiyacınız yok ve bu tamamen normal.

Sıkça Sorulan Sorular

Claude Code workflow nedir?

Claude Code workflow'u, subagent'ları büyük ölçekte yöneten bir JavaScript script'idir. Görevi tanımlarsınız, Claude script'i yazar ve bir çalışma zamanı onu arka planda yürütürken oturumunuz yanıt vermeye devam eder. Claude Code v2.1.154+ sürümünde araştırma önizlemesi olarak sunulan bu özellik, tüm ücretli planlarda kullanılabilir.

Workflow ile subagent arasındaki fark nedir?

Subagent, kendi ayrı bağlamında çalışan, konuşma içinde sizin tarafınızdan koordine edilen tek bir delege iştir. Workflow ise subagent'ları aynı anda, 16'ya kadar koordine eden yönetim script'idir. Tek bir konuşma tüm planı aklında tutabiliyorsa subagent kullanın. Planın agentları takip etmek için bir çalışma zamanına ihtiyacı varsa workflow kullanın.

Claude Code workflow token maliyeti ne kadar?

Ölçtüğümüz /deep-research çalıştırmamızda, 4 aşamadaki 9 subagent yaklaşık 8 dakikada 1,05 milyon token yaktı. Workflow'lar, her agent kendi bağlamını tükettiğinden ve bu agentlar Opus katmanı modellerde çalıştığından tasarım gereği maliyetlidir. Basit sorularda israf; gerçek çok-kaynaklı araştırmada maliyetini karşılıyor.

Claude Code workflow'larını kullanmak için ücretli plan gerekli mi?

Evet. Dynamic workflows tüm ücretli Claude planlarında (Pro, Max, Team, Enterprise) ve API ile Bedrock/Vertex/Foundry üzerinde çalışır. Ücretsiz katmanda erişim yoktur. Pro planında, Claude Code v2.1.154 veya üstüne güncelledikten sonra /config ekranındaki Dynamic workflows satırını açarak özelliği etkinleştirirsiniz.

Claude Code'da /deep-research nedir?

/deep-research, araştırma önizlemesinde gelen tek paket workflow'dur. Bir soru sorarsınız; subagent'ları konuyu paralel araştırmak üzere dağıtır, agentların birbirinin bulgularını doğruladığı bir çapraz kontrol aşaması çalıştırır, ardından tek bir yanıtı bağlamınıza sentezler; tüm bunlar arka planda gerçekleşir.

Bir workflow'u slash command olarak nasıl kaydederim?

workflow anahtar kelimesini kullanarak görevi Claude'a tarif edin, ürettiği JavaScript script'ini inceleyin ve onaylayın, ardından onaylanan script'i özel bir /command olarak kaydedin. Bundan sonra tüm çok-agent iş tek tuşla çalışır; token maliyetinin kendini amortize etmeye başladığı yer burasıdır.

Bir workflow aynı anda kaç agent çalıştırabilir?

Bir workflow en fazla 16 eşzamanlı agent çalıştırır; çalıştırma başına 1.000 agent sabit üst sınırı vardır. 16 eşzamanlı varsayılan iyi bir nedenden dolayı var: Opus katmanı ücretleriyle geniş bir dağılım hızla pahalıya gelebiliyor. Limitleri hedef değil güvenlik önlemi olarak değerlendirin; dağılımı görev gerektirdiği kadar dar tutun.

Dynamic workflows nasıl kapatılır?

Config'de disableWorkflows'u true yapın ya da Claude Code'u başlatmadan önce CLAUDE_CODE_DISABLE_WORKFLOWS=1 ortam değişkenini dışa aktarın. İkisi de özelliği tamamen devre dışı bırakır. /config ekranında Dynamic workflows satırını görmüyorsanız muhtemelen gerekli v2.1.154 sürümünün altındasınızdır; önce güncelleme yapın.

Claude Code workflow'larına gerçekten ihtiyaç duyuluyor mu, yoksa subagent'lar yeterli mi?

Bir görev tek bir konuşmanın sınırlarını aşana kadar subagent'lar yeterlidir. Normal bir konuşmada koordine edilen bir avuç subagent, yüksek token maliyeti olmadan gündelik işleri karşılar. Bir workflow'a gerçekten yalnızca şu durumlarda ihtiyaç duyarsınız: görev tek bir konuşmanın takip edemeyeceğinden fazla agent ürettiğinde, yönetimi kod olarak yeniden çalıştırılabilir hale getirmek istediğinizde ya da agentların birbirini çatışmalı biçimde çapraz kontrol etmesine ihtiyaç duyduğunuzda.