Nethür
Giriş yap
macOS yakında

Blog · 3 Kasım 2026

Birden fazla Claude Code ajanı paralel nasıl çalıştırılır

Paralel Claude Code oturumları için pratik bir rehber: tek bir checkout neden direnir, git worktree bunu nasıl çözer ve birden fazla ajanı nasıl incelenebilir tutarsınız.

Yan yana çalışan birkaç ajan oturumuyla Nethür çalışma alanı

Bir Claude Code oturumu tek bir checkout içinde tek iş parçacığı gibi çalışır: başlattığınız dizindeki dosyaları okur ve yazar. Birden fazla Claude Code ajanını paralel çalıştırmak için her birine kendi git worktree’sini — kendi branch’inde ayrı bir checkout — verin ve her birinde bir Claude Code örneği başlatın. Nethür gibi yönetilen araçlar worktree, terminal ve inceleme defter tutma işlerini otomatikleştirir.

Tek bir Claude Code oturumu etkileyicidir — ta ki aynı anda üç değişikliğe ihtiyaç duyana kadar. Refleks olarak aynı repoda üç terminal sekmesi açarsınız. Birkaç dakika boyunca sorunsuz görünür; sonra iki ajan aynı dosyayı düzenler, biri diğerinin altından branch değiştirir ve test çalıştırmanız artık var olmayan bir checkout’u okumaya başlar.

Paralel ajanlar bir prompt sorunu değildir. Bir dosya sistemi sorunudur. Claude Code işini sıradan dosyalar üzerinden yapar, bu yüzden iki oturumun aynı branch’i veya index’i paylaşmayan iki çalışma dizinine ihtiyacı vardır. Birkaç Claude Code örneği başlatmak kolaydır; asıl tasarım kararı gerektiren kısım, birbirlerinin üzerine basmalarını engellemektir.

Terminal sekmeleri neden paralel iş değildir

Bir git reposunda her çalışma ağacı için tek bir checkout edilmiş branch vardır. O ağaçta iki Claude Code oturumu açın; her şeyi paylaşırlar: aynı dosyalar, aynı index, aynı node_modules, aynı dev server portu. Terminaller bağımsız olduğu için oturumlar bağımsız görünür, ama altındaki çalışma ağacı tektir.

  • Bir ajan git switch veya git rebase çalıştırır, diğer ajan eski dosyaları düzenlemeye devam eder.
  • İki ajan aynı dosyayı yazar; son kaydeden kazanır ve ilk değişiklik çalışma ağacından kaybolur.
  • Bir test watcher’ı, dev server veya migration, o saniyede hangi branch checkout edilmişse ona karşı çalışır.
  • Sonucu incelemek tahmine döner çünkü diff aynı anda her oturumdan iş içerir.

Sekmeler salt okunur keşif, log takibi veya hızlı bir soru için hâlâ kullanışlıdır. Bir ajanın dosyaları düzenlemesi ve test çalıştırması gerektiği anda kullanışlılıklarını yitirirler.

Paralel oturumlar için üç pratik yol

Değerlendirmeye değer üç seçenek var. Size ne kadar izolasyon verdikleri ve ne kadar defter tutma işini size bıraktıkları konusunda ayrılırlar.

  1. Tek bir checkout’ta terminal sekmeleri — başlaması hızlı, eşzamanlı düzenlemeler için güvensiz.
  2. Elle git worktree’ler ve her worktree için bir Claude Code örneği — gerçek izolasyon, ama yolları, bağımlılıkları ve temizliği siz yönetirsiniz.
  3. Nethür gibi worktree’leri oluşturup takip eden, her birinde bir ajan çalıştıran ve diff’leri ile oturumları tek yerde toplayan bir çalışma alanı.

Seçenek 1: git worktree’leri kendiniz oluşturun

Bir git worktree, aynı reponun kendi branch’inde ve kendi dizininde ikinci bir checkout’udur. Git nesne veritabanını paylaştığı için kopya ucuzdur; buna karşılık checkout edilen dosyalar ve index birbirinden bağımsızdır.

git fetch origin
git worktree add ../shop-fix-login -b fix/login origin/main
git worktree add ../shop-fix-billing -b fix/billing origin/main

cd ../shop-fix-login && claude
# second terminal
cd ../shop-fix-billing && claude

Artık her Claude Code örneği farklı bir dizin ve farklı bir branch görür. Birine login yarışını düzeltmesini, diğerine billing’i yeniden yazmasını söyleyebilirsiniz; hiçbiri diğerinin dosyalarının üzerine yazamaz. Böylece bir oturumun yaptığı değişiklik diğerinin çalışma ağacına karışmaz.

İşin püf noktası, yeni bir checkout’ta olmayan her şey. Bağımlılıklar yok, .env dosyaları yok ve iki oturum da aynı portu bağlamaya çalışabilir. Ya her worktree’de yeniden kurulum yaparsınız ya da ağır, gitignore’lanmış dizinleri paylaşırsınız. Nethür aynı sorunu ve kendi yanıtlarını worktree rehberinde belgeliyor: paylaşılan yollar, nethur.yaml girdileri, .worktreeinclude ve setup hook’ları.

Seçenek 2: Claude Code’un kendi paralel çalışma yollarını kullanın

Claude Code’un kendisi birden fazla iş akışı çalıştırmanın yollarını eklemeye devam ediyor. Masaüstü uygulaması izole git worktree’lerde paralel oturumlar çalıştırabiliyor; subagent’lar ve ajan ekipleri bir oturumun işin parçalarını devretmesine izin veriyor. Tamamen Anthropic’in ürünü içinde yaşıyor ve tek başınıza çalışıyorsanız bu yeterli olabilir.

Bu olanaklar hâlâ Claude ile sınırlı. Claude Code, Codex ve diğer CLI ajanlarının yan yana çalıştığı tek bir çalışma alanı vermezler ve ekip arkadaşlarına birbirlerinin oturumlarını görüp devralabileceği ortak bir yer sağlamazlar. Paralel işiniz ajanlar, makineler veya insanlar arasında geçiyorsa ajanın üstünde bir katmana ihtiyacınız var.

Seçenek 3: worktree’leri sizin için çalıştıran bir çalışma alanı

Nethür bir görevin sekme değil, bir çalışma alanı aldığı fikri üzerine kurulu. Her worktree kendi branch’i, dosyaları, terminalleri, editör sekmeleri ve tarayıcı sekmeleriyle gerçek bir git worktree’dir. Oluşturmak kısa bir diyalogdur ve git işi arka planda halleder.

  1. Nethür’ü kurun ve repoyu ekleyin. Bir ekip için işi barındıracak makineyi seçin — dizüstü bilgisayarınız, bir ekip arkadaşınızın makinesi, bir VPS veya bir SSH hedefi.
  2. Her paralel görev için bir worktree oluşturun. Görevi adlandırın, başlangıç ref’ini seçin (genellikle origin/main) ve varsa bir GitHub, GitLab, Linear veya Jira öğesi bağlayın.
  3. Her worktree içinde ajan seçiciyi açıp Claude Code’u başlatın. Nethür onu o worktree çalışma dizini olacak şekilde başlatır, böylece iki oturum çakışamaz.
  4. Ajanlar çalışırken panelleri bölün veya worktree’ler arasında geçiş yapın. Kenar çubuğu hangi oturumların çalıştığını, beklediğini veya bittiğini gösterir.
  5. Her diff’i kendi başlangıç ref’ine göre inceleyin. Kazananı tutun, commit’leyip push’layın, pull request’i o worktree’den açın, sonra kaybeden worktree’leri ve branch’lerini silin.

Önemli fark, worktree oluşturan düğme değil. Önemli olan worktree, ajan oturumu, diff ve temizliğin aynı göreve bağlı kalması. Paralel ajanlar tarifi aynı akışı ekran görüntüleri ve üç ajanlı bir örnekle anlatıyor.

Hangi yaklaşım işinize uygun?

YaklaşımDosya izolasyonuKurulumİncelemeEkip
Tek checkout’ta sekmelerYok — paylaşılan dosyalar ve branchAnındaKarışık diff, elle ayıklamaOrtak görünüm yok
Elle git worktree’lerTam — her worktree için bir branchGit komutları, bağımlılıklar, env dosyalarıDizin başına bir diff, elleYollar sohbette paylaşılır
Claude Code masaüstüClaude oturumları için tamKur ve giriş yapClaude için yerleşik incelemeTek kullanıcılı yüzey
NethürTam — git worktree veya klasör çalışma alanıRepo ekle, worktree oluşturWorktree başına diff, notlar, PR akışıPaylaşılan projeler, sohbet, devralmalar

Paralelliği iyi kullanan dört kalıp

  • Aynı görev, üç ajan. Aynı prompt’u Claude Code, Codex ve başka bir CLI’a üç worktree’de verin. Sırayla yeniden denemek yerine diff’leri karşılaştırın; anlaşmazlık genellikle zor kısmı işaret eder.
  • Sorumluluk alanlarına göre bölün. Bir ajan API değişikliğine, biri arayüze, biri testleri yazmaya sahip olsun. Bağlam görünür kalsın diye aynı issue’yu her worktree’ye bağlayın.
  • Uygula ve incele. Bir ajan değişikliği yaparken ikincisi ayrı bir worktree’de diff’i okuyup regresyon arasın. Son karar sizde kalır.
  • Keşfet ve yayınla. Uzun süren bir araştırma oturumunu bir worktree’de, temiz bir uygulama oturumunu başka bir worktree’de tutun. Araştırma ajanı merge etmek üzere olduğunuz branch’i asla kirletmez.

Planlamanız gereken tuzaklar

  • Bağımlılıklar ve yerel gizli değerler. Yeni bir worktree temiz bir checkout’tur. node_modules ve cache’leri paylaşın, .env dosyalarını .worktreeinclude ile kopyalayın veya oluşturmadan sonra bir setup hook çalıştırın.
  • Portlar ve veritabanları. 3000 üzerinde iki dev server çakışır. Her worktree’ye kendi portunu, mümkünse kendi veritabanını veya şemasını verin.
  • Üretilen dosyalar ve migration’lar. Araç seti bunun için tasarlanmadıysa aynı veritabanına iki migration çalıştırmayın.
  • Token bütçesi. Paralellik kullanımı katlar. İki veya üç oturumla başlayın, kullanım göstergelerini izleyin ve yalnızca bekleyen oturumları durdurun.
  • Temizlik borcu. Her worktree bir branch’tir. Kazananı seçer seçmez kaybedenleri silin, yoksa repo terk edilmiş deneylerle dolar.

İnsanlar işin içine girince paralel iş zorlaşır

İki geliştirici aynı projede ajan çalıştırmaya başladığı anda dosya sistemi sorunu bir koordinasyon sorununa dönüşür. Hangi worktree hangi branch’te? Kim hangi incelemeyi bekliyor? Yazar çevrimdışı olduğunda bir başkası oturumu devralabilir mi?

Nethür bunu paylaşılan projeler ve bir ekip sunucusuyla çözer: herkes aynı çalışma alanına bağlanır, aktif oturumları görür, işin yanında birbirini @mention’lar ve bir transcript kopyalamaya gerek kalmadan oturumu devralabilir. Herkes yine kendi Claude aboneliğiyle giriş yapar; döndürmeniz gereken ortak bir key yoktur. Ekip rehberi kurulumu anlatıyor.

İki worktree ile başlayın

Normalde iki sıralı Claude Code çalıştırması gerektirecek bir görev seçin. Aynı ref’ten iki worktree oluşturun, iki ajana aynı prompt’u verin ve ne döndüğünü karşılaştırın. Bu tek deney size paralel iş hakkında herhangi bir benchmark’tan fazlasını anlatır: izolasyonun faydasını, bağımlılık sürtünmesini ve inceleme maliyetini kendi reponuzda görürsünüz.

İşe yaradığında kazanan branch’i tutun ve diğer worktree’yi silin. Sonra temiz biçimde ikiye ayrılan bir görevle tekrar yapın. Paralel ajanlar bir alışkanlıktır, bir düğme değil.

Rehberi işe koşun.

Nethür’ü indirin ve ilk paralel ajanınızı dakikalar içinde çalıştırın; ya da zaten sahip olduğunuz bir makinede ekip çalışma alanı kurun.