Claude Code'un Davranışını Değiştiren 3 Mod

Claude Code'a artık sadece yeni özellik eklemiyorsunuz. Mods ile Claude Code'un kendisinin nasıl davrandığını değiştirebiliyorsunuz — tool call'lar, prompt'lar, turn'ler ve terminal arayüzü (Anthropic duyurusu).

Anthropic'in 1 Ekim 2026 tarihli rehberi rastgele üç demo seçmiyor. Farklı işleri çözen üç örnek mod sunuyor: context farkındalığı, riskli komut kontrolü ve turn sonrası inceleme (Getting started with Claude Code mods). Bu yazıda Token Weather, Blast Radius ve Replay Theater'ı — ne işe yaradıklarını ve neden önemli olduklarını — ele alıyoruz.

Öne Çıkanlar

• Mods, Claude Code olaylarına bağlanan ve kendi UI'ını çizebilen TypeScript/JavaScript eklentileridir. Claude Code v2.1.287+ gerekir; varsayılan olarak açıktır (mods rehberi).
• Token Weather, context window'un ne kadar dolduğunu prompt'un üzerinde canlı bir "forecast" olarak gösterir — Clear → Storm → Compact soon.
• Blast Radius, riskli Bash komutlarını (rm -rf, force push, git reset --hard, migration…) tutar, etkiyi gösterir, Proceed / Cancel sunar.
• Replay Theater, bir turn'deki Edit/Write kayıtlarını tutar; /replay veya r ile diff'leri adım adım gezersiniz.
• Mods, MCP tool veya basit slash komut değildir: hook zincirinde olayı gözlemleyebilir, yeniden yazabilir veya cevaplayabilir.

Claude Code Mods Tam Olarak Nedir?

Kısa cevap: Mod, davranışı bir JS/TS modülünde yaşayan bir Claude Code plugin'idir. hooks/hooks.json tek bir modüle işaret eder; modül register(on, options) export eder ve tool.call, turn.complete, ui.render, command.run gibi olaylara hook bağlar.

Hook'lar middleware zinciri gibidir. Sizin hook'unuz çalışır, next(e) olayı iletir, en sonda Claude Code varsayılan işini yapar. Bir hook şunlardan birini yapabilir:

Bu, MCP sunucuları (modele ekstra tool) veya sadece görüntüleyen statusline script'lerinden farklıdır. Mods oturumun içinde yaşar, state tutar, panel açar ve olacak olanı engelleyebilir veya değiştirebilir.

Anthropic, AGENTS.md desteği ve /diff paneli gibi bazı yerleşik özelliklerin de mod olarak yazıldığını; kaynaklarının anthropics/claude-code deposundaki mods/ altında olduğunu belirtiyor (mods rehberi).

Önkoşullar

claude --version   # 2.1.287 veya üzeri

Mods varsayılan olarak açıktır. API sürümler arasında değişebilir; Claude Code bir modu yüklediğinde tip tanımlarını modun .claude-plugin/types/ klasörüne yazar — bunlar sizin sürümünüze aittir (mods rehberi).

Üçüncü taraf modları, makinenizde çalışan herhangi bir paket gibi ele alın: repoyu okuyun, yalnızca güvendiğiniz kaynaklardan kurun.

Üç Örnek Mod — Kısa Bakış

1. Token Weather — Context Dolmadan Önce Görün

Değer: Claude Code'da context window'un ne kadar dolduğunu artık tahmin etmek zorunda değilsiniz.

Token Weather her turn sonrası $.session.usage() okur ve prompt'un üzerinde tek satır çizer: hava ikonu + kelime, yüzde, window içindeki token, son turn'lerin sparkline'ı ve son turn'ün eklediği miktar (mods rehberi, mods vitrini).

Kavramsal görünüm:

Context Window

██████████████░░░░░░ 72%

Used: 72%
Remaining: 28%

Gerçek session'da bu, tek satırlık bir banttır (örneğin ☂ Showers 67% of context 134.4k / 200k + sparkline). Büyük projelerde veya uzun Claude Code session'larında bu satır, "Claude karıştı" ile "zaten Storm'daydık" arasındaki farktır.

Referans uygulama yaklaşık 80 satırdır. Anthropic rehberi bir kısayol da gösterir: doğal dilde bir prompt yapıştırıp Claude'un aynı session'da hot reload ile token-weather iskeletini yazmasını sağlayabilirsiniz (mods rehberi).

2. Blast Radius — Tehlikeli Shell'i Çalışmadan Durdurun

Değer: Claude'a tam yetki vermek yerine, kritik işlemlerde araya giren bir güvenlik katmanı ekleyebilirsiniz.

Claude Bash'te rm -rf, git reset --hard, git clean, force push veya veritabanı migration gibi kalıpları çağırdığında Blast Radius çağrıyı tutar, neyin değişeceğini tahmin eder (git clean -n, git status --porcelain gibi dry-run kontrolleriyle) ve Proceed / Cancel paneli açar (mods rehberi).

Claude şunu çalıştırmak istediğinde:

rm -rf node_modules

veya:

git push --force

Gördüğünüz ekran kabaca şöyle düşünülebilir:

⚠ Risky command detected

git push --force

Potential impact:
• Remote branch will be rewritten
• Existing commits may be lost

[ Cancel ]   [ Proceed ]

Anthropic kaydında Cancel, Claude'a gerekçeli bir red döner; Proceed orijinal komutu çalıştırır. Kısayollar: 1 = Proceed, 2 = Cancel.

Resmi rehberden önemli dürüstlük: Blast Radius bir güvenlik ağıdır, permission sistemi değildir. Komut metnini sınıflandırır; alias, $(…) veya rm çağıran script'ler geçebilir. Sert engel için Claude Code permission rules kullanın (mods rehberi).

Altyapıda bu, Bash için tool.call üzerinde answer hamlesidir: etkiyi ölç, UI kararını bekle, sonra ya next(e) ya da return { deny: "…" }.

3. Replay Theater — Claude'un Son Değişikliklerini Adım Adım İzleyin

Değer: "Claude ne yaptı?" sorusunun cevabı tek dev diff yerine adım adım takip edilebilir.

Replay Theater bir turn'deki her Edit ve Write'ı kaydeder (dosya yolu + önce/sonra metin). Turn bitince prompt üzerinde bir ipucu çıkar. r tuşuna basın veya /replay çalıştırın — numaralı adımlar, Prev / Next / Close (mods rehberi, mods vitrini).

Claude bir turn'de sekiz dosya değiştirdiyse:

/replay

Step 1 → app/api/auth.ts
Step 2 → lib/auth.ts
Step 3 → middleware.ts
Step 4 → app/login/page.tsx
…
[ ← Previous ]  [ Next → ]

Düzenlemeleri asla engellemez veya değiştirmez — saf observe. Bu yüzden demo, öğretim ve agent'in bir problemi hangi sırayla çözdüğünü görmek için özellikle uygundur.

Üçü Birlikte Nasıl Konumlanır?

• Token Weather: Ne kadar context kaldı?
• Blast Radius: Bu shell komutu çalışmalı mı?
• Replay Theater: Hangi dosyalar, hangi sırayla değişti?

Birlikte mods tezini gösterirler: sadece MCP tool eklemiyorsunuz — Claude Code'un döngüsünü ve UI'ını yeniden şekillendiriyorsunuz. Tarayıcı, dokümantasyon ve araştırma için zaten MCP kullanıyorsanız o katmanı koruyun (5 Claude Code MCP); mods altta durur ve agent'in yalnızca ne çağırabileceğini değil, nasıl davrandığını değiştirir.

Modu Denemek veya Kendiniz Yazmak

Yerel plugin dizini (öğrenmek için en hızlısı)

claude --plugin-dir ./token-weather

Session açıkken kayıtlar hot-reload olur.

Marketplace ile paylaşım (üç komut)

Mods, diğer plugin'ler gibi kurulur. Anthropic rehberinden:

/plugin marketplace add your-org/my-mods
/plugin install token-weather@my-mods
/reload-plugins

Veya CLI ile yerel marketplace klasöründen:

claude plugin marketplace add ./my-mods
claude plugin install token-weather@my-mods --scope user

Doğrulama ve test:

claude plugin validate ./token-weather
claude plugin test ./token-weather

(mods rehberi)

Kısayol: Modu Claude'a tarif edin

API'yi ezberlemeniz şart değil. Anthropic'in Token Weather kısayolu, Claude'un modu oluşturup hot reload açmasını isteyen hazır bir prompt'tur. "Ne göstermeli" satırlarını değiştirin — sizin modunuz olur (mods rehberi).

SSS

Mods MCP'nin yerini alır mı?

Hayır. MCP, modelin çağırabileceği tool'ları ekler. Mods, Claude Code runtime'ına (tool, turn, UI) bağlanır. İkisini birlikte kullanın: yetenek için MCP, davranış ve koruma için mods.

Örnek modlar her kurulumda yerleşik mi?

Anthropic, Token Weather, Blast Radius ve Replay Theater'ı claude.dev/mods ve getting-started rehberinde öğretim örnekleri olarak belgeler. Aynı zamanda mod olan yerleşik özellikler (ör. /diff, AGENTS.md) anthropics/claude-code içindeki mods/ altındadır. Topluluk marketplace'lerini ayrı tutun; kurmadan önce doğrulayın.

Blast Radius, Claude'u gözetimsiz çalıştırmaya yeter mi?

Hayır. Üretim veya yıkıcı işler için permission rules ve insan kontrolüyle birlikte kullanın. Resmi rehber, komut metnine göre sınıflandırmanın eksik kaldığını açıkça söyler.

Hangi Claude Code sürümü gerekir?

2.1.287 veya üzeri (mods rehberi).

Sırada Ne Var?

1. Claude Code'u ≥ 2.1.287 yapın.
2. Önce Token Weather'ı deneyin — en düşük risk, uzun session'da anında geri bildirim.
3. Claude'u temizlik veya git geçmişinde serbest bırakmadan önce Blast Radius ekleyin.
4. Çok dosyalı turn'lerden sonra /replay kullanın; agent'in düzenleme sırasına güveniniz oluşsun.
5. Örneklerin cevaplamadığı bir sorunuz olduğunda ("maliyet göstergesi?", "terraform apply engeli?") o modu Claude'a tarif edin ve klasörü plugin olarak saklayın.

Mods, Claude Code'u sabit bir agent'ten sizin şekillendirdiğiniz bir ortama çevirir. Anthropic'in üç örneğiyle başlayın; dördüncüyü sizin iş akışınız için yazın.