Claude Code eklentisi nedir ve maliyeti ne kadardır?

Claude Code eklentisi nedir

Claude Code eklentisi, Claude Code'un tek bir birim olarak yüklediği ve yönettiği bileşenler dizinidir. Bu bileşenler; yetenekler, aracı yazılımlar (agents), kancalar (hooks), MCP sunucuları, LSP sunucuları ve arka plan izleyicileridir. 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ılmalarını sağlar.

Bir eklenti, aracı yazılıma daha önce sahip olmadığı hiçbir yetenek kazandırmaz. Eklenti içindeki her parça, .claude/ dizininde manuel olarak yazabileceğiniz öğelerdir. Eklenti, paketleme katmanıdır; bu parçaları sürümlendirmenin, on beş kişiye dağıtmanın ve herkesin dosyaları kopyalamasını istemeden daha sonra güncellemenin bir yoludur. Tüm mantık 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ı manifest dosyası eklentiyi isimlendirir ve bu isim bir ad alanı (namespace) haline gelir. commit-commands adlı bir eklentideki yetenek, /commit-commands:commit olarak çağrılır; böylece iki farklı eklenti, biri diğerini gölgelemeden commit adlı bir yeteneği barındırabilir. Eklenti aracı yazılımları da @-mention listesinde aynı şekilde plugin-name:agent-name olarak kapsamlandırılır.

Eklenti, yetenek, MCP sunucusu veya kurallar dosyası

Bu dört terim birbirinin yerine geçiyormuş gibi kullanılır. Ancak birbirleriyle rekabet etmezler ve aralarındaki sınırın bir kez belirtilmesi faydalıdır.

• Yetenek (skill), görev gerektirdiğinde Claude tarafından yüklenen tek bir yönerge birimidir. Bkz: Agent Yeteneği gerçekte nedir.
• MCP sunucusu, araçları bir protokol üzerinden ajana sunan ayrı bir süreçtir; genellikle kendi çalıştırdığınız bir ağ servisidir.
• CLAUDE.md gibi bir kurallar dosyası, oturum başlangıcında okunan ve her şeye uygulanan proje bağlamıdır.
• Eklenti (plugin), yetenekleri, ajanları, kancaları (hooks) ve MCP sunucu tanımlarını bir sürüm numarası ve dağıtım kanalıyla birlikte bir arada tutabilen bir kapsayıcıdır.

Dolayısıyla bir eklentinin yanıtladığı soru "ajan ne yapabilir" değildir. Soru, "bunu ekibime nasıl dağıtırım ve gelecek ay nasıl güncellerim" sorusudur. İlk üçü arasında bir seçim yapıyorsanız, yetenekler, MCP sunucuları ve kurallar dosyalarının karşılaştırması bu kararı ayrıntılı olarak ele almaktadır. Eğer ilgilendiğiniz kısım MCP 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

Marketplace üzerinden yüklenen bir eklenti, klonlandığı yerden çalıştırılmak yerine ~/.claude/plugins/cache dizinindeki yerel bir önbelleğe kopyalanır. Yüklenen her sürüm kendi dizinine sahip olur. Güncelleme veya kaldırma işlemi yaptığınızda, eski sürüm dizini yetim (orphaned) olarak işaretlenir ve yaklaşık iki hafta sonra silinir; böylece eski sürümü zaten yüklemiş olan bir oturum, işlem ortasında hata vermek yerine çalışmaya devam eder.

Yol her güncellemede değiştiği için, bir eklenti kendi konumunu asla sabit (hardcode) olarak kodlamamalıdır. Eklenti içindeki kancalar (hooks) ve MCP yapılandırmaları, mevcut kurulum dizinine çözümlenen ${CLAUDE_PLUGIN_ROOT} değişkenini kullanır. Güncelleme sonrasında korunması gereken durum bilgileri, ~/.claude/plugins/data/ altında kararlı bir dizine çözümlenen ${CLAUDE_PLUGIN_DATA} içine kaydedilmelidir.

Yalnızca eklentinin kendi dizini önbelleğe kopyalanır; bu durum, kullanıcıların geç aşamada fark ettiği bir soruna yol açar. Eklenti kök dizininin dışını işaret eden ../shared-utils gibi bir yol, yerel yolla geliştirme yaparken çalışır ancak kurulumdan sonra bozulur, çünkü bu dosyalar hiçbir zaman kopyalanmamıştır.

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 yerleştirilmelidir. Diğer her şey eklenti kök dizininde bulunur. skills/ veya hooks/ dosyalarını .claude-plugin/ içine koymak, bir eklentinin sorunsuz yüklenip ardından hiçbir işlev göstermemesinin en yaygın nedenidir: Claude Code bu dizinleri kök dizinde arar, bulamazsa 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şamadan oluşur; ilk aşama aslında hiçbir şey kurmaz. Öncelikle eklenti kataloğu olan bir marketplace eklersiniz, ardından bu katalogdan tekil eklentileri kurarsınız. Anthropic'in resmi marketplace'i olan claude-plugins-official, Claude Code'u ilk kez etkileşimli olarak başlattığınızda sizin için kaydedilir. Diğerlerini ise kendiniz eklersiniz.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

Deponun anthropics/claude-code, marketplace'in ise claude-code-plugins olarak adlandırıldığına dikkat edin. İsim, depo yolundan değil, depo içindeki katalog dosyasından gelir; bu nedenle bir kurulum komutu yazmadan önce marketplace ismini /plugin içindeki Marketplaces sekmesinden okuyun.

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 activate. ise bileşenlerin yüklenmediğini ve ilgili komutu çalıştırmanız gerektiğini belirtir. Eğer /reload-plugins, konuşmanın yeniden okunacağı konusunda bir uyarı verirse, komutu /reload-plugins --force şeklinde tekrar çalıştırın. Ardından eklentinin gerçekten orada olduğunu doğrulayın: /plugin, eklentiyi Installed sekmesi altında gösterir; /help, yeteneklerini Custom commands altında listeler; yüklenemeyen herhangi bir öğe ise 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 erişiminizi sağlar. Proje kapsamı (project scope), eklentiyi deponun .claude/settings.json dosyası içindeki enabledPlugins kısmına yazar; böylece depoyu klonlayan herkese bu eklenti önerilir. Yerel kapsam (local scope) ise yalnızca bu depoda, sadece 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 bayrağını kullanmadığınız sürece eklenti kullanıcı kapsamına kurulur.

claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin list

claude plugin install oturum 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 eklentilerin yönetimi her iki yerde de aynı yöntemle yapılır. /plugin list, nelerin kurulu olduğunu 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; /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 dağıtmak için onu projenin .claude/settings.json dosyasına ekleyin. Üyeler, depo klasörüne güven verdikleri anda eklentiyi kurmaları için yönlendirilirler.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Kendi eklentinizi geliştirirken marketplace'i tamamen devre dışı bırakı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 algılar; claude plugin validate ./my-plugin ise manifest dosyasını, yetenek ve aracı ön bilgilerini ve hooks/hooks.json öğesini, başkaları görmeden önce denetler.

Claude Code eklentisinin maliyeti nedir?

Mekanizma ücretsizdir. Ağustos 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; eklenti ise metin dosyalarından oluşan bir dizindir.

Bir eklentinin maliyeti token cinsindendir ve abonelik kullanımınız veya API faturanız aslında bu tokenları ölçer. Bu maliyet üç farklı şekilde ortaya çıkar ve her biri farklı işleyişe sahiptir.

Sabit bağlam maliyeti. Bir eklentinin katkıda bulunduğu içerik, bağlamınızda yer alır ve oturumun her adımında yeniden okunur. Kurulumdan önce, /plugin detay görünümü, token cinsinden bir Context cost tahmini ve ekleyeceğiniz komutları, becerileri, aracıları, kancaları, MCP ve LSP sunucularını listeleyen bir Will install bölümü gösterir. Her ikisini de inceleyin. Yerel veya özel pazar yerlerinden alınan eklentiler bu verileri sağlamayabilir; bu durumda tahmini kendiniz yapmanız gerekir. Bir MCP sunucusu içeren eklentiler genellikle en ağır olanlarıdır çünkü araç tanımları büyüktür; ancak MCP araç aramasını destekleyen modellerde bu tanımlar, araç gerekene kadar ertelenir.

Ç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. Bir aracı (agent) ise farklıdır. Bir alt aracı, 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 oturumun ortasında bir eklentiyi 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, LSP sunucuları, izleyiciler ve temalar bunu asla yapmaz: ekledikleri içerik 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. İstisna, bir MCP sunucusu sağlayan eklentilerdir. Araçları araç araması ile ertelenirse önbellek korunur. Eğer istem öneki (prompt prefix) içine yüklenirlerse, bir sonraki istek tüm konuşmayı önbelleğe alınmamış girdi olarak yeniden okur. /reload-plugins uyarısının ve --force geçilene kadar 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 durum satırı her ikisini de görmenizi sağlar. Sağlıklı bir oturum, oluşturduğundan çok daha fazlasını okur. Eğer oluşturma miktarı 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 bakış için Claude Code bağlam penceresi nasıl yönetilir ve bu token sayıları gerçekte ne anlama gelir bölümlerine bakın.

Küçük bir temizlik işlemi kendi maliyetini karşılar. Installed sekmesi, en az iki haftadır kullanmadığınız eklentileri bir Not used recently başlığı altında gruplar ve detay görünümünde bir Last used satırı sunar. Bu eklentiler her oturumda başlangıç sürenizi ve bağlamınızı tüketmeye devam eder. Bunları devre dışı bırakın veya kaldırın.

Bir eklenti sizin izinlerinizle çalışır

Anthropic'in kendi belgeleri bu konuda oldukça nettir: eklentiler ve pazar yerleri, makinenizde sizin kullanıcı izinlerinizle rastgele kod çalıştırabilen, yüksek güven gerektiren bileşenlerdir. Bu durum varsayımsal değildir. Bir eklentinin kancaları (hooks), araç çağrılarından önce ve sonra dahil olmak üzere oturum olaylarında kabuk komutları çalıştırır. Eklentinin bin/ dizini, eklenti etkinleştirildiğinde Bash aracının PATH değişkenine eklenir. MCP sunucuları ise eklentinin başlattığı süreçlerdir. Burada hiçbir şey kullanıcı hesabınızdan yalıtılmış (sandboxed) değildir.

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) belirteçlerini, bir bulut CLI oturumunu ve Docker soketine erişimi elinde tutar; bu nedenle "kullanıcınız olarak rastgele kod çalıştırmak", makinenin kontrolünü ele geçirmek anlamına gelir. Eğer Claude Code bir VPS üzerinde çalışıyorsa, herhangi bir kurulum yapmadan önce Claude Code'un bir VPS üzerinde güvenli bir şekilde nasıl çalıştırılacağı konusunu okuyun ve harici bir servisle iletişim kuran bir eklenti yüklemeden önce kimlik bilgilerinin bir ajandan nasıl uzak tutulacağı konusunu inceleyin.

Bazı güvenlik önlemleri mevcuttur ve bunları bilmek faydalıdır. Proje kapsamlı bir eklenti, sizden ziyade depodan (repository) gelir; bu nedenle yalnızca çalışma alanına güvendikten sonra yüklenir, MCP sunucuları yine de sunucu bazında onay gerektirir, LSP sunucuları bu güveni bekler 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 kopyalanır ve pazar yeri dışını işaret eden sembolik bağlantılar (symlinks) atlanır; böylece bir eklenti 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.

FAQ

Claude Code eklentileri ekstra ücrete tabi mi?

Hayır. Eklenti sistemi, pazar yeri ekleme veya eklenti kurma 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 (prompt prefix) içine yüklenen bir MCP sunucusu sağlıyorsa, maliyetli ve önbelleğe alınmamış bir adımın gerçekleşmesine neden olabilir. /plugin detay görünümü, kurulumdan önce bir Context cost tahmini gösterir.

Eklenti ve yetenek (skill) arasındaki fark nedir?

Yetenek, tek bir talimat birimidir. Eklenti ise yetenekler, ajanlar, kancalar (hooks), MCP sunucuları, LSP sunucuları ve izleyiciler içerebilen; bir isme, sürüme ve kurulabileceği bir pazar yerine sahip bir pakettir. Sadece sizin ve mevcut projeniz için geçerli olan durumlarda .claude/ içinde bağımsız bir yetenek 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 isteyene kadar içinde tek bir kural bulunan tek bir dosya yeterlidir. Başkalarının da ihtiyaç duyduğu ve zamanla güncellenmesi gereken durumlarda bunu bir eklentiye dönüştürün. Eklenti yetenekleri isim uzaylıdır (namespaced), bu nedenle bir eklenti içindeki yetenek /skill-name yerine /plugin-name:skill-name olarak çağrılır.

Eklentim kuruldu ancak yetenekleri görünmüyor. Sorun nedir?

Öncelikle kurulum özetini kontrol edin. Eğer Run /reload-plugins to activate. mesajı göründüyse bileşenler henüz yüklenmemiştir; yeniden yükleme işlemi konuşmanın tekrar okunacağını belirtiyorsa, işlemi /reload-plugins --force olarak yeniden ç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 bunları aramadığı .claude-plugin/ içine yerleştirmektir. Eklenti yeteneklerinin isim uzaylı olduğunu unutmayın, bu yüzden /help içindeki Custom commands sekmesinde /plugin-name:skill-name ifadesini arıyor olmalısınız. Son çare olarak rm -rf ~/.claude/plugins/cache komutunu kullanın, yeniden başlatın ve tekrar kurun.

Eklentileri etkileşimli panel olmadan kurabilir miyim?

Evet. /plugin panelinin kullanılamadığı betikler, imajlar ve etkileşimli olmayan ortamlarda çalışan claude plugin install name@marketplace kabuk komutunu kullanın. --scope project veya --scope local bayraklarını kullanmadığınız sürece kurulum kullanıcı kapsamına yapılır. Oturum dışında çalıştığı için, eklentinin etkili olması adına halihazırda açık olan bir oturumda /reload-plugins komutu gereklidir.

GitHub'da bulduğum bir pazar yerinden eklenti kurmak güvenli mi?

Bunu, o deponun kurulum betiğini bizzat çalıştırıyormuşsunuz gibi değerlendirin; çünkü yapılan işlem 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ı başlatabilir; tüm bunları sizin kullanıcı yetkilerinizle yapar. Anthropic, üçüncü taraf eklenti içeriklerini kontrol etmez veya doğrulamaz. Sadece okuyabildiğiniz kaynaklardan kurulum yapın, onaylamadan önce Will install listesini inceleyin ve sunucularda dizüstü bilgisayarlara kıyasla daha katı olun; çünkü sunucudaki hesap genellikle çalınmaya değer anahtarlar ve tokenlar barındırır.