Aynı klasörde iki Claude Code oturumu açabilir miyim?

Açabilirsin, Claude Code başlar; ama iki oturum aynı dosyaları değiştirir ve birbirinin yarım kalmış değişikliklerini görür. Her oturuma ayrı bir git worktree ver ya da en azından katı bir klasör sınırı çiz.

Birden fazla Claude Code ajanı aynı limiti mi paylaşır?

Evet. Aynı hesaba girmiş her oturum aynı 5 saatlik ve haftalık limitten harcar; dört ajan limiti yaklaşık dört kat hızlı bitirir.

Aynı anda kaç Claude Code ajanı çalıştırabilirim?

Claude Code’un kendisinde katı bir sınır yok. Pratikte bir kişinin takip edebileceği sayı iki ile dört arası; asıl tavanı limitler ve inceleme süresi belirler.

Paralel Claude Code ajanlarının işini nasıl birleştiririm?

Her worktree’yi normal bir dal gibi ele al: testleri orada çalıştır, dalı push edip pull request aç ya da yerelde birleştir. Dalları birer birer birleştir ve her birinden sonra testleri yeniden çalıştır.

Birden fazla Claude Code ajanını paralel çalıştırma

Tek bir Claude Code oturumu işi adım adım yürütür. Dosya okurken ve test çalıştırırken sen beklersin. Birden fazla Claude Code ajanını paralel çalıştırmak bu bekleme süresini işe çevirir: bir ajan API’yi yazar, diğeri testleri hazırlar, üçüncüsü ikisiyle de ilgisi olmayan bir hatayı düzeltir.

Bu yazıda en basit kurulumdan en rahatına doğru ilerliyorum: düz terminaller, tmux, git worktree, Claude Code’un kendi paralel oturumları ve son olarak AgentVera. Her adım bir öncekinde eksik olan bir şeyi ekliyor. Sonda da genelde can yakan tuzakların listesi var: merge çakışmaları, limitler ve token’lar.

Aynı anda birden fazla Claude Code ajanı çalıştırılabilir mi?

Evet. Claude Code bir CLI; claude yazdığın her seferde kendi konuşması ve bağlamı olan bağımsız bir oturum başlatırsın. Beş tane açmana engel yok. Sorun başlatmakta değil, eşgüdümde: aynı klasördeki iki oturum aynı dosyayı gönül rahatlığıyla değiştirir, aynı hesaba girmiş tüm oturumlar da o hesabın limitini paylaşır.

Yani asıl soru, onları birbirinden nasıl ayıracağın ve nasıl takip edeceğin.

1. seçenek: ayrı terminal pencereleri

En hızlı kurulum, ajan başına bir terminal sekmesi:

# sekme 1
cd ~/code/acme-web && claude
# sekme 2
cd ~/code/acme-web && claude

Küçük ve net ayrılmış işlerde işe yarar. Her ajana ilk mesajında hangi klasörlere dokunabileceğini söyle (“yalnızca src/api/”, “yalnızca tests/”).

Eksikleri hızla ortaya çıkar: hangi sekmenin onay beklediğini göremezsin, iki oturum aynı çalışma kopyasını paylaşır ve bir ajan git checkout yaptığında diğeri bir anda başka bir dalda bulur kendini.

2. seçenek: tmux

tmux, terminali kapatsan da oturumları canlı tutar ve birkaç paneli aynı anda görmeni sağlar:

tmux new-session -d -s agents -c ~/code/acme-web
tmux split-window -h -t agents -c ~/code/acme-web
tmux send-keys -t agents:0.0 'claude' Enter
tmux send-keys -t agents:0.1 'claude' Enter
tmux attach -t agents

Artık iki ajan yan yana görünür ve dizüstünün kapağını kapatsan da (makine açık kaldıkça) yaşamaya devam eder. tmux görünürlüğü çözer, yalıtımı değil: iki panel de hâlâ aynı klasörü değiştirir.

3. seçenek: ajan başına bir git worktree

“İki ajan, tek depo” sorusunun standart cevabı git worktree. Worktree, aynı .git geçmişini paylaşan, kendi dalında duran ikinci bir çalışma klasörüdür:

cd ~/code/acme-web
git worktree add ../acme-web-api -b feat/api
git worktree add ../acme-web-tests -b feat/tests

cd ../acme-web-api && claude     # ajan 1
cd ../acme-web-tests && claude   # ajan 2

Artık her ajanın kendi dosyaları ve dalı var. Bir ajanın git checkout’u ya da yarım yazılmış dosyası diğerini etkilemez. Ajan işini bitirdiğinde dalı, herhangi bir özellik dalı gibi birleştirilir.

Birkaç pratik not:

Bağımlılıkları her worktree’de kur. node_modules, sanal ortamlar ve derleme çıktısı paylaşılmaz. Her yeni klasörde pnpm install (ya da karşılığını) çalıştır.
Yerel ayarları kopyala. .env dosyaları genelde git’te yok sayılır, yeni worktree’de görünmez.
Portlar çakışır. 3000 portunda iki geliştirme sunucusu açılmaz; her worktree’ye ayrı port ver.
Temizle. Dal birleşince git worktree remove ../acme-web-api, elle sildiğin klasörler için git worktree prune.

Ayrıntılar git worktree ile paralel geliştirme yazısında.

4. seçenek: Claude Code’un kendi paralel oturumları

Anthropic’in Claude Code masaüstü uygulaması, git komutlarını yazmana gerek kalmadan paralel Claude oturumlarını her biri kendi worktree’sinde çalıştırabiliyor. Yalnızca Claude kullanıyor ve resmi aracı istiyorsan makul bir durak. Yalıtımı ve temel bir genel bakışı karşılıyor.

Hedeflemediği şeyler: Claude’un yanında Codex ya da Gemini CLI gibi başka CLI’ları çalıştırmak, bir ajanın çıktısını otomatik olarak diğerine iletmek ya da limit dolunca ajanı başka bir hesaba taşımak. Çoklu ajan uygulamaları burada devreye giriyor. Seçeneklerin karşılaştırması için birden fazla kodlama ajanını paralel çalıştıran en iyi araçlar yazısına bak.

5. seçenek: AgentVera

AgentVera, makinendeki claude komutunu gerçek terminallerde açar ve ajanları proje başına bir ızgarada dizer. Claude Code’un kendi girişini kullanır; Pro ya da Max planın olduğu gibi çalışır. Yukarıdaki sorunların karşılıkları:

Sorun	AgentVera’da
Hangi ajanın seni beklediği görünmüyor	1×1’den 5×4’e ızgara; her panelde durum ve canlı bağlam boyutu; onay bekleyen ajanlar durum çubuğunda listelenir
Ajanlar aynı dosyaları değiştiriyor	Worktree paneli: bir daldan worktree açıp ajanı doğrudan orada başlat
İki ajan yine de aynı dosyaya dokunuyor	Dosya çakışması uyarısı: iki ajan aynı klasörde aynı dosyayı değiştirince hem ajana hem sana haber verilir; hiçbir şey engellenmez
Çıktıyı elle kopyalamak gerekiyor	Akışlar bir ajanın yanıtını şablonla diğerine iletir
Limit görevin ortasında doluyor	Hesap geçişi ajanı sıradaki Claude hesabına taşır ve konuşmayı kopyalar
Bağlam her turda büyüyor	Belirlediğin eşikte otomatik `/compact`, ayrıca bağlam profilleri

Adım adım

Proje klasörünü ekle. Projeler ekranından seç; Git deposu olması önerilir.
Worktree’leri aç. Sağ paneldeki worktree listesinden her görev için yeni bir daldan worktree oluştur, örneğin feat/api ve feat/tests.

Ajanları aç. Yeni ajan altında Claude Code’u seç, worktree’yi belirle; ajana bir ad, model, efor ve kısa bir rol ver:

Yalnızca src/api/ altında çalış. Testlere dokunma.
Her değişiklikten sonra pnpm test api çalıştır.
Bitirirken değiştirdiklerini madde madde listele.

Izgarayı düzenle. 2×2 düzen iki Claude ajanı, bir Codex inceleyici ve geliştirme sunucusunu çalıştıran bir terminal için yeterli.
Gerekirse bağla. Bir akış, API ajanının turu bitince son özetini test ajanına gönderebilir. Tur sınırı iki ajanın döngüye girmesini önler.
İncele ve birleştir. Otomatik kod incelemesi biten her turu kontrol eder. Git paneli her worktree’nin değişikliklerini ve ana dalın ne kadar önünde olduğunu gösterir; dalları birer birer birleştir.

Izgara, worktree’ler ve kod incelemesi ücretsiz planda. Akışlar ve hesap geçişi Pro’da.

Tuzaklar ve çözümleri

Merge çakışmaları

Worktree’ler ajanların çalışırken birbirinin üstüne yazmasını önler; birleştirirken çıkan çakışmaları önlemez. Farklı dallarda src/routes.ts’i değiştiren iki ajan sonunda yine çakışır.

İşi yalnızca dala göre değil, klasöre ya da modüle göre böl.
Ortak dosyaları (rota tabloları, şemalar, lock dosyaları) tek bir ajana bırak.
Önce küçük dalı birleştir, sonra diğer worktree’yi main üzerine taşı ve çakışmayı ajanına çözdür: o worktree’de git rebase main, ardından ajandan çözmesini ve testleri yeniden çalıştırmasını iste.

Kullanım limitleri

Aynı hesaptaki tüm oturumlar aynı 5 saatlik ve haftalık limiti paylaşır. Dört ajan dört kat kota almaz; limite dört kat hızlı ulaşır. Claude Code’da /usage ile düzenli kontrol et ve yoğun paralel oturumları limit penceresinin başına planla. Meşru olarak birden fazla hesabın varsa (kişisel ve iş gibi) ve sağlayıcının koşulları izin veriyorsa, hesap geçişi biri dolduğunda görevi sürdürür. Ayrıntı: Claude Code limiti.

Token kullanımı

Her ajan kendi bağlamını taşır: sistem istemi, araç tanımları, CLAUDE.md, MCP sunucuları ve okuduğu her dosya. Bu taban yük her turda, her ajan için yeniden okunur.

Ajanlara dar ve somut görevler ver ki daha az dosya okusunlar.
Uzun bir konuşma pahalılaşmadan /compact çalıştır ya da bir eşikte otomatik çalışmasını sağla.
Ajanın ihtiyaç duymadığı MCP sunucularını kapat.
Ajanlar arasında çıktı aktarırken tüm dökümü değil, özeti gönder.

Ölçülmüş rakamlar için Claude Code token tasarrufu.

İşi durduran onaylar

Onay bekleyen bir ajan durur, diğerleri devam eder. Beş panelde birini kaçırmak kolay. Durumu takip et, bildirimleri kullan ya da güvenli işlemlere (dosya okuma, test çalıştırma) Claude Code izin ayarlarında izin ver ki ajanlar daha az sorsun.

Çok erken, çok fazla ajan

Darboğaz ajanlardan sana kayar. Dört dalı incelemek, bir dalı incelemekten uzun sürer. Net ayrılmış görevlerde iki ajanla başla, işe yarayınca üçüncüyü ekle.

Kısa kontrol listesi

Ortak koda dokunabilecek her ajana bir worktree
Her worktree’de bağımlılıklar kurulu, .env kopyalanmış
Her ajanın rolünde klasörleri ve hedefi yazılı
Geliştirme sunucuları için ayrı portlar
Bir birleştirme planı: önce hangi dal, çakışmayı kim çözecek
/usage ve bağlam boyutu göz önünde

Sonuç

Birden fazla Claude Code ajanını paralel çalıştırmak büyük ölçüde yalıtım ve dikkat meselesi. Worktree’ler her ajana kendi dosyalarını verir; tmux ya da bir ızgara hepsini görmeni sağlar; kısa roller ve bir birleştirme planı sonucu incelenebilir tutar. Başlamak için düz terminaller ve worktree’ler yeter. Izgara, ajanlar arası akışlar ve limitlerde yardım istediğinde AgentVera’yı ücretsiz indir ve ilk iki Claude Code ajanını aç. Genel yöntem için paralel kodlama ajanları yazısına bak.