Eklenti nasıl seçilir ve güvenle kurulur

Bir skill sayfayı gözle görülür biçimde iyileştirdi ve sonraki adım kendiliğinden akla geliyor: bir tane değil, hemen on tane kurmak. Tam bu sırada bir meslektaş bir bağlantı gönderiyor: "kur, işine yarar". Bunların hepsi tek bir komutla kuruluyor ve tuzak da tam burada. Eklenti bir yetenek listesi gibi görünüyor, ama aslında makinenizde sizin yetkilerinizle çalışacak ve ajanla her konuşmada yer kaplayacak bir kod.

Eklentinin skill'den farkını ve içinde ne olabileceğini, katalogların nereden geldiğini ve güvenilir bir kaynağı rastgele birinden nasıl ayırt edeceğinizi, Claude Code'un kurulumdan önce neyi gösterdiğini ve bunu nasıl okuyacağınızı ele alalım. Sonra bütün yolu baştan sona geçelim: kurmak, kendi görevinizde denemek, kapatmak, kaldırmak. Sonunda da her kurulumdan önce ne yapmanız gerektiğine ve aynısını ajanın internetten getirdiği her skill için neden yapmak gerektiğine bakacağız.

1. Skill ve plugin

Bir marangozun yazıya geçirilmiş prosedürleri vardır: tezgah nasıl hazırlanır, nasıl bileme yapılır, bir seri şablonla nasıl çıkarılır. Tek başına çalıştığı sürece bunlar defterinde durur. Sonra atölyedeki komşusu birini ister, çırağı bir başkasını, bir ay sonra da karşıdaki atölye arar ve herkese tek tek kağıt göndermekten bıkar. O zaman birkaç prosedürü bir kutuya koyar, yan yüzüne atölyenin damgasını vurur ve içine bir not bırakır: burada ne var ve nasıl kullanılır. Böyle bir kutu bütün olarak verilebilir, güncellenebilir ve numaralandırılabilir.

İşte eklenti (plugin) budur. Bir yetenek daha değil, birkaç yeteneğin etrafındaki bir paket.

Eklenti tek başına ayrı bir yetenek değil, birkaç yeteneği dağıtmanın bir yolu. Yapabildiği her şeyi içindekiler sayesinde yapar: yetenekler, yardımcılar, otomatik tepkiler, bağlantılar. Bu yüzden "eklenti ne yapabiliyor" sorusu her zaman şu soruya varır: içinde ne var.

Kendi eklentinizi, skill'lerinizi başkaları da istemeye başladığında toplarsınız. Tam olarak neye ihtiyacınız olduğundan emin değilseniz - skill mi, ayrı rolü olan bir yardımcı mı, yoksa eklenti mi - ajana sorun, ama hemen oluşturmaya girişmeden önce size sorular sormasını isteyin: taslağı o hazırlar, içinde ne olduğunu siz kontrol edersiniz. Basit bir ölçüt: aynı isteği tekrarlıyorsanız - skill; yan iş konuşmayı kirletiyorsa - yardımcı; aynı set başka bir projede de gerekiyorsa - eklenti. Eklentinin adım adım nasıl toplandığı ayrı bir konu. Bu yazı kutuyu teslim alanlar için.

2. Eklentinin içinde ne var

Kutuda çoğunlukla beş bölme bulunur ve hepsi aynı derecede zararsız değildir.

• skills - ajanın açıklamaya göre kendiliğinden ya da sizin komutunuzla uyguladığı prosedürler;
• agents - ajanın işin bir kısmını devrettiği, ayrı role sahip yardımcılar;
• hooks - olaylara verilen otomatik tepkiler: bir şey gerçekleştiğinde sizin isteğiniz olmadan komut çalıştırırlar;
• MCP servers - dış servislere bağlantılar; bunlar sayesinde ajan bilgisayarınızın dışında bir şeyler okur ve değiştirir;
• LSP servers - belirli bir dil için kod önerileri; ayrıca kurulmuş bir programa ihtiyaç duyarlar.

Alttaki iki bölme, kutunun bir köşeye atılmayıp dikkatle teslim alınmasının nedeni. Hooks ve MCP içeren bir eklenti, bir "yetenek setinden" beklemeyeceğiniz şeyleri yapabiliyor: komut çalıştırmak ve dış servislere gitmek. İçinde duvara asılacak bir poster değil, gerilim altındaki canlı bir alet var. Hooks, MCP ve agents'ın tek tek ne olduğu ayrı birer konu; burada paketin parçası olarak ne anlama geldiklerini bilmek yeterli. Bu beşinin dışında bölmeler de olur, örneğin varsayılan ayarlar ya da ajanın yanıt stili, ama bunlar genel tabloyu değiştirmez.

Elinizde kart yoksa ajandan eklentinin reposunu açıp klasörlerinde ne olduğunu anlatmasını isteyin.

3. Önekli isim

Eklentiden gelen skill'lerin adında önek bulunur: /eklenti-adı:skill-adı, örneğin /commit-commands:commit. Komşunuzun da bir "temizlik"i olabilir, ama kutuda damga olduğu sürece ikisini karıştırmazsınız.

Bedeli uzun bir isim: ortak bir setin karşılığını komutu daha uzun yazarak ödersiniz. Proje klasöründeki kendi skill'inizde önek yoktur.

Bir faydası da var. / menüsünde önekten komutun nereden geldiği ve kimin kutusuna ait olduğu her zaman görülür.

4. Katalog ve iki adım

Kutular depodan alınır. Eklenti kataloğu, İngilizcesiyle marketplace, birinin tuttuğu, başkalarının eklentilerinden oluşan bir listedir. Onunla iki adımda çalışılır: önce katalog bağlanır, sonra ondan eklentiler tek tek kurulur. Kataloğu bağlamak tek başına hiçbir şey kurmaz, yalnızca bir liste edinirsiniz.

Çoğu kişi için ilk adım zaten atılmış durumda. /plugin komutu dört sekmeli bir panel açar: Discover - bağlı tüm kataloglarda eklenti aramak; Installed - kurulu olanlar; Marketplaces - kataloglar; Errors - yükleme hataları. Anthropic'in resmi kataloğu ilk çalıştırmadan itibaren bağlıdır ve eklentileri Discover sekmesinde hemen görünür: seçin, açın, kurun. Claude Code'u açmadan bakmak isterseniz aynı liste claude.com/plugins sitesinde de var.

İkinci katalog, ihtiyacınız olan eklenti resmi katalogda olmadığında devreye girer: topluluk kataloğu ya da içinde katalog dosyası bulunan başka birinin reposu. Tek komutla bağlanır, ondan eklenti kurmak da tek komut:

/plugin marketplace add anthropics/claude-plugins-community   # topluluk kataloğunu bağla
/plugin install eklenti-adı@claude-community                  # ondan tek bir eklenti kur
/plugin list                                                  # eklentinin listede olduğunu kontrol et

Başka birinin kataloğu da aynı ilk komutla bağlanır, yalnızca onun adresiyle.

En sık takılınan bir incelik var (ben de istisna değilim). Kurulumda kullanılan katalog adı repo adından değil, kataloğun kendi tanımından gelir: repo anthropics/claude-plugins-community adını taşır, ama kurulum claude-community üzerinden yapılır. Kataloğun adı Marketplaces sekmesinde görünür.

Resmi katalogda farklı türde eklentiler var. GitHub entegrasyonu bir MCP, yani dış bir servise bağlantı. Bir dil için kod önerileri, mesela typescript-lsp, bir LSP. security-guidance ise ajanın her değişikliğini tipik güvenlik açıklarına karşı kontrol eder.

5. Kaynağa güvenin üç basamağı

Eklenti bir klasörden kendiliğinden yüklenmez: açıkça kurulması gerekir ve bu bürokrasi değil. İçinde sizin yetkilerinizle çalışacak kod var, yani bu bilgisayarın başında sizin yapabildiğiniz her şeyi o da yapabilir. Bu yüzden herhangi bir eklenti hakkındaki ilk soru "ne yapabiliyor" değil, "nereden geliyor" olmalı.

Resmi katalog. Anthropic tarafından tutulur, ama içindeki eklentilerin çoğu Anthropic'in kendisinden değil, iş ortaklarından ve başka yazarlardan gelir. Burada yabancı bir repoya göre daha az dikkat gerekir, ama açıklamayı ve içeriği yine de okumakta fayda var.

Topluluk kataloğu. Anthropic'in otomatik kontrolünden geçmiş üçüncü taraf eklentiler; neredeyse her biri katalogda belirli bir sürüme sabitlenmiştir. Bu bir filtre, garanti değil: eklentinin tam olarak vaat ettiğini yaptığını kimse doğrulamadı.

Herhangi bir repo ya da klasör. Hiçbir kontrol yok. Yazarın kim olduğuna, anlaşılır bir açıklama olup olmadığına ve klasörlerde ne bulunduğuna kendiniz bakarsınız.

Tek bir çalışma oturumunda üç basamağın hepsiyle karşılaşabilirsiniz: topluluk kataloğundan bir tasarım eklentisi, Anthropic'in kataloğundan bir başkası, içinde tek bir eklenti bulunan yabancı bir repodan üçüncüsü. Her an hangi basamakta durduğunuzu biliyorsanız bu normal.

Ölçü eklentiye göre değişir. Ne kadar çok şey yapabiliyorsa, yani içinde ne kadar çok hooks ve MCP varsa ve kaynak resmi olandan ne kadar uzaksa, o kadar dikkatli bakın.

6. Claude Code kurulumdan önce ne gösterir

Ne kadar dikkatli bakacağınızı kaynak belirler. Ayrıntıları Claude Code'un kendisi gösterir: eklentiyi /plugin panelinin Marketplaces sekmesinden ya da /plugin install ad@katalog komutuyla açın, kartını göreceksiniz. Discover listesindeki kart daha kısadır: içinde maliyet tahmini yoktur.

Kartta, bütün bu işin asıl amacı olan üç satır var. Son ikisi yalnızca resmi katalogdaki eklentilerde bulunur.

• Will install - içerik: kaç skill, agent, hook, MCP ve LSP geleceği;
• Context cost - eklentinin ajanın penceresine ne kadar ekleyeceği: Every turn - her isteğinizde, When invoked - ajan onun skills ve agents bileşenlerini yüklediğinde;
• Last updated - eklentinin en son ne zaman güncellendiği.

Will install:  skills: 8   agents: 1   hooks: 2   MCP servers: 1
Context cost:  Every turn: ~400 tokens   When invoked: ~1.5k tokens
Last updated:  2 weeks ago

Sayılar ve satırların görünümü temsili, her eklentide ve Claude Code sürümünde farklıdır. İçeriği okumak kolay, ama bu yalnızca ilk yaklaşım: içinde sadece skills varsa eklenti büyük olasılıkla okuyor ve öneride bulunuyordur; hooks ya da MCP varsa komut çalıştırıyor ya da dışarı çıkıyordur ve bu, açıklamayı açıp tam olarak hangileri olduğunu anlamak için bir sebep. Kart her şeyi göstermez: eklenti, kartta görünmeyen çalıştırılabilir dosyalar ve varsayılan ayarlar da getirebilir. Tanımadığınız bir kaynakta repoya da göz atın.

Kartın sormayacağı üçüncü soru da şu: eklenti size uygun mu. İyi bir eklentiyi bile kurmayabilirsiniz. Sizin skill'inizle aynı işi yapıyor, başka bir işletim sistemi için script'ler getiriyor ya da sizde olmayan bir sorunu çözüyor olabilir.

7. Eklenti kimin için kurulur

Kutunun kime verileceğine kurulum sırasında, önceden karar verilir. Üç seçenek var.

• user - size, tüm projelerinizde;
• project - bu repoyla çalışan herkese: kayıt .claude/settings.json dosyasına gider ve projeyle birlikte taşınır;
• local - size ve yalnızca bu projede, meslektaşlarınıza görünmez.

Bir de managed var: onu yönetici kurar ve siz değiştiremezsiniz. Çoğu kişi bununla karşılaşmaz.

Kural tek: uyan en dar scope. Eklentinin etkin olduğu yer ne kadar azsa, çalıştığı durum da o kadar az olur ve sonradan temizlenecek şey de o kadar azalır. Şüpheli bir eklenti dar scope ile zararsız hale gelmez: etkin olduğu yerde yine aynı şeyleri yapabilir. Project scope ayrıca anılmayı hak ediyor: yalnızca kendiniz için karar vermiyorsunuz. Repoyu açan bir meslektaşta eklenti etkin olur ama kurulu olmaz: /plugin panelinin Errors sekmesinde bir uyarı belirir, eklentiyi ise kendisi kurması gerekir.

Panelden kurarken scope sorulur; /plugin install da seçim yapabileceğiniz bir kart açar.

8. Kurmak ve kontrol etmek

Kurulum sorunsuz geçtiyse iki cümleden biriyle biter. Ya eklenti zaten etkindir ya da /reload-plugins çalıştırmanız istenir. İkinci durumda çalıştırırız; komut, yeniden yüklemenin konuşmayı yeniden okuyacağı uyarısını verirse --force ile tekrarlarız. Claude Code'u yeniden başlatmaya gerek yok.

Eklentinin kurulduğunu /plugin list gösterir: eklenti listededir ve skill'leri / menüsünde önekle birlikte belirmiştir.

Açık bir kutu tezgahta yer kaplar. Etkin bir eklenti, ilk saniyeden itibaren ajanın penceresine kendi skill'lerinin duyurularını ekler: adlarını ve açıklamalarını. Tam içerik yalnızca skill iş başına geçtiğinde yüklenir, ama duyurular her zaman orada durur. Dış servislere bağlantılarda araç adları hemen gelir, açıklamalar ise gerektikçe; otomatik tepkiler pencerede neredeyse hiç yer kaplamaz. Pencere ne kadar doluysa her yanıt o kadar pahalı ve yavaş olur.

Gerçek bedeli yalnızca karşılaştırarak görürsünüz: /context pencerenin neyle dolu olduğunu gösterir. Kurulumdan önce ve sonra çalıştırın.

1) eklenti olmadan: kendi görevinizi yapın, sonucu not edin
2) eklentiyi kurun, gerekirse /reload-plugins
3) aynı görevi tekrar yapın
4) karşılaştırın ve karar verin: tutmak, kapatmak, kaldırmak

Karşılaştırmanın sonucu burada bilerek yok: herkesinki farklı. Ölçüt basit: eklentinin ne yaptığını iki cümleyle anlatabiliyor ve onu tutmak ya da kaldırmak için bir sebep söyleyebiliyorsanız tamam - açıklamadan değil, kendi denemenizden.

9. Kapatmak, kaldırmak, kataloğu çıkarmak

Üç işlem var ve birbirlerinden farklılar. /plugin disable kapatır ama kaldırmaz: eklenti pencerede yer kaplamayı bırakır, geri açmak için /plugin enable. /plugin uninstall tamamen kaldırır. /plugin marketplace remove kataloğu kaldırır ve onunla birlikte ondan kurulmuş bütün eklentiler de silinir. Bunu unutmak kolay.

/plugin disable eklenti-adı@katalog      # kapat ama kaybetme
/plugin uninstall eklenti-adı@katalog    # tamamen kaldır
/plugin marketplace remove katalog       # kataloğu ve ondan kurulan her şeyi kaldır

Komutlar aynı paneli açar ve açık bırakır, kapatmak için Esc. Installed sekmesinde aynı işler komutsuz da yapılır: sorunlu eklentiler üstte gösterilir, kapatılmış olanlar altta daraltılmış durur. Tüm proje için etkin bir eklentiyi kaldırırsanız Claude Code sorar: yalnızca sizde mi, yoksa herkes için mi.

Temizlik. Kendi kurduğunuz ve iki hafta boyunca, on oturum içinde hiç kullanmadığınız eklentileri Claude Code, Installed sekmesinde "Not used recently" başlığı altında toplar, kartta da eklentinin en son ne zaman çalıştığını gösterir. Ayrıca /doctor kullanılmayan eklentileri bağlamdaki maliyetleriyle birlikte listeler. araç takımı, içinde ne olduğunu ve neden orada olduğunu hatırladığınız sürece bir takım olarak kalır.

Güncellemeler. Resmi kataloglar kendiliğinden güncellenir ve /reload-plugins çalıştırmanızı ister; üçüncü taraf kataloglar varsayılan olarak güncellenmez. Bir güncelleme neredeyse yeni bir kurulumdur: içerik değişebilir ve kartı yeniden açmakta fayda var.

Bir şey bozulursa, kurulumun kendisi sırasında bile: nedeni Errors sekmesi gösterir. Sonrası kapatmak, yeniden kurmak, son çare olarak eklenti önbelleğini temizleyip yeniden kurmak. Marketplaces sekmesinden resmi katalog kaybolduysa onu /plugin marketplace add anthropics/claude-plugins-official geri getirir.

10. Sadece eklentiler değil

İsteğiniz üzerine ajanın başka birinin reposundan indirip proje klasörüne koyduğu bir skill de aynı durum, yalnızca katalog, kart ve scope yok. Onu sizden başka kontrol edecek kimse yok.

Sorular aynı. Nereden geliyor. İçinde ne var: SKILL.md bir dakikada okunur, ama klasörün tamamı kontrol edilir - başvurduğu script'ler ve dosyalar da. Hangi araçları kendine önceden izinli sayıyor: allowed-tools alanı. Bu alan, ayrıca sorulmadan önceden onaylanmış olanı gösterir, olabilecek her şeyin tam listesini değil. Üçüncü taraf bir servisin reposundan gelen bir skill kendine komut çalıştırma izni verebilir ve dışarıya bir şey gönderen bir skill için bu gayet normal. Ama bunu ilk çalıştırmadan önce görmek gerekir, sonra değil.

Eklentiden tek bir farkı var. Skill'in kartı yoktur, ama bütün içeriği düz metin olarak hemen yanında durur ve ilk çalıştırmadan önce okunabilir.

11. Her kurulumdan önce ne yapmalı

Yazıda geçtikleri sırayla altı adım.

1. Kaynak. Resmi katalog, topluluk kataloğu ya da başka birinin reposu - sonrasına ne kadar dikkatli bakacağınızı bu belirler.
2. İçerik. Karttaki "Will install"; hooks ve MCP, komut çalıştırmak ve dışarı çıkmak demektir, bunlar varsa açıklamayı açın.
3. Bedel. Karttaki "Context cost" (resmi katalogda) ve öncesinde ve sonrasında /context: eklentinin bedeli her isteğinizden ödenir.
4. Scope. Uyan en dar olanı; project scope meslektaşlarınız adına da verilmiş bir karardır.
5. Deneme. Öncesinde ve sonrasında tek bir görev, açıklamadan değil kendi testinizden çıkan sonuç.
6. Karar. Tutmak, kapatmak ya da kaldırmak; birkaç hafta sonra Installed sekmesi kullanmadıklarınızı hatırlatır.

Damgalı kutu, prosedürleri bütün olarak ve tek tek göndermeye gerek kalmadan vermek için icat edildi ve bu iki yönde de işliyor. Kutuyu teslim alan damgaya bakar, kapağı açar ve tezgaha yalnızca bugün gerekeni koyar.

Eklenti paneli ve mesajlarının metni sürümden sürüme değişir; ekranınız burada anlatılandan farklıysa satırların tam görünümüne değil, anlamına göre hareket edin.