Claude Code Eklentileri Nasıl Geliştirilir: Adım Adım Kılavuz

Claude Code, çoğu geliştirme görevini kutudan çıktığı gibi halleder, ancak her ekibin varsayılanların kapsamadığı özel iş akışları vardır. Şirketinizin tercih ettiği yapıda bileşenleri hazırlayan özel bir komuta, her commit öncesi otomatik linting'e ya da sürekli kullandığınız bir çerçevenin belgelerine hızlı erişime ihtiyaç duyabilirsiniz.

Claude Code eklentileri, bu özellikleri kendiniz eklemenizi sağlar. Topluluk tarafından geliştirilen eklentileri kurabilir veya kendi eklentilerinizi oluşturabilirsiniz.

Anthropic’in özerk kod yazma aracında yeniyseniz, Claude Code Rehberi veya Claude Modellerine Giriş ile başlamanızı öneririm. Bu eğitim, Claude Code'un kurulu olduğunu ve temel görevler için kullandığınızı varsayar.

Sonunda şunları nasıl yapacağınızı bileceksiniz:

• Anthropic'in dizininden ve topluluk kaynaklarından eklenti bulma ve kurma
• Eklentilerin içerebileceği üç bileşen türünü anlama
• Farklı kullanım durumları için doğru türü seçme
• Kendi eklentilerinizi geliştirme ve paylaşma

Anthropic'in en yeni modelinin yeteneklerine genel bakış için, Claude Sonnet 4.6 rehberimize göz atın

Claude Code Eklentileri Nedir?

Eklenti, bir veya daha fazla Claude Code uzantısını kolay paylaşım ve kurulum için bir pakette toplayan yapıdır. Yapılandırma dosyalarını makineler veya ekip arkadaşları arasında elle kopyalamak yerine, her şeyi bir eklentiye sarıp tek bir birim olarak dağıtabilirsiniz.

Eklentiler üç tür bileşen içerebilir:

• Skills: /skill-name ile çağırdığınız özel komutlar veya uygun olduğunda Claude'un otomatik kullandığı bağlam farkındalıklı istemler
• MCP sunucuları: Claude'a aksi halde erişimi olmayan verilere erişim sağlayan harici hizmet ve API bağlantıları
• Hook'lar: Bir dosya düzenlenmeden önce veya bir commit'ten sonra gibi belirli olaylarda otomatik çalışan kabuk betikleri

Bir eklenti bunlardan yalnızca birini içerebilir ya da birlikte çalışan birkaçını birleştirebilir. Bir "dağıtım" eklentisi, manuel dağıtımlar için bir /deploy becerisi, hazırlık ortamı durumunu kontrol eden bir MCP sunucusu ve herhangi bir dağıtım komutu çalışmadan önce testleri çalıştıran bir hook içerebilir.

plugin.json bildirim dosyası, bir eklentinin ne içerdiğini tanımlar. Hangi skill'lerin, MCP sunucularının ve hook'ların kurulacağını; eklenti adı, sürümü ve yazarı gibi metaverileri belirtir. Bir eklenti kurduğunuzda, Claude Code bu bildirimi okur ve her bileşeni doğru konuma yerleştirir.

Bu paketleme formatı sayesinde Claude Code uzantılarının dahili dosya yapısını anlamanıza gerek yoktur. Eklentiyi kurarsınız ve her şey olması gerektiği yere yerleşir.

Claude Code Eklentilerini Bulma ve Kurma

Eklentilerin çoğu iki yerden birinde bulunur. Anthropic'in resmi dizini olan plugins.claude.ai, Anthropic tarafından geliştirilen eklentileri, doğrulanmış topluluk katkılarını ve popüler üçüncü taraf uzantıları içerir. Her liste, eklentinin hangi bileşenleri içerdiğini, uyumluluk bilgilerini ve kurulum talimatlarını gösterir.

İkinci kaynak GitHub'dır. awesome-claude-code deposu, kategoriye göre düzenlenmiş bir seçkiyi korur ve bireysel geliştiriciler eklentilerini kendi depolarında yayınlar.

İstediğiniz bir eklentiyi bulduktan sonra, kurulum komutu bulunduğu yere göre değişir:

# From the official directory
claude plugin add @anthropic/deploy-helper
 
# From a GitHub repository
claude plugin add github:username/repo-name
 
# From a local directory (useful during development)
claude plugin add ./my-plugin

Birkaç eklenti kurduktan sonra, bunları takip etmek isteyeceksiniz. plugin komutu listeleme, güncelleme ve kaldırmayı yönetir:

# List all installed plugins
claude plugin list
 
# Update a specific plugin to the latest version
claude plugin update @anthropic/deploy-helper
 
# Update all plugins
claude plugin update --all
 
# Remove a plugin
claude plugin remove @anthropic/deploy-helper

Kurulum sırasında vereceğiniz kararlardan biri kapsamdır. Eklentiler iki yerde bulunabilir: kullanıcı kapsamı ~/.claude/plugins/ altına kurulur ve tüm projelerinizde çalışır; proje kapsamı ise belirli bir depo içinde .claude/plugins/ altına kurulur.

Varsayılan kullanıcı kapsamıdır. Bir eklentiyi yalnızca geçerli proje için kurmak üzere --project bayrağını ekleyin:

claude plugin add @anthropic/deploy-helper --project

Proje kapsamındaki eklentiler, uzantı belirli bir kod tabanına bağlıysa mantıklıdır. 

Şirketinizin dağıtım sürecini bilen bir eklenti o projede yer almalıdır. Kişisel tercihlerinize göre kodu biçimlendiren bir eklenti ise kullanıcı düzeyinde yer almalıdır. Bir eklenti her iki kapsamda da mevcutsa, proje sürümü önceliklidir; bu da ekiplerin projeye özgü yapılandırmaları zorunlu kılmasına izin verirken, geliştiricilerin kişisel eklentilerini başka yerlerde etkin tutmasını sağlar.

Doğru Claude Code Eklenti Türünü Seçme

Üç bileşen türü farklı amaçlara hizmet eder ve kaynak tüketimleri de farklıdır. Bu ödünleşimleri anlamak, bağlam penceresini sağlıklı tutar ve her iş için doğru araca uzanmanıza yardımcı olur.

Skills vs MCP sunucuları: Token dengesi

MCP sunucuları, oturum başında her araç tanımını bağlam penceresine önyükler. Her araç adı, açıklaması ve tam parametre şemasını gerektirir; bu genellikle araç başına 100-300 token tutar. Beş sunuculuk bir kurulum, tek bir karakter yazmadan önce yaklaşık 55.000 token tüketir:

• GitHub: 35 araç
•  Slack: 11 araç
• Sentry: 5 araç
• Grafana: 5 araç
• Splunk: 2 araç

Bir analiz, 7+ sunuculu kurulumların 67.000+ token tükettiğini buldu; bu da 200K'lık bağlam pencerenizin üçte birinin, konuşma başlamadan gitmesi demek.

Skills, aşamalı açıklama yaklaşımıyla farklı bir yol izler. Oturum başında, Claude yalnızca YAML ön bilgilendirmesinden her becerinin adını ve tek satırlık açıklamasını görür; beceri başına yaklaşık 100 token. 

Tam talimatlar, yalnızca Claude becerinin mevcut görevle ilgili olduğuna karar verdiğinde yüklenir. Referans dosyaları yalnızca özel olarak ihtiyaç duyulduğunda yüklenir. Ve betikler bağlam penceresine hiç girmez; Claude onları harici olarak çalıştırır ve yalnızca çıktı geri döner.

Anthropic, 2025'in sonlarında Tool Search ile bu dengesizliği ele aldı; MCP sunucularına tembel yüklemeyi getiren bir özellik. 

Her araç tanımını önyüklemek yerine, Claude Code artık araç açıklamalarının mevcut bağlamın %10'undan fazlasını tüketeceğini algılar ve isteğe bağlı yüklemeye geçer. 

Dahili testlerde, büyük araç kitaplıklarında bağlam kullanımı ~134.000 tokenden ~5.000 tokene düştü. Araç seçimi doğruluğu da iyileşti; MCP değerlendirmelerinde Opus 4 %49'dan %74'e, Opus 4.5 ise %79,5'ten %88,1'e yükseldi.

Peki, hangisini ne zaman kullanmalısınız?

Skills, Claude'un yargısını kullanarak uygulayabileceği bilgi veya iş akışlarına erişmesini istediğinizde en iyi uyum sağlar. Ekibinizin kod inceleme kontrol listesini tanımlayan bir beceri, Claude kodu incelerken yüklenir; ancak her bir maddenin nasıl uygulanacağına bağlama göre yine Claude karar verir. 

Ayrıca ağır hesaplama gerektiren işlemler için betiklere ihtiyaç duyulduğunda da skills mantıklıdır; çünkü betik kodu bağlam penceresi dışında kalır.

MCP sunucuları, Claude'un Slack mesajları, GitHub PR'ları veya veritabanı sorguları gibi harici hizmetlerden gerçek zamanlı verilere ihtiyaç duyduğunda en iyi uyum sağlar. Birden fazla yapay zekâ aracısının aynı araçlara ihtiyaç duyduğu durumlarda veya denetim günlükleri ve açık izinler gibi kurumsal özellikler gerektiğinde de doğru seçimdir.

Birçok kurulum her ikisini birden birleştirir: skills doğal dil talimatlarıyla "nasıl" ve "ne zaman"ı sağlar; MCP sunucuları ise gerçek API çağrılarını üstlenir.

Kurulmaya değer popüler Claude Code skills

• Superpowers: TDD, hata ayıklama ve yapılandırılmış planlama için 20+ üretimde sınanmış iş akışı
• frontend-design: Claude'a genel estetikten kaçınmasını ve cesur tasarım kararları almasını söyler
• mcp-builder: Harici API'leri entegre etmek için MCP sunucuları oluşturma rehberi
•  webapp-testing: UI doğrulaması için Playwright kullanarak yerel web uygulamalarını test edin
•  skill-creator: Yeni beceriler oluşturma sürecinde sizi yönlendiren etkileşimli araç

Bağlanmaya değer popüler MCP sunucuları

• Context7: Gerçek zamanlı, sürüme özel dokümantasyon arama
• GitHub: Depo arama, PR yönetimi, sorun takibi
• Playwright: Ekran görüntüsü yerine erişilebilirlik ağaçlarıyla tarayıcı otomasyonu
• Supabase: Satır Düzeyi Güvenlik farkındalığıyla veritabanı sorguları
• Sentry: Hata izleme ve performans izleme, doğrudan editörünüzde

Ayrıca en iyi uzaktan MCP sunucuları rehberimizi de okuyabilirsiniz.

Hook'lar: Deterministik katman

Hook'lar, skills–MCP tartışmasının tamamen dışındadır. Skills ve MCP sunucuları Claude'a dönüktür (ne zaman kullanılacağına Claude karar verirken), hook'lar sisteme dönüktür. PreToolUse veya PostToolUse gibi olaylarda tetiklenir; Claude belirli eylemleri yapmadan önce veya sonra kabuk betiklerini çalıştırır. Bir hook'un çalışıp çalışmayacağı konusunda Claude'un söz hakkı yoktur.

Bu, her seferinde istisnasız gerçekleşmesi gereken durumlarda Hook'ları doğru seçim kılar: her commit öncesi linting, korumalı dizinlere yazmayı engelleme, her bash komutunu günlüğe alma veya herhangi bir dağıtımdan önce testleri çalıştırma.

Bu geliştirici "yazarken-engelle" hook'ları yerine "gönderimde-engelle" hook'larını öneriyor. Claude'u görevin ortasında engellemek aracıyı şaşırtır ve daha kötü sonuçlar üretir. Ekibi, PreToolUse hook'unu Bash(git commit) etrafına saracak şekilde kullanıyor ve yalnızca testler geçerse var olan bir geçici dosyayı kontrol ediyor. Dosya yoksa, commit yok. Aracı işini bitiriyor, ardından doğrulama en sonda gerçekleşiyor.

Hook'lar, bağlam penceresi dışında kabuk betikleri olarak çalıştıkları için token ek yükü getirmez.

Kurulması faydalı Claude hook'ları

• Düzenlemede ESLint/Prettier: Claude yazdıktan sonra dosyaları otomatik biçimlendir
• Commit'te test geçidi: Testler geçmedikçe commit'leri engelle
• Korumalı yollar: Göçler, yapılandırmalar veya vendor dizinlerine yazmayı önle
• Tamamlanınca bildirim: Uzun görevler bittiğinde Slack veya masaüstü uyarıları gönder
• Transkript yedeği: Sıkıştırma çalıştırılmadan önce konuşma geçmişini kaydet

Kendi Claude Code Eklentilerinizi Nasıl Geliştirirsiniz

Bir beceri kişisel .claude/ dizininizde bulunduğunda, onu yalnızca siz kullanabilirsiniz. Onu bir eklenti olarak paketlemek, ekip arkadaşlarınızla paylaşmanıza veya projeler arasında yeniden kullanmanıza olanak tanır.

session-logger adlı, /session-logger:summarize komutu ekleyen bir eklenti oluşturacağız. Çağrıldığında, Claude konuşmayı gözden geçirir ve yapılandırılmış bir özeti SESSION_LOG.md dosyasına ekler.

Eklenti yapısını oluşturun

Eklentiler dosya sisteminizde herhangi bir yerde bulunabilir. Bu eğitim için ana dizininizde bir tane oluşturacağız:

cd ~
mkdir -p session-logger/.claude-plugin
mkdir -p session-logger/skills/summarize

Bu, şunları oluşturur:

~/session-logger/
├── .claude-plugin/
│   └── plugin.json  	# manifest goes here, nowhere else
└── skills/
	└── summarize/   	# folder name becomes the command name
    	└── SKILL.md 	# must be named exactly this

Manifesti yazın

~/session-logger/.claude-plugin/plugin.json dosyasını oluşturun:

{
  "name": "session-logger",
  "description": "Log session summaries to a markdown file",
  "version": "1.0.0"
}

name alanı ad alanı öneki olur. Bu eklentideki tüm komutlar /session-logger: ile başlayacaktır.

Beceri dosyasını yazın

~/session-logger/skills/summarize/SKILL.md dosyasını oluşturun:

---
description: Log a summary of the current session to SESSION_LOG.md
disable-model-invocation: true
---
 
When invoked, review the conversation and create a summary with these sections:
 
- **Date/time**: Current timestamp
- **Tasks completed**: What was accomplished
- **Files modified**: List of files created or changed
- **Decisions made**: Architectural or implementation choices
- **Open questions**: Unresolved items for future sessions
 
Append the summary to SESSION_LOG.md in the project root. Create the file if it doesn't exist.

disable-model-invocation: true satırı, bu beceriyi yalnızca sizin tetikleyebileceğinizi Claude'a bildirir. Bu bayrak olmadan, Claude konuşmaya yardımcı olacağını düşünürse komutu kendi kendine çalıştırmaya karar verebilir. Bir günlükleyici veya dağıtım aracı için genellikle manuel kontrol istersiniz.

Yerelde test edin

Eklentiyi kullanmak istediğiniz herhangi bir projeye gidin ve ardından --plugin-dir bayrağı eklentinize işaret edecek şekilde Claude Code'u başlatın:

cd ~/your-project
claude --plugin-dir ~/session-logger

/session-logger:summarize yazarak komutu çağırın. Eklenti komutlarının, tam adı yazana kadar otomatik tamamlama önerilerinde görünmediğini unutmayın. Claude Code onu geçerli bir komut olarak tanıdığında metin maviye döner.

Oturumda biraz çalıştıktan sonra komutu çalıştırın. Claude konuşmayı gözden geçirir ve geçerli proje dizininizdeki SESSION_LOG.md dosyasına bir kayıt ekler.

Başkalarıyla paylaşın

Eklentinizi GitHub'a gönderin. Manuel klonlamanın ötesinde dağıtmak için, bir eklenti pazarına ekleyin. pazar yeri rehberi, kendi pazar yerinizi oluşturmayı veya mevcut olanlara başvurmayı kapsar.

Sonuç

Eklentiler, Claude Code'u genel amaçlı bir yardımcıdan, sizin özel iş akışınıza göre şekillenmiş bir araca dönüştürür. Oluşturduğumuz oturum günlükleyicisi yaklaşık beş dakika ve üç dosya sürdü. En faydalı eklentilerin çoğu bundan çok daha karmaşık değildir.

Adımları izlediyseniz, artık makinenizde çalışan bir eklentiniz var. Onu özelleştirmeyi deneyin. Özet formatını değiştirin, yeni bölümler ekleyin veya ekibinizin gerçekten ihtiyaç duyduğu bir şeyle değiştirin. Kişisel bir aracı hızla geliştiriyor olun ya da yüzlerce geliştiriciye dağıtacağınız bir şey üzerinde çalışın, yapı aynı kalır.

Fırsat bulduğunuzda topluluk depolarına göz atın. Başkalarının eklentilerini nasıl yapılandırdığını görmek, dokümantasyonun öğretemediği kalıpları öğretir. Ve faydalı bir şey inşa ettiğinizde, yayınlayın. Ekosistem paylaşılan eklentilerle, birer birer büyür.