Claude Code mod'ları: Ajanın içinde çalışan kendi kodun

Mod nedir?

Claude Code, Anthropic’in terminalde ve masaüstü uygulamasında çalışan kodlama ajanı. 1 Ekim’de çıkan 2.1.287 sürümüyle yeni bir genişletme yolu geldi: mod.

Mod, bir eklentinin (plugin) içinde gelen JavaScript ya da TypeScript fonksiyonları. Claude Code bir şey yaptığında, örneğin bir araç çağırdığında, sen bir istem gönderdiğinde ya da ekranın bir parçasını çizdiğinde, bir olay (event) üretiyor. Mod bu olayları dinliyor ve üç şeyden birini yapıyor:

• İzlemek: Ne olduğunu not edip olayı olduğu gibi bırakmak.
• Değiştirmek: Olayı yolda değiştirmek, örneğin bekleme göstergesinin yanına bir sayaç eklemek.
• Üstlenmek: Olayı kendisi karşılamak, örneğin bir komutu reddetmek.

Mod’lar Claude Code’un kendi sürecinde çalıştığı için arayüze de dokunabiliyor. Konuşmanın yanına sekmeli ve düğmeli bir panel, istem kutusunun üstüne bir şerit ekleyebiliyor. Claude’un kendi çizdiği parçaları da yeniden tasarlayabiliyor. Claude Code’un bazı özellikleri zaten mod olarak yazılmış: /diff paneli ve AGENTS.md desteği bunlardan.

Hook, skill, MCP: Fark ne?

Claude Code’u genişletmenin zaten birkaç yolu vardı. Kısaca:

• Ayar hook’u: Bir olay olduğunda ayar dosyasında tanımladığın bir kabuk komutu ya da HTTP isteği çalışır. Bir aracı engelleyebilir, kayıt tutabilir. Ama dışarıda çalışır ve ekrana bir şey çizemez.
• Skill: Claude’a bir işi nasıl yapacağını anlatan Markdown talimatları. Claude’un ne bildiğini değiştirir.
• MCP sunucusu: Claude’a yeni araçlar veren ayrı bir program.
• Mod: Claude Code’un içinde çalışan fonksiyonlar. Arayüz çizebilir, olayları yeniden yazabilir, Claude’u hiç çalıştırmadan anında cevap veren /komutlar ekleyebilir.

Belgeler, işini zaten bir ayar hook’u, skill ya da MCP sunucusu görüyorsa mod yazmadan önce bunları karşılaştırmanı öneriyor. Mod, panel çizmek ya da bir olayı yeniden yazmak gibi diğerlerinin yetmediği işler için.

Videoda ne yapıldı?

Mod yazmak için kod bilmen gerekmiyor. Claude’a ne istediğini anlatıyorsun, o yazıyor ve oturumu yeniden başlatmadan yüklüyor. Better Stack’teki geliştirici, kullanım limitlerini Minecraft’taki can ve açlık çubukları gibi gösteren bir panel istetti. Videoya göre Claude, resmî mod API’sinde olmayan bir kullanım verisi için Claude Code’un /usage komutunun kullandığı belgelenmemiş bir adresi bulup oturum açmış kullanıcı olarak sorguladı. İkinci örnek daha eğlenceliydi: Claude’un her adımını küçük bir modele okutan ve bunlara yorum yapan sahte bir Twitch sohbeti.

Bu örnek aslında mod’ların gücünü de, riskini de aynı anda gösteriyor.

Güvenlik: Mod senin yetkinle çalışır

Belgeler bu konuda açık. Yüklenen bir mod:

• Dosyalarını okuyup yazabilir, program başlatabilir, ağa istek atabilir.
• Ortam değişkenlerindeki ve ayar dosyalarındaki API anahtarlarını görebilir.
• Gönderdiğin her istemi ve Claude’un her araç çağrısını görebilir, bunları değiştirebilir.
• Bir araç çağrısını sana sormadan onaylayabilir.
• Senin planından ya da API anahtarından model çağırabilir.

Mod’lar korumalı bir alanda (sandbox) çalışmıyor. Claude Code’un sandbox özelliği Claude’un çalıştırdığı komutları kapsıyor, mod’un başlattığı işlemleri değil.

Kurmadan önce ne yapabileceğini görmenin bir yolu var. Eklentinin dosyalarını indirip şunu çalıştırıyorsun:

claude plugin validate ./bir-mod

Çıktı, mod’un hangi olayları dinlediğini ve dosya okuma, ağ isteği gibi hangi işleri istediğini kodu çalıştırmadan listeliyor. Ama bu bir güvenlik garantisi değil, sadece bir döküm. Şüphelenirsen Claude Code’u --safe-mode ile başlatıp kurduğun tüm mod’ları bir oturumluk kapatabilirsin.

Topluluk da hızlı davrandı: Bağımsız bir “awesome” listesi, 4 Ekim itibarıyla GitHub’da 1.700’den fazla mod taradığını söylüyor. Bu resmî bir dizin değil. Kurmadan önce kodu okumak hâlâ senin işin.

Düşün

• Her gün kullandığın bir araçta en çok neyin farklı olmasını isterdin? Bunu bir mod mu, yoksa bir skill mi çözerdi?
• Tarayıcı eklentisi kurarken izinlere ne kadar dikkat ediyorsun? Ajan eklentilerinde daha dikkatli olmalı mısın?

Kendi cümlelerimizle yazılmış bir özettir, çeviri değildir. Tüm kaynaklar yukarıda.