Agent Teams beta

Agent Teams beta – Claude Code ile Paralel Çalışan Ekipler

Claude Code, birden fazla Claude Code oturumunu bir ekip halinde koordine etmenize olanak tanıyan Agent Teams özelliğini beta olarak sunuyor. Bu özellik sayesinde bir oturum ekip lideri (team lead) olarak çalışır, görevleri atar ve sonuçları sentezlerken, ekip arkadaşları (teammates) kendi bağlam pencerelerinde (context window) bağımsız olarak çalışır ve birbirleriyle doğrudan iletişim kurabilir.

Not: Agent Teams deneyseldir ve varsayılan olarak devre dışıdır. Etkinleştirmek için CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ortam değişkenini settings.json veya ortamınıza eklemeniz gerekir. Bilinen sınırlamaları vardır (oturum devam ettirme, görev koordinasyonu ve kapanma davranışı ile ilgili).

Agent Teams, Claude Code v2.1.32 veya daha yenisini gerektirir. Sürümünüzü claude --version ile kontrol edebilirsiniz.

Agent Teams ne zaman kullanılmalı (When to use agent teams)

Agent Teams, paralel keşif çalışmasının gerçek değer kattığı görevler için en etkilidir. En güçlü kullanım alanları:

• Araştırma ve inceleme (Research and review): Birden fazla ekip arkadaşı bir problemin farklı yönlerini eşzamanlı olarak araştırabilir, bulgularını paylaşabilir ve birbirlerinin sonuçlarını sorgulayabilir.
• Yeni modüller veya özellikler: Her ekip arkadaşı birbirine karışmadan kendi parçasını üstlenebilir.
• Rekabet eden hipotezlerle hata ayıklama: Ekip arkadaşları farklı teorileri paralel olarak test eder ve daha hızlı sonuca ulaşır.
• Katmanlar arası koordinasyon: Frontend, backend ve testleri kapsayan değişiklikler, her biri farklı bir ekip arkadaşına atanabilir.

Agent Teams, koordinasyon yükü getirir ve tek bir oturuma kıyasla önemli ölçüde daha fazla token kullanır. Sıralı görevler, aynı dosyada düzenleme yapılması gereken işler veya çok sayıda bağımlılığı olan çalışmalar için tek bir oturum veya subagent'lar daha etkilidir.

Subagent'lar ile karşılaştırma (Compare with subagents)

Hem Agent Teams hem de subagent'lar işi paralelleştirmenize olanak tanır, ancak farklı şekilde çalışırlar. Seçim, çalışanların birbirleriyle iletişim kurması gerekip gerekmediğine bağlıdır:

Hızlı, odaklı çalışanlar ve raporlama için subagent'ları kullanın. Ekip arkadaşlarının bulguları paylaşması, birbirini sorgulaması ve kendi kendine koordine olması gerektiğinde Agent Teams'i kullanın.

Agent Teams'i etkinleştirme (Enable agent teams)

Agent Teams varsayılan olarak devre dışıdır. Etkinleştirmek için CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ortam değişkenini 1 olarak ayarlayın. Bunu shell ortamınızda veya settings.json dosyasında yapabilirsiniz:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

İlk Agent Team'inizi başlatma (Start your first agent team)

Agent Teams'i etkinleştirdikten sonra, Claude'a bir agent team oluşturmasını söyleyin ve görevi ile istediğiniz ekip yapısını doğal dilde tanımlayın. Claude ekibi oluşturur, ekip arkadaşlarını başlatır ve çalışmayı koordine eder.

Örnek bir prompt:

"I'm designing a CLI tool that helps developers track TODO comments across their codebase. Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate."

Claude, paylaşılan bir görev listesi oluşturur, her bakış açısı için ekip arkadaşları başlatır, problemi keşfetmelerini sağlar, bulguları sentezler ve iş bittiğinde ekibi temizlemeye çalışır.

Liderin terminali tüm ekip arkadaşlarını ve ne üzerinde çalıştıklarını listeler. Shift+Down kısayolunu kullanarak ekip arkadaşları arasında geçiş yapabilir ve onlara doğrudan mesaj gönderebilirsiniz. Son ekip arkadaşından sonra Shift+Down sizi lidere geri döndürür.

Agent Team'inizi kontrol etme (Control your agent team)

Lidere doğal dilde ne istediğinizi söyleyin. Lider, talimatlarınıza göre ekip koordinasyonu, görev ataması ve delegasyonu yönetir.

Görüntüleme modu seçme (Choose a display mode)

Agent Teams iki görüntüleme modunu destekler:

• In-process: Tüm ekip arkadaşları ana terminaliniz içinde çalışır. Shift+Down ile ekip arkadaşları arasında geçiş yapın ve doğrudan mesaj yazın. Herhangi bir terminalde çalışır, ek kurulum gerektirmez.
• Split panes: Her ekip arkadaşı kendi panosunu alır. Tüm çıktıyı aynı anda görebilir ve bir panoya tıklayarak doğrudan etkileşime geçebilirsiniz. tmux veya iTerm2 gerektirir. tmux'un bazı işletim sistemlerinde bilinen sınırlamaları vardır ve geleneksel olarak en iyi macOS'te çalışır. iTerm2'de tmux -CC kullanmak, tmux'a giriş için önerilen yöntemdir.

Varsayılan mod "auto"dur. Zaten bir tmux oturumu içinde çalışıyorsanız split panes kullanır, aksi halde in-process kullanır. "tmux" ayarı split-pane modunu etkinleştirir ve terminalinize göre tmux veya iTerm2 kullanıp kullanmayacağını otomatik olarak algılar.

Ayarları geçersiz kılmak için ~/.claude/settings.json dosyasında teammateMode değerini ayarlayın:

{
  "teammateMode": "in-process"
}

Tek bir oturum için in-process modunu zorlamak amacıyla flag olarak da kullanabilirsiniz:

claude --teammate-mode in-process

Split-pane modu için tmux veya iTerm2 ile birlikte it2 CLI gereklidir. tmux'u sistem paket yöneticinizle kurabilirsiniz. iTerm2 için it2 CLI'yi kurun ve iTerm2 → Settings → General → Magic → Enable Python API seçeneğini etkinleştirin.

Ekip arkadaşlarını ve modelleri belirleme (Specify teammates and models)

Claude, görevinize göre kaç ekip arkadaşı başlatacağına karar verir veya tam olarak ne istediğinizi belirtebilirsiniz:

"Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate."

Ekip arkadaşları, liderin /model seçimini varsayılan olarak devralmaz. Prompt'ta model belirtilmediğinde kullanılacak modeli değiştirmek için /config içinde Default teammate model ayarını yapın. Default (leader's model) seçeneğini işaretleyerek ekip arkadaşlarının liderin mevcut modelini takip etmesini sağlayabilirsiniz.

Ekip arkadaşları için plan onayı gerektirme (Require plan approval for teammates)

Karmaşık veya riskli görevler için ekip arkadaşlarının uygulamaya geçmeden önce plan yapmasını isteyebilirsiniz. Ekip arkadaşı, lider planı onaylayana kadar salt okunur plan modunda çalışır:

"Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes."

Bir ekip arkadaşı planlamayı bitirdiğinde, lidere bir plan onay talebi gönderir. Lider planı inceler ve onaylar veya geri bildirimle reddeder. Reddedilirse ekip arkadaşı plan modunda kalır, geri bildirime göre revize eder ve yeniden gönderir. Onaylandıktan sonra plan modundan çıkar ve uygulamaya başlar.

Lider onay kararlarını otonom olarak verir. Liderin kararını etkilemek için prompt'unuza kriterler ekleyin: "yalnızca test kapsamı içeren planları onayla" veya "veritabanı şemasını değiştiren planları reddet" gibi.

Ekip arkadaşlarıyla doğrudan konuşma (Talk to teammates directly)

Her ekip arkadaşı tam, bağımsız bir Claude Code oturumudur. Herhangi bir ekip arkadaşına doğrudan mesaj göndererek ek talimatlar verebilir, takip soruları sorabilir veya yaklaşımlarını değiştirebilirsiniz.

• In-process modu: Shift+Down ile ekip arkadaşları arasında geçiş yapın, ardından mesaj göndermek için yazın. Enter ile bir ekip arkadaşının oturumunu görüntüleyin, Escape ile mevcut turunu kesintiye uğratın. Ctrl+T ile görev listesini açıp kapatın.
• Split-pane modu: Bir ekip arkadaşının panosuna tıklayarak oturumuyla doğrudan etkileşime geçin. Her ekip arkadaşının kendi terminalinin tam görünümü vardır.

Görev atama ve sahiplenme (Assign and claim tasks)

Paylaşılan görev listesi, ekip genelinde çalışmayı koordine eder. Lider görevleri oluşturur ve ekip arkadaşları bunlar üzerinde çalışır. Görevlerin üç durumu vardır: bekleyen (pending), devam eden (in progress) ve tamamlanan (completed). Görevler ayrıca diğer görevlere bağımlı olabilir: çözülmemiş bağımlılıkları olan bekleyen bir görev, bu bağımlılıklar tamamlanana kadar sahiplenilemez.

Lider görevleri açıkça atayabilir veya ekip arkadaşları kendi kendine sahiplenebilir:

• Lider atar: Lidere hangi görevi hangi ekip arkadaşına vereceğini söyleyin.
• Kendi kendine sahiplenme: Bir görevi bitirdikten sonra ekip arkadaşı, sıradaki atanmamış ve engellenmemiş görevi kendi başına alır.

Görev sahiplenme, birden fazla ekip arkadaşı aynı görevi aynı anda sahiplenmeye çalıştığında yarış koşullarını önlemek için dosya kilitleme kullanır.

Ekip arkadaşlarını kapatma (Shut down teammates)

Bir ekip arkadaşının oturumunu nazikçe sonlandırmak için:

"Ask the researcher teammate to shut down"

Lider bir kapanma talebi gönderir. Ekip arkadaşı onaylayarak nazikçe çıkabilir veya bir açıklama ile reddedebilir.

Ekibi temizleme (Clean up the team)

İşiniz bittiğinde liderden ekibi temizlemesini isteyin:

"Clean up the team"

Bu, paylaşılan ekip kaynaklarını kaldırır. Lider temizlik yaparken aktif ekip arkadaşlarını kontrol eder ve eğer hala çalışan varsa başarısız olur, bu nedenle önce onları kapatın. Temizliği her zaman lider kullanarak yapın. Ekip arkadaşları temizlik yapmamalıdır çünkü ekip bağlamları doğru çözümlenmeyebilir ve kaynakları tutarsız bir durumda bırakabilir.

Hook'lar ile kalite kapılarını zorunlu kılma (Enforce quality gates with hooks)

Ekip arkadaşları işi bitirdiğinde veya görevler oluşturulup tamamlandığında kuralları zorunlu kılmak için hook'ları kullanın:

• TeammateIdle: Bir ekip arkadaşı boşta kalmak üzereyken çalışır. Çıkış kodu 2 ile çıkarsa geri bildirim gönderir ve ekip arkadaşının çalışmaya devam etmesini sağlar.
• TaskCreated: Bir görev oluşturulurken çalışır. Çıkış kodu 2 ile çıkarsa oluşturmayı engeller ve geri bildirim gönderir.
• TaskCompleted: Bir görev tamamlandı olarak işaretlenirken çalışır. Çıkış kodu 2 ile çıkarsa tamamlamayı engeller ve geri bildirim gönderir.

Agent Teams nasıl çalışır (How agent teams work)

Claude Agent Teams'i nasıl başlatır (How Claude starts agent teams)

Agent Teams'in başlatılmasının iki yolu vardır:

1. Siz bir ekip talep edersiniz: Claude'a paralel çalışmadan fayda sağlayacak bir görev verin ve açıkça bir agent team isteyin. Claude, talimatlarınıza göre bir ekip oluşturur.
2. Claude bir ekip önerir: Claude, görevinizin paralel çalışmadan fayda sağlayacağını belirlerse bir ekip oluşturmayı önerebilir. Devam etmeden önce siz onaylarsınız.

Her iki durumda da kontrol sizdedir. Claude, onayınız olmadan bir ekip oluşturmaz.

Mimari (Architecture)

Bir agent team şu bileşenlerden oluşur:

Ekip arkadaşı mesajları lidere otomatik olarak ulaşır. Sistem, görev bağımlılıklarını otomatik olarak yönetir. Bir ekip arkadaşı, diğer görevlerin bağımlı olduğu bir görevi tamamladığında, engellenen görevler manuel müdahale olmadan açılır.

Ekipler ve görevler yerel olarak depolanır:

• Ekip yapılandırması: ~/.claude/teams/{team-name}/config.json
• Görev listesi: ~/.claude/tasks/{team-name}/

Claude Code, bir ekip oluşturduğunuzda bunları otomatik olarak oluşturur ve ekip arkadaşları katıldıkça, boşta kaldıkça veya ayrıldıkça günceller. Ekip yapılandırması, oturum kimlikleri ve tmux panel kimlikleri gibi çalışma zamanı durumunu tutar, bu nedenle elle düzenlemeyin veya önceden yetkilendirmeyin: değişiklikleriniz bir sonraki durum güncellemesinde üzerine yazılır. Yeniden kullanılabilir ekip arkadaşı rolleri tanımlamak için bunun yerine subagent tanımlarını kullanın.

Ekip yapılandırması, her ekip arkadaşının adını, ajan kimliğini ve ajan türünü içeren bir members dizisi içerir. Ekip arkadaşları, diğer ekip üyelerini keşfetmek için bu dosyayı okuyabilir. Proje düzeyinde bir ekip yapılandırması eşdeğeri yoktur. Proje dizininizdeki .claude/teams/teams.json gibi bir dosya yapılandırma olarak tanınmaz; Claude bunu sıradan bir dosya olarak ele alır.

Ekip arkadaşları için subagent tanımlarını kullanma (Use subagent definitions for teammates)

Bir ekip arkadaşı başlatırken, herhangi bir subagent kapsamından (proje, kullanıcı, eklenti veya CLI tanımlı) bir subagent türüne başvurabilirsiniz. Bu, bir rolü (örneğin security-reviewer veya test-runner) bir kez tanımlamanıza ve hem devredilen subagent hem de agent team ekip arkadaşı olarak yeniden kullanmanıza olanak tanır.

Bir subagent tanımını kullanmak için, Claude'dan ekip arkadaşını başlatmasını isterken adını belirtin:

"Spawn a teammate using the security-reviewer agent type to audit the auth module."

Ekip arkadaşı, bu tanımın araç izin listesini (tools allowlist) ve modelini onurlandırır ve tanımın gövdesi, ekip arkadaşının sistem prompt'una ek talimatlar olarak eklenir (değiştirmez). SendMessage ve görev yönetimi araçları gibi ekip koordinasyon araçları, tools diğer araçları kısıtlasa bile bir ekip arkadaşı için her zaman kullanılabilir.

Bir subagent tanımındaki skills ve mcpServers frontmatter alanları, bu tanım bir ekip arkadaşı olarak çalıştırıldığında uygulanmaz. Ekip arkadaşları, normal bir oturumla aynı şekilde, proje ve kullanıcı ayarlarınızdan skill'leri ve MCP sunucularını yükler.

İzinler (Permissions)

Ekip arkadaşları, liderin izin ayarlarıyla başlar. Lider --dangerously-skip-permissions ile çalışıyorsa, tüm ekip arkadaşları da öyle yapar. Başlatıldıktan sonra bireysel ekip arkadaşı modlarını değiştirebilirsiniz, ancak başlatma sırasında ekip arkadaşı başına mod ayarlayamazsınız.

Bağlam ve iletişim (Context and communication)

Her ekip arkadaşının kendi bağlam penceresi vardır. Başlatıldığında, ekip arkadaşı normal bir oturumla aynı proje bağlamını yükler: CLAUDE.md, MCP sunucuları ve skill'ler. Ayrıca liderden başlatma prompt'unu alır. Liderin konuşma geçmişi aktarılmaz.

Ekip arkadaşlarının bilgi paylaşma yöntemleri:

• Otomatik mesaj teslimi: Ekip arkadaşları mesaj gönderdiğinde, alıcılara otomatik olarak teslim edilir. Liderin güncellemeleri yoklaması gerekmez.
• Boşta kalma bildirimleri: Bir ekip arkadaşı işi bitirip durduğunda, lidere otomatik olarak bildirim gönderir.
• Paylaşılan görev listesi: Tüm ajanlar görev durumunu görebilir ve mevcut işi sahiplenebilir.
• Ekip arkadaşı mesajlaşması: Ada göre belirli bir ekip arkadaşına mesaj gönderin. Herkese ulaşmak için alıcı başına bir mesaj gönderin.

Lider, ekip arkadaşlarını başlatırken her birine bir ad atar ve herhangi bir ekip arkadaşı, bu adı kullanarak diğerine mesaj gönderebilir. Daha sonraki prompt'larda başvurabileceğiniz tahmin edilebilir adlar almak için, başlatma talimatınızda lidere her ekip arkadaşına ne ad vermesini istediğinizi söyleyin.

Token kullanımı (Token usage)

Agent Teams, tek bir oturuma kıyasla önemli ölçüde daha fazla token kullanır. Her ekip arkadaşının kendi bağlam penceresi vardır ve token kullanımı aktif ekip arkadaşı sayısıyla ölçeklenir. Araştırma, inceleme ve yeni özellik çalışmaları için ek token'lar genellikle buna değer. Rutin görevler için tek bir oturum daha uygun maliyetlidir.

Kullanım senaryosu örnekleri (Use case examples)

Paralel kod incelemesi çalıştırma (Run a parallel code review)

Tek bir inceleyici, aynı anda bir tür soruna odaklanma eğilimindedir. İnceleme kriterlerini bağımsız alanlara bölmek, güvenlik, performans ve test kapsamının hepsinin aynı anda kapsamlı bir şekilde ele alınması anlamına gelir.

Prompt, her inceleyiciye farklı bir mercek atar, böylece üst üste binmezler:

"Create an agent team to review PR #142. Spawn three reviewers:

• One focused on security implications
• One checking performance impact
• One validating test coverage Have them each review and report findings."

Her inceleyici aynı PR üzerinde çalışır ancak farklı bir filtre uygular. Lider, işi bitirdikten sonra üçünün bulgularını sentezler.

Rekabet eden hipotezlerle araştırma yapma (Investigate with competing hypotheses)

Kök neden belirsiz olduğunda, tek bir ajan makul bir açıklama bulma ve aramayı durdurma eğilimindedir. Prompt, ekip arkadaşlarını açıkça çekişmeli hale getirerek bununla mücadele eder: her birinin işi yalnızca kendi teorisini araştırmak değil, aynı zamanda diğerlerini sorgulamaktır.

"Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges."

Tartışma yapısı buradaki anahtar mekanizmadır. Sıralı araştırma, çıpalama (anchoring) sorunundan muzdariptir: bir teori araştırıldıktan sonra, sonraki araştırma ona doğru yanlı olur. Birbirlerini aktif olarak çürütmeye çalışan birden fazla bağımsız araştırmacıyla, hayatta kalan teorinin gerçek kök neden olma olasılığı çok daha yüksektir.

En iyi uygulamalar (Best practices)

Ekip arkadaşlarına yeterli bağlam verin (Give teammates enough context)

Ekip arkadaşları, CLAUDE.md, MCP sunucuları ve skill'ler dahil olmak üzere proje bağlamını otomatik olarak yükler, ancak liderin konuşma geçmişini devralmazlar. Başlatma prompt'una göreve özgü ayrıntıları ekleyin:

"Spawn a security reviewer teammate with the prompt: 'Review the authentication module at src/auth/ for security vulnerabilities. Focus on token handling, session management, and input validation. The app uses JWT tokens stored in httpOnly cookies. Report any issues with severity ratings.'"

Uygun bir ekip boyutu seçin (Choose an appropriate team size)

Ekip arkadaşı sayısında katı bir sınır yoktur, ancak pratik kısıtlamalar geçerlidir:

• Token maliyetleri doğrusal olarak ölçeklenir: Her ekip arkadaşının kendi bağlam penceresi vardır ve token'ları bağımsız olarak tüketir.
• Koordinasyon yükü artar: Daha fazla ekip arkadaşı, daha fazla iletişim, görev koordinasyonu ve potansiyel çatışma anlamına gelir.
• Azalan verim: Belirli bir noktanın ötesinde, ek ekip arkadaşları işi orantılı olarak hızlandırmaz.

Çoğu iş akışı için 3-5 ekip arkadaşıyla başlayın. Bu, paralel çalışmayı yönetilebilir koordinasyonla dengeler. Ekip arkadaşı başına 5-6 görev, herkesi aşırı bağlam değiştirme olmadan üretken tutar. 15 bağımsız göreviniz varsa, 3 ekip arkadaşı iyi bir başlangıç ​​noktasıdır. Yalnızca çalışma gerçekten ekip arkadaşlarının aynı anda çalışmasından fayda sağladığında ölçeği artırın. Üç odaklı ekip arkadaşı, genellikle beş dağınık olandan daha iyi performans gösterir.

Görevleri uygun şekilde boyutlandırın (Size tasks appropriately)

• Çok küçük: Koordinasyon yükü faydayı aşar.
• Çok büyük: Ekip arkadaşları kontrol noktaları olmadan çok uzun süre çalışır, bu da boşa harcanan çaba riskini artırır.
• Tam doğru: Bir işlev, bir test dosyası veya bir inceleme gibi net bir çıktı üreten, kendi kendine yeten birimler.

Lider, işi otomatik olarak görevlere ayırır ve ekip arkadaşlarına atar. Yeterli görev oluşturmuyorsa, işi daha küçük parçalara bölmesini isteyin. Ekip arkadaşı başına 5-6 görev, herkesi üretken tutar ve birisi takılırsa liderin işi yeniden atamasına olanak tanır.

Ekip arkadaşlarının bitirmesini bekleyin (Wait for teammates to finish)

Bazen lider, ekip arkadaşlarını beklemek yerine görevleri kendisi uygulamaya başlar. Bunu fark ederseniz:

"Wait for your teammates to complete their tasks before proceeding"

Araştırma ve inceleme ile başlayın (Start with research and review)

Agent Teams'te yeniyseniz, net sınırları olan ve kod yazmayı gerektirmeyen görevlerle başlayın: bir PR'ı incelemek, bir kütüphaneyi araştırmak veya bir hatayı araştırmak. Bu görevler, paralel uygulamayla gelen koordinasyon zorlukları olmadan paralel keşfin değerini gösterir.

Dosya çakışmalarından kaçının (Avoid file conflicts)

İki ekip arkadaşının aynı dosyayı düzenlemesi, üzerine yazmalara yol açar. İşi, her ekip arkadaşı farklı bir dosya kümesine sahip olacak şekilde bölün.

İzleyin ve yönlendirin (Monitor and steer)

Ekip arkadaşlarının ilerlemesini kontrol edin, işe yaramayan yaklaşımları yeniden yönlendirin ve bulgular geldikçe sentezleyin. Bir ekibi çok uzun süre gözetimsiz bırakmak, boşa harcanan çaba riskini artırır.

Sorun giderme (Troubleshooting)

Ekip arkadaşları görünmüyor (Teammates not appearing)

Claude'dan bir ekip oluşturmasını istedikten sonra ekip arkadaşları görünmüyorsa:

• In-process modunda ekip arkadaşları zaten çalışıyor ancak görünmüyor olabilir. Aktif ekip arkadaşları arasında geçiş yapmak için Shift+Down tuşuna basın.
• Claude'a verdiğiniz görevin bir ekibi haklı çıkaracak kadar karmaşık olup olmadığını kontrol edin. Claude, göreve göre ekip arkadaşları başlatıp başlatmayacağına karar verir.
• Split paneleri açıkça talep ettiyseniz, tmux'un kurulu olduğundan ve PATH'inizde bulunduğundan emin olun: which tmux
• iTerm2 için it2 CLI'nin kurulu olduğunu ve iTerm2 tercihlerinde Python API'nin etkinleştirildiğini doğrulayın.

Çok fazla izin istemi (Too many permission prompts)

Ekip arkadaşı izin talepleri lidere yansır ve bu da sürtüşme yaratabilir. Ekip arkadaşlarını başlatmadan önce, kesintileri azaltmak için izin ayarlarınızda yaygın işlemleri önceden onaylayın.

Ekip arkadaşları hatalarda duruyor (Teammates stopping on errors)

Ekip arkadaşları, hatalarla karşılaştıktan sonra kurtulmak yerine durabilir. In-process modunda Shift+Down veya split modunda panele tıklayarak çıktılarını kontrol edin, ardından:

• Onlara doğrudan ek talimatlar verin.
• Çalışmaya devam etmesi için yedek bir ekip arkadaşı başlatın.

Lider iş bitmeden kapanıyor (Lead shuts down before work is done)

Lider, tüm görevler tamamlanmadan ekibin işinin bittiğine karar verebilir. Bu olursa, devam etmesini söyleyin. Ayrıca, lidere işi yapmak yerine devretmeye başlarsa, devam etmeden önce ekip arkadaşlarının bitirmesini beklemesini söyleyebilirsiniz.

Yetim kalan tmux oturumları (Orphaned tmux sessions)

Bir tmux oturumu ekip sona erdikten sonra kalırsa, tamamen temizlenmemiş olabilir. Oturumları listeleyin ve ekip tarafından oluşturulanı sonlandırın:

tmux ls
tmux kill-session -t <session-name>

Sınırlamalar (Limitations)

Agent Teams deneyseldir. Bilinmesi gereken mevcut sınırlamalar:

• In-process ekip arkadaşlarıyla oturum devam ettirme yok: /resume ve /rewind, in-process ekip arkadaşlarını geri yüklemez. Bir oturumu devam ettirdikten sonra lider, artık var olmayan ekip arkadaşlarına mesaj göndermeye çalışabilir. Bu olursa, lidere yeni ekip arkadaşları başlatmasını söyleyin.
• Görev durumu gecikebilir: Ekip arkadaşları bazen görevleri tamamlanmış olarak işaretleyemez, bu da bağımlı görevleri engeller. Bir görev takılı görünüyorsa, işin gerçekten yapılıp yapılmadığını kontrol edin ve görev durumunu manuel olarak güncelleyin veya lidere ekip arkadaşını dürtmesini söyleyin.
• Kapanma yavaş olabilir: Ekip arkadaşları, kapanmadan önce mevcut isteklerini veya araç çağrılarını bitirir, bu da zaman alabilir.
• Bir seferde bir ekip: Bir lider yalnızca bir ekibi yönetebilir. Yeni bir ekip oluşturmadan önce mevcut ekibi temizleyin.
• İç içe ekip yok: Ekip arkadaşları kendi ekiplerini veya ekip arkadaşlarını başlatamaz. Yalnızca lider ekibi yönetebilir.
• Lider sabittir: Ekibi oluşturan oturum, ömrü boyunca liderdir. Bir ekip arkadaşını lidere terfi ettiremez veya liderliği devredemezsiniz.
• İzinler başlatma sırasında ayarlanır: Tüm ekip arkadaşları liderin izin moduyla başlar. Başlatıldıktan sonra bireysel ekip arkadaşı modlarını değiştirebilirsiniz, ancak başlatma sırasında ekip arkadaşı başına mod ayarlayamazsınız.
• Split paneler tmux veya iTerm2 gerektirir: Varsayılan in-process modu herhangi bir terminalde çalışır. Split-pane modu VS Code'un entegre terminalinde, Windows Terminal'de veya Ghostty'de desteklenmez.
• CLAUDE.md normal çalışır: Ekip arkadaşları, CLAUDE.md dosyalarını çalışma dizinlerinden okur. Tüm ekip arkadaşlarına projeye özgü rehberlik sağlamak için bunu kullanın.

Sonraki adımlar (Next steps)

Paralel çalışma ve delegasyon için ilgili yaklaşımları keşfedin:

• Hafif delegasyon: Subagent'lar, oturumunuz içinde araştırma veya doğrulama için yardımcı ajanlar başlatır; ajanlar arası koordinasyon gerektirmeyen görevler için daha iyidir.
• Manuel paralel oturumlar: Git worktree'leri, otomatik ekip koordinasyonu olmadan birden fazla Claude Code oturumunu kendiniz çalıştırmanıza olanak tanır.
• Yaklaşımları karşılaştırma: Subagent ve agent team karşılaştırması için yan yana dökümü inceleyin.

Örnek kullanım senaryosu

Bir geliştirici, büyük bir monolitik uygulamayı mikroservislere ayırma projesinde çalışıyor. Proje üç ana modül içeriyor: kullanıcı yönetimi, ödeme işlemleri ve bildirim servisi. Geliştirici, her modülün bağımsız olarak analiz edilmesi ve yeniden yapılandırılması gerektiğine karar veriyor.

1. Geliştirici, settings.json dosyasına CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ortam değişkenini "1" olarak ekleyerek Agent Teams'i etkinleştiriyor.
2. Terminalde Claude Code'u başlatıyor ve şu prompt'u veriyor:

   "Create an agent team with 3 teammates to refactor our monolith into microservices. Assign one teammate to each module: user-management, payment-processing, and notification-service. Each teammate should analyze their module's dependencies, propose an API contract, and identify potential migration issues. Require plan approval before any changes."

3. Claude, bir ekip lideri ve üç ekip arkadaşı oluşturuyor. Her ekip arkadaşına bir modül atanıyor. Lider, paylaşılan görev listesini oluşturuyor: "Analyze user-management module", "Propose API contract for user-management", "Identify migration issues for user-management" ve diğer modüller için benzer görevler.
4. Ekip arkadaşları, kendi modüllerini analiz etmeye başlıyor. Geliştirici, Shift+Down kullanarak in-process modunda ekip arkadaşları arasında geçiş yapıyor ve ilerlemelerini kontrol ediyor.
5. Ödeme işlemleri ekip arkadaşı, planını lidere gönderiyor. Lider, planı inceliyor ve "Bu plan veritabanı şemasını değiştiriyor, ancak test kapsamı içermiyor. Lütfen test planını da ekleyin." diyerek reddediyor. Ekip arkadaşı planı revize ediyor ve yeniden gönderiyor.
6. Kullanıcı yönetimi ekip arkadaşı, bir bağımlılık çakışmasıyla karşılaşıyor ve hata vererek duruyor. Geliştirici, ekip arkadaşına doğrudan mesaj gönderiyor: "Bu bağımlılık çakışmasını çözmek için src/shared/utils.py dosyasını iki ayrı utility dosyasına bölün."
7. Tüm ekip arkadaşları görevlerini tamamladığında, lider bulguları sentezliyor ve her modül için bir API sözleşmesi ve geçiş planı içeren kapsamlı bir rapor oluşturuyor.
8. Geliştirici, lidere "Clean up the team" diyerek ekibi temizliyor. Lider, tüm ekip arkadaşlarının kapalı olduğunu doğruladıktan sonra paylaşılan kaynakları kaldırıyor.
9. Geliştirici, raporu inceliyor ve her modül için ayrı ayrı çalışmaya başlıyor. Agent Teams sayesinde, üç modülün analizi tek bir oturumda yapılacak olandan çok daha hızlı tamamlanmış oluyor.