Claude Code ekosistemini takip ediyorsanız, muhtemelen sessiz sedasız "ilginç bir npm paketi"nden "ciddi Claude Code ekipleri için varsayılan koordinasyon katmanı"na dönüşen bir projeyi fark etmişsinizdir. Bu proje, `rUv` tarafından sürdürülen ve orijinal claude-flow çabasından doğan Ruflo'dur. Fikir basit: Claude Code tek başına bir anda yalnızca bir aracı çalıştırır. Ruflo ise onu bir sürüye dönüştürür. Bu kılavuz, Ruflo'nun ne işe yaradığını, bir MCP sunucu yığınından nasıl farklılaştığını, ne zaman kuruluma değer olduğunu ve Apidog ile aracılar ile altındaki MCP trafiğinin nasıl test edileceğini açıklar. Claude Code'un başlatılırken okuduğu aracı dosya formatına yeni başlıyorsanız, agents.md kılavuzumuz ön koşul niteliğinde bir okumadır.
TL;DR
- Ruflo (eski adıyla claude-flow), `rUv` tarafından geliştirilen, 98 aracı, 60'tan fazla komut, 30 beceri, bir MCP sunucusu, hook'lar ve bir daemon içeren Claude Code için çoklu aracı orkestrasyon platformudur.
- Tek bir `npx ruvflo init` komutu, Claude Code'un sürüler oluşturmasına, oturumlar arası belleği paylaşmasına ve işi makineler arasında federasyona uğratmasına olanak tanıyan bir koordinasyon katmanı ekler.
- İki kurulum yolu mevcuttur: hafif Claude Code Eklentisi (yalnızca slash komutları) ve tam CLI kurulumu (her şeyin bağlı olduğu).
- Altyapısında Rust destekli bir yapay zeka motoru, gömüler, eklenti sistemi ve Cognitum.One mimarisi bulunur.
- MCP sunucusunun `tools/list`, `tools/call` ve federasyon uç noktalarını test etmek; CI sırasında LLM sağlayıcısını taklit etmek; ve bir aracı regresyonu ortaya çıktığında sürü trafiğini yeniden oynatmak için Apidog'u kullanın.
- Günlük iş akışınızda daha fazla yer edinmeden önce Ruflo üzerine bir sözleşme katmanı eklemek için Apidog'u indirin.
Ruflo aslında ne işe yarar?
Varsayılan olarak, Claude Code tek aracılı bir döngüdür: tek bir modelle konuşursunuz, tek bir çalışma alanını düzenler, oturumlar arasında hiçbir şeyi hatırlamaz. Bu, kısa görevler için işe yarar. Ancak bir dizi uzman aracının bir refaktöre saldırmasını istediğinizde, bir aracının bulgularının bir sonraki oturumu bilgilendirmesini istediğinizde veya iki makinenin koordineli çalışmasını istediğinizde çöker.
Ruflo, Claude Code'a bir koordinasyon katmanı olarak entegre olur. `init` sonrası, Claude'a verdiğiniz her görev, aşağıdaki kararları veren bir yönlendirici aracılığıyla ilerler:
- Görevi tek bir aracı olarak çalıştırma (Claude Code'un varsayılanı)
- Uzmanlardan oluşan bir sürü oluşturma (örn. güvenlik incelemesi için bir, testler için bir, dokümanlar için bir)
- Önceki bir oturumun belleğinden devam etme
- İşi başka bir makinedeki bir aracıya federasyona uğratma
README'de "sinir sistemi olan Claude Code" olarak tanımlanır. Bu, şekli iyi yakalar: Ruflo, Claude Code'u değiştirmez, 100 uzman aracının tek bir araç gibi hissettirmesini sağlayan katmanı ekler.
Tek diyagramda mimari
README'deki basitleştirilmiş akış:
Kullanıcı -> Ruflo (CLI/MCP) -> Yönlendirici -> Sürü -> Aracılar -> Bellek -> LLM Sağlayıcılar
^ |
+---- Öğrenme Döngüsü <------+
Test için önemli olan beş bileşen vardır.
CLI/MCP girişi. Ruflo'yu komut satırından veya Claude Code'un MCP entegrasyonundan çalıştırabilirsiniz. Her iki arayüz de altında aynı protokolü kullanır.
Yönlendirici. Küçük bir sınıflandırıcı (yapılandırılabilir, yerel bir model olabilir) görevin hangi yolu izleyeceğine karar verir. Sürü mü, tek aracı mı, devam etme mi, federasyon mu.
Sürü. Odaklanmış istemlere ve araç setlerine sahip uzman aracılardan oluşan bir havuz. Bir sürü oluşturmak, CrewAI'nin ekibine eşdeğerdir, ancak Claude Code'un kendi bağlamıyla daha sıkı entegredir.
Bellek. Oturumlar arasında kalıcıdır, gelecekteki aracılar tarafından sorgulanabilir. "Öğrenme döngüsü" burada çalışır: başarılı desenler puanlanır ve yeniden kullanılır.
LLM sağlayıcıları. Ruflo sağlayıcıdan bağımsızdır. Claude varsayılandır; OpenAI, DeepSeek, Gemini ve yerel Ollama standart sağlayıcı yapılandırması aracılığıyla çalışır.
İki kurulum yolu mevcuttur; bunlardan ne kadarını istediğinize göre seçim yapın.
Kurulum yolları ve her birinin size sağladıkları
README, ilk kez kullananları şaşırtan bir takas hakkında açıkça bilgi verir.
Yol A: Claude Code Eklentisi (lite). Claude Code pazar yeri aracılığıyla yüklersiniz: `plugin install ruflo-core@ruflo`. Bu yalnızca slash komutları ve aracı tanımları ekler. Ruflo MCP sunucusu kayıtlı değildir, bu da `memory_store`, `swarm_init` ve `agent_spawn` gibi araçların Claude'dan çağrılamayacağı anlamına gelir. Tek bir eklentinin komutlarını taahhütte bulunmadan denemek için iyidir.
Yol B: CLI kurulumu (tam). Projenizde `npx ruvflo init` komutunu çalıştırırsınız. Bu, `.claude/`, `.claude-flow/`, `CLAUDE.md`, yardımcı betikler ve MCP sunucusunu ayarlar. Her Claude Code etkileşiminde hook'lar tetiklenir. Bellek kalıcıdır. 98 aracı, 60'tan fazla komut, 30 beceri ve federasyonun hepsi bağlıdır.
README uyarır: "init sonrası, Claude Code'u normal şekilde kullanın; hook sistemi görevleri otomatik olarak yönlendirir." İşte püf nokta budur. 314 MCP aracını ezberlemek zorunda kalmamalısınız. Çerçeve yönlendirmeyi halleder.
Claude Code'u ciddi şekilde kullanan çoğu mühendislik ekibi için Yol B istediğiniz şeydir. Yol A, tek bir eklentiyi izole bir şekilde değerlendirmek içindir.
Kutu içeriği
Eklenti kataloğundan birkaç öne çıkan bileşen.
ruflo-core. Bellek deposu, sürü başlatma, aracı oluşturma temel bileşenleri. Diğer tüm eklentilerin üzerine inşa edildiği temel.
ruflo-swarm. Rol uzmanlığına sahip çoklu aracı koordinasyonu. Bir güvenlik aracı, bir performans aracı, bir dokümanlar aracı ve bir sentezleyici içeren bir kod inceleme sürüsü oluşturun.
ruflo-autopilot. Uzun süreli görev otomasyonu. Çerçeveye bir hedef verir ve kontrol noktalarıyla tamamlanana kadar iterasyon yapmasını sağlar.
ruflo-federation. Makineler arasında güvenli aracıdan aracıya iletişim. Federasyon katmanı, iki kuruluşun kaynak sızdırmadan ajanların işbirliği yapmasına olanak tanımak için veri yüklerini şifreler.
RuVector. Bellek katmanı tarafından kullanılan vektör deposu ve grafik arka ucu. İsteğe bağlıdır ancak projenizin birkaç yüz oturumdan fazla birikmiş bağlamı olduğunda önerilir.
Eklenti pazar yeri ayrıca test, güvenlik, yeniden düzenleme ve gözlemlenebilirlik için özel paketler sunar. Desen tutarlıdır: bir eklenti bir odaklanmış yeteneğe eşittir, hepsi temel bellek ve sürü temel bileşenleri üzerine inşa edilmiştir.
MCP katmanı neden önemlidir?
Ruflo'nun MCP sunucusu, çerçeveyi Claude Code'un çalışma zamanına bağlayan şeydir. Her sürü oluşturma, bellek yazma ve federasyonel aktarım, yerel MCP sunucusuna karşı bir JSON-RPC çağrısıdır.
Bu, MCP yüzeyini test etmek için tek en önemli şey yapar. Eğer `tools/list` gerilerse, Claude Code sürü temel bileşenlerini görmeyi durdurur ve ekibiniz sessizce tek aracı moduna geri döner. Eğer `memory_store` yanlış bir şekil döndürürse, aracılar bağlamda sanrılar görmeye başlar.
Bu, MCP sunucusu test kılavuzumuzda ele aldığımız aynı sorundur. Ruflo MCP sunucusu bir JSON-RPC API'dir; ona öyle davranın.
Ruflo MCP sunucusunu Apidog ile test etme
Yakalanan ilk regresyonda kendini amorti eden başlangıç test planı.
Adım 1: Kanonik istekleri yakalayın. Bir deneme projesinde `npx ruvflo init` komutunu çalıştırın. Ruflo etkin durumdayken Claude Code aracılığıyla birkaç temsilci görevi yürütün. Claude Code'un MCP denetçisini açın ve `initialize`, `tools/list`, `swarm_init` ile `tools/call` ve `memory_store` ile `tools/call` için JSON-RPC çerçevelerini yakalayın.
Adım 2: Onları Apidog'a yapıştırın. Yeni bir proje oluşturun, temel URL'yi yerel Ruflo MCP sunucunuza ayarlayın (Yol B, onu kayıtlı bir MCP olarak kurar) ve yakalanan her çerçeveyi bir istek olarak kaydedin. Apidog, JSON-RPC gövdelerini doğal olarak işler.
Adım 3: Doğrulamalar ekleyin.
- `initialize`: `result.serverInfo.name == "ruflo"` olduğunu ve protokol sürümünün desteklediğiniz sürüm olduğunu doğrulayın.
- `tools/list`: `result.tools.length >= 100` (Ruflo ~100 araçla birlikte gelir) olduğunu, her aracın `name`, `description` ve `inputSchema`'ya sahip olduğunu doğrulayın.
- `swarm_init` için `tools/call`: yanıtın bir sürü kimliği içerdiğini ve bir hata sonucu olmadığını doğrulayın.
- `memory_store` için `tools/call`: yazma işleminin başarılı olduğunu ve aynı anahtarın `memory_get` tarafından okunabilir olduğunu doğrulayın.
Adım 4: LLM sağlayıcılarını taklit edin. Ruflo, her aracı kararı için Claude'u (veya yapılandırdığınız sağlayıcıyı) çağırır. CI çalıştırmaları her commit'te gerçek bir sağlayıcıya ulaşmamalıdır. Apidog, OpenAI uyumlu uç noktayı gerçekçi yanıtlarla taklit eder; testler sırasında Ruflo'nun sağlayıcı yapılandırmasını taklit ediciye yönlendirin. Desen, Postman olmadan API testi yazımızda belgelediğimizle aynıdır.
Adım 5: Süiti CI'da çalıştırın. Apidog'un CLI çalıştırıcısı, doğrulama hatası durumunda sıfır olmayan bir kodla çıkar. Bunu GitHub Actions'a bağlayın ve bir dahaki sefere biri Ruflo'yu güncelleyip MCP şeklini bozduğunda, PR'niz yayınlanmadan önce başarısız olur.
Apidog'un günlük Ruflo döngüsüne nasıl uyum sağladığı
CI'ın ötesinde, Apidog'un Ruflo ile günlük işlerinizde kendine yer bulduğu üç an:
Bir sürü kötü davrandığında. Claude Code'un gönderdiği tam `tools/call` çerçeve dizisini yeniden oynatın. Bilinen iyi bir çalıştırma ile farkı karşılaştırın. Fark genellikle istem şablonu değiştiği için kayan bir araç argümanını gösterir.
Ruflo'yu yükselttiğinizde. Yeni sürüm, yeni araç yüzeyi. Önce test süitini çalıştırın; önceki sürüme göre fark, hangi araçların yeniden adlandırıldığını, kaldırıldığını veya şeklinin değiştiğini size söyler. Sözleşme öncelikli API geliştirmede API sözleşmelerini karşılaştırmak için aynı iş akışını kullanıyoruz.
Federasyon aksadığında. Federasyona tabi ajanlar şifreli bir kanal üzerinden iletişim kurar; enstrümantasyon olmadan el sıkışmayı ayıklamak zordur. Apidog, yerel proxy bağlantı noktasına yönlendirdiğinizde federasyon trafiğini kaydedebilir; istek günlüğü hatayı açıkça gösterir.
Yaygın tuzaklar
GitHub sorunlarında ve Discord'da ortaya çıkan desenler.
Eklenti yolunu kurmak ve tam döngü beklemek. README açık; eklentiler yalnızca slash komutlarıdır. Eğer `swarm_init` Claude'dan çağrılamıyorsa, hafif yolu kurmuşsunuzdur. Tam kurulum için `npx ruvflo init` komutunu yeniden çalıştırın.
Hook katmanını atlamak. Yol B, görevleri otomatik olarak yönlendiren hook'ları yükler. Eğer onları kaldırırsanız veya geçersiz kılarsanız, yönlendirici asla tetiklenmez ve sürü koordinasyonunu kaybedersiniz. Bir nedeniniz olana kadar varsayılanları bırakın.
Belleğin kontrolsüz büyümesine izin vermek. Bellek deposu varsayılan olarak kalıcı ve sınırsızdır. Birkaç haftalık yoğun kullanımdan sonra, indeks sürü oluşumlarını yavaşlatacak kadar büyür. Saklama süresini yapılandırın; README'nin ayarlar sayfası ayar düğmelerini kapsar.
Sadece Claude odaklı bir araç olarak ele almak. Ruflo sağlayıcıdan bağımsızdır. Varsayılan Claude'dur, ancak maliyet hassasiyetli sürüler için DeepSeek V4'e veya çevrimdışı çalıştırmalar için yerel bir Llama 5.1'e geçebilirsiniz. DeepSeek V4 API kılavuzumuz ve 2026'nın en iyi yerel LLM'leri yazımız her ikisi için de sağlayıcı yapılandırmasını kapsar.
Federasyonun güven sınırlarını aştığını unutmak. Başka bir makineye federasyon yaptığınızda, o uç noktaya veri yükleri (potansiyel olarak kod dahil) gönderiyorsunuz demektir. Şifreleme katmanı sağlamdır; politika çalışması size aittir. Açmadan önce hangi projelerin federasyon yapabileceğini tanımlayın.
Ruflo'nun diğer aracı çerçevelerle karşılaştırması
Aynı konuşmalarda sürekli olarak üç çerçeve öne çıkar.
LangGraph. Daha düşük seviyeli, genel. Orkestrasyonu kendiniz inşa edersiniz. Tam kontrol istediğinizde ve iş akışınız Claude Code odaklı olmadığında LangGraph'ı seçin. LangGraph'a TradingAgents yazımızda değinmiştik.
CrewAI. Çoklu ajan, çerçeveden bağımsız, yapılandırma açısından daha ağır. Python'ın ana dil olduğu Claude dışı iş akışları için seçin.
MCP sunucularının manuel olarak yığılması. Kendi çözümünüzü üretin. Ruflo'dan daha hafif, koordinasyonu daha zor. İki veya üç sunucu için iyi; beşten fazlası için zahmetli.
Ruflo'nun nişi "Claude Code, ama bir sürü ile." Günlük sürücünüz Claude Code ise ve 600 satır MCP şablonu yazmadan koordinasyon istiyorsanız, kuruluma değerdir.
Performans ve ölçek notları
Ruflo'yu birkaç aydır kullanan ekiplerden iki operasyonel gözlem.
Bir sürü oluşturmanın, yönlendirici kararının ve araç kaydının iki ila dört saniyelik sabit bir maliyeti vardır. Çok kısa görevler için (tek satırlık bir düzenleme) bu ek yük baskın hale gelir; yönlendiricinin bu görevleri tek aracı yolundan göndermesini, bir sürüye göndermemesini istersiniz. Varsayılan yönlendirme genellikle bunu doğru yapar; yapmazsa, eşiği ayarlayacağınız yer hook yapılandırmasıdır.
Bellek sorguları, depo büyüdükçe yavaşlar. SQLite birkaç bin oturumu iyi idare eder; bunun ötesinde, Postgres veya RuVector'a geçin. Altı mühendis ve 18 aylık geçmişe sahip bir ekip, aynı hacimde varsayılan SQLite'da 600 ms'ye kıyasla Postgres'te 40 ms medyan bellek sorguları rapor ediyor.
Gerçek dünya kullanım örnekleri
Bir platform ekibi, Ruflo'nun federasyon katmanını kullanarak bir depoda güvenlik incelemeleri yaparken, diğer bir depoda yeniden düzenleme sürüsü çalıştırıyor; her ikisi de paylaşılan bir bellek deposu aracılığıyla koordine ediliyor. Çelişkili tavsiyeleri bir insan gözden geçirene sunuyorlar.
Yalnız bir geliştirici, Ruflo'nun otomatik pilot modunu bir Linear ticket kuyruğuna bağlıyor: "bir P3 ticket'ı seç, kontrol et, bir düzeltme öner, bir PR aç, devam et." Otomatik pilot gece çalışıyor; geliştirici sabah inceliyor.
Bir araştırma grubu, Ruflo'dan gelen çoklu aracı kod inceleme desenini kullanarak üç depoda PR kalitesini değerlendiriyor. Toplam LLM harcaması, saatte 80 dolarlık tek bir insan inceleyicisine kıyasla Claude Sonnet'te haftalık 50 doların altında.
Sonuç
Ruflo, "Claude Code'u bir seferde bir aracının ötesine nasıl ölçeklendiririm?" sorusuna ciddi bir yanıttır. CLI kurulumu, tek bir komutla bellek, sürüler, federasyon ve 100'den fazla araçlık bir MCP sunucusu ekler. Eklenti pazar yeri, yetenekleri net bir şekilde ayırarak aşamalı olarak benimsemenize olanak tanır.
Beş çıkarım:
- Ruflo, Claude Code'u kalıcı belleğe ve isteğe bağlı federasyona sahip bir sürü koordinatörüne dönüştürür.
- Yol A (eklentiler) değerlendirme içindir; Yol B (`npx ruvflo init`) günlük kullanım içindir.
- MCP sunucusu sözleşme yüzeyidir; onu herhangi bir JSON-RPC API'yi test ettiğiniz gibi test edin.
- Apidog, kanonik MCP isteklerini yakalamak, doğrulamalar eklemek ve süiti CI'da çalıştırmak için en temiz yerdir.
- CI çalıştırmalarının hızlı ve ücretsiz kalması için LLM sağlayıcısını Apidog'da taklit edin.
Sonraki adım: bir deneme projesinde `npx ruvflo init` komutunu çalıştırın, Claude Code'un denetçisinde MCP çerçevelerini yakalayın ve bunları bir Apidog projesine yapıştırın. Yakaladığınız ilk regresyon, kurulum maliyetini karşılayacaktır.
SSS
Ruflo, claude-flow ile aynı mı?
Evet. Ruflo, `rUv` (aynı yazar) tarafından sürdürülen, yeniden adlandırılmış claude-flow'dur. npm paketi `ruvflo`; GitHub deposu `ruvnet/ruflo`'dur. Mevcut claude-flow yapılandırmaları çalışmaya devam eder.
Hem eklenti hem de CLI kurulumuna ihtiyacım var mı?
Hayır. Birini seçin. Eklentiler slash komutları verir; CLI kurulumu tam koordinasyon katmanını verir. Çoğu ekip CLI kurulumunu ister.
Ruflo'yu Claude olmadan kullanabilir miyim?
Evet. Ruflo sağlayıcıdan bağımsızdır. Sağlayıcı yapılandırmasında DeepSeek V4, GPT-5.5, Gemini veya yerel bir model yapılandırın. Claude varsayılandır çünkü çerçeve claude-flow'dan doğmuştur.
Bellek nerede bulunur?
Yapılandırmanıza bağlı olarak yerel bir SQLite veya Postgres deposunda. İsteğe bağlı RuVector arka ucu, anlamsal alma için vektör aramayı ekler. Bellek, açıkça yapılandırmadığınız sürece üçüncü taraf bir hizmete sızmaz.
MCP sunucusunu CI'da nasıl test ederim?
Kanonik istekleri MCP denetleyicisi ile yakalayın, bunları Apidog'a yapıştırın, JSONPath doğrulamaları ekleyin, CI'da `apidog run` komutunu çalıştırın. Tam desen MCP sunucusu test kılavuzunda bulunmaktadır.
Federasyon kuruluşlar arası güvenli mi?
Şifreleme katmanı sağlamdır. Politika katmanı sizin sorumluluğunuzdadır: hangi projelerin federasyon yapabileceğini tanımlayın, göndermeden önce veri yüklerindeki sırları temizleyin ve denetim günlüğünü düzenli olarak inceleyin.
Maliyeti nedir?
Çerçeve MIT lisanslı ve ücretsizdir. Maliyet, aracılar için LLM jetonları ve seçtiğiniz herhangi bir barındırılan vektör deposu içindir. Yoğun bir kullanıcı, günlük Ruflo kullanımı için Claude Sonnet'te ayda 200 doların altında rapor ediyor.