Kurs
Büyük ölçekli uygulamalarda veya kurumsal ortamlarda bağlam düşündüğünüzden daha hızlı dolar. Bir saat önce aldığınız büyük bir tasarım kararı muhtemelen artık bağlamda değildir; bu yüzden modelin zaten üzerinde çalıştığı şeyleri tekrar tekrar açıklamak zorunda kalırsınız. Çoğu şeyi doğru yapıyorsunuz, ama sorun tek bir asistandan tüm bir ekibin işini yapmasını istemeniz.
Claude Code Aracı Takımları bunu değiştirmek için tanıtıldı. Fikir şu: Her şeyi sırayla yapan tek bir oturum yerine, paylaşılan bir görev listesine sahip, doğrudan birbirlerine mesaj gönderen ve işleri paralel yürüten birden çok uzman aracı başlatırsınız.
Bu yazıda, Aracı Takımlarının nasıl çalıştığını, her uzman rolün ne yaptığını ve gerçek yazılım projelerinde nasıl koordine edileceğini anlatacağım.
Claude Code'a yeni misiniz? Temelleri bir öğleden sonra içinde Claude Code 101 kursumuzla yakalayın.
Claude Code Aracı Takımları Nedir?
Claude Code Aracı Takımları, birden fazla Claude Code oturumunun aynı projede aynı anda çalışmasına olanak tanıyan bir koordinasyon katmanıdır. Bir oturum ekip lideri rolünü üstlenir ve işin belirli kısımlarını ele almak üzere takım arkadaşı adı verilen diğer oturumları oluşturur.
Her takım arkadaşı, kendi bağlam penceresine sahip, tam ve bağımsız bir Claude Code örneği olarak çalışır. Ortak bir görev listesi paylaşırlar, uygun oldukça işleri sahiplenirler ve koordinasyona ihtiyaç duyduklarında doğrudan birbirlerine mesaj gönderirler.
Kurulum, birkaç terminal sekmesi açıp her birinde Claude'ı çalıştırmaktan fazlasıdır. Bunu yaptığınızda, ayrı sohbet pencereleri birbirlerinin ilerlemesini göremez ve kimin ne yaptığında anlaşamaz. Öte yandan bir aracı takımı, her oturuma işe dair paylaşılan bir görünüm ve iletişim yolu sağlar. Lider herkesin hizalı kalmasını sağlar.
Pratikte bu, oturumlar arasında artık ara bulucu olmadığınız anlamına gelir. Ekip kendi koordinasyonunu yönetir; siz yalnızca yön vermek ve sonuçları gözden geçirmek için devreye girersiniz.
Aracı Takımlarının Varlık Nedeni
Tek bir Claude Code oturumu, proje çok büyük hale gelene kadar gayet iyi çalışır.
Her Claude Code oturumunun bir bağlam penceresi vardır ve bu pencerenin bir sınırı bulunur. Çalışırken oturum, dosya içerikleri, komut çıktıları, tasarım tartışmaları ve sizin gidip gelmelerinizle dolar. Bir noktada, eski bilgiler artık bağlamda yer almaz ve model aynı görev içinde daha önce verdiğiniz kararları unutmaya başlar.
Bu durumun belirginleştiği üç yaygın senaryo vardır:
- Büyük depolar: Yüzlerce dosyadan oluşan bir kod tabanının tamamı bağlama sığmaz. Oturum, aynı dosyaları tekrar tekrar okuyup, zaten sahip olduğu anlayışı yeniden inşa etmek için jeton tüketir.
- Karmaşık projeler: Arka uç, ön uç ve testler boyunca kimlik doğrulama eklemek gibi yatay kesen özellikler, modelin aynı anda çok fazla konuyla çalışmasını gerektirir. Her yeni konu, diğer her şeyle alan için yarışır.
- Eşzamanlı birden fazla görev: Tek bir oturumdan aynı konuşmada bir özelliği uygulamasını, bir modülü yeniden düzenlemesini, testler yazmasını ve dokümantasyonu güncellemesini istemek sorun davet etmektir.
Çözüm, insan ekiplerinin onlarca yıl önce vardığıyla aynıdır: işi bölün.
Bir yeniden düzenleme sırasında bir oturum sınırlarına dayanıyorsa, arka uç değişikliklerini bir takım arkadaşına, ön uç değişikliklerini diğerine ve test güncellemelerini üçüncü birine verin. Her takım arkadaşı, işin kendi kısmı için yalnızca ihtiyaç duyduklarını kullanır.
Aynı fikir araştırma için de geçerlidir. Üç rekabet eden hipotezi olan bir görev, tek bir oturumun bunları sırayla ele almasındansa, üç takım arkadaşının her birinin bir teoriyi paralel olarak araştırıp ardından notlarını karşılaştırmasıyla daha hızlı ilerler.
Uzmanlaşma derinlik, paralellik hız kazandırır. Birlikte olduklarında ise, tek bir oturumun ya halüsinasyon göreceği ya da bitirmek için çok uzun zaman alacağı işleri yapmanızı sağlarlar.
Claude Code Aracı Takımları Nasıl Çalışır
Bir takım oturumu, düzenlemesi Claude Code içinde yapılan beş aşamadan geçer.
- Amacı tanımlayın: Ne istediğinizi, bir junior mühendise brif veriyormuş gibi sade bir dille anlatın. Lider bunu okur ve nasıl parçalara ayrılacağına karar verir.
- İşi devredin: Lider paylaşılan bir görev listesi oluşturur ve her birine bir ad, rol ve başlangıç komutu veren takım arkadaşlarını başlatır. Ekip yapısını siz belirleyebilir veya liderin belirlemesine izin verebilirsiniz.
- Paralel yürütün: Her takım arkadaşı görevleri sahiplenir, devam ediyor olarak işaretler, tamamlar ve bitti olarak işaretler. Bağımlılıklar otomatik olarak gözetilir; dosya kilitleme çatışmaları önler. Takım arkadaşları birbirlerine doğrudan mesaj gönderebilir — lider üzerinden yönlendirmeye gerek yoktur.
- Sonuçları birleştirin: Lider biten işleri toplar, çatışmaları çözer ve tek bir çıktı üretir: bir PR, rapor, yeniden düzenlenmiş modül veya hedefin gerektirdiği başka bir şey.
- Sonucu gözden geçirin: Nihai sonucu herhangi bir çekme isteği gibi gözden geçirirsiniz: farkı okuyun, kodu çalıştırın, testleri kontrol edin.
Aracı Takımlarının Uzman Rolleri
Roller, bir aracı takımına şeklini verir. Onlar olmadan, örtüşen işler yapan genel amaçlı oturumlarla karşılaşırsınız. Claude Code sabit bir liste sunmaz — rolleri brifinizde tanımlarsınız veya lideri .claude/agents/ altına kaydedilmiş bir alt aracı tanımına yönlendirirsiniz.
Planlama Aracısı
Planlama aracısı, herhangi bir kod yazılmadan önce hedefi görevlere böler. Kod tabanını keşfeder, bağımlılıkları haritalar ve tek bir takım arkadaşının sürekli kontrol gerektirmeden tamamlayabileceği, kendi içinde tutarlı birimlerden oluşan bir görev listesi üretir.
Pratikte, ekip lideri bu rolü çoğu zaman kendisi üstlenir. İş yeterince büyükse, özel bir planlama takım arkadaşını da çalıştırabilirsiniz.
Kodlama Aracısı
Kodlama aracısı uygulamayı yazar. Çoğu takım arkadaşı kodlama aracısı olacaktır; her biri işin farklı bir bölümünün sahibi olur — arka uç, ön uç, veritabanı, yapay zekâ özellikleri. Önemli olan kapsamların çakışmamasıdır: Aynı dosyayı düzenleyen iki takım arkadaşı birbirinin üzerine yazar.
Kodlama aracıları daha uygun maliyetli modellerde iyi çalışır. Pek çok uygulayıcı, lideri Opus'ta, takım arkadaşlarını Sonnet'te çalıştırır; çünkü yürütme, koordinasyon kadar derin muhakeme gerektirmez.
Test Aracısı
Test aracısı testleri yazar ve çalıştırır. Kodlama takım arkadaşı uç noktayı hâlâ inşa ederken üzerinde mutabık kalınmış bir API sözleşmesine karşı çalışabilir — böylece kod geldiğinde testler zaten hazır olur.
Ayrıca tüm oturum boyunca bir test takım arkadaşını açık tutabilir, bir kodlama takım arkadaşı bir görevi tamamlandı olarak işaretlediğinde paketi yeniden çalıştırabilirsiniz.
Gözden Geçirme Aracısı
Gözden geçirme aracısı farkları okur ve hataları, stil sorunlarını, eksik uç durumlarını ve güvenlik problemlerini işaretler. Güvenlik için bir, performans için bir olmak üzere iki farklı bakış açısına sahip iki takım arkadaşına incelemeyi bölmek özellikle iyi çalışır; lider bulgularını birleştirir.
Projeye zaten bir alt aracı tanımı yazdıysanız, takım arkadaşı araçlarını ve sistem komutunu otomatik olarak devralır.
Dokümantasyon Aracısı
Dokümantasyon aracısı docstring'ler, README güncellemeleri ve mimari notlar veya API referansları gibi daha uzun dokümanlar yazar. Kodlama ve testler bittiğinde işin nihai şekli netleşmiş olacağından, çalıştırılacak son takım arkadaşı için iyi bir adaydır.
Neden uzmanlaşma sonuçları iyileştirir
Genel amaçlı bir oturumun, uygulama, testler, dokümanlar ve geri bildirimleri aynı anda bağlamda tutması gerekir. Uzman bir takım arkadaşı ise yalnızca ihtiyaç duyduklarını yükler; böylece bağlamı küçük, muhakemesi odaklı kalır. Uzmanlaşma hata ayıklamayı da kolaylaştırır: Bir şey ters gittiğinde, tam olarak hangi oturuma bakacağınızı bilirsiniz.
Aracı Takımlarıyla Paralel Geliştirme
Paralellik, bir aracı takımının varlık nedenidir.
Lider işi görevlere böldükten ve takım arkadaşlarını başlattıktan sonra hepsi aynı anda çalışır. Her takım arkadaşı ayrı bir Claude Code oturumudur; dolayısıyla işler tek bir bağlam penceresinin arkasında sıraya girmez. Çok parçalı bir özelliği bitirme süresi, parçaların toplamından, en yavaş parçanın süresine düşer.
Paralelde özellikle iyi çalışan üç kombinasyon şöyledir.
- Ön uç ve arka uç paralelde: Hem ön hem arka katmanı kullanan yeni bir özellik geliştirirken, arka uç takım arkadaşı API uç noktasını inşa ederken ön uç takım arkadaşı onu tüketen bileşeni geliştirir. İkisi doğrudan mesajlarla koordine olur. Arka uç takım arkadaşı yanıt biçimini belirler belirlemez bunu ön uç takım arkadaşına gönderir ve her ikisi de diğerinin tamamen bitmesini beklemeden çalışmaya devam eder.
- Uygulama ve test paralelde: Kodlama takım arkadaşı uygulamayı yazarken test takım arkadaşı üzerinde anlaşılan sözleşmeye göre testleri yazar. Kodlama takım arkadaşı görevi tamamlandı olarak işaretlediğinde, testler zaten çalıştırılmaya hazırdır. Bu, önce kodu yazıp en sonda testleri ekleme şeklindeki sıradan yaklaşımdan çok daha hızlıdır.
- Dokümantasyon ve kod incelemesi paralelde: Bir kodlama takım arkadaşı bir işi bitirdiğinde, dokümantasyon takım arkadaşı docstring'leri ve README güncellemelerini yazmaya başlayabilirken, inceleme takım arkadaşı hatalar ve stil sorunları için farkı okur. Hiçbiri diğerini engellemez ve her ikisi de çıktısını liderin birleştirmesi için üretir.
Sınır, dosya çatışmalarına dayanır. Aynı dosyaya aynı anda yazan iki takım arkadaşı birbirinin üzerine yazar; bu yüzden liderin işi dosya veya modül sınırları boyunca bölmesi gerekir. Parçalar net olduğu sürece, görev listenizin desteklediği kadar çok takım arkadaşını paralelde çalıştırabilirsiniz.
Büyük Kod Tabanları için Claude Code Aracı Takımları
Büyük kod tabanlarında aracı takımları, iyi olsa iyi olurdan ziyade olmazsa olmazdır.
Yüzlerce veya binlerce dosyalı bir depo tek bir bağlam penceresine sığmaz. Büyük bir kod tabanında tek başına çalışan bir oturum, bütçesinin önemli kısmını kodu yeniden keşfetmeye harcar.
Aracı takımlarıyla her takım arkadaşı yalnızca işinin parçasıyla ilgili dosyaları yükler; böylece takım arkadaşı başına bağlam penceresi küçük ve odaklı kalır. Ekip bir bütün olarak tüm depo üzerinde akıl yürütebilir, ancak tek bir oturumun bunu yapması gerekmez.
Bu en çok üç durumda önemlidir:
- Yatay kesen değişiklikler: Birden çok modül boyunca düzinelerce dosyaya dokunan bir yeniden düzenleme, bir oturumun dalını kaybetmeden yönetmesi zordur. Modül bazında bölüp her modülü bir takım arkadaşına vermek, her birinin kapsamını yönetilebilir tutar.
- Depo genelinde denetimler: Büyük bir kod tabanında güvenlik incelemesi veya performans denetimi, her biri deponun farklı bir bölümüne bakan birden fazla takım arkadaşını paralelde çalıştırmaktan fayda görür. Lider sonra bulgularını tek bir raporda birleştirir.
- Uzun soluklu projeler: Haftalar süren bir proje, tek bir oturumun tutamayacağı bağlam biriktirir. Aracı takımları, işi kontrol noktalarına bölmenize olanak tanır; her kontrol noktası, öncesini tamamen hatırlamak zorunda olmayan bir takım arkadaşı tarafından sahiplenilir.
Bunun bir maliyeti vardır.
Her takım arkadaşı kendi bağlam penceresine sahip tam bir Claude Code oturumudur; bu nedenle jeton kullanımı ekip boyutuyla doğrusal ölçeklenir. Dört kişilik bir takım, aynı iş miktarı için tek bir oturumun yaklaşık dört katı jeton kullanır. Daha yüksek tahminler de vardır. Karşılık ise daha kısa duvar saati süresi ve konu başına daha iyi derinliktir; bu da genellikle tek bir oturumun gerçekçi biçimde tamamlayamayacağı işlerde karşılığını verir.
Proje büyüdükçe Aracı takımlarıyla elde edeceğiniz kazanç artar. Ama aşırı kullanmayın — küçük bir hata düzeltmesi için tek bir oturum daha ucuzdur ve aynı derecede etkilidir.
Aracı Takımları ve Claude Tag
Aracı takımları, Anthropic'in yapay zekânın ekip iş akışlarına nasıl uyduğunu yeniden düşündüğü tek yer değil.
Claude Tag, Claude'ı Slack'e paylaşılan örgütsel bir katılımcı olarak getiren ayrı bir özelliktir. Bir kanalda @Claude etiketlersiniz ve Claude, kuruluşunuzun araçlarını ve kanalın bağlamını kullanarak işe koyulur. Nelerin konuşulduğunu hatırlar, kendi başına takip eder ve kuruluşunuzun kimliği altında çalışır.
Bu iki özellik farklı koordinasyon sorunlarını çözer. Aracı takımları, tek bir geliştiricinin makinesinde tek bir odaklı görev için birden fazla Claude Code oturumunu koordine eder. Claude Tag ise Slack'te insanlardan oluşan bir ekip boyunca günler ve haftalar içinde tek bir Claude kimliğini koordine eder. Ancak yön aynı: Yapay zekâ, bir kişinin tek başına kullandığı bir araç olmaktan, bir ekibin mevcut iş akışının içinde çalışan bir katılımcıya dönüşüyor.
Bu, yapay zekânın iyi olması gereken şeyleri değiştirir.
Tek başına bir asistan güçlü bir genelist olmalıdır; oysa koordine bir sistem, plan yapmayı, devretmeyi, yardım istemeyi ve diğer aracılarla ve insanlarla hizalı kalmayı bilen güçlü bir uzman olmalıdır. Aracı takımları bunu Claude Code iş akışları için yapar ve Claude Tag bunu Slack iş akışında görünür kılar.
Aracı Takımları Kurmak için En İyi Uygulamalar
İyi bir aracı takım kurulumu, çoğunlukla baştaki hazırlıkla ilgilidir. Ekip hızlıdır; ancak kaybedeceğiniz zaman, kötü kapsamlandırılmış görevler ve belirsiz rollerde olacaktır.
İşte birkaç en iyi uygulama:
-
Rolleri net tanımlayın: Her takım arkadaşının tek bir odağı ve sahip olduğu bir dosya kümesi olmalıdır. Bir takım arkadaşı oluşturduğunuzda, tam olarak neyin sorumlusu olduğunu, neyin sorumlusu olmadığını ve hangi dosya veya modüllerle çalışabileceğini söyleyin. Belirsiz roller örtüşen işler, örtüşen işler ise birleştirme çatışmaları üretir.
-
Paralelleştirmeden önce görevleri ayrıştırın: Önce planlayın, sonra paralelleştirin. Çalışmayı net girdiler, çıktılar ve bağımlılıklar içeren görevlere ayırmak için bir planlama geçişi yapın; sonra planı yürütme için ekibe verin. Bir plan birkaç bin jetona mâl olur; ancak yanlış yöne giden bir ekip yüz binlercesine mâl olabilir.
-
Standartları CLAUDE.md ile paylaşın: Her takım arkadaşı başlarken çalışma dizinindeki
CLAUDE.mddosyasını okur; bu yüzden paylaşılan geleneklerinizi oraya koyun: kod stili, dosya düzeni, test yaklaşımı ve commit mesajı formatı dahil. -
İnceleme kontrol noktaları oluşturun: Takım arkadaşı ilerlemesini kontrol edin, yoldan çıkanları yönlendirin ve kabul etmeden önce liderin çıktısını gözden geçirin. Riskli görevler için, herhangi bir takım arkadaşı değişiklik yapmadan önce plan onayı isteyin. Bu, takım arkadaşını önce planını göstermeye ve liderin onayını beklemeye zorlar.
-
Ekip boyutunu sınırlayın: Çoğu iş akışı için üç ila beş takım arkadaşıyla başlayın. Bunun ötesinde, koordinasyon yükü paralel hızlanmadan daha hızlı artar.
-
Dosya çatışmalarından kaçının: İşi dosya veya modül sınırları boyunca bölün; böylece her takım arkadaşı açıkça ayrılmış olur. Aynı dosyayı düzenleyen iki takım arkadaşı birbirinin değişikliklerinin üzerine yazar. Bir görev gerçekten aynı dosyada birden çok takım arkadaşının çalışmasını gerektiriyorsa, paralelleştirmek yerine sıralayın.
-
Yaygın işlemleri önceden onaylayın: Takım arkadaşlarından gelen izin istemleri lidere yükselir ve dört takım arkadaşlı bir ekip dört kat istem üretebilir. Ekip başlatılmadan önce
permissions.allowlistenizi ayarlayın; böylece dosya okuma veya test çalıştırma gibi rutin işlemler işi kesintiye uğratmaz. -
Modeli role eşleştirin: Lideri Opus gibi daha güçlü bir modelde çalıştırın; zira koordinasyon daha derin muhakemeden faydalanır. Takım arkadaşlarını yürütme için Sonnet'te çalıştırın.
Kısa versiyonu da şu: ayrıntılı bir iş planı oluşturun, ekibi küçük bir junior mühendis grubuna brif verir gibi bilgilendirin, onlara net kapsamlar ve paylaşılan standartlar verin ve işlerini sonunda kontrol edin. Kurulumunuz gerçek bir mühendislik ekibinin çalışma biçimine ne kadar yaklaşırsa, aracı takım o kadar iyi performans gösterecektir.
Uygulamada Claude Code Aracı Takımı
Baştan sona tüm süreç şöyle.
Küçük bir örnek üzerinden ilerleyeceğim: SQLite veritabanından bir mesaj okuyan FastAPI ile bir "merhaba dünya" REST API'si ve API'yi çağırıp sonucu gösteren minicik bir HTML sayfası. Uygulamada bir arka uç rotası, bir veritabanı katmanı, statik bir ön yüz ve bir readme dokümantasyonu var; bu da onu dört kişilik bir ekip için iyi bir örnek yapıyor.
Aracı takımlarını etkinleştirin
Aracı takımları deneysel bir özelliktir ve varsayılan olarak kapalıdır. Bunları bir ortam değişkeni ayarlayarak açarsınız; bunu kabuğunuzda veya Claude Code ayarlar dosyanızda yapabilirsiniz.
Ayarlar dosyası ~/.claude/settings.json konumundadır. Açın ve şunu ekleyin:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
Ayarlar dosyasını düzenlemek istemezseniz, Claude Code'u başlatmadan önce değişkeni kabuğunuzda ayarlayabilirsiniz:
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Her iki yaklaşım da işe yarar. Değişken ayarlandıktan sonra Claude Code, takımla ilgili istemleri tanır ve siz istediğinizde koordinasyon katmanını başlatır.
Claude Code'u başlatın ve ekibi brifleyin
Proje için boş bir klasör oluşturun ve içinde Claude Code'u başlatın:
mkdir hello-api && cd hello-api
claude
Şimdi ekibi brifleyin. İstem düz doğal dildedir; ancak roller ve sınırlar konusunda ne kadar spesifik olursanız ekip o kadar iyi performans gösterir. İşte merhaba dünya API'si için istem:
Create an agent team to build a small "hello world" REST API.
The project is a FastAPI service that returns a greeting from a SQLite
database, plus a tiny HTML page that calls the API and shows the result.
- One teammate on the database: create app/db.py with a sqlite3 connection
to a greetings.db file. Define a get_greeting() function that returns
the message column from the first row. On import, create the table if
it doesn't exist and seed it with "Hello, World!" if empty.
- One teammate on the backend: build a FastAPI app in app/main.py with
a GET /greeting endpoint that calls get_greeting() from app/db.py.
Add permissive CORS and mount the static/ directory at the root so
the HTML page is served from the same origin.
- One teammate on the frontend: build static/index.html as a single page
that fetches /greeting on load, shows a spinner while loading, displays
the greeting in a centered card on success, and shows an error message
on failure. Inline the CSS and JavaScript.
- One teammate on docs: write README.md with installation, run, and
open-in-browser steps, plus an API reference table. Also create
requirements.txt with fastapi and uvicorn[standard].
Use Sonnet for each teammate. Require plan approval before any teammate
makes changes.
Bu istemde üç nokta dikkat çekicidir. Dosya sınırları (app/db.py, app/main.py, static/index.html, README.md, requirements.txt) örtüşmeyi önler. Model seçimi (Sonnet) jeton maliyetlerini yönetilebilir tutar. Ve plan approval, her takım arkadaşını herhangi bir kod yazmadan önce planını göstermeye zorlar; bu da brifi yanlış anlayanları yönlendirmek için bir kontrol noktası verir.
Ekibin işini izle
İstemi gönderdikten sonra lider işi görevlere böler ve takım arkadaşlarını başlatır. Terminalin alt kısmında, takım arkadaşı başına bir satır olacak şekilde bir aracı paneli görürsünüz.
Oluşturulan aracılar
Her satır, takım arkadaşının adını ve şu anda ne yaptığını gösterir. Lider paylaşılan görev listesini doldurur ve bağımlılıklara göre görevleri atar veya serbest bırakır. Arka uç takım arkadaşı, ondan get_greeting() içe aktardığı için veritabanı katmanını bekler. Dokümantasyon takım arkadaşı, geri kalanını doğru şekilde anlatabilecek kadar ilerleyene kadar bekler.
Görev listesini de görebilirsiniz. Açıp kapatmak için Ctrl+T tuşlarına basın. Liste her görevi, durumunu (beklemede, devam ediyor veya tamamlandı) ve hangi takım arkadaşının sahibi olduğunu gösterir.
Takım arkadaşları arasında geçiş yapın
Her takım arkadaşı tam bir Claude Code oturumudur ve herhangi biriyle konuşabilirsiniz.
Aracı panelinde, bir takım arkadaşını seçmek için yukarı ve aşağı okları kullanın; ardından oturum kaydını açmak için Enter tuşuna basın. Artık o takım arkadaşının oturumundasınız ve yazdığınız her şey lidere değil, o takım arkadaşına gider. Bu, geri kalanını dahil etmeden belirli bir takım arkadaşına ekstra bağlam vermenin veya yaklaşımını yönlendirmenin yoludur.
Esc tuşuna basarak lidere dönün.
Yoldan çıkan bir takım arkadaşını yönlendirin
Bazen bir takım arkadaşı brifi yanlış anlar veya yapmaması gereken işe sapar. Bunu ya plan onayı sırasında planını kontrol ederek ya da aracı panelinde ilerlemesinin kaydığını fark ederek yakalarsınız.
Plan onayı kullanıyorsanız, takım arkadaşı planlamadan sonra durur ve herhangi bir dosya yazmadan önce size önerisini gösterir. Veritabanı aracısı için bunun nasıl göründüğü şöyle:

Veritabanı aracısı onayı
Önerilen şemayı ve yaklaşımı okuyabilir, ardından geri bildirimle onaylayabilir veya reddedebilirsiniz. Planda bir şey eksikse, "Ham sqlite3 yerine SQLAlchemy kullan" gibi yanıt verebilir ve takım arkadaşı yeniden plan yapar.
Bir takım arkadaşının çalışmaya başladıktan sonra bir sorun fark ederseniz, aracı panelinde takım arkadaşını seçin, oturumunu açmak için Enter tuşuna basın ve mesaj gönderin. Ayrıca seçili bir takım arkadaşında x tuşuna basarak onu durdurabilir veya mevcut kişi tamamen sıkışmışsa liderden yerine yeni bir takım arkadaşı başlatmasını isteyebilirsiniz.
Kapatın ve gözden geçirin
Tüm takım arkadaşları görevlerini bitirdiğinde lider, kısa bir özet ve projeyi çalıştırmak için gereken komutlarla geri döner.

Nihai lider talimatları
Bu noktada işi gözden geçirirsiniz. Oluşturulan dosyaları düzenleyicinizde açabilir ve farkları okuyabilirsiniz.

Oluşturulan app/main.py dosyası
Veritabanı aracısının oluşturup tohumladığı veritabanını da inceleyebilirsiniz.

greetings tablosu
Ardından bağımlılıkları yükleyin, uvicorn app.main:app --reload komutunu çalıştırın ve tam yığının uçtan uca çalıştığını doğrulamak için tarayıcınızda http://localhost:8000 adresini açın.

Nihai uygulama
Değişiklik istiyorsanız, lidere neyin ayarlanacağını söyleyin; ya sorunu kendisi düzeltir ya da bunu ele alması için yeni bir takım arkadaşı başlatır. Sonuçtan memnun kaldığınızda, değişiklikleri commit etmesini isteyebilirsiniz. Oturum sona erdiğinde lider takım arkadaşlarını kapatır ve takım yapılandırması temizlenir.
Hepsi bu!
Sonuç
Claude Code Aracı Takımları iki şeyle ilgilidir: uzmanlaşma ve koordinasyon. Her takım arkadaşının işin kendi parçası ve kendi bağlam penceresi vardır. Lider onları hizalı tutar, görev listesi onları senkronize tutar ve doğrudan mesajlaşma, oturumlar arasında bilgiyi iletmeniz için sizi beklemelerini engeller.
Daha büyük resimde, yapay zekâ destekli geliştirme tek başınalıktan koordineliye doğru evriliyor. Aracı takımları bu değişimin bugün Claude Code'da nasıl göründüğüdür ve aynı desen Slack için Claude Tag'de de ortaya çıkıyor. Buna şimdiden alışan geliştiriciler, bağlam sınırlarıyla uğraşmaya daha az, gerçek özellikler üretmeye daha çok zaman harcayacaklar.
Üretken Yapay Zekâ alanında sertifika mı arıyorsunuz? İşte en iyi kurslar, hazırlık ipuçları ve SSS'leri içeren 2026'nın En İyi Üretken Yapay Zekâ Sertifikaları.
SSS
Claude Code Aracı Takımları nedir?
Claude Code Aracı Takımları, birden fazla Claude Code oturumunun aynı projede aynı anda çalışmasına olanak tanıyan bir koordinasyon katmanıdır. Bir oturum ekip lideri olarak hareket eder ve işin belirli kısımlarını yapmak üzere takım arkadaşı adı verilen diğer oturumları oluşturur. Takım arkadaşları bir görev listesi paylaşır, birbirlerine mesaj gönderir ve liderin koordinasyonu altında işlerini paralel yürütür.
Aracı takımları alt aracılardan nasıl farklıdır?
Alt aracılar tek bir Claude Code oturumu içinde çalışır ve yalnızca sonuçları ana aracıya bildirebilir. Aracı takımları ise, görev listesini paylaşan ve lidere gitmeden birbirlerine mesaj gönderen bağımsız Claude Code oturumlarından oluşur. Çalışanların bulguları paylaşması veya karşılıklı bağımlı görevlerde koordine olması gerektiğinde aracı takımlarını kullanın.
Ne zaman bir aracı takımı kullanmak mantıklıdır?
Aracı takımları, paralel keşiften fayda gören işler için uygundur; çok katmanlı özellikler, büyük yeniden düzenlemeler, rekabet eden hipotezlerle hata ayıklama ve depo genelinde denetimler gibi. Küçük hata düzeltmeleri veya birden fazla takım arkadaşının aynı dosyaları düzenlemek zorunda kalacağı çalışmalar için daha az kullanışlıdır. İyi bir kural, tek bir oturum bağlamı tüketecek ya da çok fazla zaman alacaksa, ekibin ekstra jetona değeceğidir.
Aracı takımlarının jeton maliyeti ne kadar?
Her takım arkadaşı kendi bağlam penceresine sahip tam bir Claude Code oturumudur; bu nedenle jeton kullanımı ekip boyutuyla doğrusal ölçeklenir. Üç veya dört takım arkadaşından oluşan bir ekip, aynı iş miktarı için tek bir oturumun yaklaşık üç veya dört katı jeton kullanır. Koordinasyon genellikle yürütmeden daha derin muhakeme gerektirdiğinden, maliyetleri yönetilebilir tutmak için lideri Opus gibi daha güçlü bir modelde ve takım arkadaşlarını Sonnet'te çalıştırabilirsiniz.
Takım arkadaşlarının birbirinin işinin üzerine yazmasını nasıl engellerim?
İşi dosya veya modül sınırları boyunca bölün; böylece her takım arkadaşı kendi alanının sahibi olur. Ekibi briflerken, her takım arkadaşının sorumlu olduğu belirli dosya veya dizinleri adlandırın ve iki takım arkadaşının aynı dosya üzerinde çalışmasına izin vermekten kaçının. Bir görev aynı dosya üzerinde değişiklik gerektiriyorsa, paralelde çalıştırmak yerine görev listesinde bağımlılık olarak sıralayın.
