Plugin System

Plugin’ler Claude Code extension’larını dağıtım için paketler. Bir plugin; custom command, subagent, skill, hook ve MCP server içerebilir. Anthropic, plugin marketplace’i Aralık 2025’te 36 küratörlü plugin ile resmi olarak başlattı.

Plugin Structure

my-plugin/
├── .claude-plugin/
│   └── plugin.json              # Zorunlu: metadata
├── commands/                     # Slash command'lar
│   └── hello.md
├── agents/                       # Subagent'lar
│   └── helper.md
├── skills/                       # Skill'ler
│   └── my-skill/
│       └── SKILL.md
├── hooks/                        # Event handler'lar
│   └── hooks.json
└── .mcp.json                     # MCP server'lar

Plugin Manifest

Minimal plugin.json:

{
  "name": "my-plugin",
  "description": "Bu plugin ne yapar",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

Plugin Management

> /plugin                              # İnteraktif arayüz
> /plugin install name@marketplace     # Kur
> /plugin enable name@marketplace      # Etkinleştir
> /plugin disable name@marketplace     # Devre dışı bırak
> /plugin uninstall name@marketplace   # Kaldır
> /plugin marketplace add ./local      # Yerel marketplace ekle
> /plugin marketplace list             # Marketplace'leri listele

Local Development

Test için yerel marketplace oluşturun:

mkdir dev-marketplace && cd dev-marketplace
mkdir my-plugin
# Plugin yapısını oluştur

cd ..
claude
> /plugin marketplace add ./dev-marketplace
> /plugin install my-plugin@dev-marketplace

Plugin Installation Improvements

Plugin’ler artık custom npm registry ve npm kaynaklarından kurulumda spesifik versiyon pinleme destekler.

Plugin Components

Custom Marketplace Oluşturma

Takımlar kendi marketplace’lerini GitHub repo olarak kurabilir. Her plugin bir alt dizin:

my-team-marketplace/
├── code-review-plugin/
│   └── .claude-plugin/
│       └── plugin.json
├── deploy-plugin/
│   └── .claude-plugin/
│       └── plugin.json
└── security-plugin/
    └── .claude-plugin/
        └── plugin.json

GitHub’da yayınlama:

# 1. GitHub repo oluştur
gh repo create my-org/claude-marketplace --public

# 2. Plugin'leri ekle
cp -r code-review-plugin/ claude-marketplace/
cd claude-marketplace && git add -A && git commit -m "add plugins" && git push

# 3. Takım üyeleri marketplace'i ekler
> /plugin marketplace add my-org/claude-marketplace
> /plugin install code-review-plugin@my-org/claude-marketplace

Yerel path ile:

# Network share veya monorepo içinden
> /plugin marketplace add /shared/team-plugins
> /plugin marketplace add ../tools/claude-plugins

Marketplace yönetimi:

> /plugin marketplace list              # Tüm marketplace'leri listele
> /plugin marketplace remove my-org/... # Marketplace kaldır

Kullandığım Plugin’ler

feature-dev

En popüler Claude Code plugin’i. Tek bir prompt ile 7 fazlı feature geliştirme workflow’u çalıştırır:

graph LR
    R["Requirements"] --> E["Explore"]
    E --> D["Design"]
    D --> I["Implement"]
    I --> T["Test"]
    T --> RV["Review"]
    RV --> DOC["Docs"]

    style R fill:#1a1a3e,stroke:#a855f7,stroke-width:1px,color:#c084fc
    style I fill:#132213,stroke:#22c55e,stroke-width:1px,color:#4ade80
    style T fill:#1c1208,stroke:#eab308,stroke-width:1px,color:#facc15
    style RV fill:#2d1117,stroke:#f85149,stroke-width:1px,color:#f85149

# Kurulum
/plugin marketplace add feature-dev

# Kullanım
> /feature-dev "Kullanıcı profil sayfası ekle - avatar upload, bio düzenleme, şifre değiştirme"

Her faz otomatik çalışır: gereksinim toplar, codebase’i parallel agent’larla keşfeder, mimari tasarlar, implement eder, test yazar, review yapar ve dokümante eder.

multi-agent-squad

Production-ready multi-agent orchestration plugin’i. Karmaşık görevleri birden fazla özelleşmiş agent’a böler ve koordine eder.

# Kurulum
/plugin marketplace add multi-agent-squad

Ne zaman kullanmalı:

• Monolith-to-microservices migrasyon
• Cross-module refactoring
• Büyük codebase audit’leri
• Paralel feature geliştirme

feature-dev vs multi-agent-squad:

Trending & High-Star Plugin’ler

Understand-Anything

5 özelleşmiş AI agent ile codebase’i analiz edip knowledge graph oluşturur. Yeni bir projeye girdiğinizde codebase’i hızla anlamanızı sağlar.

/plugin marketplace add understand-anything

• Codebase’i 5 agent paralel tarar (mimari, bağımlılıklar, pattern’lar, API’ler, veri akışı)
• İlişkisel knowledge graph çıkarır
• Yeni takım üyelerine onboarding veya brownfield projelere giriş için ideal

GitHub - Understand-Anything

claude-context

Zilliz tarafından geliştirilen semantic code search MCP. Hybrid BM25 + vector search ile codebase’de akıllı arama yapar, ~%40 token azaltması sağlar.

/plugin marketplace add claude-context

• Keyword arama (BM25) + anlamsal arama (vector) birleşimi
• Claude’un doğru dosyaları bulma doğruluğunu artırır
• Büyük codebase’lerde token tasarrufu kritik

GitHub - claude-context

oh-my-claudecode

Teams-first multi-agent orchestration. 19 özelleşmiş agent ve 28 skill ile takım bazlı geliştirme workflow’ları sunar.

/plugin marketplace add oh-my-claudecode

• Takım odaklı: code review, PR yönetimi, sprint planning agent’ları
• 19 agent birbirini koordine eder
• Tek geliştirici değil, takım workflow’u optimize eder
• multi-agent-squad’dan farkı: takım süreçlerine (PR, review, sprint) odaklanması

GitHub - oh-my-claudecode

Kaynak: Claude Code Docs - Create Plugins