Bir projede birden fazla Claude Code ajanı nasıl çalıştırılır?

Tek oturum neden yetmiyor?

Bir Claude Code oturumu, tek bağlam penceresi olan tek bir ajandır. Gerçek bir projede bu tek ajan arayüzü, sunucuyu, testleri ve bütün kararları aynı anda taşımak zorunda kalır. Bağlamı dolar, önceki seçimleri kaybeder ve aynı anda tek iş yapar. İşi birkaç oturuma bölmek her ajana daha küçük bir iş ve daha temiz bir bağlam verir; birbirini beklemeyen parçalar da aynı anda ilerler.

Zor olan daha çok oturum açmak değil. Zor olan, oturumların birbirinin yazdığını ezmesini ve verilen kararları unutmasını önlemek.

1. yol: elle, terminaller ve git worktree ile

Claude Code terminalde çalışır; birkaç ajanın en basit yolu birkaç terminaldir.

1. Her ajana bir çalışma kopyası. İki oturum aynı klasörde çalışırsa aynı dosyaları düzenler. git worktree, aynı depodan her ajana kendi klasörünü ve dalını verir:

   git worktree add ../uygulamam-arayuz -b arayuz
   git worktree add ../uygulamam-sunucu -b sunucu

2. Her klasörde bir oturum aç. Her worktree'de bir terminal açıp claude çalıştır. Artık her oturumun kendi bağlamı ve kendi dalı var.
3. Ortak kuralları bir kez yaz. Claude Code her oturumun başında projedeki CLAUDE.md dosyasını okur. Teknoloji yığınını, kod kurallarını ve her ajanın uyması gereken kararları oraya yaz; her sohbette tekrarlamazsın.
4. Elle birleştir. Bir dal bitince farkı incelersin, testleri çalıştırırsın, birleştirirsin. Parçaları tutarlı tutan sensin.

Claude Code'da ayrıca alt ajanlar (subagents) var: bir oturumun odaklı bir iş için başlattığı, kendi bağlamı olan ve sonucu ana sohbete geri veren yardımcılar. Araştırma ya da kendi içinde kapalı bir değişiklik için iyiler. Kalıcı bir ekip değiller: oturumlar arasında rol tutmazlar ve planı yine ana oturum taşır.

Bu kurulum çalışır ve ek bir maliyeti yoktur. Sınırları proje büyüdükçe görünür: her kararı terminaller arasında sen taşırsın, dosyaya yazdığın dışında oturumlar arasında hiçbir şey hatırlanmaz ve neler olduğunu görmek için her terminale tek tek bakarsın.

Paralel ajanları çalıştıran beş kural

Hangi yolla çalıştırırsan çalıştır, ajanlar Korvenium'un kendi ürünlerini (bu site dahil) yaparken bu kurallara uyuyoruz.

1. Dosya başına bir sahip. İki ajan aynı dosyayı aynı anda yazmaz. Her işte o ajanın dosyaları yazılıdır, örneğin SENİN DOSYALARIN: builder.html, builder.css.
2. Kendi başına anlaşılır brief. Ajan başka bir ajanın sohbetini görmez. Gerekeni brief taşımalı: okunmuş dosyalar, bulunmuş neden ve "bitti"nin ölçütü. Yoksa her ajan projeyi baştan okur.
3. Önce sözleşme. Arayüz ve sunucu birlikte değişiyorsa sözleşmeyi (uç, girdi, çıktı, hata) ikisi başlamadan yaz ve iki brief'e de aynen koy.
4. On değil, iki üç parça. Her ek parça bir birleştirme ve bir çakışma ihtimali demek. Büyüklüğe göre değil, sahiplik alanına göre böl.
5. Önce kanıt, sonra insan. "Bitti", derlemenin ve testlerin çalıştığı ve sonucun yazıldığı anlamına gelir. Hiçbir şey gönderilmeden önce bir insan inceler ve onaylar.

2. yol: OBA ile

OBA (Ortak Beyinli Ajanlar), Korvenium'un Windows masaüstü uygulamasıdır: Claude Code, Codex ya da Antigravity CLI üzerinde çalışan bir yapay zekâ kodlama ajanı ekibi görevi böler, kodu senin proje klasöründe yazar, inceler ve test eder; sonucu insan onaylar. Yukarıdaki kurulumu senin yerine yürütür:

• Her projeye bir ev. Her proje kendi klasörü ve kendi ekibi olan bir evdir; örneğin bir yetkili, bir arayüz geliştiricisi, bir sunucu geliştiricisi ve bir testçi. Her ajan o klasörde çalışan ayrı bir Claude Code (ya da Codex, Antigravity CLI) oturumudur.
• İşi yetkili böler. Görevi evin yetkilisine verirsin. Yetkili hangi parçanın kime ait olduğuna karar verir, her parça için kendi dosya listesiyle bir brief yazar ve parçaları dağıtır; birbirini beklemeyen parçalar aynı anda çalışır. Bir ajan bitirince raporu yetkiliye döner; yetkili parçaları birleştirir ve sonucu doğrular.
• Kalıcı ortak hafıza. Kararlar, kurallar ve proje notları tek bir ortak hafızada durur. Notlar birbirine bağlanır ve oturumlar arasında kalır; ajanlar sıfırdan başlamaz, aynı bağlamı her sohbete yapıştırmazsın.
• Terminal yığını yerine pano. Her iş, durumu ve kanıtı panoda görünür; ajanların çalışmasını köy meydanında izlersin. Bir ajanın karara ihtiyacı olunca soru panoda seni bekler.
• Gönderimi sen onaylarsın. Ajanlar commit atar; değişiklikleri GitHub'a göndermek, ayarlardan kapatmadıysan önce sana sorulur.
• Kendi kendine yürüyen yol haritası. Adımları projenin yol haritası dosyasına yazarsın; köy bunları her ev için sırayla, her birinin yazılı "bitti" ölçütüyle işler.

Bir evdeki ajanlar aynı proje klasörünü paylaşır; onları ayrı kopyalar değil, yukarıdaki dosya sahipliği kuralı ayırır. Kodun, sohbetlerin ve hafıza notların bilgisayarında kalır; ajanlar seçtiğin CLI'nin arkasındaki yapay zekâ servisine, o CLI tek başına nasıl bağlanıyorsa öyle bağlanır. O abonelik ya da API anahtarı senindir.

Gerçek bir örnek: bu yazı

Bu yazı OBA'da, korvenium.com'u yöneten evde hazırlandı. Görev tek cümleydi: OBA sayfalarına görünür fiyat, güncel sürüm ve güncelleme tarihi ekle, bir blog kur ve bu rehberi yaz. Evin yetkilisi Alex, blogu ve ona bağlanan site dosyalarını kendisinde tuttu; ürün sayfalarındaki fiyat ve sürüm satırlarını, hangi dört sayfanın onun olduğunu yazan bir brief'le arayüz geliştiricisi Max'e verdi. İki parça aynı anda çalıştı ve hiç aynı dosyaya dokunmadı. Ardından Alex sitenin SEO denetimini çalıştırdı; iş gönderilmeden önce bir insanın onayına gitti.

Başlamak için gerekenler

• Windows 10 ya da 11, 64 bit ve en az bir kodlama CLI'si: Claude Code, Codex ya da Antigravity CLI, kendi hesabıyla ya da bir API anahtarıyla. Git özellikleri için Git for Windows.
• Güncel sürüm OBA 1.5.8. Ücretsiz plan 1 ev ve 2 ajan içerir; bir yetkili ve bir geliştirici için yeter. Pro ev ve ajan sınırını kaldırır, GitHub'ı açar: 31 Aralık 2026'ya kadar çıkış fiyatıyla ayda $12 ya da yılda $120. Korvenium Lifetime ilk 100 alıcıya tek ödeme $400. Bkz. planlar ve indirme.