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 kapsamına girmeyen özgün iş akışları vardır. Şirketinizin tercih ettiği yapıda bileşenleri iskeletlendiren özel bir komut, her commit öncesi otomatik linting ya da sürekli kullandığınız bir çerçevenin dokümantasyonuna hızlı erişim isteyebilirsiniz.

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

Anthropic’in ajansal kodlama aracında yeniyseniz, Claude Code Rehberi ya da Claude Modellerine Giriş ile başlamanızı öneririm. Bu eğitim, Claude Code’un kurulu olduğunu ve temel görevlerde kullandığınızı varsayar.

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

• Anthropic’in dizininden ve topluluk kaynaklarından eklentileri bulup yüklemek
• Eklentilerin içerebileceği üç bileşen türünü anlamak
• Farklı kullanım durumları için doğru türü seçmek
• Kendi eklentilerinizi geliştirmek ve paylaşmak

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

Özet

• Claude Code eklentileri, paylaşılabilir paketler halinde claude plugin add ile kurulan skills, MCP sunucuları ve hook’ları bir araya getirir

• Skills talep üzerine yüklenir (~her biri 100 token); MCP sunucuları araç tanımlarını önceden yükler (Tool Search ile azaltılır); hook’lar sıfır token maliyetiyle kabuk betikleri olarak çalışır

• Bilgi ve iş akışları için skills, harici API erişimi için MCP sunucuları, her seferinde tetiklenmesi gereken kurallar için hook’lar kullanın

• Üç dosyayla bir eklenti oluşturun: .claude-plugin/plugin.json manifesti, bir skills/ dizini ve bir SKILL.md talimat dosyası

Claude Code Eklentileri Nedir?

Bir eklenti, bir veya daha fazla Claude Code uzantısını kolay paylaşım ve kurulum için paketleyen bir birimdir. Yapılandırma dosyalarını makineler ya da 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 ilgili olduğunda Claude’un otomatik olarak kullandığı bağlam duyarlı istemler

• MCP sunucuları: Claude’a aksi halde erişemeyeceği verilere erişim sağlayan harici hizmetler ve API’lara bağlantılar

• Hook’lar: Bir dosya düzenlenmeden önce veya bir commit’ten sonra gibi belirli olaylarda otomatik olarak çalışan kabuk betikleri

Bir eklenti bunlardan yalnızca birini içerebilir veya birlikte çalışan birkaçını birleştirebilir. Bir “dağıtım” eklentisi, manuel dağıtımlar için bir /deploy skill’i, hazırlık ortamı durumunu kontrol eden bir MCP sunucusu ve herhangi bir dağıtım komutu yürütülmeden önce testleri çalıştıran bir hook içerebilir.

plugin.json manifest 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 meta verilerle birlikte belirtir. Bir eklentiyi kurduğunuzda, Claude Code bu manifesti okur ve her bileşeni doğru konuma yerleştirir.

Bu paketleme formatı, Claude Code uzantılarının dahili dosya yapısını anlamanızı gerektirmez. Eklentiyi kurarsınız ve her şey olması gereken yere iner.

Claude Code Eklentilerini Bulma ve Yükleme

Çoğu eklenti iki yerden birinde bulunur. Anthropic’in claude.com/plugins adresindeki resmi dizininde Anthropic tarafından geliştirilen eklentiler, doğrulanmış topluluk katkıları ve popüler üçüncü taraf uzantılar yer alır. Her liste, eklentinin içerdiği bileşenleri, uyumluluk bilgilerini ve kurulum talimatlarını gösterir.

İkinci kaynak GitHub’dır:

İstediğiniz eklentiyi bulduktan sonra, kurulum komutu bulunduğu yere bağlıdır:

# 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ırma işlemlerini 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/ konumuna kurulur ve tüm projelerinizde çalışır; proje kapsamı ise belirli bir depo içinde .claude/plugins/ konumuna 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 kapsamlı eklentiler, uzantı belirli bir kod tabanına bağlı olduğunda mantıklıdır. 

Şirketinizin dağıtım sürecini bilen bir eklenti o projede olmalıdır. Kodu kişisel tercihlerinize göre biçimlendiren bir eklenti ise kullanıcı düzeyinde yer almalıdır. Bir eklenti her iki kapsamda da mevcut olduğunda, proje sürümü önceliklidir; böylece ekipler proje özelindeki yapılandırmaları zorunlu kılabilirken geliştiriciler kişisel eklentilerini başka yerlerde etkin tutabilir.

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

Üç bileşen türü farklı amaçlara hizmet eder ve bağlam penceresi token’larını farklı şekilde tüketir. Bu ödünleşimleri anlamak, her iş için doğru olanı seçmenize yardımcı olur.

Skills ve MCP sunucuları: Token dengesi

MCP sunucuları, oturum başlangıcında her araç tanımını bağlam penceresine önceden yükler. Her araç adı, açıklaması ve tam parametre şemasını gerektirir; bu da genellikle araç başına 100–300 token’dır. Beş sunuculu bir kurulum, siz tek harf yazmadan 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 penceresinin üçte birinin, konuşma başlamadan gitmesi demek.

Skills ise kademeli açıklama yaklaşımını kullanır. Oturum başlangıcında Claude sadece YAML önbilgisindeki her skill’in adını ve tek satırlık açıklamasını görür; bu da skill başına yaklaşık 100 token’dır. 

Tam talimatlar ancak Claude, skill’in mevcut görev için ilgili olduğuna karar verdiğinde yüklenir. Başvuru dosyaları ise yalnızca özel olarak gerektiğinde yüklenir. Betikler asla bağlam penceresine girmez; Claude bunları harici olarak çalıştırır ve yalnızca çıktı geri gelir.

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

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

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

Aralarında nasıl karar vereceğiniz şöyle.

Claude’un yargısını kullanarak uygulayabileceği bilgi veya iş akışlarına erişmesini istediğinizde skills en uygunudur. Ekibinizin kod inceleme kontrol listesini açıklayan bir skill, Claude kodu incelerken yüklenir; ancak her bir öğenin nasıl uygulanacağına bağlama göre yine Claude karar verir. 

Ağır hesaplama için betiklere ihtiyaç duyan işlemler için de 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ğu durumlar için en iyisidir. Birden fazla yapay zeka ajanının aynı araçlara ihtiyaç duyduğu veya denetim günlükleri ve açık izinler gibi kurumsal özellikler gerektiği durumlarda da doğru seçimdir.

Birçok kurulum 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ı gerçekleştirir.

Kurulmaya değer popüler Claude Code skills

• Superpowers (bizim eğitimimiz): TDD, hata ayıklama ve yapılandırılmış planlama için 20+ üretimde denenmiş iş akışı
• frontend-design: Claude’a genel estetikten kaçınmasını ve cesur tasarım kararları almasını söyler
• mcp-builder: Harici API’ları 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 skills 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 özgü dokümantasyon arama
• GitHub: Depo arama, PR yönetimi, iş takip
• 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: Editörünüzde doğrudan hata izleme ve performans izleme

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

Hook’lar: Deterministik katman

Hook’lar, skills ve MCP tartışmasının tamamen dışındadır. Skills ve MCP sunucuları Claude’a dönükken (Claude ne zaman kullanılacağına karar verir), hook’lar sisteme dönüktür. PreToolUse veya PostToolUse gibi olaylarda tetiklenir, Claude belirli eylemleri gerçekleştirmeden önce veya sonra kabuk betiklerini çalıştırırlar. Bir hook’un çalışıp çalışmayacağına Claude karar vermez.

Bu, hook’ları istisnasız gerçekleşmesi gereken durumlar için doğru seçim yapar: her commit öncesi linting, korumalı dizinlere yazmayı engelleme, her bash komutunu günlüğe kaydetme veya herhangi bir dağıtımdan önce testleri çalıştırma.

Şu geliştirici “block-at-submit” hook’larını “block-at-write” hook’larına tercih ediyor. Claude’u görev ortasında engellemek ajanı şaşırtır ve daha kötü sonuçlar üretir. Ekibi, PreToolUse hook’u ile Bash(git commit) komutunu sarmalayıp sadece testler geçtiğinde var olan bir geçici dosyayı kontrol ediyor. Dosya yoksa commit de yok. Ajan işini bitiriyor, doğrulama ise sonda gerçekleşiyor.

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

Kurulması faydalı Claude hook’ları

• Düzenlemede ESLint/Prettier: Claude yazdıktan sonra dosyaları otomatik biçimlendir
• Commit’te test kapısı: Testler geçmedikçe commit’leri engelle
• Korumalı yollar: Geçişler, yapılandırmalar veya vendor dizinlerine yazmayı engelle
• Tamamlanınca bildirim: Uzun görevler bittiğinde Slack veya masaüstü uyarıları gönder
• Konuşma kaydı yedekleme: Sıkıştırma çalışmadan önce sohbet geçmişini kaydet

Kendi Claude Code Eklentilerinizi Nasıl Geliştirirsiniz

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

Bir session-logger adlı eklenti geliştireceğiz; bu eklenti bir /session-logger:summarize komutu ekler. Ç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şlar.

Skill’i yazın

Şunu oluşturun: ~/session-logger/skills/summarize/SKILL.md:

---
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 skill’i yalnızca sizin tetikleyebileceğinizi Claude’a bildirir. Bu bayrak olmadan Claude, konuşmaya yardımcı olacağını düşünürse komutu kendi başına ç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 --plugin-dir bayrağı eklentinizi gösterecek ş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ını yazana kadar otomatik tamamlama önerilerinde görünmediğini unutmayın. Metin, Claude Code onu geçerli bir komut olarak tanıdığında 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 giriş 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ınızı oluşturmayı veya mevcut olanlara göndermeyi kapsar.

Son Düşünceler

Eklentiler, Claude Code’u genel amaçlı bir asistandan, sizin özgün iş akışınıza uyarlanmış bir şeye dönüştürür. Oluşturduğumuz oturum günlüğü, yaklaşık beş dakika ve üç dosya aldı. Çoğu faydalı eklenti bundan çok daha karmaşık değildir.

Eğer adımları izlediyseniz, artık makinenizde çalışan bir eklentiniz var. Onunla oynamayı deneyin: özet biçimini değiştirin, yeni bölümler ekleyin veya ekibinizin gerçekten ihtiyaç duyduğu bir şeye dönüştürün. İster hızlı bir kişisel araç, ister yüzlerce geliştiriciye dağıtacağınız bir şey geliştirin, yapı aynı kalır.

Ayrıca fırsat buldukça topluluk depolarına göz atın. Başkalarının eklentilerini nasıl yapılandırdığını görmek, dokümantasyonun öğretemeyeceği kalıpları öğretir.

Claude Code konusunda derinleşmek için Claude Code en iyi uygulamaları, Superpowers skills çerçevesi, daha uzun oturumlar için slash komutları ve güvenlik ve izinler üzerine eğitimlerimize göz atın. Claude modelleri hakkında daha fazla bilgi edinmek isterseniz, Claude Modellerine Giriş kursunu öneririm.