Claude Code mod'ları: Claude Code'un davranışını değiştirebilen plugin'ler

Claude Code zaten ayarlar, permission kuralları, slash command’lar, skill’ler ve bir status line ile özelleştirilebiliyordu. 1 Ekim’de çıkan Claude Code 2.1.287 daha derin bir katman ekliyor: mod’lar. Sürüm notları plugin’lerin artık “daha derin davranışı değiştirebileceğini” söylüyor. Aynı gün Anthropic’in geliştirici blogu Addy Osmani’nin boş bir klasörden bir mod kuran eğitimini yayımladı. Bu yazı mod’ların ne olduğunu, eğitimin ne kurduğunu ve nelere dikkat etmek gerektiğini özetliyor. Eğitimi ve Anthropic’in açık kaynağını okuduk; bu mod’ları kendimiz kurmadık ya da çalıştırmadık.

Mod nedir

Mod, davranışı bir JavaScript ya da TypeScript modülünde yaşayan bir Claude Code plugin’i. Eğitim yapıyı şöyle anlatıyor: .claude-plugin/plugin.json manifest’i olan normal bir plugin, tek bir modülü adlandıran bir hooks/hooks.json ve register(on, options) export eden bir modül. İçinde on(event, matcher?, hook) bir hook ekliyor ve her hook aynı biçimde: $ (mod API’si), e (event’in girdisi) ve next alıyor.

Hook’lar middleware gibi bir zincir oluşturuyor. Hook’unuz çalışır, next(e) event’i diğer plugin’lere ve sonra Claude Code’un kendi davranışına iletir ve bir hook üç şeyden birini yapabilir:

Hamle	Nasıl	Örnek
Observe	next(e) çağır, sonucu incele	Her dosya düzenlemesini kaydet, her turn’den sonra bir ölçüm al
Rewrite	next({ ...e, command }) çağır	Zincirin geri kalanının gördüğünü değiştir
Answer	next çağırmadan { deny: "…" } döndür	Bir tool call’u reddet ya da bir komutu ya da tool’u kendin sun

Event’ler tool call’ları, gönderilen prompt’u, turn’lerin başlamasını ve bitmesini, oturumun başlamasını ve bitmesini, slash command’ları ve arayüzün çizilen her parçası olan ui.render’ı kapsıyor. Modül DOM’u ve Node’u olmayan bir sandbox’ta çalışıyor, bu yüzden dışarıyla her şey $ üzerinden gidiyor; $ ise ui, session, state, store, fs, process, clock, http, tool, command, model ve daha fazlasını sunuyor.

Settings hook’larından farkı

Bir settings hook’u her event için bir shell komutu çalıştırıyor ve JSON’u stdin ile stdout üzerinden geçiriyor. Mod ise bir kez yüklenip oturumda kalıyor; bu yüzden state tutabiliyor, event’lerle güncellenen UI çizebiliyor ve Claude Code’a geri dönüp bir pane açabiliyor, bir process çalıştırabiliyor, bir slash command ya da modelin çağırabileceği bir tool kaydedebiliyor. Anthropic ayrıca Claude Code’un kendi özelliklerinin bir kısmının mod olarak yazıldığını söylüyor: AGENTS.md desteği ve /diff pane’i bunlardan. Kaynakları repository’nin mods klasöründe açık; orada sec-default ve telemetry de var.

Eğitimin üç mod’u

Token Weather, her turn’den sonra context window’un ne kadar dolu olduğunu okuyor ve prompt’un üstüne tek satır çiziyor: bir hava durumu ikonu ve kelimesi (yüzde 25’in altı Clear, Cloudy, Showers, 75’ten Storm, 90’dan Compact soon), yüzde, pencereden kullanılan token, son turn’lerin küçük bir grafiği ve son turn’ün ne kadar eklediği. Yaklaşık 80 satır. Eğitim bir kısayol da sunuyor: bir prompt’u Claude Code’a yapıştırıp mod’u onun yazmasını sağlamak.

Blast Radius, komut rm -rf, git reset --hard, git clean, force push ya da veritabanı migration’ı gibi bir şeyse Bash çağrısını tutuyor. Komutun neye dokunacağını araçların kendi dry run’larıyla (git status --porcelain, git clean -n gibi) hesaplıyor ve Proceed ile Cancel olan bir pane açıyor. Cancel, Claude’a nedenle birlikte bir ret döndürüyor. Yukarıdaki “answer” hamlesini kullanıyor.

Replay Theater, bir turn sırasında her Edit ve Write çağrısını, dosya ve öncesi ile sonrası metniyle kaydediyor. Turn bitince r’ye basmak ya da /replay yazmak, düzenlemeleri tek tek diff olarak gezen bir pane açıyor. Bir düzenlemeyi asla engellemiyor ya da değiştirmiyor; yalnızca gözlemliyor.

Denemek

Eğitim Claude Code 2.1.287 ya da üstünü gerektiriyor ve mod’ların varsayılan olarak açık olduğunu söylüyor. Bir mod’u klasörden claude --plugin-dir ./token-weather ile yüklüyorsunuz ve dosyayı kaydetmek modülü yerinde yeniden yüklüyor. claude plugin validate manifest’i ve modülü denetliyor, claude plugin test plugin’in testlerini gerçek runtime’a karşı çalıştırıyor. Paylaşım herhangi bir plugin gibi: mod’u bir marketplace’e, yani .claude-plugin/marketplace.json içeren bir klasöre ya da GitHub repository’sine koyup /plugin marketplace add, /plugin install ve /reload-plugins komutlarını kullanıyorsunuz. Genel olarak plugin’ler için Claude Marketplace notumuza bakabilirsiniz.

Eğitimden iki pratik ayrıntı: veriyi modül değişkenlerinde değil $.state içinde tutun, çünkü her kayıt modülü yeniden yükleyip onları sıfırlıyor; bir hook’un dispatch başına 10 saniyelik kendi süresi var, ama bir $ çağrısının içinde beklemekte geçen süre buna sayılmıyor. Anthropic, API’nin sürümler arasında değişebileceğini ve Claude Code’un mod’un .claude-plugin/types/ klasörüne yazdığı tip tanımlarının kendi sürümünüz için referans olduğunu uyarıyor.

Nelere dikkat etmeli

• Mod, Claude Code’un erişimiyle çalışan koddur. Anthropic, bir mod’un makinenizde “Claude Code’un sahip olduğu aynı erişimle çalıştığını ve Anthropic’in değil yayımcısının yazdığını” söylüyor; önce repository’yi okumanızı ve yalnızca güvendiğiniz kişilerden kurmanızı öneriyor. Bir mod her event’i görebilir ve tool call’ları yeniden yazabilir ya da yanıtlayabilir; onu güçlü yapan da, güvenilmeyen bir tanesini riskli yapan da bu.
• Koruma mod’u bir permission sistemi değildir. Eğitim, Blast Radius’un komut metnini okuduğunu, bu yüzden $(…), alias’ların ve rm çağıran script’lerin ondan geçebildiğini söylüyor ve kesin engel için permission kurallarını öneriyor.
• Kurumların mod’ların üstünde bir katmanı var. Repository’deki sec-default mod’u, bir kurumun klasik hook’larını, managed settings’ini, tool policy’sini ve deny kurallarını kişinin kurduğu plugin’lerin erişiminden uzak tutuyor. Açıklamasına göre managed settings olan bir makinede ya da Team ve Enterprise kurumlarında, managed prependPlugins aksini söylemedikçe en dışta duruyor.
• Paylaşım ve keşif Claude dizininden geçiyor. Anthropic’in duyuru yazısı, mod içeren plugin’lerin Claude dizininden ya da CLI’da /plugin ile kurulabildiğini ve bir mod’un plugin olarak paketlenip dizine gönderilerek paylaşıldığını söylüyor. Eğitim, gönderim adresi olarak claude.ai/directory/manage’i veriyor. Kendi marketplace’inize bir bağlantı vermek de hâlâ çalışıyor.

Sürüm notları ayrıca “You should know” adlı yerleşik bir mod’u listeliyor: bir yan agent, sizin ya da Claude’un gözden kaçırabileceği şeyleri işaretliyor. /plugin enable cc-plugin-you-should-know@builtin ile açılıyor ve telemetry’nin açık olduğu first-party oturumlar için olduğu belirtiliyor. Denemedik.

Editoryal inceleme: 1 Ekim 2026 (AI). Anthropic’in claude.dev’deki eğitiminden, aynı gün tamamı okunarak, v2.1.287 sürüm notlarından ve açık mods klasörünün README’sinden hazırlandı. Hiçbir mod’u kurmadık, çalıştırmadık ya da test etmedik. Görseller Anthropic’indir, kredi ve kaynak bağlantısıyla yeniden üretilmiştir.

Düzeltme, 3 Ekim 2026: bu yazının önceki sürümü, Claude dizininin mod içeren plugin’leri henüz kabul etmediğini söylüyordu. Anthropic’in duyuru yazısı ve eğitimi kabul ettiğini söylüyor; yukarıdaki cümleyi düzelttik.