# Plugin'ler zaten çalışanı paketler

Plugin yeni bir yetenek değil. Skill'leri, alt ajanları, hook'ları ve MCP sunucularını tek bir kurulabilir, sürümlenebilir birimde topluyor; etkin bir plugin kullanmasanız da her turda bağlam yiyor.

## Dört yerine tek birim

Şimdiye kadar Claude Code'u genişletmenin dört yolunu gördünüz: skill'ler, hook'lar, alt ajanlar ve MCP sunucuları. Her biri tek başına, düz dosyalarla, plugin'e gerek olmadan çalışıyor.

**Plugin** bu listeye yeni bir şey eklemiyor. Bu parçaları, isteğe bağlı olarak dokümanların "mod" dediği bir hook modülüyle birlikte, tek bir kurulabilir birimde topluyor. Birimi `.claude-plugin/plugin.json` dosyası tarif ediyor.

O yüzden dürüst soru "plugin kullanmalı mıyım" değil. Soru şu: birbirine ait bir takım şeyim var mı ve başkası buna ihtiyaç duyuyor mu.

Plugin, bir takımı paylaşmak ya da sürümlemek için. Tek projede tek bir skill'e ihtiyacınız varsa `.claude/skills/` içindeki bir dosya daha basit ve güncellenecek bir şeyi yok.

## İçinde neler olur

Parçalar alışık biçimlerini koruyor. Bir plugin şunları taşıyabilir:

- skill'ler: kurulunca isim alanı alırlar, yani `acme` plugin'indeki `review` skill'i `/acme:review` olur
- alt ajanlar
- `hooks/hooks.json` içinde hook'lar
- MCP sunucuları

İsim alanı işe yarıyor. İki takım da `review` adlı bir skill yayınlayabilir ve biri ötekini ezmez.

## Kurmak ve denemek

Yöneticiyi açmak için `/plugin` yazın. Üç sekmesi var: Discover, Marketplaces ve Installed. **Marketplace**, plugin'leri listeleyen bir katalog; önce kataloğu ekliyor, sonra içinden seçiyorsunuz.

Hâlâ yazmakta olduğunuz bir plugin için marketplace'e hiç gerek yok. Klasörden yüklemek için Claude Code'u `--plugin-dir <dir or zip>` ile, bir bağlantıdaki zip için `--plugin-url <zip url>` ile başlatın. Düzenledikten sonra `/reload-plugins` değişiklikleri alıyor. `claude plugin disable` birini kapatıyor.

```terminal
$ claude --plugin-dir ./acme-tools
* Plugin'i klasörden yükler
> /acme:review
* Plugin'in review skill'ini çalıştırır
# Klasör plugin'in kendisi. Yazarken katalog gerekmiyor.
```

**Question:** acme adlı bir plugin'in içinde review adlı bir skill var. Nasıl çağırırsınız?

- /review
- /acme:review
- /plugin review
- /acme review

**Answer:** /acme:review. Plugin skill'leri /plugin-name:skill-name biçiminde isim alanı alır; bu da diğer skill'lerle çakışmayı önler.


## Gözden kaçması kolay maliyet

Plugin kurmak bedava gibi hissettiriyor ama değil.

Etkin bir plugin, çağrılabilir bileşenlerinin adlarını ve açıklamalarını her turda bağlama koyuyor. MCP sunucuları ve hook'ları yalnızca plugin'i kullandığınızda değil, her oturumda çalışıyor. Bir öğleden sonra için kurduğunuz plugin, siz kapatana kadar bunların hepsini ödemeye devam ediyor.

Bunu görmenize yardım eden iki şey var. Anthropic'in resmi marketplace'indeki plugin'ler, kurmadan önce bir bağlam maliyeti tahmini gösteriyor. Installed sekmesi ise dokunmadığınız plugin'leri "Not used recently" altında grupluyor; temizlik listeniz bu.

> **Plugin içindeki alt ajanlar neyi yapamaz**
Bir plugin'le gelen alt ajanlar `hooks`, `mcpServers` ve `permissionMode` alanlarını güvenlik nedeniyle yok sayıyor. Plugin alt ajanında yazdığınız bir hook eksik görünüyorsa sebep bu. O davranışı plugin'in kendi hook'larına koyun.


## Takımla paylaşmak

Yol şu: parçaları düz dosya olarak kurup test edin, bir `plugin.json` ile paketleyin ve başkalarının tek yerden kurup güncelleyebilmesi için marketplace üzerinden yayınlayın. Sürüm plugin'le birlikte durduğu için kopyalanan klasörlerin zamanla birbirinden ayrışması sorunu çözülüyor.

Paylaşmadan önce test edin. `claude plugin eval` plugin'ler için test paketlerini çalıştırıyor. Otomatik çalıştırmalarda plugin ve bağımlılık yükleme hataları `system/init` event'inin `plugin_errors` alanında görünüyor; bu da CI'da iyi bir kapı oluyor.

> **Taşıdıklarınızı denetleyin**
`/plugin` açın, Installed'a gidin ve "Not used recently" grubunu okuyun. Özlemeyeceklerinizi kapatın. Sonra normal bir iş yapın ve bir şeyin eksik olup olmadığına bakın.


**Question:** Etkin bir plugin hakkında hangisi doğrudur?

- Siz çağırana kadar maliyeti yoktur
- MCP sunucuları ve hook'ları her oturumda çalışır
- Yalnızca bir skill eşleşince yüklenir
- Kurulduktan sonra kapatılamaz

**Answer:** MCP sunucuları ve hook'ları her oturumda çalışır. Etkin plugin her turda bağlam ekler, MCP sunucularını ve hook'larını kullanılsın kullanılmasın her oturumda çalıştırır. claude plugin disable onu kapatır.