Kısa cevap (Kasım 2026): Yapay zeka kodlama ajanlarını çakışmadan paralel çalıştırmak için aynı dosyalara dokunabilecek her ajana kendi git worktree’sini ver: git worktree add ../app-auth -b auth-refactor aynı deponun ikinci bir dalını ortak geçmişle kendi klasöründe açar. Claude Code artık bunu claude --worktree <ad> ile kendisi yapabiliyor, OpenAI’ın ChatGPT masaüstü uygulaması da Codex sohbetlerini isteğe bağlı worktree’lerde çalıştırıyor. Her worktree’nin kendi bağımlılıkları, kendi izlenmeyen .env dosyaları ve kendi geliştirme sunucusu portu olmalı. Her dalı normal bir pull request ile birleştir, iş bitince worktree’leri git worktree remove ile kaldır.
Aşağıda worktree yönetmenin ve ajan turlarını geri almanın bir yolu olarak geçen AgentVera’yı biz geliştiriyoruz; git komutları ise her yerde çalışır.
Git worktree nedir?
Bir git worktree, aynı deponun farklı bir dalını aynı anda ayrı bir klasörde açar. Her klasörün kendi çalışma dosyaları vardır, ama .git verisi ortaktır. Bir worktree’de attığın commit diğerlerinden anında görünür.
Klonla karşılaştırınca:
| Worktree | Ayrı klon | |
|---|---|---|
| Disk kullanımı | Az (geçmiş paylaşılır) | Deponun tamamı |
| Commit görünürlüğü | Anında | Fetch/push gerekir |
| Aynı dal iki yerde | Engellenir (güvenli) | Mümkün (karışıklık riski) |
| Kurulum | Tek komut | Klonla ve ayarla |
Temel komutlar
Yeni bir dalda worktree oluşturmak:
git worktree add ../acme-web-auth -b auth-refactor
Var olan bir daldan worktree açmak:
git worktree add ../acme-web-billing billing-v2
Worktree’leri listelemek, kilitlemek ve kaldırmak:
git worktree list
git worktree lock ../acme-web-billing
git worktree remove ../acme-web-auth
git worktree prune
lock bir worktree’nin yanlışlıkla prune edilmesini ya da kaldırılmasını engeller; remove, --force eklemedikçe commit’lenmemiş değişiklik içeren bir worktree’yi silmeyi reddeder; prune da klasörü elle silinmiş worktree’lerin kayıtlarını temizler.
Ajan başına bir ağaç
Paralel ajanlar için kural basit: çakışma riski olan her ajana kendi worktree’sini ver.
Örnek bir düzen:
| Ajan | Görev | Worktree | Dal |
|---|---|---|---|
| Mimar (Claude Code) | Auth yeniden yapılanması | ../acme-web-auth | auth-refactor |
| Arayüz (Gemini CLI) | Ayarlar sayfası | ../acme-web-settings | settings-ui |
| Testçi (Codex) | Auth testleri | ../acme-web-auth | auth-refactor |
Testçi, Mimar’ın worktree’sini paylaşır; çünkü Mimar’ın değişikliğini test eder ve yalnızca tests/ altında çalışır. Arayüz ajanı ise kendi dalında bambaşka bir iş yapar.
Bu sana şunları kazandırır:
- Ajanlar birbirinin yarım yazılmış dosyalarını hiç görmez.
- Her iş kendi dalı ve kendi pull request’iyle birleşir.
- Bir işten vazgeçmek dalını silmek kadar kolaydır.
İşin kendisini nasıl böleceğin için paralel kodlama ajanları yazısına bak.
Ajanlara yerleşik worktree’ler
Bu rehber ilk kez Eylül 2026’da çıktığından beri ajanlar ve uygulamaları kurulumun büyük kısmını üstlendi.
Claude Code. claude --worktree feature-auth (ya da -w), depo kökündeki .claude/worktrees/feature-auth/ altında, worktree-feature-auth adlı yeni bir dalda worktree açar ve oturumu orada başlatır. Ad vermezsen Claude bir ad seçer. Anthropic’in belgelerinden işe yarar ayrıntılar:
- Yeni worktree’ler deponun varsayılan dalından açılır; bunun yerine mevcut çalışmandan dallanmak için
worktree.baseRefdeğerini"head"yap. - Proje kökündeki,
.gitignoresöz dizimiyle yazılmış bir.worktreeincludedosyası.envya da.env.localgibi gitignore’daki dosyaları Claude Code’un açtığı her worktree’ye kopyalar. - Çıktığında, adsız bir oturumun temiz worktree’si dalıyla birlikte kaldırılır; değişiklik varsa Claude saklamak isteyip istemediğini sorar.
- Alt ajanlar frontmatter’larına
isolation: worktreeyazılınca kendi worktree’lerinde çalışabilir. - Worktree’ler izlenmeyen dosya olarak görünmesin diye
.claude/worktrees/klasörünü.gitignore’a ekle.
Codex. OpenAI’ın ChatGPT masaüstü uygulaması birkaç Codex sohbetini aynı anda, her birini istersen kendi git worktree’sinde çalıştırır; Handoff ile bir sohbeti worktree ile kendi checkout’un arasında taşırsın. Codex CLI’ı tek başına kullanıyorsan worktree’yi git ile aç ve codex’i içinde başlat.
Masaüstü uygulamaları. Birden fazla ajan çalıştıran uygulamaların çoğu artık her ajan ya da görev için worktree’yi senin yerine açıyor; bunları Claude Code ve Codex’i paralel çalıştırma araçları yazısında karşılaştırıyoruz. Bu tür uygulamalara çoğu zaman ajan tabanlı geliştirme ortamı denir.
Worktree’yi kim açarsa açsın, aşağıdaki git kuralları geçerli.
AgentVera’da worktree yönetimi
Worktree’leri komut satırından yönetebilirsin, ama ajanlar çoğaldıkça takip zorlaşır. AgentVera’da sağ paneldeki Worktree’ler sekmesiyle şunları yapabilirsin:
- Yeni ya da var olan bir daldan worktree oluşturmak.
- Her worktree’nin değişiklik sayısını, ana dalın ne kadar önünde ya da gerisinde olduğunu ve son commit’ini görmek.
- Ajanı doğrudan bir worktree’de başlatmak.
- Bir worktree’yi kilitlemek, prune etmek, zorla kaldırmak ve dalını silmek.
Yeni bir ajan oluştururken çalışma alanı olarak bir worktree de seçebilirsin; ajanın paneli dalını küçük bir etiketle gösterir. Ajanların worktree’lerde değiştirdiği Markdown dosyaları da Spec’ler panelinde plan ve doküman olarak listelenir.
Her turu geri alınabilir tut
Worktree’ler ajanları birbirinden ayırır. Peki bir ajan kendi worktree’sinin içinde yanlış yöne giderse?
Geleneksel cevap sık commit atmaktır, ama ajanın her adımını commit’lemek geçmişi kirletir. AgentVera’nın turları başka bir yol izler:
- Her turun başında çalışma klasörünün anlık görüntüsü gizli bir git referansına alınır.
- Dalına, index’ine ve stash’ine dokunulmaz.
- Ajan başına son 60 tur saklanır.
- Panelin Seçenekler menüsündeki Turlar’dan bir turun değiştirdiği dosyaları görürsün.
- Bu turu geri al o turun değişikliklerini geri alır; geri almayı da geri alabilirsin.
Böylece ajanın rahatça denemesine izin verebilirsin: sonucu beğenmezsen önceki duruma bir tık uzaklıktasın.
Birleştirmeden önce
Paralel dallarda biten işi ana dala almadan önce:
- Her worktree’de testleri çalıştır.
- Farkları incele; otomatik kod incelemesi bunu hızlandırır.
- Commit mesajlarını toparla. AgentVera’nın Git paneli hazırlanmış farktan deponun stiline uyan bir mesajı Claude Haiku ile yazabilir.
- Dalı gönder ve bir pull request aç; Git panelindeki GitHub kartı mevcut dalın pull request’ini gösterir ya da yenisini açar.
Sık yapılan hatalar
- Aynı dalı iki worktree’de açmak. Git buna izin vermez; bu bir güvenlik önlemi.
- Silinen klasörlerin kayıtlarını bırakmak.
git worktree pruneile temizle. - node_modules’u unutmak. Her worktree kendi bağımlılıklarının kurulmasını ister.
- İzlenmeyen dosyaları unutmak.
.envve gitignore’daki diğer dosyalar yeni bir worktree’de görünmez; kopyala ya da Claude Code için.worktreeinclude’a yaz. - Ajan turlarını commit sanmak. Turlar geri alma içindir; kalıcı geçmiş için yine commit at.
Örnek bir gün: üç ajan, iki dal
Bunu bir çalışma günüyle somutlaştıralım.
Sabah: kurulum
Ana klasörde main açık. İki iş var: auth yeniden yapılanması ve bir ayarlar sayfası. İki worktree açarsın:
git worktree add ../acme-web-auth -b auth-refactor
git worktree add ../acme-web-settings -b settings-ui
Her birinde bağımlılıkları kur ve env dosyasını kopyala:
cd ../acme-web-auth && pnpm install && cp ../acme-web/.env .
cd ../acme-web-settings && pnpm install && cp ../acme-web/.env .
Mimar ve Testçi auth-refactor worktree’sinde, Arayüz ajanı settings-ui’da başlar.
Öğlen: bir tur yanlış gidiyor
Arayüz ajanı ayarlar sayfasını düzenlerken ortak bir bileşenin stilini de değiştirir. Bu kapsam dışı. Turlar listesinde son turun değiştirdiği dosyaları görür, turu geri alır ve ajana ortak bileşene dokunmamasını söylersin. Dalın geçmişi temiz kalır; çünkü geri alma bir commit değil, gizli referanstaki görüntüye dönüştür.
Akşam: birleştirme
Auth işi bitince testleri çalıştırır, incelemeye bakar ve dalı gönderirsin. Ayarlar sayfası bitmediyse worktree’si açık kalır ve ajan ertesi gün aynı klasörde devam eder. Uygulamayı kapatıp yeniden açtığında AgentVera, Claude ve Codex ajanlarını CLI geçmişinden aynı konuşmaya geri getirir.
Worktree’lerde dikkat edilecek ortam ayrıntıları
Paralel worktree’lerde en sık takılınan noktalar koddan değil ortamdan çıkar:
- Port çakışmaları: İki worktree’de aynı anda geliştirme sunucusu çalıştırıyorsan ikisinin aynı portu istemesine izin verme. Ortam değişkenleriyle farklı portlar ver.
- Env dosyaları:
.envgibi git’te olmayan dosyalar yeni bir worktree’ye kendiliğinden gelmez; kopyala. - Veritabanı: İki dal farklı migration’lar taşıyorsa tek bir yerel veritabanını paylaşmak sorun çıkarabilir.
- Windows yolları: Derin
node_modulesklasörleri 260 karakter sınırına takılabilir;git config --global core.longpaths trueayarla ve worktree’leri kısa bir kök altında tut. Ayrıntılar Windows’ta kodlama ajanlarını yönetmek yazısında.
AgentVera’nın Portlar paneli dinlenen portları ve her birini hangi ajanın başlattığını gösterir; böylece hangi worktree’nin hangi sunucuyu açtığını takip edebilirsin.
Ajanı kopyalamak ve konuşmayı çatallamak
Bazen aynı problemi iki yoldan denemek istersin. AgentVera’da bir ajanı kopyaladığında aracı, hesabı, modeli, eforu, rolü, grubu ve worktree’si birebir kopyalanır; istersen konuşma geçmişini de çatallayabilirsin (Claude için --fork-session, Codex için fork).
Worktree’lerle birleşince bu güçlü bir deneme düzeni olur: aynı konuşmadan çatallanmış iki ajanı iki worktree’de çalıştır, sonuçları karşılaştır ve beğendiğin dalı birleştir. Diğer dalı silmek deneyi iz bırakmadan temizler.
Kontrol listesi
- Çakışma riski olan her ajanın kendi worktree’si var mı?
- Her worktree’de bağımlılıklar kurulu ve env dosyaları kopyalanmış mı?
- Her geliştirme sunucusunun kendi portu var mı?
- Ajanların rolleri hangi klasörlerde çalışacaklarını söylüyor mu?
- Birleştirmeden önce testler ve inceleme yapıldı mı?
- Biten worktree’leri kaldırıp
git worktree pruneçalıştırdın mı?
Sonuç
Git worktree’ler ajanları fiziksel olarak ayrı tutar, turlar da her ajanın kendi değişikliklerini geri alınabilir kılar. Claude Code ve ajan uygulamaları artık worktree’leri senin için açıyor, ama temel aynı: ajan başına bir ağaç, kendi ortamı ve işi eve getiren bir pull request.
AgentVera worktree’leri, turları ve Git panelini tek pencerede toplar. Bu yazıyı paralel kodlama ajanları yazısıyla birlikte oku ya da ücretsiz planla başla.