Claude Code'da Plugin ve Marketplace Sistemi: Kapsamlı Rehber

Claude Code'un eklenti (plugin) sistemi, özel skill'leri, subagent'ları, hook'ları, MCP sunucularını ve hatta LSP sunucularını tek bir paylaşılabilir pakette bir araya getirmenizi sağlar. Daha önce Agent Skills rehberimde anlattığım .claude/skills/ yaklaşımı kişisel ya da tek bir proje için harikadır; ama bir skill setini ekibinize dağıtmak, sürüm numarasıyla güncellemek ya da topluluğa açık hâle getirmek istediğinizde plugin sistemi devreye girer. Bu yazıda, resmi Claude Code dokümantasyonuna (code.claude.com/docs) dayanarak plugin oluşturmayı, yerelde test etmeyi, marketplace (eklenti pazarı) kavramını, resmi ve topluluk marketplace'lerini, kendi marketplace'inizi kurmayı ve plugin yönetimini uçtan uca anlatıyorum.

Plugin Nedir, Standalone Yapılandırmadan Farkı Ne?

Claude Code, özel skill, subagent ve hook eklemenin iki yolunu destekler: standalone (.claude/ dizini altında, tek bir projeye özel) ve plugin (skill, agent, hook içeren ve isteğe bağlı bir .claude-plugin/plugin.json manifestosu taşıyan kendi kendine yeten dizinler). Aralarındaki fark şu şekilde özetlenebilir:

Yaklaşım	Skill adlandırması	En uygun olduğu durum
Standalone (.claude/ dizini)	/hello	Kişisel iş akışları, projeye özgü özelleştirmeler, hızlı denemeler
Plugin (skill/agent/hook içeren dizin)	/plugin-adi:hello	Ekiple paylaşmak, topluluğa dağıtmak, sürümlü sürümler, projeler arası yeniden kullanım

Genel tavsiye, hızlı yineleme için önce .claude/ içinde standalone başlamak, paylaşmaya hazır olduğunuzda ise plugin'e dönüştürmektir. Plugin'lerin en belirgin farkı isimlendirme kuralıdır: bir plugin'in skill'leri her zaman plugin-adi:skill-adi biçiminde ad alanına (namespace) sahiptir; bu sayede birden fazla plugin aynı isimli bir skill taşısa bile çakışma olmaz.

Hızlı Başlangıç: İlk Plugin'inizi Oluşturmak

Bir plugin, herhangi bir konumda yaşayabilen; skill, agent ya da hook içeren bir dizindir. Önce boş bir dizin oluşturun:

mkdir my-first-plugin

Plugin'in kimliğini tanımlayan manifest dosyası .claude-plugin/plugin.json yolunda bulunur:

mkdir my-first-plugin/.claude-plugin

Ardından my-first-plugin/.claude-plugin/plugin.json içeriğini yazın:

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

Manifest alanlarının anlamı şöyle:

• name: benzersiz kimlik ve skill ad alanı. Skill'ler bu adla önekli olur (/my-first-plugin:hello gibi).
• description: plugin yöneticisinde (plugin manager) plugin'i tararken ya da kurarken gösterilir.
• version: isteğe bağlıdır. Belirtilirse kullanıcılar yalnızca bu alanı artırdığınızda güncelleme alır (command kaynaklı plugin'ler hariç); belirtilmezse sürüm, sürüm yönetimindeki bir sonraki kaynaktan gelir.
• author: isteğe bağlıdır, atıf için kullanışlıdır.

homepage, repository ve license gibi ek alanlar da desteklenir. Sonra bir skill ekleyin — skill'ler skills/ dizininde yaşar, her biri bir SKILL.md içeren klasördür:

mkdir -p my-first-plugin/skills/hello

my-first-plugin/skills/hello/SKILL.md içeriği:

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

Plugin'i --plugin-dir bayrağıyla test edin:

claude --plugin-dir ./my-first-plugin

Claude Code başladıktan sonra /my-first-plugin:hello yazarak skill'i deneyebilir, /help ile "Custom commands" sekmesinde plugin ad alanı altında listelendiğini görebilirsiniz. Skill'e argüman eklemek için içerikte $ARGUMENTS yer tutucusunu kullanabilirsiniz; değişikliklerden sonra yeniden başlatmadan /reload-plugins ile güncellemeleri yükleyebilirsiniz.

Skill Dizininde Otomatik Yüklenen Plugin'ler

--plugin-dir'ı her seferinde bayrak olarak geçmek yerine, claude plugin init komutuyla skill dizininizde otomatik yüklenen bir plugin iskeleti oluşturabilirsiniz:

claude plugin init my-tool

Bu komut, ~/.claude/skills/my-tool/ altında bir .claude-plugin/plugin.json manifestosu ve başlangıç SKILL.md dosyası oluşturur. Bir sonraki oturumda bu, marketplace ya da kurulum adımı gerektirmeden my-tool@skills-dir olarak yüklenir.

Plugin Dizin Yapısı: Neler Ekleyebilirsiniz?

Bir plugin, tek bir skill'in çok ötesine geçebilir; özel agent'lar, hook'lar, MCP sunucuları, LSP sunucuları ve arka plan monitörleri (background monitor) barındırabilir. Her bileşenin yeri sabittir:

Dizin	Konum	Amaç
.claude-plugin/	Plugin kökü	plugin.json manifestosunu içerir (bileşenler varsayılan konumları kullanıyorsa isteğe bağlı)
skills/	Plugin kökü	Skill'ler, <isim>/SKILL.md dizinleri olarak
commands/	Plugin kökü	Skill'ler düz Markdown dosyaları olarak; yeni plugin'lerde skills/ tercih edilmeli
agents/	Plugin kökü	Özel agent tanımları
hooks/	Plugin kökü	hooks.json içinde olay işleyicileri
.mcp.json	Plugin kökü	MCP sunucu yapılandırmaları
.lsp.json	Plugin kökü	Kod zekâsı için LSP sunucu yapılandırmaları
monitors/	Plugin kökü	monitors.json içinde arka plan monitör tanımları
bin/	Plugin kökü	Plugin etkinken Bash aracının PATH'ine eklenen çalıştırılabilir dosyalar
settings.json	Plugin kökü	Plugin etkinleştirildiğinde uygulanan varsayılan ayarlar

Sık yapılan bir hata: commands/, agents/, skills/ ya da hooks/ dizinlerini .claude-plugin/ içine koymayın. Yalnızca plugin.json oraya gider; diğer tüm dizinler plugin kökünde olmalıdır. Plugin kökü, --plugin-dir'a verdiğiniz ya da .claude-plugin/plugin.json içeren dizindir — asla ~/.claude/ değildir.

LSP Sunucuları: Gerçek Zamanlı Kod Zekâsı

LSP (Language Server Protocol) plugin'leri, Claude'a tanım'a atlama, referans bulma ve düzenleme sonrası anında tip hatası görme gibi yetenekler kazandırır — VS Code'un kod zekâsını çalıştıran aynı teknolojidir. Yaygın diller için resmi marketplace'teki hazır LSP plugin'lerini kurmak yeterlidir; desteklenmeyen bir dil için kendi .lsp.json'unuzu yazabilirsiniz:

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

Kullanıcıların, plugin'i kurmanın yanı sıra dil sunucusu ikili dosyasını (binary) kendi makinelerine kurması gerekir — plugin bunu sizin için kurmaz.

Arka Plan Monitörleri

Arka plan monitörleri (background monitor), plugin'inizin günlükleri, dosyaları ya da harici durumu arka planda izleyip olayları Claude'a bildirmesini sağlar. Plugin etkinken Claude Code her monitörü otomatik başlatır; bunu Claude'a ayrıca söylemenize gerek kalmaz. monitors/monitors.json içinde tanımlanır:

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

command'ın her stdout satırı, oturum sırasında Claude'a bildirim olarak iletilir.

settings.json ile Varsayılan Davranışı Değiştirmek

Plugin kökündeki bir settings.json, plugin etkinleştirildiğinde varsayılan yapılandırma uygular. Şu anda yalnızca agent ve subagentStatusLine anahtarları desteklenir. agent anahtarı, plugin'in agents/ dizinindeki özel bir agent'ı ana iş parçacığı (main thread) olarak etkinleştirir; bu, sistem promptunu, araç kısıtlamalarını ve modelini uygular:

{
  "agent": "security-reviewer"
}

settings.json'daki ayarlar, plugin.json içinde bildirilen ayarlara göre önceliklidir; bilinmeyen anahtarlar sessizce yok sayılır.

Plugin'i Yerelde Test Etmek

Geliştirme sırasında kurulum yapmadan doğrudan yüklemek için --plugin-dir kullanın:

claude --plugin-dir ./my-plugin

Bu bayrak, plugin dizininin bir .zip arşivini de kabul eder:

claude --plugin-dir ./my-plugin.zip

Bir --plugin-dir plugin'i, kurulu bir marketplace plugin'iyle aynı isme sahipse, o oturum için yerel kopya önceliklidir — böylece kurulu bir plugin'de değişiklik yaparken önce onu kaldırmanız gerekmez. İstisna, yönetilen (managed) ayarların zorla etkinleştirip devre dışı bıraktığı plugin'lerdir; --plugin-dir bunları geçersiz kılamaz. Aynı bayrağı birden çok kez vererek birden fazla plugin'i aynı anda yükleyebilirsiniz:

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

Zaten .zip olarak paketlenmiş ve bir URL'de barındırılan bir plugin'i test etmek için (örneğin bir CI derleme çıktısı) bunun yerine --plugin-url kullanın; Claude Code arşivi başlangıçta getirir ve yalnızca o oturum için yükler:

claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

Plugin'inizde değişiklik yaptıkça, yeniden başlatmadan güncellemeleri almak için /reload-plugins çalıştırın. Bu komut skill'leri, agent'ları, hook'ları, plugin MCP sunucularını ve plugin LSP sunucularını yeniden yükler. Skill'lerinizi /plugin-adi:skill-adi ile deneyin, agent'ların /context altında Custom Agents'ta göründüğünü kontrol edin ve her hook'un eşleştiği olayı tetikleyip etkisini doğrulayın.

Marketplace Nedir, Nasıl Çalışır?

Bir marketplace, başkasının oluşturup paylaştığı plugin'lerin bir kataloğudur. Marketplace kullanımı iki adımlı bir süreçtir:

1. Marketplace'i eklemek: Bu, kataloğu Claude Code'a kaydeder, böylece nelerin mevcut olduğuna göz atabilirsiniz. Henüz hiçbir plugin kurulmaz.
2. Tek tek plugin'leri kurmak: Kataloğa göz atıp istediğiniz plugin'leri kurarsınız.

Resmi Anthropic Marketplace'i

Claude Code, resmi Anthropic marketplace'ini (claude-plugins-official) ilk kez etkileşimli çalıştırdığınızda otomatik olarak ekler. Ağınız indirmeyi engelliyorsa veya bir marketplace politikası önceki bir denemeyi engellediyse, elle ekleyebilirsiniz:

claude plugin marketplace add anthropics/claude-plugins-official

Mevcut plugin'lere göz atmak için /plugin çalıştırıp Discover sekmesine gidin ya da claude.com/plugins adresindeki kataloğa bakın. Resmi marketplace'ten bir plugin kurmak için:

/plugin install github@claude-plugins-official

Resmi marketplace, Anthropic tarafından derlenir ve dahil edilme tamamen Anthropic'in takdirindedir; uygulama içi başvuru formları plugin'i topluluk marketplace'ine ekler, resmi olana değil.

Topluluk Marketplace'i

anthropics/claude-plugins-community adresindeki topluluk marketplace'i, Anthropic'in otomatik doğrulama ve güvenlik taramasından geçmiş üçüncü taraf plugin'lerini barındırır. Her plugin, katalogda belirli bir commit SHA'sına sabitlenir (pinned). Resmi marketplace'in aksine, bunu elle eklemeniz gerekir:

/plugin marketplace add anthropics/claude-plugins-community

Ardından claude-community marketplace adını kullanarak kurun:

/plugin install <plugin-adi>@claude-community

Demo Marketplace: claude-code-plugins

Anthropic ayrıca, plugin sisteminin neler yapabileceğini gösteren örnek plugin'ler içeren bir demo marketplace'i (claude-code-plugins) barındırır. Resmi marketplace'in aksine bunu da elle eklemeniz gerekir:

/plugin marketplace add anthropics/claude-code

/plugin komutunu çalıştırdığınızda dört sekme arasında Tab ile gezinebileceğiniz bir arayüz açılır: Discover (tüm marketplace'lerdeki plugin'lere göz atma), Installed (kurulu plugin'leri yönetme), Marketplaces (marketplace ekleme/kaldırma/güncelleme) ve Errors (plugin yükleme hataları).

Marketplace Ekleme Yolları

/plugin marketplace add komutu farklı kaynak türlerini destekler:

Kaynak türü	Örnek
GitHub deposu (owner/repo)	/plugin marketplace add anthropics/claude-code
Git URL'si (GitLab, Bitbucket, self-hosted)	/plugin marketplace add https://gitlab.com/company/plugins.git
SSH adresi	/plugin marketplace add git@gitlab.com:company/plugins.git
Yerel dizin ya da marketplace.json yolu	/plugin marketplace add ./my-marketplace
Uzak (barındırılan) marketplace.json URL'si	/plugin marketplace add https://example.com/marketplace.json

Belirli bir dal ya da etikete eklemek için URL'nin sonuna # ile referansı ekleyin: /plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0. Host'a göre .git soneki kuralı değişir: github.com ve gitlab.com hem soneki olan hem olmayan URL'leri klonlanabilir depo olarak tanır (GitLab'de sonek olmadan destek Claude Code v2.1.232 ve üzeri gerektirir); Azure DevOps'ta /_git/ yolu içeren her URL soneksiz klonlanır; kendi barındırdığınız GitLab sunucuları dahil diğer tüm host'larda, URL'yi doğrudan barındırılan bir marketplace.json dosyası olarak değil klonlanacak bir depo olarak tanıması için .git sonekini eklemeniz gerekir. Her zaman https:// önekini dahil edin; Claude Code v2.1.196 ve sonrası, önek olmadan yazılan bir host adını geçersiz bir GitHub owner/repo kısaltması olarak reddeder.

Plugin Kurmak ve Yönetmek

Marketplace'leri ekledikten sonra bir plugin'i adıyla kurabilirsiniz:

/plugin install plugin-adi@marketplace-adi

Komut, üç kurulum kapsamından (scope) birini seçmenizi ister:

• User scope: tüm projelerinizde, yalnızca sizin için kurulur.
• Project scope: depodaki tüm katılımcılar için kurulur; .claude/settings.json'a eklenir.
• Local scope: yalnızca sizin için, yalnızca bu depoda kurulur, katılımcılarla paylaşılmaz.

İnteraktif adım olmadan kurmak için, kabuk (shell) komutu claude plugin install'ı kullanabilirsiniz; bu, --scope vermezseniz varsayılan olarak user scope'a kurar:

claude plugin install formatter@your-org --scope project

Kurulum sonrası özet, plugin'in mevcut oturumda aktif olup olmadığını söyler: Plugin is now active. ise Claude Code kurulumun bir parçası olarak plugin'i etkinleştirmiştir; Run /reload-plugins to activate. görürseniz komutu çalıştırmanız gerekir (etkinleştirme, prompt önbelleğini geçersiz kılacağı için otomatik yapılmamıştır).

Kurulu Plugin'leri Yönetmek

/plugin çalıştırıp Installed sekmesine giderek plugin'leri görüntüleyebilir, etkinleştirebilir, devre dışı bırakabilir ya da kaldırabilirsiniz. Doğrudan komutlarla da yönetilebilir:

/plugin list
/plugin disable plugin-adi@marketplace-adi
/plugin enable plugin-adi@marketplace-adi
/plugin uninstall plugin-adi@marketplace-adi

/plugin list'e --enabled ya da --disabled bayrağı ekleyerek yalnızca o durumdaki plugin'leri listeleyebilirsiniz. Scripting için, paneli açmayan claude plugin kabuk komutlarını tercih edin. Claude Code, en az 10 oturum boyunca en az iki haftadır kullanılmamış marketplace plugin'lerini Installed sekmesinde "Not used recently" başlığı altında listeler — bu, hâlâ başlangıç ve bağlam maliyeti eklerken artık kullanmadığınız plugin'leri bulmanıza yardımcı olur. Organizasyonunuzun yönettiği ya da --plugin-dir ile yüklediğiniz plugin'ler ile tema, output style, monitor ya da workflow ekleyen plugin'ler bu listeye hiç girmez.

Kendi Marketplace'inizi Oluşturmak

Bir marketplace, kendi marketplace.json dosyanızı içeren bir Git deposu, yerel dizin ya da barındırılan URL'dir. Ekibinizle ya da toplulukla plugin paylaşmak istediğinizde şu adımları izlersiniz:

1. Plugin'leri oluşturun: skill, agent, hook, MCP ya da LSP sunucusu içeren bir veya daha fazla plugin geliştirin.
2. Marketplace dosyasını oluşturun: plugin'lerinizi ve nerede bulunacaklarını listeleyen bir marketplace.json yazın.
3. Marketplace'i barındırın: GitHub, GitLab ya da başka bir git host'una gönderin.
4. Kullanıcılarla paylaşın: kullanıcılar /plugin marketplace add ile marketplace'inizi ekler, ardından tek tek plugin kurar.

Marketplace'inizi yayınladıktan sonra deponuza değişiklik göndererek güncelleyebilirsiniz; kullanıcılar yerel kopyalarını /plugin marketplace update ile yeniler. Bir plugin'i topluluğa hazır hâle getirmeden önce, gönderim (submission) inceleme hattının çalıştırdığı aynı kontrolü yerelde koşabilirsiniz:

claude plugin validate ./your-plugin

Doğrulama geçerse Claude Code ✔ Validation passed (ya da uyarı varsa ✔ Validation passed with warnings) yazdırır; uyarıları hata olarak ele almak için --strict ekleyebilirsiniz. Topluluk marketplace'ine gönderim, claude.ai için claude.ai/admin-settings/directory/submissions/plugins/new, Team/Enterprise organizasyonu olmayan bireysel yazarlar için Console'daki platform.claude.com/plugins/submit formu üzerinden yapılır. Onaylanan plugin'ler, anthropics/claude-plugins-community kataloğunda belirli bir commit SHA'sına sabitlenir; katalog gece (nightly) senkronize olduğundan onay ile plugin'in kataloğa yansıması arasında gecikme olabilir.

Takım Marketplace'leri: extraKnownMarketplaces

Takım yöneticileri, projelerin .claude/settings.json dosyasına marketplace yapılandırması ekleyerek otomatik marketplace kurulumu sağlayabilir. Bir ekip üyesi depo klasörüne güvendiğinde (trust), Claude Code bu marketplace'leri ek bir bilgilendirme olmadan ekler:

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

Marketplace'in eklenmesi, harici bir kaynaktan (örneğin bir GitHub deposu ya da npm paketi) gelen ve yalnızca projenin .claude/settings.json'ının etkinleştirdiği bir plugin'i otomatik kurmaz; ekip üyesi bunu kendisi kurana kadar Claude Code, plugin'in kurulu olmadığını bildirir ve çalıştırılacak claude plugin install komutunu gösterir.

Resmi Marketplace'teki Plugin Kategorileri

Resmi marketplace, kod zekâsından harici entegrasyonlara kadar birkaç kategoriye ayrılır:

Kod Zekâsı (LSP)

Dil	Plugin	Gerekli ikili dosya
Go	gopls-lsp	gopls
Python	pyright-lsp	pyright-langserver
Rust	rust-analyzer-lsp	rust-analyzer
TypeScript	typescript-lsp	typescript-language-server
C/C++	clangd-lsp	clangd
Java	jdtls-lsp	jdtls

Bu plugin'ler kurulduktan ve dil sunucusu ikili dosyası çalışır durumda olduktan sonra Claude iki yetenek kazanır: her düzenlemeden sonra otomatik tanı (diagnostics) — tip hataları, eksik import'lar, sözdizimi sorunları bir derleyici çalıştırmadan görünür hâle gelir — ve tanım'a atlama, referans bulma, hover'da tip bilgisi görme gibi kesin kod gezinme yetenekleri. /plugin'in Errors sekmesinde Executable not found in $PATH görüyorsanız, ilgili dil sunucusu ikilisini kurmanız gerekiyor demektir.

Harici Entegrasyonlar

Bu plugin'ler, manuel kurulum yapmadan Claude'u harici servislere bağlamak için önceden yapılandırılmış MCP sunucuları paketler: kaynak kontrolü için github ve gitlab; proje yönetimi için atlassian (Jira/Confluence), asana, linear, notion; tasarım için figma; altyapı için vercel, firebase, supabase; iletişim için slack; izleme için sentry.

Otomatik Güvenlik İncelemesi ve Geliştirme İş Akışları

security-guidance plugin'i, Claude'un yaptığı her değişikliği yaygın güvenlik açıkları için gözden geçirir ve bulduklarını aynı oturumda düzeltmesini sağlar. Geliştirme iş akışları kategorisinde ise commit-commands (git commit/push/PR akışları), pr-review-toolkit (PR inceleme için özel agent'lar), agent-sdk-dev (Claude Agent SDK ile geliştirme araçları) ve plugin-dev (kendi plugin'lerinizi oluşturma araç seti) bulunur. Ayrıca yanıt tarzını değiştiren explanatory-output-style (uygulama kararları hakkında eğitici içgörüler) ve learning-output-style (interaktif öğrenme modu) gibi output style plugin'leri de mevcuttur.

Auto-Update: Marketplace ve Plugin Güncellemeleri

Claude Code, başlangıçtan sonra marketplace'leri ve kurulu plugin'leri arka planda otomatik güncelleyebilir. Bir marketplace için auto-update etkinse, Claude Code oturum başladıktan en fazla on dakika rastgele gecikmeyle marketplace verisini yeniler ve kurulu plugin'leri diskte en son sürümlerine günceller — böylece çalışan oturum, başlangıçta yüklediği sürümleri kullanmaya devam eder. Herhangi bir plugin güncellendiyse, /reload-plugins çalıştırmanızı isteyen bir bildirim görürsünüz; aksi hâlde yeni sürümler bir sonraki başlatmada yüklenir. claude-plugins-official ve çoğu diğer resmi Anthropic marketplace'i varsayılan olarak auto-update açık gelir; üçüncü taraf ve yerel geliştirme marketplace'lerinde varsayılan kapalıdır. Claude Code ve marketplace'lerden alınan plugin'ler için otomatik güncellemeleri tamamen kapatmak isterseniz DISABLE_AUTOUPDATER ortam değişkenini ayarlayın; yalnızca Claude Code güncellemelerini kapatıp plugin auto-update'lerini açık tutmak isterseniz bunun yanına FORCE_AUTOUPDATE_PLUGINS=1 ekleyin.

Güvenlik

Plugin'ler ve marketplace'ler, makinenizde kullanıcı yetkilerinizle keyfi kod çalıştırabilen, yüksek güvenilirlik gerektiren bileşenlerdir. Yalnızca güvendiğiniz kaynaklardan plugin kurun ve marketplace ekleyin. Anthropic, plugin'lere dahil edilen MCP sunucularını, dosyaları ya da diğer yazılımları kontrol etmez ve bunların amaçlandığı gibi çalıştığını doğrulayamaz — kurmadan önce her plugin'in ana sayfasını kontrol edin. Organizasyonlar, yönetilen marketplace kısıtlamalarıyla kullanıcıların hangi marketplace'leri ekleyebileceğini sınırlayabilir.

Sorun Giderme

Belirti	Olası neden ve çözüm
/plugin komutu tanınmıyor	claude --version ile sürümü kontrol edin, Claude Code'u güncelleyin (npm: npm install -g @anthropic-ai/claude-code@latest) ve terminali yeniden başlatın.
Plugin skill'leri görünmüyor	rm -rf ~/.claude/plugins/cache ile önbelleği temizleyin, Claude Code'u yeniden başlatın ve plugin'i tekrar kurun.
Marketplace "..." not found hatası	Marketplace'i /plugin marketplace add ile ekleyin, ardından kurulumu tekrar deneyin.
Dil sunucusu başlamıyor	İkili dosyanın kurulu ve $PATH'te olduğunu doğrulayın; ayrıntı için /plugin Errors sekmesine bakın.
Yeni kurulan plugin aktif değil	Kurulum özeti Run /reload-plugins to activate. diyorsa bu komutu çalıştırın; prompt önbelleğini geçersiz kılacaksa --force ile tekrar deneyin.
rust-analyzer/pyright yüksek bellek kullanıyor	Büyük projelerde bellek sorunu yaşıyorsanız /plugin disable <plugin-adi> ile devre dışı bırakıp Claude'un yerleşik arama araçlarına güvenebilirsiniz.

Pratik Senaryo: Ekip İçin Basit Bir Plugin ve Marketplace

Diyelim ki ekibinizde herkesin kullandığı bir commit skill'i ve bir code-review agent'ı var; şu ana kadar bunları her geliştiricinin kendi .claude/ dizinine elle kopyalayarak paylaşıyordunuz. Önce bir plugin dizini oluşturup mevcut dosyaları taşırsınız:

mkdir -p team-tools/.claude-plugin
cp -r .claude/commands team-tools/
cp -r .claude/agents team-tools/

team-tools/.claude-plugin/plugin.json'ı yazarsınız:

{
  "name": "team-tools",
  "description": "Ekibin ortak commit ve code review araçları",
  "version": "1.0.0"
}

claude --plugin-dir ./team-tools ile yerelde test ettikten, claude plugin validate ./team-tools ile doğruladıktan sonra bu dizini your-org/claude-plugins adlı bir GitHub deposuna gönderirsiniz ve depo kökünde bir .claude-plugin/marketplace.json ile katalog dosyanızı oluşturursunuz. Ardından projenizin .claude/settings.json'ına extraKnownMarketplaces girdisini eklersiniz; böylece depoyu güvenen her ekip üyesi marketplace'i otomatik alır ve claude plugin install team-tools@your-org komutuyla tek satırda kurar. Elle kopyalama, sürüm karmaşası ve "sende hangi sürüm var" sorularının yerini artık tek bir sürümlü, merkezi kaynak alır.

Sıkça Sorulan Sorular

Plugin ile standalone .claude/ yapılandırması arasındaki fark nedir, ne zaman hangisini kullanmalıyım?

Standalone yapılandırma (.claude/commands/, .claude/skills/ vb.) yalnızca tek bir projede geçerlidir ve skill'ler /isim olarak adlandırılır; hızlı deneme ve kişisel iş akışları için idealdir. Plugin ise kendi kendine yeten bir dizin ve isteğe bağlı bir plugin.json manifestosudur; skill'leri /plugin-adi:isim olarak ad alanına sahiptir, marketplace üzerinden dağıtılabilir, sürümlenebilir ve projeler arası yeniden kullanılabilir. Bir şeyi ekiple paylaşmaya ya da topluluğa dağıtmaya karar verdiğinizde standalone yapılandırmayı plugin'e dönüştürmeniz önerilir.

Bir plugin'i test etmek için mutlaka bir marketplace'e mi eklemem gerekir?

Hayır. claude --plugin-dir ./my-plugin ile herhangi bir yerel dizini, kurulum ya da marketplace kaydı yapmadan doğrudan yükleyip test edebilirsiniz; bu bayrak bir .zip arşivini de kabul eder. URL'de barındırılan bir .zip arşivini test etmek için ise --plugin-url kullanılır. Marketplace, yalnızca plugin'i başkalarıyla paylaşmaya hazır olduğunuzda gereklidir.

Resmi marketplace ile topluluk marketplace'i arasındaki fark nedir?

claude-plugins-official, Anthropic'in kendi takdirine göre derlediği ve ilk etkileşimli çalıştırmada otomatik eklenen bir kataloğdur; uygulama içi gönderim formları buraya plugin eklemez. anthropics/claude-plugins-community ise otomatik doğrulama ve güvenlik taramasından geçmiş, her plugin'in belirli bir commit SHA'sına sabitlendiği üçüncü taraf plugin kataloğudur; elle /plugin marketplace add anthropics/claude-plugins-community ile eklenir ve @claude-community adıyla kurulur.

Plugin kurarken hangi kapsamı (scope) seçmeliyim?

Yalnızca kendi kullanımınız ve tüm projeleriniz için user scope; depodaki tüm katılımcılarla paylaşmak ve .claude/settings.json'a eklemek için project scope; yalnızca bu depoda, yalnızca sizin için ve katılımcılarla paylaşılmadan kurmak için local scope kullanılır. Bir organizasyon yöneticisinin yönetilen ayarlarla kurduğu plugin'ler ise managed scope'ta görünür ve değiştirilemez.

Kendi ekibim için özel (private) bir marketplace nasıl paylaşırım?

Plugin'lerinizi ve konumlarını listeleyen bir marketplace.json oluşturup bunu özel bir git deposuna (GitHub, GitLab ya da self-hosted) gönderirsiniz. Ekip üyeleri bu depoyu /plugin marketplace add owner/repo ile ekler; deponun private olması, marketplace'in yalnızca depoya erişimi olanlarca görülebilmesini sağlar. Takım yöneticileri, projenin .claude/settings.json'ına extraKnownMarketplaces ekleyerek bu marketplace'in, depo klasörü güvenildiğinde otomatik kaydedilmesini de sağlayabilir.

Bir plugin kurulumdan hemen sonra neden aktif olmuyor?

Kurulum özeti Plugin is now active. demiyorsa, etkinleştirme prompt önbelleğini geçersiz kılacağı için Claude Code bunu otomatik yapmamıştır; Run /reload-plugins to activate. mesajını gördüğünüzde bu komutu çalıştırmanız gerekir. Yeniden yükleme prompt önbelleğini geçersiz kılacaksa komut sizi uyarır ve /reload-plugins --force ile tekrar denemenizi bekler.

Özet

Plugin sistemi, Claude Code'daki özel skill, agent, hook, MCP ve LSP sunucularını tek bir sürümlenebilir, paylaşılabilir pakette toplar. Geliştirme sırasında --plugin-dir ile herhangi bir dizini kurulum yapmadan test edebilir, paylaşmaya hazır olduğunuzda bir marketplace.json ile kendi marketplace'inizi yayınlayabilir ya da claude-plugins-official/claude-plugins-community gibi Anthropic'in kataloglarını kullanabilirsiniz. Kurulum /plugin install plugin-adi@marketplace-adi ile üç kapsamdan (user/project/local) birine yapılır; ekipler extraKnownMarketplaces ile bu süreci tamamen otomatikleştirebilir. Her plugin ve marketplace, makinenizde kod çalıştırabilen güvenilir bileşenler olduğundan yalnızca kaynağına güvendiğiniz plugin'leri kurmayı unutmayın.

Plugin'lerin taşıyabileceği skill ve slash komut yapısını daha derinlemesine görmek isterseniz Agent Skills rehberime, plugin'lerin ekleyebileceği MCP sunucularının detayları için MCP rehberime göz atabilirsiniz.