Anla Dene

Claude · Gelişmiş · 203 Ölçekle ve otomatikleştir · Konu 5 / 7

4.10 Worktree ve paralel iş

Aynı anda iki iş yürüt, birbirinin dosyasını bozmasın.

Bu sayfada ne öğreneceksin

Kısaca

Aynı klasörde iki Claude oturumu açıp ikisine de dosya düzenlettirirsen birbirinin değişikliğini ezebilirler. Çözüm, her oturuma kendi dosya kopyasını vermek. Git'in bunun için bir özelliği var: worktree (çalışma ağacı). Resmî dokümana göre worktree, ana klasörle aynı depo geçmişini ve uzak adresi paylaşan ama kendi dosyaları ve kendi dalı olan ayrı bir çalışma klasörüdür. Her oturum kendi worktree'sinde çalışınca biri yeni özellik yazarken öteki hata düzeltebilir. Git tarafını 3.10'da görmüştün.

Doküman worktree'nin paralel çalışmanın tek yolu olmadığını da söylüyor. Claude Code'da aynı anda birden çok iş yürütmenin beş yolu sayılıyor: subagent'lar, agent view, agent teams, dinamik workflow'lar ve projeler. Worktree'ler bunlardan biri değil; dosya düzenlemelerini yalıtan destek aracı. Subagent'ları 4.2'de görmüştün.

Bu sayfada yalnız dokümanda anlatılan yolları ve işine en çok yarayacak olanları göreceksin. Birkaç oturumu aynı anda çalıştırmanın kullanım maliyetini çarpacağını doküman açıkça yazıyor; sayıları ve limitleri Costs sayfasından kontrol et.

Adım adım

  1. Projeyi git deposu olarak aç. Worktree'ler git gerektirir. İlk kez çalıştırıyorsan önce o klasörde bir kez claude yazıp güven (trust) iletişim kutusunu kabul et; yoksa --worktree hata verip çıkar.
  2. Worktree'de bir oturum başlat. Dokümana göre --worktree (kısaca -w) bir ad ile yalıtılmış bir worktree oluşturur ve Claude'u içinde başlatır. Varsayılan konum depo kökündeki .claude/worktrees/<ad>/, dal adı worktree-<ad>:
    claude --worktree feature-auth
    Ad vermezsen Claude kendisi bir ad üretir (dokümandaki örnek: bright-running-fox).
  3. İkinci işi başka terminalde, başka adla başlat. Aynı komutu farklı adla ikinci bir terminalde çalıştır; ikinci yalıtılmış oturum açılır.
    claude --worktree bugfix-login
    Doküman, worktree içeriğinin ana klasörde izlenmeyen dosya gibi görünmemesi için .claude/worktrees/ satırını .gitignore'a eklemeni öneriyor.
  4. Ortamı hazırla. Worktree temiz bir kopyadır. Doküman, bağımlılıkları kurmayı Claude'a söylemeni ya da proje kurulumunu worktree klasöründe kendin çalıştırmanı söylüyor. .env gibi git'in izlemediği dosyaları her yeni worktree'ye otomatik kopyalamak için proje köküne .worktreeinclude dosyası koy (.gitignore sözdizimiyle). Yalnız hem eşleşen hem de gitignore'daki dosyalar kopyalanır. Örnek içerik:
    .env
    .env.local
  5. Oturum içinden de isteyebilirsin. Oturumda Claude'a "bir worktree'de çalış" dersen EnterWorktree aracıyla bir tane oluşturur. Bir işi subagent'lara paylaştırıyorsan "agent'ların için worktree kullan" demen yeter; kalıcı yapmak için özel subagent dosyasının üst bilgisine isolation: worktree yazılır. Her subagent geçici bir worktree alır; değişiklik yapmadan biterse Claude Code onu kendiliğinden siler.
  6. Çıkarken ne olduğunu bil. Oturumdan çıkınca Claude Code worktree'de kaybolacak iş olup olmadığına bakar. Temizse ve oturumun adı yoksa worktree ve dalı silinir (adlı oturumda önce sorar). İş varsa tut ya da sil diye sorar; silmek klasörü, dalı ve içindeki tüm işi siler. Tutarsan sonra dönmek için Claude Code'un çıkışta yazdığı claude --worktree <ad> --resume komutunu kullanırsın. -p ile çalıştırdığın etkileşimsiz oturumlarda çıkış sorusu yoktur ve worktree otomatik temizlenmez.
  7. Gerekirse worktree'yi git ile kendin yönet. Belirli bir mevcut daldan başlamak ya da klasörü depo dışına koymak için doküman şu komutları veriyor (dal ve yol adları kurgusal):
    git worktree add ../project-feature-a -b feature-a
    git worktree list
    git worktree remove ../project-feature-a
  8. Çok oturumu tek ekrandan yönet (agent view). Terminalde claude agents yazarsan tüm arka plan oturumların tek ekranda listelenir: hangisi çalışıyor, hangisi senden girdi bekliyor, hangisi bitti. Alttaki kutuya bir görev yazıp Enter'a basınca yeni bir arka plan oturumu başlar; her yeni istem ayrı bir oturumdur. Bir satırda Space son çıktıyı (peek) gösterir ve yanıt yazabilirsin; Enter ya da → oturuma girer, boş istemde ← tabloya döndürür. Açık bir oturumu arka plana almak için içinde /bg yazarsın. Agent view araştırma önizlemesindedir (research preview); arayüz ve kısayollar değişebilir. Agent view'dan başlattığın oturum, git deposundaysa, dosya düzenlemeden önce kendiliğinden .claude/worktrees/ altında yalıtılmış bir worktree'ye geçer (dokümandaki istisnalar var, örneğin zaten bir worktree'nin içindeysen geçmez).

Hangisini ne zaman seçmeli

Doküman beş yolu şöyle karşılaştırıyor (özetledim):

YolNe verirNe zaman
Subagent'larTek oturumun içinde, kendi bağlamında yan iş yapıp özet döndüren yardımcılarYan iş ana konuşmanı arama sonuçları ve log'larla doldururdu
Agent view (claude agents)Arka plan oturumlarını tek ekrandan başlat ve izle. Araştırma önizlemesiBirbirinden bağımsız birkaç görev var, devredip arada bakmak istiyorsun
Agent teamsOrtak görev listesi ve mesajlaşmayla birlikte çalışan oturumlar, bir lider yönetir. Deneysel, varsayılan olarak kapalıClaude'un bir projeyi parçalara bölüp dağıtmasını ve çalışanları eşgüdümde tutmasını istiyorsun
Dinamik workflow'larÇok sayıda subagent çalıştıran ve sonuçları çapraz doğrulayan bir betikİş birkaç subagent'ı aşıyor (ör. kod tabanı genelinde denetim)
Projelerclaude.ai/code ya da masaüstü uygulamasında tek sohbetten başlayan paralel oturumlar (Pro, Max ve Ultra planlarında genel beta)İş günlerce sürüyor ve makinen kapalıyken de ilerlemeli

Agent teams'i kullanmak istersen dokümana göre CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 ayarı gerekir; bu ayar olmadan takım kurulmaz. Dokümanın tavsiyesi, önce daha hafif bir seçeneğin işi görüp görmediğine bakmak: subagent'lar tek oturumda çalışır, oturum arası mesajlaşma ise kendi çalıştırdığın oturumlar arasında bulgu taşır.

Oturumlar arası mesajlaşmada Claude, açık oturumlarını listeleyip birine mesaj gönderebilir. Dokümanın örneği: iki oturum aynı depoda ayrı worktree'lerde çalışıyorsa biri değişikliğini öbürüne bildirebilir. Mesaj yalnız yazılı bir metindir; konuşma geçmişi ya da dosya taşımaz.

Çalışan işi nereden göreceğin de farklı: arka plan oturumları için claude agents, o anki oturumun arka planındakiler için /tasks, workflow'lar için /workflows. Doküman, oturum içindeki /agents komutunun claude agents ile adı benzer olsa da ayrı bir şey olduğunu özellikle belirtiyor.

Çakışma riski ve yapılacaklar

Hazır prompt

Bir oturumun içindeyken işi yalıtmak için (köşeli parantezleri doldur):

Bu işi ayrı bir worktree'de yap: [görevi bir iki cümleyle anlat]. Bitince değişiklikleri commit et ve hangi dalda olduklarını söyle. Ana klasördeki dosyalara dokunma.

Üç bağımsız işi subagent'lara paylaştırmak için dokümandaki "agent'ların için worktree kullan" ifadesine dayanan istem:

Şu üç işi birbirinden bağımsız subagent'larla yap ve agent'ların için worktree kullan: 1) [birinci iş], 2) [ikinci iş], 3) [üçüncü iş]. Her biri bitince ne değiştirdiğini ve testlerin sonucunu özetle. İki iş aynı dosyaya dokunacaksa bana önce haber ver.

Claude yanılabilir. Bitince git worktree list ve git status ile gerçekten ne olduğuna kendin bak.

Sık yapılan hata

Video

Video: yakında.

Kaynak

Son doğrulama: 2026-11-12

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik