Anla Dene

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

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

  1. Plugin'in neleri paketlediğini bil. Doküman bileşenleri şöyle sayıyor: skill'ler (SKILL.md talimatları), 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.
  2. Gözatmak için /plugin yaz. 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).
  3. 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-commands plugin'idir.
    /plugin install commit-commands@claude-plugins-official
  4. 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ığı.
  5. 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 kez claude plugin install <ad>@<marketplace> --scope project çalıştırır.
  6. 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 bir marketplace.json adresi 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
    /plugin install deploy-helper@your-marketplace
    Aynı işi kabuktan da yapabilirsin: claude plugin marketplace add ve claude plugin install.
  7. Yönet ve gerekirse kaldır. /plugin panelindeki 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 enable ve claude 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.
  8. Kendi plugin'ini yap. En küçük plugin tek bir skill'dir. Önce klasör ve manifest:
    mkdir -p my-first-plugin/.claude-plugin
    Manifest my-first-plugin/.claude-plugin/plugin.json dosyasına yazılır. Zorunlu tek alan name'dir; description, version ve author isteğe bağlıdır:
    {
      "name": "my-first-plugin",
      "description": "Selamlama örneği",
      "version": "1.0.0",
      "author": {
        "name": "Senin Adın"
      }
    }
    Skill, plugin klasörünün kökünde skills/<ad>/SKILL.md olarak durur (.claude-plugin/ içine yalnız plugin.json girer). Sonra doğrula ve yalnızca bu oturum için yükle:
    claude plugin validate ./my-first-plugin
    claude --plugin-dir ./my-first-plugin
    Plugin'deki skill, plugin adı önekiyle çalışır. Örnekte skill'in adı hello ise komutu /my-first-plugin:hello olur. Önek, iki plugin'in aynı adlı skill'i yüzünden çakışmasını önler.
  9. Yayınla. Doküman üç yol sayıyor: (1) plugin klasörünü ya da .zip halini 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.json eklenir; dosya depodaysa plugin yayınlanmış sayılır. Kullanıcılara iki komut verirsin: marketplace'i ekleyen claude plugin marketplace add your-org/your-marketplace ve plugin'i kuran claude plugin install deploy-helper@your-marketplace. Yayından önce claude 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.

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

Video

Video: yakında.

Kaynak

Son doğrulama: 2026-10-21

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik