Claude Code eklentisi nedir ve maliyeti ne kadardır?
Claude Code eklentilerinin çalışma prensibini, kurulum süreçlerini ve maliyet yapısını öğrenin. Eklenti mekanizması ücretsizdir ancak kullanılan token miktarı artabilir.
Claude Code eklentisi nedir
Claude Code eklentisi, Claude Code'un tek bir birim olarak yüklediği ve yönettiği bileşenler dizinidir. Ana bileşenler yetenekler (skills), aracılar (agents), kancalar (hooks), MCP sunucuları, LSP sunucuları ve arka plan izleyicileridir; bir eklenti ayrıca komutlar, çıktı stilleri, temalar, iş akışları ve bir bin/ çalıştırılabilir dosyalar dizini de içerebilir. Bir eklentiyi yüklemek, tüm parçalarını tek bir isim altında aynı anda ekler; devre dışı bırakmak ise aynı şekilde kaldırır.
Bir eklenti, aracıya genellikle daha önce sahip olmadığı bir yetenek kazandırmaz. Yetenekler, aracılar, kancalar ve MCP sunucularının tamamı bir .claude/ dizininde elle yazılabilecek şeylerdir. İstisnalar, kod zekası için dil sunucuları ve Claude Code'un yalnızca bir eklentiden yüklediği modlar'dır. Diğer her şey için eklenti bir paketleme katmanıdır: bu parçaları sürümlendirmek, on beş kişiye dağıtmak ve herkesin dosyaları kopyalamasını istemeden daha sonra güncellemek için bir yöntemdir. Tüm fikir bundan ibarettir ve eklentilerle ilgili kafa karışıklıklarının çoğu, bunların yeni bir yetenek türü olduğunu varsaymaktan kaynaklanır.
.claude-plugin/plugin.json konumundaki isteğe bağlı bildirim dosyası (manifest), eklentiyi adlandırır ve bu isim bir ad alanı (namespace) haline gelir. commit-commands adlı bir eklentideki bir yetenek, /commit-commands:commit olarak çağrılır; böylece iki eklenti de birbirini gölgelemeden commit adlı bir yetenek sunabilir. Eklenti aracılarının kapsamı, @-bahsetme listesinde plugin-name:agent-name şeklinde aynı şekilde belirlenir.
Eklenti, yetenek, MCP sunucusu veya kurallar dosyası
Bu dört terim sanki birbirinin rakibiymiş gibi kullanılır. Ancak durum böyle değildir ve aralarındaki sınırın bir kez belirtilmesi gerekir.
- Yetenek (skill), görev gerektirdiğinde Claude tarafından yüklenen tek bir yönerge birimidir. Bkz: Agent Yeteneği aslında nedir.
- MCP sunucusu, araçları bir protokol üzerinden aracıya (agent) sunan ayrı bir süreçtir; genellikle kendi çalıştırdığınız bir ağ servisidir.
CLAUDE.mdgibi bir kurallar dosyası, oturum başlangıcında okunan ve her şeye uygulanan proje bağlamıdır.- Eklenti (plugin); Claude Code'un tek bir birim olarak yüklediği yetenekler, aracılar, kancalar (hooks), MCP sunucuları veya diğer bileşenlerden oluşan bir dizindir. İsteğe bağlı manifest dosyası eklentiyi isimlendirir; ayrıca sürüm, açıklama ve diğer meta verileri ekleyebilir. Dağıtım, eklentinin bir parçası değildir: pazar yeri, eklentileri listeleyen ve her birinin nereden alınacağını belirten ayrı bir katalogdur.
Dolayısıyla bir eklentinin yanıtladığı soru "aracı ne yapabilir" değildir. Soru, "bunu ekibime nasıl dağıtırım ve gelecek ay nasıl güncellerim" sorusudur. İlk üç seçenek arasında bir tercih yapıyorsanız, yetenekler, MCP sunucuları ve kurallar dosyalarının karşılaştırması bu kararı detaylıca ele almaktadır. Eğer ilgilendiğiniz konu MCP kısmı ise, kendi MCP sunucularınızı bir VPS üzerinde çalıştırmak barındırma tarafını kapsamaktadır.
Eklentilerin konumu ve içeriği
Çoğu pazar yeri eklentisi, her yüklü sürüm için ayrı bir dizin oluşturularak ~/.claude/plugins/cache altındaki yerel bir önbelleğe kopyalanır. Yerel bir yoldan eklediğiniz pazar yeri eklentileri yerinde yüklenir; bağlantı modundaki komut kaynağı eklentileri ise kaynak dizinlerine giden bağlantılar aracılığıyla yüklenir. Kopyalanmış bir eklentiyi güncellediğinizde veya kaldırdığınızda, eski sürüm dizini yetim (orphaned) olarak işaretlenir ve yaklaşık iki hafta sonra silinir. Bu sayede, eski sürümü zaten yüklemiş olan bir oturum, işlem sırasında hata vermek yerine çalışmaya devam eder. Temizlik işlemi yalnızca en az bir eklenti kurulumu kayıtlı olduğunda çalışır; son eklentinizi de kaldırdıktan sonra, başka bir eklenti yükleyene kadar yetim dizinler kalmaya devam eder.
Kopyalanmış bir eklentinin yolu her güncellemede değiştiği için, bir eklenti kendi konumunu asla sabit kodlamamalıdır (hardcode). Eklenti içindeki kancalar (hooks) ve MCP yapılandırmaları, mevcut kurulum dizinine çözümleyen ${CLAUDE_PLUGIN_ROOT} kullanır. Güncelleme sonrasında korunması gereken durum bilgileri, ~/.claude/plugins/data/ altındaki kararlı bir dizine çözümleyen ${CLAUDE_PLUGIN_DATA} içine kaydedilmelidir.
Kopyalanmış bir eklenti için, aynı pazar yerindeki başka yerlere giden sembolik bağlantı hedefleri hariç, yalnızca eklentinin kendi dizini önbelleğe kopyalanır. Eklenti kök dizininin dışındaki bir yolu okuyan bir betik (örneğin ../shared-utils), yerel yolla geliştirme yaparken çalışır ancak eklenti önbelleğe kopyalandığında bozulur; çünkü bu dosyalar hiçbir zaman kopyalanmamıştır. plugin.json içinde bu şekilde tanımlanan bir bileşen yolu daha erken başarısız olur: Claude Code, geliştirme aşamasında bile eklenti kök dizininin dışına çıkan herhangi bir bileşen yolunu reddeder ve path escapes plugin directory hatası verir.
Dizin yapısı şu şekildedir:
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── code-review/
│ └── SKILL.md
├── agents/
├── hooks/
│ └── hooks.json
├── .mcp.json
└── bin/.claude-plugin/ içine yalnızca plugin.json konulmalıdır. Diğer her şey eklenti kök dizininde yer alır. skills/ veya hooks/ dosyalarını .claude-plugin/ içine yerleştirmek, bir eklentinin sorunsuz kurulup hiçbir işlev göstermemesinin en yaygın nedenidir: Claude Code bu dizinleri kök dizinde arar, bulamaz ve eklentiyi bileşensiz olarak yükler.
Manifest dosyasının kendisi küçüktür.
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
}Claude Code eklentisi nasıl kurulur
Kurulum iki aşamalıdır ve ilk aşama herhangi bir kurulum gerçekleştirmez. Öncelikle eklenti kataloğu olan bir marketplace eklersiniz, ardından bu marketplace üzerinden bireysel eklentileri kurarsınız. Anthropic'in resmi marketplace'i olan claude-plugins-official, yönetilen bir politika veya CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL tarafından engellenmediği sürece, Claude Code'u ilk kez etkileşimli olarak başlattığınızda sizin için otomatik olarak kaydedilir. Diğerlerini ise kendiniz eklersiniz.
/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-officialMarketplace adı, depo yolundan değil, depo içindeki katalog dosyasından gelir; bu nedenle bir kurulum komutu girmeden önce /plugin içindeki Marketplaces sekmesinden marketplace adını kontrol edin. anthropics/claude-code içindeki eski claude-code-plugins marketplace kullanımdan kaldırılmıştır; yeni kurulumlar için claude-plugins-official kullanın. Eski marketplace üzerinden kurulan mevcut eklentiler resmi depodan güncellenir, bu nedenle sadece marketplace değiştirmek için commit-commands yeniden kurmanıza gerek yoktur.
Kurulumdan sonra özet satırını okuyun. Plugin is now active., bileşenlerin bu oturumda yüklendiği anlamına gelir. Run /reload-plugins to apply., bileşenlerin kurulum sırasında etkinleştirilmediğini belirtir; panel kapanır ve Claude Code bu yeniden yükleme işlemini sizin yerinize gerçekleştirir. Yeniden yükleme işlemi konuşmanın tekrar okunacağına dair bir uyarı verirse, eklentiyi beklemede bırakır ve siz onu /reload-plugins --force olarak yeniden çalıştırırsınız. Ardından eklentinin gerçekten orada olduğunu doğrulayın: /plugin onu Installed sekmesi altında gösterir, / yazmak yeteneklerini /plugin-name:skill-name olarak listeler ve yüklenemeyen herhangi bir öğe, nedeni ile birlikte Errors sekmesi altında görünür.
Kurulum sırasında bir kapsam (scope) istenir ve bu kapsam, eklentiye kimin erişebileceğini belirler. Kullanıcı kapsamı (user scope), her projede sizin için geçerlidir. Proje kapsamı (project scope), eklentiyi deponun enabledPlugins altındaki .claude/settings.json dosyasına yazar; bu da eklentiyi depoyu klonlayan herkes için etkinleştirir. Bu işlem eklentiyi onlar için indirmez: marketplace girişi göreli bir yol değilse veya bir seed dizini onu zaten içermiyorsa, her iş birlikçi onu kendi makinesine örneğin claude plugin install name@marketplace --scope project ile bir kez kurmalıdır. Yerel kapsam (local scope) ise sadece bu depoda, yalnızca sizin için geçerlidir.
Bir betik, Dockerfile veya etkileşimli panelin bulunmadığı herhangi bir oturum için bunun yerine shell formunu kullanın. --scope parametresini geçmediğiniz sürece kullanıcı kapsamına kurulum yapar. Henüz kimsenin etkileşimli bir oturum açmadığı bir makinede resmi marketplace kayıtlı değildir, bu yüzden önce onu ekleyin.
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin listclaude plugin install bir oturumun dışında çalışır, bu nedenle halihazırda açık olan bir oturum, siz /reload-plugins komutunu çalıştırana veya yeni bir oturum başlatana kadar yeni eklentiyi görmeyecektir.
Mevcut eklentileri yönetmek her iki yerde de aynı yöntemle yapılır. /plugin list, kurulu olanları listeler ve --enabled veya --disabled parametrelerini kabul eder. /plugin disable name@marketplace bir eklentiyi kaldırmadan devre dışı bırakır, /plugin enable tekrar etkinleştirir ve /plugin uninstall ise tamamen kaldırır. Slash-komut formları, değişikliği uygulamak için eklenti panelini açar; bu nedenle betiklerde claude plugin ... shell karşılıklarının kullanılması gerekir.
Bir marketplace'i tüm ekibe sunmak için onu projenin .claude/settings.json dosyasına ekleyin veya claude plugin marketplace add your-org/claude-plugins --scope project komutunu bir kez çalıştırıp oluşturduğu dosyayı commit edin. Claude Code, ekip üyeleri depo klasörüne güven duyduklarında marketplace'i her biri için otomatik olarak kaydeder.
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}Kendi eklentinizi geliştirirken marketplace'i tamamen atlayın. claude --plugin-dir ./my-plugin, o oturum için bir dizini yükler, /reload-plugins yaptığınız değişiklikleri yeniden başlatmaya gerek kalmadan alır ve claude plugin validate ./my-plugin, manifest dosyasını, yetenek ve aracı ön bilgilerini (frontmatter) ve hooks/hooks.json öğesini başkaları görmeden önce denetler. Paylaşım yapmak için de marketplace gerekmez: klasörü veya klasörün bir .zip kopyasını birine gönderebilir ve --plugin-dir ile yüklemesini sağlayabilirsiniz; ancak siz yeni bir kopya gönderene kadar güncellemeleri alamazlar.
Claude Code eklentisinin maliyeti nedir?
Mekanizmanın kendisi ücretsizdir. Kasım 2026 itibarıyla bir pazar yeri eklemek, eklenti kurmak veya bir eklentiyi etkin tutmak için herhangi bir ücret alınmamaktadır. Resmi ve topluluk pazar yerleri herkese açık git depolarıdır; bir eklenti ise metin dosyalarından oluşan bir dizindir.
Bir eklentinin maliyeti token cinsindendir ve tokenlar, abonelik kullanımınızın veya API faturanızın gerçekte ölçtüğü birimdir. Bir eklentinin bu ikisinden hangisini tüketeceği, aracı nasıl kullandığınıza bağlıdır; Claude Code'un her plandaki maliyeti bölümü, abonelik katmanlarını ve token başına API fiyatlandırmasını açıklamaktadır. Bu maliyet üç farklı şekilde ortaya çıkar ve farklı davranışlar sergilerler.
Sabit bağlam maliyeti. Etkinleştirilen her eklenti, Claude'un kendi başına çağırabileceği becerilerin, aracıların ve komutların adlarını ve açıklamalarını bağlamınıza ekler. Bu kısım, herhangi bir şey çalıştırılsın ya da çalıştırılmasın, oturumun her adımında yeniden okunur. Her bileşen token harcamaz: bir kanca (hook), harness tarafından çalıştırılır ve modelin bağlamına hiçbir şey eklemez. Kurulumdan önce /plugin detay görünümü, eklemek üzere olduğunuz komutları, becerileri, aracıları, kancaları, MCP ve LSP sunucularını listeleyen bir Will install bölümü gösterir. Anthropic'in resmi pazar yerindeki bir eklenti için, eklentiyi pazar yeri adıyla veya Discover listesi yerine Marketplaces sekmesinden açtığınız sürece Every turn ve When invoked tahminlerini içeren bir Context cost bölümü de gösterilir. Her ikisini de okuyun. Kendi pazar yerinizden veya üçüncü taraf bir pazar yerinden gelen bir eklentinin Context cost bölümü yoktur, ancak manuel tahmin yapmak zorunda değilsiniz: kabuğunuzda claude plugin details name komutunu çalıştırmak, --plugin-dir ile ilettiğiniz bir eklenti de dahil olmak üzere, yüklü herhangi bir eklenti için Always-on token değerini ve bileşen bazlı dökümü yazdırır; böylece bir depoyu klonlayıp herhangi bir şey kurmadan önce claude --plugin-dir ./that-plugin plugin details that-plugin komutunu çalıştırabilirsiniz. Bu rakam MCP sunucularını kapsamaz. Bir MCP sunucusu içeren eklenti genellikle en ağır olanıdır çünkü araç tanımları büyüktür; ancak MCP araç aramasını destekleyen modellerde bu tanımlar, bir araca ihtiyaç duyulana kadar ertelenir. Eklenti etkinleştirilmiş bir oturumda /context komutunu çalıştırın ve ne eklediklerini görmek için MCP tools satırını okuyun.
Çağırma maliyeti. Bir eklentinin becerisini çalıştırmak, talimatlarını konuşmaya ekler; bu nedenle beceri gövdesi için yalnızca kullanıldığında ödeme yaparsınız. Ancak gövde işin ucuz kısmıdır; becerinin aracıya ne yapacağını söylemesi maliyetli olabilir: unlazy becerisinin Depth Tree yöntemi, tokenlarının neredeyse tamamını, aracının bir görevi tamamlanmış saymasına izin verilmeden önce zorunlu tuttuğu ekstra geçişler için harcar, kurduğunuz dosya için değil. Bir aracı (agent) farklıdır. Bir alt aracı (subagent), kendi sistem istemi ve kendi önbelleği ile kendi konuşmasını yürütür ve önbellek isabeti olmadan başlar; bu nedenle iş akışı aracıları tetikleyen bir eklenti, bağlam tahmininin önerdiğinden çok daha maliyetlidir.
Önbellek maliyeti. Bir eklentiyi oturum ortasında etkinleştirmek veya devre dışı bırakmak, bir sonraki isteğin tüm konuşmanızı yeniden işlemesine neden olabilir. Beceriler, komutlar, aracılar, kancalar, izleyiciler ve temalar bunu asla yapmaz: ekledikleri şeyler mevcut geçmişin sonuna eklenir, böylece bir sonraki istek yeni içerik için ödeme yapar ancak öncesindeki her şeyi önbellekten okumaya devam eder. İstisnalar, bir MCP sunucusu sağlayan eklentiler ve dil sunucusu Claude'a LSP aracını veren kod zekası eklentileridir. MCP için durum araç aramasına bağlıdır: araçlar ertelenirse önbellek korunur; istem öneki içine yüklenirlerse, bir sonraki istek tüm konuşmayı önbelleğe alınmamış girdi olarak yeniden okur. /reload-plugins komutunun, MCP araçlarında veya LSP aracında yapılan bir değişikliğin önbelleği bozacağı durumlarda, siz --force komutunu iletene kadar uyarı vermesinin ve işlemi reddetmesinin nedeni tam olarak budur.
Bunu tahmin etmek yerine izleyebilirsiniz. Her API yanıtı cache_read_input_tokens ve cache_creation_input_tokens değerlerini bildirir ve canlı token kullanımını gösteren özel bir durum satırı her ikisini de önünüze getirir. Sağlıklı bir oturum, oluşturduğundan çok daha fazlasını okur. Eğer oluşturma oranı her adımda yüksek kalıyorsa, önekinizdeki bir şey her adımda değişiyor demektir. Pencereyi neyin doldurduğuna dair daha geniş bir resim için Claude Code bağlam penceresini yönetme ve bu token sayılarının gerçekte ne anlama geldiği bölümlerine bakın.
Küçük bir temizlik işlemi kendi maliyetini karşılar. Installed sekmesi, en az 14 gün ve 10 oturum boyunca kullanmadığınız pazar yeri kurulumlu eklentileri bir Not used recently başlığı altında gruplar ve detay görünümünde bir Last used satırı sunar. Başlık; yönetilen eklentileri, tohum dizini eklentilerini ve tema, çıktı stili, izleyici veya iş akışı içeren eklentileri hariç tutar; bir LSP sunucusu, tanılama verileri sunduğunda veya kod navigasyon isteğine yanıt verdiğinde kullanılmış sayılır. strictKnownMarketplaces yapılandırıldığında, ne başlık ne de Last used: satırı görünür. Bu eklentiler yine de her oturumda başlangıç süresi ve bağlam maliyeti oluşturmaya devam eder. Bunları devre dışı bırakın veya kaldırın. Daha ucuz olan alışkanlık, kurmadan önce seçici olmaktır: Matt Pocock'un hangi becerilerinin kurulmaya değer olduğu bölümü, 27 becerilik bir koleksiyonu inceler ve tek başına çalışan bir geliştiricinin ihtiyaç duydukları ile yalnızca bir ekipte fayda sağlayanları birbirinden ayırır.
Bir eklenti sizin izinlerinizle çalışır
Anthropic'in kendi dokümantasyonu bu konuda nettir: yüklediğiniz bir eklenti, makinenizde sizin kullanıcı izinlerinizle rastgele kod yürütebilir. Bu varsayımsal bir durum değildir. Bir eklentinin kancaları (hooks), araç çağrılarından öncesi ve sonrası dahil olmak üzere oturum olaylarında shell komutları çalıştırır. Eklenti etkinleştirildiğinde, eklentinin bin/ dizini Bash aracının PATH değişkenine eklenir. Eklentinin stdio MCP sunucuları, eklentinin başlattığı süreçlerdir ve bir mod, Claude Code'un kendi içinde JavaScript çalıştırır. Kancalar, izleyiciler, sunucu süreçleri ve mod süreçleri Claude Code'un sandbox'ı dışında çalışır; ancak Claude'un yaptığı araç çağrıları için Claude Code'un izin kuralları geçerliliğini korur.
Bir dizüstü bilgisayarda bu risk, masaüstü kullanıcınızın erişebildiği alanlarla sınırlıdır. Bir sunucuda ise durum genellikle böyle değildir. Ajanı çalıştıran hesap genellikle SSH anahtarlarını, dağıtım (deploy) token'larını, bir bulut CLI oturumunu ve Docker socket erişimini elinde tutar; bu nedenle "kullanıcınız yetkisiyle rastgele kod çalıştırmak", makinenin ele geçirilmesi anlamına gelir. Eğer Claude Code bir VPS üzerinde çalışıyorsa, herhangi bir şey yüklemeden önce Claude Code'un bir VPS üzerinde güvenli şekilde nasıl çalıştırılacağı konusunu okuyun ve harici bir servisle iletişim kuran bir eklenti yüklemeden önce kimlik bilgilerinin bir ajanın erişiminden nasıl uzak tutulacağı konusunu inceleyin. Diğer araç setleri de aynı kiralık sunucu üzerinde aynı engelle karşılaşır; bu nedenle yüklemeye değer DeepSeek Harness eklentileri, yeni yetenekler eklemekten ziyade harcama limitleri, araç izin kuralları ve enjeksiyon taraması gibi güvenlik odaklıdır.
Bazı koruma mekanizmaları mevcuttur ve hangilerinin ne işe yaradığını bilmek faydalıdır. Proje kapsamlı bir eklenti, sizin tarafınızdan değil depodan (repository) gelir; bu nedenle çalışma alanına güvendikten sonra yüklenir, MCP sunucuları yine de sunucu bazlı onay gerektirir ve arka plan izleyicileri hiç yüklenmez. Eklenti ile gelen ajanların kanca, MCP sunucusu veya izin modu tanımlamasına izin verilmez. Pazar yeri eklentileri önbelleğe kopyalandığında, pazar yeri dışını işaret eden sembolik bağlantılar (symlinks) atlanır; böylece kopyalanan bir eklenti, bu bağlantılar aracılığıyla ana makinedeki rastgele dosyaları çekemez.
Bunların hiçbiri, yüklediğiniz şeyi incelemenin yerini tutmaz. Will install listesini kontrol edin, kaynak kodunu açıp okuyabildiğiniz eklentileri tercih edin, ekibinizin eklentilerini kontrolünüz altındaki bir pazar yeri deposunda tutun ve kendi yazdığınız her şey üzerinde claude plugin validate çalıştırın. İncelediğiniz bir şey daha sonra değişebilir: knowledge-work-plugins ve first-party-plugins hariç, Anthropic'in resmi pazar yerleri için otomatik güncelleme varsayılan olarak açıktır, kaynak yoluyla eklenen üçüncü taraf eklentiler için ise kapalıdır; güncellemenin açık olduğu durumlarda Claude Code, eklenti dosyalarını arka planda günceller.
FAQ
Claude Code eklentileri ek ücret gerektirir mi?
Hayır. Eklenti sistemi, pazar yeri ekleme veya eklenti yükleme için herhangi bir ücret alınmaz. Maliyet, diğer tüm bağlamlarda olduğu gibi planınız veya API harcamanız üzerinden faturalandırılan token kullanımıdır. Bir eklenti her adımda kalıcı bağlam ekler, yeteneklerinden veya ajanlarından biri çağrıldığında daha fazla bağlam ekler ve araçları istem öneki içine yüklenen bir MCP sunucusu sağlıyorsa, önbelleğe alınmamış pahalı bir adımı zorunlu kılabilir. Anthropic'in resmi pazar yerindeki bir eklenti için /plugin detay görünümü, yüklemeden önce bir Context cost tahmini gösterir; diğer tüm eklentiler için claude plugin details name, eklenti yüklendiğinde veya --plugin-dir ile yüklendiğinde her zaman açık olan token maliyetini yazdırır.
Eklenti (plugin) ile yetenek (skill) arasındaki fark nedir?
Yetenek, tek bir talimat birimidir. Eklenti ise yetenekleri, ajanları, kancaları (hooks), MCP sunucularını, LSP sunucularını ve izleyicileri içeren; bir isme, genellikle bir sürüme ve genellikle kurulabileceği bir pazar yerine sahip bir pakettir; ancak bir klasör veya .zip olarak da paylaşılabilir ve insanlar bunu --plugin-dir ile yükleyebilir. Sadece sizin ve bu proje için geçerli olduğunda, bağımsız bir yeteneği .claude/ içinde yazın. Ponytail, ajanı çalışan en küçük değişikliğe yönlendirir gibi tek amaçlı bir yetenek, bunun en net örneğidir: ekibiniz de istediği güne kadar içinde tek bir kural olan tek bir dosya. Başkalarının ihtiyacı olduğunda ve zaman içinde güncellenmesi gerektiğinde onu bir eklentiye dönüştürün. Eklenti yetenekleri isim alanlıdır (namespaced), bu nedenle bir eklenti içindeki yetenek /skill-name yerine /plugin-name:skill-name olarak çağrılır.
Eklentim yüklendi ancak yetenekleri görünmüyor. Sorun nedir?
Önce yükleme özetini kontrol edin. Eğer Run /reload-plugins to apply. dediyse, Claude Code panel kapandığında bu yeniden yüklemeyi çalıştırır; eğer yeniden yükleme konuşmanın tekrar okunacağı konusunda uyarırsa, /reload-plugins --force olarak tekrar çalıştırın. Yüklendiği halde hiçbir şey görünmüyorsa, /plugin kısmını açın ve Errors sekmesini okuyun. En yaygın yapısal hata; skills/, agents/ veya hooks/ öğelerini, Claude Code'un onları aramadığı .claude-plugin/ içine yerleştirmektir. Eklenti yeteneklerinin isim alanlı olduğunu unutmayın, bu yüzden / yazdığınızda /plugin-name:skill-name ifadesini arıyorsunuz. Eğer başkasının eklentisi ise ve hatasız yükleniyorsa, detaylar bölmesini Installed sekmesinde açın: orada hiçbir yetenek listelemeyen bir eklentinin sunabileceği bir yetenek yoktur. Eğer Errors sekmesi eklentinin önbelleğe alınmadığını söylüyorsa, yükleme dizini eksiktir; bu durumda kabuğunuzdan claude plugin install name@marketplace ile yeniden yükleyin ve /reload-plugins komutunu çalıştırın.
Eklentileri etkileşimli panel olmadan yükleyebilir miyim?
Evet. --scope project veya --scope local geçmediğiniz sürece kullanıcı kapsamına yükleme yapan claude plugin install name@marketplace kabuk komutunu kullanın. Bu komut; betiklerde, imajlarda ve /plugin panelinin kullanılamadığı etkileşimli olmayan ortamlarda çalışır. Bir oturumun dışında çalıştığı için, halihazırda açık olan bir oturumun eklenti etkili olmadan önce /reload-plugins komutuna ihtiyacı vardır. Etkileşimli terminali olmayan bir oturumda, eklenti MCP sunucularındaki değişiklikler bir sonraki oturumda etkili olur.
GitHub'da bulduğum bir pazar yerinden eklenti yüklemek güvenli mi?
Bunu, o deponun yükleme betiğini kendiniz çalıştırıyormuşsunuz gibi değerlendirin, çünkü bu durum buna oldukça yakındır. Bir eklenti; kancalar aracılığıyla kabuk komutları çalıştırabilir, Bash aracının PATH kısmına yürütülebilir dosyalar ekleyebilir ve MCP sunucularını başlatabilir; bunların tümünü kullanıcı ayrıcalıklarınızla yapar. Anthropic, üçüncü taraf eklenti içeriklerini kontrol etmez veya doğrulamaz. Okuyabileceğiniz kaynaklardan yükleyin, onaylamadan önce Will install listesini inceleyin ve sunucudaki hesap genellikle çalınmaya değer anahtarlar ve tokenlar barındırdığından, sunucuda dizüstü bilgisayara göre daha katı olun.