12. Plugins (Eklentiler)

Bölüm 10 bağlayıcıları, Bölüm 11 becerileri ele aldı. Eklenti, bu ikisini ve birkaç bileşeni daha tek bir kurulabilir pakette birleştirir.

Ayrımı en yalın hâliyle şöyle kurabiliriz: bağlayıcı erişimdir, beceri bilgidir, eklenti ise paketlemedir. Bağlayıcı Claude'a bir hizmete ulaşma imkânı verir; beceri o hizmetin nasıl kullanılacağını öğretir; eklenti ikisini birlikte, tek adımda kurulur hâle getirir.

12.1 Eklenti Nedir?

Eklenti, bir manifest dosyası ve bileşenlerden oluşan bir pakettir. Kurulduğunda, içindeki her bileşen ayrı ayrı kurulmuş gibi çalışır — ancak kullanıcı tek bir işlem yapmıştır.

Kaynak: Anthropic, "Install plugins" — https://claude.com/docs/cowork/guide/plugins ve "Plugins reference" — https://code.claude.com/docs/en/plugins-reference. Doğrulama tarihi: 6 Eylül 2026.

Önemli Kapsam Sınırı

Bu sınır, Bölüm 10.5'teki bulguyla aynı ailedendir: bir yeteneğin var olması ile sizin ortamınızda kullanılabilir olması farklı şeylerdir. Kısım III boyunca tekrarlanan bu ayrım, Claude ekosistemini anlamanın anahtarıdır.

12.2 Neden Paketleme Önemli?

Bileşenleri ayrı ayrı kurmak mümkünken, neden paket?

Resmî dokümantasyonun verdiği örnek açıklayıcıdır: bir satış eklentisi, bir müşteri yönetimi bağlayıcısını, satış sürecinizi öğreten bir beceriyi, aday araştırma ve görüşme takibi için komutları, ve rakip analizini paralel yürüten bir alt ajanı bir arada barındırabilir. Bu bileşenler birlikte Claude'u bir uzmana dönüştürür; tek tek ise yalnızca yapı taşlarıdır.

İkinci gerekçe dağıtımdır. Bir ekibin veya kurumun ortak çalışma biçimini yaymanın en pratik yolu, onu tek bir kurulabilir pakete koymaktır.

12.3 Canlı Gözlem: Bir Eklentinin Ölçeği

Bu kitabın yazıldığı oturumda kurulu bir eklenti bulunuyordu ve yapısı doğrudan incelendi. Gözlem, eklentilerin ölçeği hakkında kavramsal açıklamalardan daha somut bir fikir verir.

Bulgu

Tek bir eklenti, oturuma on dokuz ayrı beceri yüklemişti. Becerilerin tümü, eklenti adıyla oluşturulmuş ortak bir ad alanı öneki taşıyordu.

Bundan Çıkan Üç Sonuç

• Ad alanı çakışmayı önler. Farklı eklentiler aynı adda beceri sunabilir; ön ek bunları ayırır. Bir beceriyi çağırırken eklenti adıyla birlikte anılır.
• Eklentiler tek beceriden çok daha büyük olabilir. On dokuz beceri, tek bir kurulum işlemiyle gelmiştir. Bu, Bölüm 11'deki kademeli açılımın neden kritik olduğunu gösterir: on dokuz becerinin tam gövdesi bağlamda dursaydı, oturum başlamadan bağlam dolardı.
• Beceriler kendi içlerinde de hiyerarşiktir. İncelenen becerilerin çoğu, ana dosyanın yanında bir başvuru klasörü barındırıyordu — yani kademeli açılım eklenti düzeyinde ve beceri düzeyinde iki kez uygulanmıştı.

12.4 Eklenti Yapısı

Kendi eklentinizi yazmak isterseniz, yapı aşağıdaki gibidir.

Ad Alanı Ayrıntısı

Bir becerinin çağrılma adı, SKILL.md dosyasındaki ad alanından gelir. Bu alan boş bırakılırsa, kurulum dizininin adı kullanılır — ki pazar yerinden kurulan eklentilerde bu ad bir sürüm dizesidir ve her güncellemede değişir.

Pratik sonucu şudur: ad alanını yazmayı ihmal eden bir eklentide, becerilerin çağrılma adları güncelleme sonrası değişir ve kullanıcının alışkanlıkları bozulur.

12.5 Kurulum ve Pazar Yerleri

Eklentiler üç kaynaktan gelir: Anthropic'in yerleşik resmî dizini, kuruluşunuzun kendi dağıtımı, veya doğrudan yüklediğiniz bir dosya.

Claude Code'da Kurulum

Anthropic'in incelenmiş dizini Claude'a yerleşiktir ve ayrıca eklenmesi gerekmez. Üçüncü taraf pazar yerleri, içinde bir pazar yeri manifest dosyası bulunan herhangi bir git deposu olabilir.

Cowork'te Kurulum

Cowork'te kurulum arayüz üzerinden yapılır: pazar yerinden seçme, kuruluşunuzun sunduğu eklentileri kullanma veya dosya yükleme.

12.6 Bilinen Sorun: Yeniden Yükleme

Anthropic'in kendi hata kayıtlarında belgelenmiş bir sorun, eklentiyle çalışanların karşılaşabileceği kafa karıştırıcı bir durumu açıklar.

Bir eklenti kurulduktan sonra yeniden yükleme komutu çalıştırıldığında, eklenti sayacı artar ve işlem başarılı görünür — ancak yeni beceriler kullanılabilir listede görünmez. Beceriler ancak oturum tamamen yeniden başlatıldığında etkin hâle gelir.

Kaynak: anthropics/claude-code hata kaydı #35641. Bu sorun bildirildiği tarihte açıktı; sonradan giderilmiş olabilir. Doğrulama tarihi: 6 Eylül 2026.

12.7 Ne Zaman Eklenti, Ne Zaman Beceri?

Bölüm 11'de üretilen doğrulama becerisi bu tabloya göre doğru seçimdi: tek bir yöntemi kalıcı hâle getiriyor, dış erişim gerektirmiyor ve sohbet arayüzünde çalışması gerekiyor.

12.8 Bölüm Özeti

• Bağlayıcı erişimdir, beceri bilgidir, eklenti paketlemedir.
• Bir eklenti skills, connectors, agents, commands ve hooks bileşenlerini barındırabilir.
• Eklentiler yalnızca Cowork ve Claude Code'da çalışır; sohbet arayüzünde kullanılamaz.
• Tek bir eklenti çok sayıda beceri yükleyebilir; canlı gözlemde on dokuz beceri saptanmıştır.
• Ad alanı öneki, farklı eklentilerin becerileri arasındaki çakışmayı önler.
• Kademeli açılım, eklenti ekosisteminin var olmasını mümkün kılan temel tasarımdır.
• Bileşenler eklenti kökünde durur; manifest klasörüne konulması en sık yapılan yapısal hatadır.
• Beceri adı belirtilmezse kurulum dizini adı kullanılır ve güncellemede değişebilir.
• Kurulum sonrası beceriler görünmüyorsa, oturumu tamamen yeniden başlatın.

Güncellik kontrolü: Kavramsal içerik https://claude.com/docs/cowork/guide/plugins ve https://code.claude.com/docs/en/plugins-reference adreslerinden 6 Eylül 2026 itibarıyla doğrulanmıştır. Canlı gözlem aynı tarihli oturumda yapılmıştır.