Claude · Gelişmiş · 202 Genişlet · Konu 5 / 5
4.9 Plugins
Hazır paketleri kur, kendininkini yayınla. Ama önce içine bak.
Bu sayfada ne öğreneceksin
- Plugin'in ne olduğunu ve skill, subagent, hook, MCP ile ilişkisini
- Bir marketplace'ten plugin kurmayı ve kurmadan önce neye bakacağını
- Kendi kurulumunu plugin yapıp arkadaşlarına ya da ekibine yayınlamanın yollarını
Kısaca
Daha önceki konularda skill'leri (4.1), subagent'ları (4.2), MCP bağlantılarını (4.3) ve hook'ları (4.4) tek tek kurdun. Bunları başkalarıyla paylaşmak istersen dosyaları makineden makineye kopyalamak zorunda kalırsın. Plugin bu sorunu çözer.
Resmî dokümana göre plugin; skill, agent, hook, MCP sunucusu gibi bileşenlerin bulunduğu ve Claude Code'un tek birim olarak kurup yüklediği bir klasördür. Kursun cümlesiyle: plugin, bir kurulumu paketleyip bir kişiden diğerine taşıma yoludur. Çoğu plugin bir marketplace'ten gelir. Marketplace, plugin'leri ve her birinin nereden alınacağını listeleyen bir katalogdur.
Doküman bir ayrım da yapıyor: skill, subagent, hook ve MCP sunucuları plugin olmadan da tek başına çalışır. Kurulumun yalnız sana ya da tek projene hizmet ediyorsa bu haliyle bırakabilirsin. Birkaç bileşeni tek paket olarak paylaşmak, birçok projeye kurmak ya da sürümlü yayın çıkarmak istediğinde plugin yapmak mantıklıdır.
En önemli nokta güvenlik: kurduğun plugin makinende, senin yetkilerinle kod çalıştırabilir. Bu yüzden sayfanın büyük kısmı "kurmadan önce nasıl bakarım" üzerine.
Adım adım
- Plugin'in neleri paketlediğini bil. Doküman bileşenleri şöyle sayıyor: skill'ler (
SKILL.mdtalimatları), agent'lar (Claude'un iş devredebileceği subagent tanımları), hook'lar (yaşam döngüsündeki noktalarda çalışan komutlar), MCP sunucuları. Plugin'in adını belirleyen küçük bir manifest dosyası da vardır:.claude-plugin/plugin.json. - Gözatmak için
/pluginyaz. Bir Claude Code oturumunda bu komut paneli açar; Discover (Keşfet) sekmesi marketplace'lerindeki plugin'leri listeler, yazarak arayabilirsin. Doküman, Anthropic'in resmî marketplace'inin Claude Code'u ilk kez etkileşimli terminal oturumunda başlattığında kendiliğinden eklendiğini söylüyor (yönetici ilkesi engellemedikçe). - Adıyla kurmaya başla. Aşağıdaki komut doğrudan kurmaz; önce plugin'in ayrıntılarını açar ki incelemeni yapıp kapsamı seçebilesin. Örnek, dokümandaki
commit-commandsplugin'idir./plugin install commit-commands@claude-plugins-official - Ayrıntı panelini oku. Panelde Will install bölümü plugin'in eklediği komutları, agent'ları, skill'leri, hook'ları ve MCP/LSP sunucularını gösterir. Anthropic'in resmî marketplace'indeki plugin'lerde Context cost (bağlam maliyeti) tahmini de görünür; plugin'i adıyla (yukarıdaki komutla) ya da Marketplaces sekmesinden açtığında çıkar, Discover listesinden açılan panelde çıkmaz. Panelde ayrıca şu uyarı çıkar: Anthropic'in plugin'lerin içine neyin konduğunu denetlemediği ve beklendiği gibi çalışacağını doğrulayamadığı.
- Kapsamı seç. Doküman üç kapsam sayıyor: user (sende, bu makinedeki her projede), project (bu depoda çalışan herkes için, işlenen
.claude/settings.jsonüzerinden) ve local (yalnız sende, yalnız bu depoda). Project kapsamı eklentiyi başkalarının makinesine indirmez; her ekip arkadaşı kendi makinesinde bir kezclaude plugin install <ad>@<marketplace> --scope projectçalıştırır. - Başka bir marketplace gerekiyorsa önce onu ekle. Kaynak bir GitHub deposu (
owner/repo), tam git adresi, yerel klasör ya da barındırılan birmarketplace.jsonadresi olabilir. Bir arkadaşının ya da şirketinin yayınladığı marketplace, dokümanın sınıflandırmasında "third-party" (üçüncü taraf) sayılır. Aşağıdaki iki komuttan ilki marketplace'i ekler, ikincisi plugin'i kurar (adlar kurgusaldır)./plugin marketplace add your-org/your-marketplace
Aynı işi kabuktan da yapabilirsin:/plugin install deploy-helper@your-marketplaceclaude plugin marketplace addveclaude plugin install. - Yönet ve gerekirse kaldır.
/pluginpanelindeki Installed sekmesinden plugin'i etkinleştirebilir, devre dışı bırakabilir, güncelleyebilir ya da kaldırabilirsin. Kabuktan karşılıkları:claude plugin disable,claude plugin enableveclaude plugin uninstall. Doküman otomatik güncellemenin Anthropic'in resmî marketplace adlarının çoğunda (iki istisna var) ve claude.ai'dan eklenen marketplace'lerde varsayılan olarak açık, topluluk, üçüncü taraf ve yerel geliştirme marketplace'lerinde kapalı olduğunu söylüyor. - Kendi plugin'ini yap. En küçük plugin tek bir skill'dir. Önce klasör ve manifest:
Manifestmkdir -p my-first-plugin/.claude-pluginmy-first-plugin/.claude-plugin/plugin.jsondosyasına yazılır. Zorunlu tek alanname'dir;description,versionveauthoristeğe bağlıdır:
Skill, plugin klasörünün kökünde{ "name": "my-first-plugin", "description": "Selamlama örneği", "version": "1.0.0", "author": { "name": "Senin Adın" } }skills/<ad>/SKILL.mdolarak durur (.claude-plugin/içine yalnızplugin.jsongirer). Sonra doğrula ve yalnızca bu oturum için yükle:claude plugin validate ./my-first-plugin
Plugin'deki skill, plugin adı önekiyle çalışır. Örnekte skill'in adıclaude --plugin-dir ./my-first-pluginhelloise komutu/my-first-plugin:helloolur. Önek, iki plugin'in aynı adlı skill'i yüzünden çakışmasını önler. - Yayınla. Doküman üç yol sayıyor: (1) plugin klasörünü ya da
.ziphalini doğrudan birkaç kişiye vermek, (2) kendi marketplace'ini kurmak, (3) Anthropic'in dizinine başvurmak. Kendi marketplace'in için depoya bir.claude-plugin/marketplace.jsoneklenir; dosya depodaysa plugin yayınlanmış sayılır. Kullanıcılara iki komut verirsin: marketplace'i ekleyenclaude plugin marketplace add your-org/your-marketplaceve plugin'i kuranclaude plugin install deploy-helper@your-marketplace. Yayından önceclaude plugin validate --strict ./your-pluginçalıştırmanı öneriyor. Plugin adını kalıcı say: yeniden adlandırılan plugin, mevcut kurulumlar için başka bir plugin olur.
Kurmadan önce: güvenlik
Bu bölüm sayfanın en önemli kısmı. Resmî doküman şunu açık söylüyor: kurduğun bir plugin makinende senin kullanıcı yetkilerinle keyfi kod çalıştırabilir. Kurs da aynı uyarıyı yapıyor: plugin'in hook'ları her eşleşen araç çağrısında çalışır, yani plugin'i skill'leri için kursan bile hook'ları da gelir.
- Hook, izleyici ve sunucu süreçleri izin kurallarının dışında kalır. Dokümana göre hook'lar ve plugin'in başlattığı MCP/LSP sunucuları kum havuzunun (sandbox) dışında, tam kullanıcı yetkisiyle çalışır. İzin kuralların yalnızca Claude'un yaptığı araç çağrılarını kapsar.
- Hook'lar birikir. Kursa göre plugin'in
PreToolUsehook'u ile seninki ikisi de her araç çağrısında çalışır; biri ötekinin yerini almaz. Skill, agent ve komutlar ise plugin adıyla önek aldığı için seninkilerle çakışmaz. - Plugin davranışı değiştirebilir. Plugin köküne bir
settings.jsonkonabilir ama dokümana göre yalnızagentvesubagentStatusLineanahtarları etki eder. Kursa göreagentanahtarı, plugin'in bir subagent'ını ana konuşmaya yükseltir; yani plugin'i açmak Claude Code'un varsayılan davranışını değiştirebilir. - Güncellemeyle içerik değişebilir. Marketplace'te otomatik güncelleme açıksa Claude Code plugin'i arka planda günceller; incelediğin dosyalar diskte değişebilir.
- İnceleme sırası (dokümandan). Kabukta
claude plugin marketplace listile marketplace'in kaynağını gör./pluginpanelindeki ayrıntıyı oku. Will install bölümü bir hook'un var olduğunu gösterir ama ne çalıştırdığını göstermez; bunun için plugin dizinindekihooks/hooks.json(her hook'un komutu),.mcp.json(her sunucunun komutu ya da adresi) vebin/içindeki dosyaları oku. Plugin deposunu klonlayıpclaude --plugin-dir <plugin dizini> plugin details <plugin adı>komutunu çalıştırırsan oturum başlatmadan birComponent inventory(bileşen dökümü) alırsın. - "İncelenmiş" güvenilir demek değildir. Kurs, otomatik incelemenin her şeyi yakalamadığını ve resmî marketplace'in ayrı bir kuyrukla seçildiğini söylüyor. Kuralı da şöyle koyuyor: plugin'i ve marketplace'i yalnız gerçekten güvendiğin kaynaklardan ekle.
- Güvenmediğini kaldır.
claude plugin uninstall <plugin>komutunu kurduğun--scopeile çalıştır. Dosyalar~/.claude/plugins/cache/altında bir süre diskte kalır. Marketplace sahibine de güvenmiyorsan marketplace'i de kaldır; bu, ondan kurduğun tüm plugin'leri kaldırır.
Plugin'ler her oturumun parçasıdır. Dokümana göre Claude'un kendiliğinden çağırabileceği skill, agent ve komutların adı ve açıklaması her turda bağlamdadır; hiç kullanılmasa bile bağlam penceresinde yer tutar ve kullanımına sayılır. Kullanılmayanı /plugin ya da claude plugin disable ile kapat.
Hazır prompt
Bir plugin'i kurmadan önce Claude'dan ikinci bir göz iste. Bu, senin incelemenin yerini tutmaz; Claude yanılabilir, yazdığı her komutu ve dosya yolunu kendin da kontrol et. Köşeli parantezleri doldur:
[plugin adı] plugin'ini kurmadan önce incelemek istiyorum. Plugin'in deposunu klonladığım klasör: [klasör yolu]. hooks/hooks.json, .mcp.json ve bin/ klasöründeki dosyaları oku. Şunları listele: hangi hook hangi olayda ne komutu çalıştırıyor, hangi MCP sunucusu hangi komut ya da adresle başlıyor, bin/ içinde ne var. Ağa bağlanan ya da dosya silen bir şey varsa özellikle belirt. Emin olmadığın yerde tahmin yürütme, "bilmiyorum" de.
Daha büyük bir plugin'i Claude ile birlikte kurmak için doküman, resmî marketplace'teki plugin-dev plugin'ini kurup /plugin-dev:create-plugin komutunu yazdığın bir açıklamayla çalıştırmayı gösteriyor:
/plugin-dev:create-plugin [plugin'in ne yapacağını bir iki cümleyle anlat. Örnek: ekibimizin kod inceleme skill'ini ve bir kontrol hook'unu paketleyen plugin]
Sık yapılan hata
- Plugin'i yalnızca skill'leri için kurup hook'larına bakmamak. Hook'lar da gelir ve komut çalıştırır. Kurmadan önce Will install panelini ve
hooks/hooks.jsondosyasını oku. - Marketplace adına güvenmek. Doküman, marketplace adının kataloğu kimin yayınladığını söylediğini, her plugin'in ne yaptığını söylemediğini belirtiyor. Hangi marketplace'ten gelirse gelsin kurmadan önce incele.
- Version'u artırmadan yeni commit göndermek. Doküman:
plugin.json'daversionvarsa ve değiştirmeden commit atarsan kullanıcılar eski kopyada kalır. Her yayındaversion'u artır ya da git tabanlı marketplace'te hiç koyma (o zaman commit SHA'sı kullanılır). - Bileşenleri
.claude-plugin/içine koymak. Oraya yalnızplugin.jsongirer; orada duran bileşenler yüklenmez. Skill, agent, hook ve MCP dosyaları plugin kökünde durur. - Plugin'e sır koymak. API anahtarı, token ya da parola gibi değerleri plugin dosyalarına yazma, çünkü plugin başkalarına dağıtılır. Kullanıcıdan alınacak değerler için dokümandaki
userConfigalanı var, hassas değerler"sensitive": trueile maskelenir ve güvenli depoda tutulur.
Video
Video: yakında.
Kaynak
- Anthropic Academy, Claude Code in action: Plugins (plugin tanımı, marketplace, kurmadan önce okuma, hook'ların birikmesi, manifest)
- Claude Code dokümanı: Plugins overview (plugin nedir, ne zaman gerekir, kapsamlar, marketplace)
- Claude Code dokümanı: Install and manage plugins (kurma komutları, marketplace ekleme, yönetme, güncelleme)
- Claude Code dokümanı: Plugin security and trust (ne yapabilir, inceleme adımları, kaldırma)
- Claude Code dokümanı: Create a Claude Code plugin (manifest, ilk plugin,
--plugin-dir) - Claude Code dokümanı: Publish and distribute a plugin (dağıtım yolları, sürümleme, kendi marketplace'in)
- Claude Code dokümanı: Anthropic's marketplaces (resmî, topluluk ve demo marketplace)
- Claude Code dokümanı: Add components to a plugin (plugin
settings.jsonanahtarları,userConfig)
Son doğrulama: 2026-10-21