Claude Code Takım Modunu Açıyor! Kullanmanız Gereken Agent Takımları!

Claude Code yine büyük bir hamle yaptı: Agent Takımları, bunu Sub Agent'ların süper güçlendirilmiş versiyonu olarak düşünebilirsiniz～ Aşağıdaki resim Agent Takımları ve Subagent'ların karşılaştırmasını gösteriyor:

Ben "ilk kullanan ben oldum"! (Çok iyi! Çok iyi! Çok iyi!)

Agent Takımlarını etkinleştirme koşulları: 
1. Claude Code'u en son sürüme güncelleyin (claude update) 

2. settings.json dosyasına şu satırı ekleyin:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Claude Code'u yeniden başlatın～  

4. Ardından doğrudan doğal dil kullanarak Claude Code'a bir Agent Takımı oluşturmasını söyleyin (tabii ki, Agent Takımının ne yapması gerektiğini açıkça belirtin)  

Ayrıca, diğer modeller Agent Takımlarının çalışmasını etkilemez (ben coding için KIMi kullanıyorum)

Agent Takımları hakkında daha fazla bilgi için aşağıya bakın (Anthropic resmi makalesi)!

Agent Takımları, birden fazla Claude Code örneğini birlikte çalıştırmanızı sağlar. Bir oturum lider olur, işleri koordine eder, görevleri dağıtır, sonuçları birleştirir. Takım arkadaşları bağımsız çalışır, her biri kendi bağlam penceresinde, ayrıca doğrudan birbirleriyle konuşabilirler.

Alt ajanlardan (Subagents) farklı olarak (alt ajanlar tek bir oturumda çalışır, sadece ana ajana rapor verir), ayrıca doğrudan tek bir takım arkadaşıyla etkileşime girebilirsiniz, liderden geçmenize gerek yoktur.

Bu belge şunları kapsar:

• • Agent Takımlarını ne zaman kullanmalı, en iyi kullanım durumları ve alt ajanlarla karşılaştırma dahil

• • Takım başlatma

• • Takım arkadaşlarını kontrol etme, görüntüleme modları, görev atama ve devretme dahil

• • Paralel çalışma için en iyi uygulamalar

Agent Takımlarını Ne Zaman Kullanmalı

Agent Takımları, paralel keşfin gerçek değer eklediği görevlerde en etkilidir. En güçlü kullanım durumları şunları içerir:

• • Araştırma ve inceleme —— Birden fazla takım arkadaşı bir sorunun farklı yönlerini aynı anda araştırabilir, ardından bulgularını paylaşabilir ve birbirlerininkilere meydan okuyabilir

• • Yeni modüller veya özellikler —— Takım arkadaşları birbirini etkilemeden bağımsız bölümlere sahip olabilir

• • Rekabetçi hipotezlerle hata ayıklama —— Takım arkadaşları farklı teorileri paralel olarak test ederek daha hızlı cevap bulabilir

• • Katmanlar arası koordinasyon —— Ön uç, arka uç ve testleri kapsayan değişiklikler, her biri farklı bir takım arkadaşı tarafından sorumlu tutulur

Agent Takımları koordinasyon ek yükü ekler (Opus4.6 ile Agent Takımlarını açmaya cesaret eder misin🤣), tek bir oturum kullanmaktan önemli ölçüde daha fazla token tüketimi artırır. Küçük gruplar bağımsız olarak çalışabildiğinde en iyi sonucu verirler. Sıralı görevler, aynı dosya düzenleme veya çok fazla bağımlılığı olan işler için tek bir oturum veya alt ajanlar daha etkilidir.

Alt Ajanlarla Karşılaştırma

Agent Takımları ve alt ajanların her ikisi de paralel çalışmanıza izin verir, ancak farklı şekillerde çalışır. Çalışanlarınızın birbirleriyle iletişim kurması gerekip gerekmediğine göre seçim yapın:

Alt ajanlar

Agent Takımları

Bağlam

Kendi bağlam penceresi; sonuçlar çağırana döndürülür

Kendi bağlam penceresi; tamamen bağımsız

İletişim

Sadece ana ajana sonuçları rapor eder

Takım arkadaşları doğrudan birbirlerine mesaj gönderir

Koordinasyon

Ana ajan tüm işi yönetir

Paylaşılan görev listesi, kendi kendine koordinasyon

En uygun

Sadece sonuçlarla ilgili odaklanmış görevler

Tartışma ve işbirliği gerektiren karmaşık işler

Token Maliyeti

Daha düşük: Sonuçlar ana bağlama toplanır

Daha yüksek: Her takım arkadaşı bağımsız bir Claude örneğidir

Hızlı, odaklanmış çalışanların sonuçları rapor etmesi gerektiğinde alt ajanları kullanın. Grupların bulgularını paylaşması, birbirlerine meydan okuması ve kendi kendine koordine olması gerektiğinde Agent Takımlarını kullanın.

Agent Takımlarını Etkinleştirme

Agent Takımları varsayılan olarak devre dışıdır. CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ortam değişkenini 1 olarak ayarlayarak etkinleştirin, bu shell ortamında veya settings.json üzerinden yapılabilir:

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

İlk Agent Takımınızı Başlatma

Agent Takımları etkinleştirildikten sonra, Claude'a bir Agent Takımı oluşturmasını söyleyin, görevi ve istediğiniz takım yapısını doğal dilde açıklayın. Claude ipucunuza göre takım oluşturur, takım arkadaşları üretir ve işi koordine eder.

Bu örnek iyi çalışır çünkü üç rol bağımsızdır, birbirini beklemeden sorunu keşfedebilir:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Bir Agent Takımı oluşturarak bunu farklı açılardan keşfedin: biri UX'ten sorumlu, biri teknik mimariden sorumlu, biri şeytanın avukatını oynuyor.)

Oradan, Claude paylaşılan bir görev listesi olan bir takım oluşturur, her perspektif için takım arkadaşları üretir, sorunu keşfetmelerini sağlar, bulguları birleştirir ve tamamlandığında takımı temizlemeye çalışır.

Liderin terminali tüm takım arkadaşlarını ve çalışma içeriklerini listeler. Takım arkadaşlarını seçmek ve doğrudan onlara mesaj göndermek için Shift+Yukarı/Aşağı kullanın.

Agent Takımınızı Kontrol Etme

Lidere ne istediğinizi doğal dilde söyleyin. Talimatlarınıza göre takım koordinasyonunu, görev atamasını ve devretmeyi işler.

Görüntüleme Modu Seçme

Agent Takımları iki görüntüleme modunu destekler:

• • Süreç içi mod —— Tüm takım arkadaşları ana terminaliniz içinde çalışır. Takım arkadaşlarını seçmek ve doğrudan mesaj göndermek için Shift+Yukarı/Aşağı kullanın. Ek kurulum gerektirmeden herhangi bir terminal için uygundur.

• • Bölünmüş ekran modu —— Her takım arkadaşının kendi bölmesi vardır. Herkesin çıktısını aynı anda görebilirsiniz, bölmeye tıklayarak doğrudan etkileşime geçin. tmux veya iTerm2 gerektirir.

Varsayılan "auto"dur, eğer zaten bir tmux oturumunda çalışıyorsanız bölünmüş ekran kullanır, aksi takdirde süreç içi modu kullanır.

Tek bir oturum için süreç içi modu zorlamak için bayrağı iletin:

claude --teammate-mode in-process

Takım Arkadaşları ve Modeller Belirleme

Claude görevinize göre kaç takım arkadaşı üreteceğine 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.
(Bu modülleri paralel olarak yeniden düzenlemek için 4 kişilik bir takım oluşturun. Her üye için Sonnet kullanın.)

Takım Arkadaşı Plan Onayı İsteme

Karmaşık veya riskli görevler için, takım arkadaşlarından uygulamadan önce plan yapmalarını isteyebilirsiniz. Takım arkadaşları, lider yöntemlerini 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.
(Kimlik doğrulama modülünü yeniden düzenlemek için bir mimar takım arkadaşı oluşturun. Herhangi bir değişiklik yapmadan önce plan onayı gerektirin.)

Takım arkadaşı planı tamamladığında, lidere bir plan onay isteği gönderir. Lider planı inceler ve onaylar veya reddeder ve geri bildirim sağlar.

Devretme Modunu Kullanma

Devretme modu olmadan, lider bazen takım arkadaşlarının bitirmesini beklemek yerine kendisi görevi uygulamaya başlar. Devretme modu, lideri sadece koordinasyon araçlarıyla sınırlayarak bunu önler. Devretme moduna geçmek için Shift+Tab tuşuna basın.

Doğrudan Takım Arkadaşlarıyla Konuşma

Her takım arkadaşı tam, bağımsız bir Claude Code oturumudur. Doğrudan herhangi bir takım arkadaşına mesaj gönderebilirsiniz:

• • Süreç içi mod: Takım arkadaşını seçmek için Shift+Yukarı/Aşağı kullanın, ardından mesaj göndermek için yazın. Takım arkadaşının oturumunu görüntülemek için Enter'a basın, ardından mevcut turunu kesmek için Escape'e basın. Görev listesi arasında geçiş yapmak için Ctrl+T'ye basın.

• • Bölünmüş ekran modu: Takım arkadaşının bölmesine tıklayarak doğrudan oturumuyla etkileşime geçin.

Görev Atama ve Talep Etme

Paylaşılan görev listesi takımın çalışmasını koordine eder. Lider görevler oluşturur, takım arkadaşları tamamlar. Görevlerin üç durumu vardır: bekleyen, devam eden, tamamlanan. Görevler ayrıca diğer görevlere bağımlı olabilir.

Lider görevleri açıkça atayabilir veya takım arkadaşları bir görevi tamamladıktan sonra kendileri talep edebilir.

Takım Arkadaşlarını Kapatma

Bir takım arkadaşının oturumunu zarif bir şekilde sonlandırmak için:

Ask the researcher teammate to shut down
(Araştırmacı takım arkadaşına kapanmasını söyleyin)

Lider bir kapatma isteği gönderir. Takım arkadaşı onaylayabilir ve zarifçe çıkabilir veya reddedebilir ve nedenini açıklayabilir.

Takımı Temizleme

Tamamlandığında, lidere temizlemesini söyleyin:

Clean up the team
(Takımı temizleyin)

Bu paylaşılan takım kaynaklarını kaldırır. Lider temizleme çalıştırdığında, aktif takım arkadaşlarını kontrol eder, eğer hala çalışan varsa başarısız olur, bu yüzden önce onları kapatın.

Agent Takımları Nasıl Çalışır

Mimari

Agent Takımı şunları içerir:

• • Lider: Takım oluşturan, takım arkadaşları üreten ve çalışmayı koordine eden ana Claude Code oturumu

• • Takım arkadaşları: Atanan görevleri işleyen bağımsız Claude Code örnekleri

• • Görev listesi: Takım arkadaşlarının talep ettiği ve tamamladığı iş öğelerinin paylaşılan listesi

• • Posta kutusu: Ajanlar arasında iletişim için mesaj sistemi

Sistem otomatik olarak görev bağımlılıklarını yönetir. Takım ve görevler yerel olarak depolanır:

• • Takım yapılandırması: ~/.claude/teams/{team-name}/config.json

• • Görev listesi: ~/.claude/tasks/{team-name}/

Bağlam ve İletişim

Her takım arkadaşının kendi bağlam penceresi vardır. Üretildiğinde, takım arkadaşları normal oturumlarla aynı proje bağlamını yükler: CLAUDE.md, MCP sunucuları ve beceriler. Liderin konuşma geçmişi aktarılmaz.

Takım arkadaşları bilgiyi nasıl paylaşır:

• • Otomatik mesajlaşma: Takım arkadaşı mesaj gönderdiğinde, otomatik olarak alıcıya iletilir

• • Boşta bildirimi: Takım arkadaşı tamamlandığında ve durduğunda, otomatik olarak lidere bildirilir

• • Paylaşılan görev listesi: Tüm ajanlar görev durumunu görebilir ve mevcut işi talep edebilir

Token Kullanımı

Agent Takımları, tek bir oturum kullanmaktan önemli ölçüde daha fazla token tüketimi artırır. Her takım arkadaşının kendi bağlam penceresi vardır, token kullanımı aktif takım arkadaşı sayısı arttıkça artar. Araştırma, inceleme ve yeni özellik işleri için ekstra token genellikle değerlidir. Düzenli görevler için tek bir oturum daha uygun maliyetlidir.

Kullanım Durumu Örnekleri

Paralel Kod İncelemesi Çalıştırma

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

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.
(PR #142'yi incelemek için bir Agent Takımı oluşturun. Üç inceleyici oluşturun: biri güvenlik etkilerine odaklanmış, biri performans etkisini kontrol ediyor, biri test kapsamını doğruluyor. Her birinin inceleme yapmasını ve bulgularını rapor etmesini sağlayın.)

Rekabetçi Hipotezlerle Soruşturma

Kök neden belirsiz olduğunda, tek bir ajan makul görünen bir açıklama bulduğunda aramayı durdurma eğilimindedir.

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.

En İyi Uygulamalar

Takım Arkadaşlarına Yeterli Bağlam Sağlama

Takım arkadaşları otomatik olarak proje bağlamını yükler, ancak liderin konuşma geçmişini miras almaz. Üretim ipucuna göreve özgü ayrıntıları dahil edin.

Görev Boyutunu Uygun Şekilde Ayarlama

• • Çok küçük: Koordinasyon ek yükü kazancı aşar

• • Çok büyük: Takım arkadaşları kontrol etmeden çok uzun süre çalışır, boşa çaba riskini artırır

• • Tam doğru: Kendi kendine yeten birim, net bir teslimat üretir

Takım Arkadaşlarının Bitirmesini Bekleme

Bazen lider, takım arkadaşının bitirmesini beklemek yerine kendisi görevi uygulamaya başlar. Bunu fark ederseniz:

Wait for your teammates to complete their tasks before proceeding
(Devam etmeden önce takım arkadaşlarınızın görevlerini tamamlamasını bekleyin)

Dosya Çakışmalarından Kaçınma

İki takım arkadaşı aynı dosyayı düzenlerse üzerine yazmaya neden olabilir. İşi, her takım arkadaşının farklı dosya setlerine sahip olacağı şekilde bölün.

İzleme ve Yönlendirme

Takım arkadaşlarının ilerlemesini kontrol edin, işe yaramayan yöntemleri yeniden yönlendirin ve ilerledikçe bulguları birleştirin.

Sınırlamalar

Agent Takımları deneyseldir. Mevcut sınırlamalar:

• • Süreç içi takım üyeleri oturum kurtarmayı desteklemez: /resume ve /rewind süreç içi takım arkadaşlarını kurtarmaz

• • Görev durumu gecikebilir: Takım arkadaşları bazen görevi tamamlandı olarak işaretleyemez

• • Kapatma yavaş olabilir: Takım arkadaşları kapanmadan önce mevcut isteği tamamlar

• • Oturum başına bir takım: Bir lider aynı anda sadece bir takım yönetebilir

• • İç içe takımlar desteklenmez: Takım arkadaşları kendi takımlarını oluşturamaz

• • Lider sabittir: Takımı oluşturan oturum ömrü boyunca liderdir

• • Bölünmüş ekran tmux veya iTerm2 gerektirir: VS Code entegre terminali, Windows Terminal veya Ghostty desteklenmez