# Paralel yapay zeka ajanları için git worktree (2026 rehberi)

Adres: https://agentvera.dev/blog/git-worktree-paralel-gelistirme/ · Yayın: 2026-09-28 · Güncelleme: 2026-11-03

Paralel yapay zeka ajanları için git worktree: ajan başına bir çalışma ağacı, komutlar, Claude Code’un --worktree özelliği, env dosyaları, portlar ve tur geri alma.

**Kısaca:**

- Git worktree aynı deponun başka bir dalını ortak geçmişle kendi klasöründe açar; aynı dosyalara dokunabilecek her ajana kendi worktree’sini ver.
- Claude Code artık worktree’yi kendisi açıyor: claude --worktree <ad> .claude/worktrees/ altında çalışır, bir .worktreeinclude dosyası da .env ve diğer izlenmeyen dosyaları içeri kopyalar.
- Her worktree’nin kendi bağımlılıkları, kendi izlenmeyen env dosyaları ve kendi geliştirme sunucusu portu olmalı; git worktree remove ve prune ile temizle.
- Bizim geliştirdiğimiz AgentVera her turda klasörün görüntüsünü gizli bir git referansına alır ve ajan başına son 60’ı saklar; tek bir tur dala, index’e ve stash’e dokunmadan geri alınır.

**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](/sozluk/git-worktree/ "Git worktree nedir?"), 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:

```bash
git worktree add ../acme-web-auth -b auth-refactor
```

Var olan bir daldan worktree açmak:

```bash
git worktree add ../acme-web-billing billing-v2
```

Worktree’leri listelemek, kilitlemek ve kaldırmak:

```bash
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ı](/blog/paralel-kodlama-ajanlari/ "Paralel kodlama ajanları: Claude Code ve Codex birlikte") 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.baseRef` değerini `"head"` yap.
- Proje kökündeki, `.gitignore` söz dizimiyle yazılmış bir `.worktreeinclude` dosyası `.env` ya da `.env.local` gibi 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: worktree` yazı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ı](/blog/paralel-yapay-zeka-kodlama-ajani-araclari/ "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ı](/sozluk/ajan-tabanli-gelistirme-ortami/ "Ajan tabanlı geliştirme ortamı nedir?") 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:

1. Yeni ya da var olan bir daldan worktree oluşturmak.
2. 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.
3. Ajanı doğrudan bir worktree’de başlatmak.
4. 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ı](/ozellikler/turlar-ve-oturum-tekrari/ "Turlar ve oturum tekrarı") 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](/blog/yapay-zeka-kod-incelemesi/ "Yapay zeka kod incelemesi: ajan çıktısını denetle") bunu hızlandırır.
- Commit mesajlarını toparla. AgentVera’nın [Git paneli](/ozellikler/git-ve-github/ "Git ve GitHub") 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 prune` ile temizle.
- **node_modules’u unutmak.** Her worktree kendi bağımlılıklarının kurulmasını ister.
- **İzlenmeyen dosyaları unutmak.** `.env` ve 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:

```bash
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:

```bash
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ı:** `.env` gibi 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_modules` klasörleri 260 karakter sınırına takılabilir; `git config --global core.longpaths true` ayarla ve worktree’leri kısa bir kök altında tut. Ayrıntılar [Windows’ta kodlama ajanlarını yönetmek](/blog/windowsta-kodlama-ajanlari/ "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ı](/blog/paralel-kodlama-ajanlari/ "Paralel kodlama ajanları") yazısıyla birlikte oku ya da [ücretsiz planla başla](/ "AgentVera").

## Sık sorulanlar

**Git worktree nedir?** Aynı deponun farklı dallarını aynı anda ayrı klasörlerde açmanı sağlayan bir git özelliğidir. Her klasörün kendi çalışma dosyaları vardır; depo geçmişi ortaktır.

**Worktree ile klon arasındaki fark nedir?** Klon deponun tam bir kopyasıdır. Worktree aynı .git verisini paylaşır, daha az yer kaplar ve bir worktree’de atılan commit diğerlerinden anında görünür.

**Claude Code worktree’yi kendisi açar mı?** Evet. claude --worktree <ad> (ya da -w), .claude/worktrees/<ad>/ altında worktree-<ad> adlı yeni bir dalda worktree açar ve oturumu orada başlatır. Bir .worktreeinclude dosyası .env gibi gitignore’daki dosyaları içine kopyalar.

**Codex worktree destekliyor mu?** OpenAI’ın ChatGPT masaüstü uygulaması Codex sohbetlerini paralel, 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 ile worktree’leri git ile kendin açarsın.

**Ajanın bir turunu nasıl geri alırım?** AgentVera’da her turun başında çalışma klasörünün görüntüsü gizli bir git referansına alınır. Seçenekler → Turlar’dan bir turun değiştirdiği dosyaları görür ve turu geri alırsın; dalına, index’ine ve stash’ine dokunulmaz.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz plan aynı anda 2 ajan çalıştırır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/
