Kısa cevap (Kasım 2026): Claude Code ve Codex gibi paralel kodlama ajanlarını aynı projede çalıştırmak için her ajana kendi git worktree’sini (ya da kesin bir klasör sınırını), ölçülebilir tek bir hedefi ve çıktısının gideceği belirli bir yeri ver. İlk adımda artık iki CLI de yardım ediyor: claude --worktree <ad> Claude Code’u kendi worktree’sinde başlatır, OpenAI’ın ChatGPT masaüstü uygulaması da Codex sohbetlerini paralel, istersen git worktree’lerde çalıştırır. Birden fazla sağlayıcının ajanlarını tek pencerede görmek istiyorsan AgentVera, Orca, Emdash ya da VS Code Agents penceresi gibi bir çoklu ajan uygulaması kullan. İki ajanla başla ve her ajanın aynı plan limitlerinden harcadığını unutma.
Burada adı geçen uygulamalardan biri olan AgentVera’yı biz geliştiriyoruz, okurken bunu aklında tut. Aşağıdaki yöntem düz terminallerde de işe yarar.
Bu rehber ilk çıktığından beri ne değişti?
Bu rehber ilk kez Eylül 2026’da yayımlandı. O günden bu yana:
- Claude Code worktree’yi kendisi açıyor.
claude --worktree feature-auth(ya da-w),.claude/worktrees/feature-auth/altındaworktree-feature-authadlı yeni bir dalda worktree açar ve oturumu orada başlatır. Alt ajanlar da frontmatter’larınaisolation: worktreeyazılınca kendi worktree’lerini alabilir. - Codex, OpenAI’ın uygulamasında paralel çalışıyor. ChatGPT masaüstü uygulaması birkaç Codex sohbetini aynı anda, her birini istersen kendi worktree’sinde çalıştırır; macOS ve Windows’ta var, Linux önizlemede.
- Birden fazla ajanı yöneten uygulamalar çoğaldı. Orca, VS Code Agents penceresi ve başkaları Conductor, Paradev (eski adı Superset) ve AgentVera’ya katıldı. Hepsini Claude Code ve Codex’i paralel çalıştırma araçları yazısında karşılaştırıyoruz.
- Limitlerin adları değişti. Anthropic’in Max planları artık Max ve Ultra. Pro ve Max kullanımı hâlâ 5 saatlik bir pencereyle ve haftalık bir limitle sınırlıyor; birkaç ajan tek hesabı paylaşıyorsa bu önemli.
Neden paralel kodlama ajanları?
Tek bir ajanla çalışmanın darboğazı beklemektir. Ajan düşünürken, dosya okurken ve test çalıştırırken sen ya bekler ya da başka bir işe geçersin. Paralel ajanlar bu bekleme süresini değerlendirir.
En çok şu durumlarda işe yarar:
- Bağımsız işler: Birbirine dokunmayan bir arka uç uç noktası ile ön yüzdeki bir form.
- Yazma ve doğrulama: Bir ajan kodu yazar, diğeri aynı değişiklik için test yazar.
- Araştırma ve uygulama: Bir ajan kütüphane seçeneklerini karşılaştırırken diğeri mevcut kodu düzenler.
- Farklı güçlü yanlar: Claude Code ve Codex farklı modeller ve araç setleriyle gelir; aynı problemi ikisiyle denemek seni sonuca daha hızlı götürebilir. İkisinin farkları için: Claude Code mu Codex mi?
İşi bölmenin üç kuralı
Paralel çalışmanın başarısı işi nasıl böldüğüne bağlıdır.
1. Dosya sınırlarını baştan çiz
İki ajanın aynı dosyayı değiştirmesi en sık yaşanan sorundur. Her ajanın rolüne hangi klasörlere dokunabileceğini yaz. Örneğin bir ajan yalnızca src/api/ altında, diğeri yalnızca tests/ altında çalışsın.
2. Her ajana tek bir hedef ver
“Auth modülünü iyileştir” yerine “oturum yönetimini refresh token’a taşı” gibi ölçülebilir bir hedef ver. Hedef net olunca ajan erken durabilir, çıktısını kontrol etmek de kolaylaşır.
3. Çıktının nereye gideceğine karar ver
Bir ajanın sonucu diğerinin girdisi olacaksa bunu baştan tasarla. Plan dosyası mı yazacak, commit mi atacak, yoksa yanıtını doğrudan sonraki ajana mı gönderecek?
Dosya çakışmasını git worktree ile önle
Klasör sınırları yetmediğinde en sağlam yol her ajana ayrı bir çalışma ağacı vermektir. Bir git worktree, aynı deponun başka bir dalını ortak geçmişle kendi klasöründe açar. Worktree’leri elle oluşturabilirsin:
git worktree add ../acme-web-auth -b auth-refactor
git worktree add ../acme-web-tests -b auth-tests
Ya da bu işi Claude Code’a bırakabilirsin:
claude --worktree auth-refactor
Claude Code bu worktree’yi .claude/worktrees/ altına koyar; o yüzden bu klasörü .gitignore’a ekle. Proje kökündeki bir .worktreeinclude dosyası (gitignore söz dizimiyle) .env gibi izlenmeyen dosyaları Claude Code’un açtığı her worktree’ye kopyalar. Çıktığında Claude, adsız bir oturumun temiz worktree’sini kaldırır; değişiklik içeren bir worktree’yi kaldırmadan önce sorar.
Her ajan kendi klasöründe çalışır ve diğerinin dosyalarına hiç dokunmaz. İş bitince dalları normal bir pull request ile birleştirirsin. Portlar, ortam dosyaları ve temizlik dahil ayrıntılar git worktree ile paralel geliştirme yazısında.
AgentVera’da worktree’ler sağ panelde durur: yeni ya da var olan bir daldan worktree açabilir, değişiklik sayısını ve ana dalın ne kadar önünde ya da gerisinde olduğunu görebilir, ajanı doğrudan o worktree’de başlatabilirsin.
Örnek kurulum: Claude Code yazar, Codex test eder
Basit ve etkili bir başlangıç düzeni:
| Ajan | Araç | Rol | Çalışma yeri |
|---|---|---|---|
| Mimar | Claude Code | Özelliği planlar ve uygular | auth-refactor worktree’si |
| Testçi | Codex | Değişiklik için entegrasyon testi yazar | Aynı worktree, yalnızca tests/ |
| Geliştirme sunucusu | Terminal | pnpm dev çalıştırır | Ana klasör |
AgentVera’da kurulum adımları:
- Proje klasörünü ekle.
- Yeni ajan penceresinde Claude Code’u seç, adını “Mimar” koy ve rolüne dosya sınırlarını yaz.
- Aynısını Codex için “Testçi” adıyla yap.
- Geliştirme sunucusunu bir Terminal ajanında başlat.
- Mimar’a görevini ver; turunu bitirince çıktısını Testçi’ye aktar.
Son adımı elle ya da bir akışla yapabilirsin: akışlar (Pro ve Team) bir ajanın son yanıtını {{output}} şablonuyla diğerine gönderir; hedef ajan meşgulse turunu bitirmesini bekler. Uygulama kullanmıyorsan sonraki ajanın okuduğu düz bir özet dosyası da aynı işi görür.
Paralel ajanları takip etmek
Ajan sayısı arttıkça asıl iş onları takip etmek olur. Şunlara dikkat et:
- Durum: Hangi ajan çalışıyor, hangisi seni bekliyor, hangisi hata verdi?
- Bağlam boyutu: Uzayan konuşmalar her turda daha fazla token harcar.
- Onay istekleri: İzin bekleyen bir ajan durur, diğerleri çalışmaya devam eder.
AgentVera’nın çalışma alanı ajanları bir ızgarada yan yana gösterir. Her panelde durum, canlı bağlam boyutu ve bir mesaj kutusu bulunur. Onay bekleyen ajanlar durum çubuğunda listelenir; ⇧⌘A en uzun süredir bekleyene götürür.
Bağlam, maliyet ve limitler
Paralel çalışmak token kullanımını katlar. Her ajanın ilk isteği araç tanımlarını, sistem talimatını ve eklentileri taşır; uzun konuşmalarda bu taban her turda yeniden okunur. Bir hesaptaki tüm ajanlar o hesabın limitlerini de paylaşır: Claude Pro ve Max’te 5 saatlik oturum penceresi ve haftalık bir limit.
Maliyeti kontrol altında tutmak için:
- Basit işler için ajanları daha dar bir araç setiyle başlat, MCP sunucularını yalnızca gereken yerde ekle. MCP sunucu yöneticileri her ajan için tek bir liste tutmana yardım eder.
- Uzun konuşmaları
/compactile sıkıştır. - Ajanlar arasında çıktı aktarırken yalnızca gereken kısmı gönder.
- Limitler düzenli olarak bitiyorsa Claude Code hesap değiştirici araçlar yazısına bak; birden fazla hesabı yalnızca sağlayıcının koşulları izin veriyorsa kullan.
Ölçülmüş rakamlar için Claude Code token tasarrufu yazısına bakabilirsin.
Sık yapılan hatalar
Aynı dosyada iki ajan. En hızlı çözüm bir worktree ya da kesin bir klasör sınırıdır.
Belirsiz görevler. “Kodu düzelt” gibi açık uçlu görevler ajanın durmadan dosya okumasına ve bağlamın şişmesine yol açar.
Kontrol etmeden birleştirmek. Paralel ajanların ürettiğini birleştirmeden önce testleri çalıştır ve farkları incele. Otomatik kod incelemesi burada zaman kazandırır.
Her şeyi aynı anda başlatmak. İki ajanla başla, iş bölümü oturunca üçüncüyü ekle.
Uçtan uca bir örnek: refresh token’a geçiş
Kâğıt üzerinde iş bölümü kolay görünür; gerçek bir görevde nasıl işlediğine bakalım. Hedef: bir web uygulamasının oturum yönetimini kısa ömürlü erişim token’larına ve döndürülen refresh token’lara taşımak.
Görevi bölmek
Önce işi bağımsız parçalara ayır. Bu görevde üç parça var:
- Sunucu tarafı: token üretimi, doğrulama ve döndürme (
src/auth/). - Testler: yeni akış için entegrasyon testleri (
tests/api/). - Dokümantasyon: API değişikliklerini README’ye yansıtmak.
Sunucu tarafı ile testler aynı davranışa bakar ama farklı klasörlerde yaşar. Dokümantasyon ise ancak sunucu tarafı oturunca anlam kazanır. Bu yüzden ilk ikisini paralel, üçüncüsünü sonra çalıştır.
Rol talimatları
Her ajanın rolünü kısa ve kesin tut. Mimar için:
Yalnızca src/auth/ altında çalış. Testleri değiştirme.
Her değişiklikten sonra pnpm test auth çalıştır.
İşin bitince yaptığın değişiklikleri madde madde özetle.
Testçi için:
Yalnızca tests/ altında çalış. Uygulama koduna dokunma.
Sana gelen özetteki davranışlar için entegrasyon testi yaz.
Mimar’ın rolündeki son satır önemli: onun özeti Testçi’nin girdisi olur. Özet ne kadar düzenliyse Testçi o kadar az dosya okur.
Teslim ve takip
Mimar turunu bitirince son yanıtı elle ya da bir akışla Testçi’ye gider. Testçi meşgulse akış onun turunu bitirmesini bekler; bağlantının tur sınırı da iki ajanın sonsuz bir döngüye girmesini engeller. Bu arada sen Terminal ajanında geliştirme sunucusunun loglarını izleyebilir ya da üçüncü bir ajana dokümantasyonu hazırlatabilirsin.
Ne zaman paralel çalışmamalı?
Her iş paralelleşmez. Şu durumlarda adım adım ilerleyen tek bir ajanla devam et:
- Değişiklik tek bir dosyada ya da birbirine sıkı bağlı birkaç dosyada toplanıyorsa.
- Görev henüz net değilse; önce araştırma ve plan gelir.
- Bir ajanın çıktısı diğerinin ön koşuluysa ve ikinci iş kısaysa.
Bu durumlarda paralellik yerine aşamalı bir hat daha iyi çalışır. Bunu yapay zeka ajan iş akışı yazısında anlattım.
Paralel ajanları nerede çalıştırmalı?
Bunların hepsini düz terminal sekmelerinde yapabilirsin. İkiden fazla ajanın olunca onları bir arada gösteren bir uygulama işini kolaylaştırır. Neye bakman gerektiğini ajan tabanlı geliştirme ortamı maddesinde anlattık; kısaca:
- Tek sağlayıcı: Claude masaüstü uygulaması (Code sekmesi) paralel Claude oturumlarını worktree’lerde çalıştırır; ChatGPT masaüstü uygulaması aynısını Codex için yapar.
- Editörünün içinde: VS Code Agents penceresi Copilot’u çalıştırır, Claude ve Codex de deneysel seçenek olarak var.
- Ücretsiz ve açık kaynak, her işletim sistemi: Orca (MIT) ya da Emdash (Apache-2.0).
- Yalnızca Mac: Conductor, Claude Code, Codex ve Cursor ajanlarını çalıştırır.
- Windows, Linux ya da macOS’ta kendi girişlerinle birçok CLI ajanı: AgentVera bunlardan 18’ini tek bir ızgarada çalıştırır. Kapalı kaynaktır; ızgara, worktree’ler ve tüm ajanlar ücretsiz planda, akışlar ve hesap geçişi Pro ve Team’de.
İşletim sistemine özel yardım için Windows’ta kodlama ajanlarını yönetmek yazısına, ajanlar gözetimsiz çalışacaksa Claude Code’u gece çalıştırma yazısına bak.
Kontrol listesi
Paralel bir oturumdan önce:
- Her ajanın hedefi tek cümleyle yazılı mı?
- Dosya sınırları rolde var mı?
- Çakışma ihtimali varsa her ajanın kendi worktree’si var mı?
- Bir ajanın çıktısı diğerine gidecekse teslim (özet dosyası ya da akış) hazır mı?
- Testleri çalıştıracak bir ajan ya da terminal var mı?
- Planının limitinden ne kadar kaldığını biliyor musun?
Sonuç
Paralel kodlama ajanları temiz bölünen işlerde gerçekten zaman kazandırır. Anahtar, ajanları birbirinden ayırmak ve aralarındaki teslimi tanımlamaktır: worktree’ler dosyaları ayırır, bir özet dosyası ya da akış çıktıyı taşır, iyi yazılmış roller de sorumlulukları ayırır.
AgentVera bu düzeni tek pencerede kurmak için tasarlandı: Claude Code, Codex ve diğer CLI’lar kendi girişleriyle yan yana çalışır. Ücretsiz planla başlayabilir, daha fazlası gerektiğinde planlara göz atabilirsin.