Claude Code ajanları nedir, nasıl kurulur: 4 ajanlı multi-agent sistemi

Projeni planlama, arayüz, backend ve test-güvenlik ajanlarına bölerek context ve limit sorununu nasıl hafifleteceğini adım adım anlatıyoruz.

Bu rehberin videosu: Claude'u 4'e Böldüm: Multi-Agent Sistemi Kurdum (00:07:35).

Claude Code ajanları nedir?

Ajanlar aslında Markdown dosyalarıdır. Projenin içinde kurulurlar ve her birinin kendine özel bir görevi vardır.

Ajan dosyasında isim, model, açıklama ve ajanın neler yapabileceği yazılır. Yani ajanın rolünü ve sınırlarını bu dosyada sen belirlersin.

Proje küçükse ajanlara gerek olmayabilir. Ama web sitesi ya da uygulama yapıyorsan ajan sistemini anlamak ve kurmak işini ciddi kolaylaştırır.

• Ajan = görevi tanımlanmış bir MD dosyası
• Her ajanın tek bir uzmanlık alanı olur
• Ajanların ortak okuduğu dosyalardan biri CLAUDE.md dosyasıdır

Neden tek sohbet yerine birden fazla ajan?

Sohbet sınırlıdır. Videodaki örnekte Claude Code ile konuşma %85'e gelince özetleniyor ve sadece bir kısmı hatırlanıyor.

Dosyalar ajanlar arasında bölüştürülünce, özetlenen ya da yeni açılan sohbette Claude hangi ajana gideceğini anlar. Mesela plana dair bir soru sorduğunda sadece plan ajanı devreye girer, başka dosyaları okuması gerekmez.

Obsidian ya da bilgi grafiği gibi bir yapı kullanmıyorsan Claude her oturumda dosyaları yeniden okur. Bu da context ve limit sorununu büyütür.

• Token daha verimli kullanılır
• Context dolsa bile yön kaybolmaz
• Her ajan hangi araçları, MCP server'ı ve skill'leri kullanacağını bilir
• Ajanlar eş zamanlı çalışabilir

Model seçimi ve erişim izinleri

Her ajana hangi modeli kullanacağını ayrı ayrı yazabilirsin. Videoda front-end ajanı için Sonnet, planlama ajanı için Opus seçildi. Böylece modeller göreve göre verimli kullanılıyor.

İzinler de ajana göre değişir. Örnekteki builder ajanının okuma, yazma ve düzenleme izni var. Retriever ajanının ise yazma izni yok.

Belirli ajanlara belirli görevler ve izinler verince onları kısıtlamış olursun. Güvenlik kontrolü yapan ajan planlama yapmaz. Bu da projede bir güvenlik katmanı oluşturur.

• Ağır düşünme işleri için Opus, arayüz için Sonnet örneği
• Yazma izni sadece gereken ajanlarda olsun
• Görev ayrımı = daha az karışıklık

Skill dosyaları ve hazır ajan deposu

Ajanların daha iyi çalışması için onlara skill dosyaları verilir. Bir ajana birden fazla skill ekleyebilirsin. Videodaki projede toplam beş skill seti var. Örneğin backend ve frontend tarafında ikişer skill kullanılıyor.

Videoda GitHub üzerindeki bir ajan ve skill deposu gösteriliyor. Bu depoda 184 ajan ve 150 skill bulunuyor, araçlar da var. Örneğin API tasarımı için kullanılan, Opus ile çalışan bir backend mimarisi ajanı inceleniyor.

Depodaki ajanları alıp projene göre özelleştirmesi için Claude'a verebilirsin. Claude her ajan için bir tool set ve skill set oluşturur. Bağlantılar video açıklamasında paylaşılıyor.

• Hazır ajanı olduğu gibi kopyalayabilirsin
• Daha iyisi: projene göre Claude'a uyarlat
• Her ajan için hem tool set hem skill set olsun

Ajanlar birbiriyle nasıl konuşur?

Her şey ana sohbetten başlar. Ana sohbete "web sitesini kur" gibi bir prompt verirsin. Claude bu işle görevli ajanı otomatik devreye sokar.

Sıralı sistemde ajan işini bitirince ana Claude'a mesajla döner. Ana Claude da sonraki ajana, örneğin frontend'e, bunu prompt olarak iletir. Paralel sistemde birkaç ajan aynı anda çalışır ve hepsi işini bitirince mesajla geri bildirim yapar.

Limit ya da context dolduğunda sohbetler kaybolabilir. Bu yüzden videoda ajanların ne yaptığı bir state dosyasına yazdırılıyor. Sonraki oturumda Claude bu dosyadan neler yapıldığını takip ediyor. Bir sonraki videoda bu iletişimin Obsidian üzerinden kurulacağı söyleniyor.

• Sıralı çalışma: ajan biter, ana Claude sonrakine aktarır
• Paralel çalışma: ajanlar aynı anda çalışır, sonra rapor verir
• State dosyası: hangi ajan, hangi rol, hangi dosyalar

Adım adım

1. Projeyi açar açmaz ilk iş olarak hangi ajanlara ihtiyacın olduğunu belirle. Örneğin planlama, arayüz, backend ve test-güvenlik.
2. Her ajan için bir Markdown dosyası oluştur. İçine isim, model, açıklama ve yapması gereken görevleri yaz.
3. Her ajana uygun modeli ata. Örneğin planlama için Opus, front-end için Sonnet.
4. Araç izinlerini ajana göre kısıtla. Yazma izni sadece gereken ajanlarda olsun.
5. GitHub'daki hazır ajan ve skill deposundan uygun olanları al, projene göre özelleştirmesi için Claude'a ver. Her ajana tool set ve skill set oluşturt.
6. CLAUDE.md dosyasında ajanlardan bahset. Ajanlar bu dosyayı ortak olarak okur.
7. Ajanları sıralı ya da paralel çalıştıracak net bir prompt yaz. Yaptıklarını bir state dosyasına kaydetmelerini iste.

Kontrol listesi

• Her ajanın tek ve net bir görevi var mı?
• Her ajanda model, açıklama ve yetenekler tanımlı mı?
• Yazma ve düzenleme izinleri sadece gereken ajanlarda mı?
• Ajanlar CLAUDE.md dosyasında anılıyor mu?
• Ajanların yaptıkları state dosyasına yazılıyor mu?
• Prompt, hangi ajanın ne yapacağını açıkça anlatıyor mu?

Sıkça Sorulan Sorular