Custom commands

Claude Code, forward slash yazarak erişebileceğiniz built-in komutlarla birlikte gelir, ancak sık çalıştırdığınız tekrarlayan görevleri otomatikleştirmek için kendi custom command’larınızı da oluşturabilirsiniz.

Custom Command Oluşturma

Bir custom command oluşturmak için projenizde belirli bir klasör yapısı kurmanız gerekir:

1. Proje dizininizde .claude klasörünü bulun
2. İçine commands adında yeni bir dizin oluşturun
3. İstediğiniz komut adıyla yeni bir markdown dosyası oluşturun (audit.md gibi)

Dosya adı komut adınız olur — yani audit.md, /audit komutunu oluşturur.

Örnek: Audit Komutu

İşte proje dependency’lerini güvenlik açıkları için denetleyen bir custom command’ın pratik bir örneği:

Bu audit komutu üç şey yapar:

1. Vulnerable kurulu package’ları bulmak için npm audit çalıştırır
2. Güncellemeleri uygulamak için npm audit fix çalıştırır
3. Güncellemelerin bir şeyi bozmadığını doğrulamak için test’leri çalıştırır

Komut dosyanızı oluşturduktan sonra Claude Code onu otomatik olarak alır. Yeniden başlatmanız gerekmez.

Argümanlı Komutlar

Custom command’lar $ARGUMENTS placeholder’ını kullanarak argüman alabilir. Bu onları çok daha esnek ve yeniden kullanılabilir kılar.

Örneğin, bir write_tests.md komutu şunu içerebilir:

Şunlar için kapsamlı testler yaz: $ARGUMENTS

Test conventions:
* React Testing Library ile Vitest kullan
* Test dosyalarını kaynak dosyayla aynı klasördeki bir __tests__ dizinine yerleştir
* Test dosyalarını [filename].test.ts(x) olarak adlandır
* Import'lar için @/ prefix'i kullan

Coverage:
* Happy path'leri test et
* Edge case'leri test et
* Error state'leri test et

Daha sonra bu komutu bir file path ile çalıştırabilirsiniz:

/write_tests hooks dizinindeki use-auth.ts dosyası

Argümanlar file path olmak zorunda değildir — görev için Claude’a context ve yön vermek üzere geçirmek istediğiniz herhangi bir string olabilirler.

Temel Faydalar

• Automation - Tekrarlayan iş akışlarını tek komuta dönüştür
• Consistency - Aynı adımların her seferinde takip edilmesini sağla
• Context - Claude’a projeniz için spesifik talimatlar ve convention’lar sağla
• Flexibility - Komutların farklı input’larla çalışması için argüman kullan

Custom command’lar, test suite’leri çalıştırma, kod deploy etme veya ekibinizin convention’larına uygun boilerplate üretme gibi proje spesifik iş akışları için özellikle faydalıdır.