Claude Code Şablonları: Yetenekler, Aracılar, Kancalar ve Daha Fazlası

Claude Code Şablonları Nedir?

Claude Code şablonları, bir projede veya yerel ortamınız genelinde Claude Code’un davranışını özelleştiren yeniden kullanılabilir yapılandırma dosyalarıdır. 

Önemli olan, şablonların dosya tabanlı olduğunu anlamaktır. Bunları tipik bir ayarlar arayüzü üzerinden kurup yapılandırma ekranlarında gezmezsiniz. Bunun yerine Claude Code belirli dosya ve klasörleri keşfeder, ilgili metaverileri bağlama yükler ve nasıl davranacağına bu bilgilere dayanarak karar verir.

Uygulamada bunlar genellikle proje düzeyindeki .claude/ gibi klasörlerde saklanan Markdown, JSON veya kabuk tabanlı dosyalardır ya da paylaşım için eklenti tarzı dizinlere paketlenirler.

Tipik bir proje düzeyi yapı şu şekilde görünebilir:

my-app/
├── CLAUDE.md
├── .mcp.json
└── .claude/
    ├── skills/
    │   └── database-migration/
    │       └── SKILL.md
    ├── agents/
    │   └── security-auditor.md
    ├── commands/
    │   └── summarize-pr.md
    └── settings.json

Claude code şablonları vs CLAUDE.md

CLAUDE.md hâlâ önemlidir, ancak farklı bir rol üstlenir. CLAUDE.md’yi proje brifingi olarak düşünün: projenin ne olduğu, hangi komutların önemli olduğu, hangi kodlama standartlarının geçerli olduğu ve Claude’un hatırlaması gereken mimari kurallar. 

Daha derin bir anlatım için CLAUDE.md yazım rehberimize bakın.

Şablonlar daha modülerdir:

• Bir yetenek, bir geçiş iş akışını kodlayabilir. 
• Bir aracı, güvenlik incelemesi kişiliğini izole edebilir. 
• Bir kanca, dosya düzenlemelerinden sonra çalışabilir. 
• Bir MCP yapılandırması, Claude’u GitHub, SQLite veya başka bir harici sisteme bağlayabilir.

Şablonların, daha geniş Claude Code iş akışı tasarımıyla nasıl bağlandığı da burada ortaya çıkar. Güçlü şablonlar, planlama, test etme ve bağlam devri konularındaki iyi alışkanlıklarla eşleştirildiğinde en iyi sonucu verir. 

Bu tür uygulamaların daha fazlası en iyi uygulamalar rehberimizde ayrıntılandırılmıştır.

Özel komutlar da yetenek sistemi kapsamında ele alınır, ancak eski .claude/commands/ formatı hâlâ çalışır. Önerilen yeni format, eğik çizgi komut çağrısını ve Claude tarafından otomatik çağrıyı destekleyen .claude/skills/<name>/SKILL.md’dir.

Hangi Tür Claude Code Şablonlarını Kullanabilirim?

Claude Code şablon ekosistemi genellikle altı kategoriye ayrılır: yetenekler, aracılar, komutlar, kancalar, MCP entegrasyonları ve eklentiler. 

İlk beşi Claude’un davranışını doğrudan değiştirir. Eklentiler biraz farklıdır: yetenekleri, aracıları, kancaları, komutları, MCP sunucularını ve diğer bileşenleri yeniden kullanılabilir bir pakete toplayabilen bir dağıtım formatıdır.

Aşağıda bu kategorilerin her birine bakacağız.

1. Yetenekler

Yetenekler, tekrarlanabilir, çok adımlı görevler için talimat paketleridir. Bir yetenek genellikle YAML ön bilgisi ve bir Markdown gövdesi içeren bir SKILL.md dosyasına sahip bir klasördür. 

Ön bilgi, yeteneğin ne yaptığını ve nasıl davranması gerektiğini açıklar; gövde ise Claude’a hangi adımları takip edeceğini söyler. Ayrıntılı bir derin dalış için şu Claude Yetenekleri rehberindeki bilgilere bakın.

Claude, yeteneğin açıklamasını, ne zaman ilgili olduğunu belirlemek için kullanır. Varsayılan olarak hem kullanıcı hem Claude bir yeteneği çağırabilir: /skill-name yazabilirsiniz ya da mevcut görev yetenek açıklamasıyla eşleştiğinde Claude onu otomatik olarak yükleyebilir. Dağıtım gibi manuel kontrol istediğiniz iş akışları için modelin otomatik çağrısını devre dışı bırakabilirsiniz.

İşte kısa bir dosya örneği: .claude/skills/database-migration/SKILL.md

---
name: database-migration
description: Use when creating, reviewing, or modifying database migrations. Ensures migrations are reversible, tested, and checked before and after execution.
allowed-tools:
  - Read
  - Write
  - Bash
---

# Database Migration Skill

When working on a database migration:

1. Inspect the existing schema and migration history before writing changes.
2. Confirm whether the migration is additive, destructive, or data-transforming.
3. Create a reversible migration whenever the framework supports rollback.
4. Run the project’s migration check command before applying the migration.
5. Run tests that cover the affected models, queries, or API endpoints.
6. After writing the migration, summarize:
   - schema changes
   - rollback behavior
   - affected tables
   - test commands run

Bu, talimatlar işlemsel olduğu için kullanışlıdır. Claude’a sadece “geçişlerde dikkatli ol” demiyorsunuz. Ona tekrarlanabilir bir kontrol listesi veriyorsunuz. 

Yetenekler, aksi halde Claude’a ikiden fazla kez yapıştıracağınız her şey için idealdir: API uç noktaları oluşturma, değişiklik günlükleri yazma, test iskeleti çıkarma, sürüm notları oluşturma, çekme isteklerini inceleme veya geçiş kontrolleri yapma.

Geliştiricilerin yeniden kullanılabilir yapay zekâ iş akışlarına neleri dönüştürdüğüne dair daha geniş ilham için Aracı Yetenekleri listemize bakın.

2. Aracılar

Aracılar, daha doğrusu Claude Code’daki özel alt aracılar, kendi Markdown tanımı, YAML ön bilgisi, araç kısıtlamaları, model seçimi ve sistem istemi olan uzmanlaşmış yapay zekâ asistanlarıdır. 

Proje kapsamı için .claude/agents/ içinde veya kişisel kapsam için ~/.claude/agents/ içinde bulunabilirler. Aracılar, Claude’dan istenerek veya doğrudan .claude/agents/ klasöründeki markdown dosyaları düzenlenerek oluşturulur.

Aslında yeteneklerle aracılar arasında bir fark vardır. Bir yetenek, bir görevin nasıl yapılacağını tanımlar. Bir aracı ise Claude’un çalışırken kim olması gerektiğini tanımlar: rolü, odağı, izinleri ve sınırları.

Şu aracı örneğine bakalım:

---
name: security-auditor
description: Reviews code for security vulnerabilities and produces a findings report without modifying files.
tools: Read, Glob, Grep, Bash
model: sonnet
---

You are a security auditor.

Your task is to inspect the codebase for vulnerabilities, risky patterns, and missing safeguards.

Rules:
- Do not edit files.
- Do not suggest broad rewrites unless directly tied to a security issue.
- Focus on authentication, authorization, input validation, secrets, dependency risk, and unsafe shell or SQL usage.
- Produce a findings report with severity, affected files, evidence, and recommended next steps.

Bu aracı, Claude’a net sınırlar verdiği için faydalıdır. Genel bir oturumda Claude, bir sorun bulur bulmaz düzeltmeye kayabilir. Bir güvenlik denetçisi aracı ise yalnızca inceleme ve raporlama yapması, değişikliklerden kaçınması için yönlendirilir. 

Aracılar, güvenlik denetimi, dokümantasyon incelemesi, mimari inceleme, veri mühendisliği veya kod kalitesi kontrolleri gibi bağlam izolasyonu ve izin sınırlarının önemli olduğu uzman alanlar için idealdir.

Aracılar, uzmanlaşmış yeteneklerle eşleştirildiğinde de kullanışlıdır. Örneğin, bir güvenlik denetçisi aracı bulgular-raporu yeteneğini çağırabilirken, bir frontend inceleme aracı bileşen testi yeteneğini kullanabilir.

3. Komutlar

Komutlar, /generate-tests, /check-deps veya /summarize-pr gibi eğik çizgiyle çağrılan kısayollardır. Geçmişte, özel komutlar .claude/commands/ altında Markdown dosyaları olarak saklanır ve dosya adı komut adı olarak kullanılırdı. 

Claude Code bu eski formatı hâlâ destekler, ancak yeni komut benzeri iş akışları için yetenekleri kullanmanızı öneririm; çünkü hem aynı /name çağrısını hem de uygun olduğunda otomatik çağrıyı desteklerler.

Komutlar, tetikleyicinin açık olmasını istediğinizde en iyisidir. Bir yetenek, Claude eşleşen bir görev tespit ettiğinde otomatik olarak etkinleşebilir, ancak bir komut yalnızca siz seçtiğinizde çalışmalıdır. Bu da komutları şu tür kontrol noktaları için kullanışlı kılar: “şimdi test üret”, “bu PR’ı şimdi özetle”, “bağımlılıkları şimdi kontrol et” veya “şimdi bir commit mesajı hazırla”.

4. Kancalar

Kancalar, Claude Code yaşam döngüsü olaylarına yanıt olarak çalışan otomasyon kurallarıdır. Claude Code’un yaşam döngüsünün belirli noktalarında çalışan, kullanıcı tanımlı kabuk komutlarıdır ve davranış üzerinde deterministik kontrol sağlar. 

Kancalar ile şimdiye kadar ele aldığımız diğer şablonlar arasındaki fark, kancaların sizin ne istediğinizle değil, Claude’un ne yaptığıyla tetiklenmesidir.

Basitçe söylemek gerekirse, Claude’un bir dosyayı düzenledikten sonra biçimlendirmeyi hatırlamasını ummanıza gerek yoktur; bir kanca bunu otomatik olarak yapabilir.

Geçerli kanca olay adları arasında PreToolUse, PostToolUse, Notification ve Stop gibi olaylar bulunur. 

Örnek: Claude bir dosyayı düzenledikten veya yazdıktan sonra bir biçimlendirici çalıştırın:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Example: block risky shell commands before Claude runs them:
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/block-dangerous-bash.py"
          }
        ]
      }
    ]
  }
}

Kancalar, Claude’un atlayamaması gereken kurallar için en iyisidir: bir linter çalıştırma, düzenlenen dosyaları biçimlendirme, korumalı dosya düzenlemelerini engelleme, üretilen kodu kontrol etme veya Claude’un girdiye ihtiyaç duyduğu durumlarda bildirim gönderme. 

Ayrıntılı bir eğitim için Claude Code Kancalar Rehberini okuyun.

5. MCP Entegrasyonları

MCP entegrasyonları, Model Context Protocol aracılığıyla Claude Code’u harici araçlara, veri kaynaklarına ve API’lere bağlar. MCP, yapay zekâ sistemleri ile harici araçlar arasında bir bağlayıcı katman görevi görür. Claude Code’da bu, Claude’un yerel dosyalar ve kabuk komutlarının ötesine geçebilmesi anlamına gelir. 

Hangi MCP sunucularını yapılandırdığınıza bağlı olarak, Claude’un GitHub, veritabanları, dokümantasyon sistemleri, bulut platformları veya dahili API’ler gibi harici hizmetlerle etkileşime girmesine olanak tanır. Tam bir açıklama ve demo proje için Model Context Protocol eğitimimize bakın.

Bir MCP sunucusu üç geniş yetenek türünü ortaya çıkarabilir:

• Araçlar: Claude’un çağırabileceği çalıştırılabilir işlevler, örneğin bir GitHub konusu oluşturmak veya bir veritabanı sorgusu çalıştırmak.
• Kaynaklar: bir dosya, veritabanı satırı veya belge gibi salt okunur bağlam kaynakları.
• İstemler: sunucu tarafından sunulan yeniden kullanılabilir görev şablonları.

Proje düzeyindeki bir .mcp.json, yan yana birden fazla sunucuyu yapılandırabilir:

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sqlite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "./data/app.db"
      ]
    }
  }
}

Bu önemlidir çünkü Claude yalnızca erişebildiği bağlam ve araçlardan yola çıkarak akıl yürütebilir. MCP olmadan yerel dosyaları inceleyebilir, ancak sorun izleyicinizi, veritabanınızı, bulut ortamınızı veya dahili API’nizi inceleyemez. 

Claude’un, statik bir kod anlık görüntüsü yerine gerçek yığınla çalışması ve harici verilere erişmesi gerektiğinde MCP en iyi seçenektir.

6. Eklentiler

Eklentiler paketlenmiş demetlerdir. Tek bir kurulabilir yapı içinde yetenekler, aracılar, kancalar, MCP yapılandırmaları, komutlar ve diğer bileşenleri içerebilirler. 

Claude Code’da bir eklenti genellikle bir .claude-plugin/plugin.json bildirimi ve skills/, agents/, hooks/ ve eklenti kökünde .mcp.json gibi bileşen klasörlerini içerir.

Örnek eklenti yapısı:

frontend-workflow-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── component-test/
│       └── SKILL.md
├── agents/
│   └── frontend-reviewer.md
├── hooks/
│   └── hooks.json
└── .mcp.json

Örnek eklenti json’ı:

{
  "name": "frontend-workflow",
  "displayName": "Frontend Workflow",
  "version": "1.0.0",
  "description": "Frontend development workflow with review agents, test skills, and formatting hooks",
  "author": {
    "name": "Your Team"
  }
}

Eklentiler yeni bir davranış türü eklemez. Diğer türleri taşınabilir hale getirirler. Tam bir kurulumu ekip genelinde paylaşmak, aynı iş akışını projeler arasında yeniden kullanmak veya her dosyayı manuel oluşturmak yerine topluluk tarafından bakımı yapılan bir demeti kurmak istediğinizde eklentileri kullanın.

Sıfırdan oluşturmak için DataCamp’in Claude Code Eklentileri Adım Adım Rehberine bakın.

Hangi Şablon Türünü Seçmeliyim?

Tamamen anlıyorum; bu kadar çok tür kafa karıştırıcı olabilir. Hepsi Claude’un davranışını değiştirebilir. Fark çoğunlukla nasıl tetiklendikleri ve ne tür bir kontrol sağladıklarıdır.

Daha net hale getirmek için aralarındaki bir karşılaştırma:

Basit bir karar kuralı yardımcı olur:

• Claude koda her dokunduğunda bir kuralı otomatik olarak uygulamak istiyorsanız bir kanca kullanın. 
• Claude’un belirli bir görev için derin alan uzmanlığını benimsemesini istiyorsanız bir aracı kullanın. 
• Claude’un tutarlı şekilde tekrar etmesi gereken bir iş akışını kodlamak istiyorsanız bir yetenek kullanın. 
• Eylemi doğru anda kendiniz çağırmak istiyorsanız bir komut veya komut benzeri yetenek kullanın. 
• Claude’un harici hizmetlere veya canlı veriye ihtiyacı varsa MCP kullanın. 
• Tam bir iş akışı kurulumunu kurmak veya paylaşmak istiyorsanız bir eklenti kullanın.

Gerçek projelerde bu türler genellikle birlikte kullanılır. Bir güvenlik eklentisi, bir security-auditor aracısını, bir audit-findings yeteneğini, bir bağımlılık kontrol komutunu ve bir pre-commit kancasını paketleyebilir. Aracı rolü tanımlar, yetenek rapor yapısını belirler, komut size açık bir kontrol noktası sağlar ve kanca korkuluğu uygular.

Claude’un uygulamaya geçmeden önce resmi bir planı takip etmesi gereken iş akışları için şart odaklı geliştirme çoğu zaman doğaçlama isteme yerine daha uygundur.

Claude Code Şablonlarını Nerede Bulabilirim?

Üç pratik kaynak vardır: Anthropic, topluluk koleksiyonları ve kendiniz.

Önce resmi Anthropic kaynakları ve dokümantasyonuyla başlayın. Anthropic’in Claude Code dokümantasyonu yetenekler, alt aracılar, kancalar, MCP ve eklentileri kapsar ve üretim ortamına alacağınız bir şeyi yayımlamadan önce mevcut dosya formatlarını ve davranışları doğrulamak için en iyi yerdir.

İkinci olarak topluluk koleksiyonlarını kullanın. En görünür topluluk merkezi, kendisini Claude Code projeleri için kullanıma hazır yapılandırmalar kataloğu olarak tanımlayan aitmpl.com’dur. Canlı geziniminde şu anda Yetenekler, Aracılar, Komutlar, Ayarlar, Kancalar, MCP’ler ve Eklentiler yer alır. 

Güncel etkileşimli kurulum komutu:

npx claude-code-templates@latest

Proje dokümantasyonu ayrıca daha kısa bir takma ad da gösteriyor:

npx cct@latest

Belirli bileşenler için, canlı GitHub README’si şu kurulum komutlarını gösteriyor:

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

Ayrıca tek bir komutta birden çok bayrak kullanarak tam bir yığın kurulumunu da gösterir.

Topluluk şablonlarını değerlendirirken bazı kalite göstergelerini kontrol edin:

• description alanı, Claude’un yeteneği veya aracıyı doğru şekilde tetiklemesi için yeterince spesifik mi?

• allowed-tools dar kapsamlı mı, yoksa şablon gereksiz yere geniş yazma ve bash izinleri mi istiyor?

• Depo yakın zamanda bakımdan geçti mi?

• Şablon neyi değiştirdiğini açıklıyor mu?

• İncelemediğiniz kodu çalıştıran kancalar veya MCP sunucuları içeriyor mu?

Üçüncü olarak, kendi şablonlarınızı yazın. Bu genellikle yığınıza sıkı sıkıya bağlı iş akışları için en doğru yanıttır. Bir topluluk şablonu size yararlı bir temel verebilir, ancak kurum içi geçiş politikanızı, adlandırma kurallarınızı, veri modelinizi veya dağıtım risk toleransınızı bilemez.

Son Düşünceler

Claude Code şablonları, Claude Code’u oturumdan oturuma bir yardımcıdan kalıcı bir geliştirme ortamına taşıyan mekanizmadır. 

Bahsettiğim altı kategori aslında katmanlardır: yetenekler iş akışlarını kodlar, aracılar rolleri tanımlar, komutlar açık eylemler oluşturur, kancalar korkulukları uygular, MCP harici sistemleri bağlar ve eklentiler her şeyi yeniden kullanım için paketler.

Başlamak için en iyi yer devasa bir eklenti yığını değildir. Ben, en sık tekrarladığınız iş akışı için tek bir yetenekle başlardım. Claude’un varsayılan davranışının hâlâ nerede sürtünme yarattığını gördüğünüzde, uzman inceleme için bir aracı, uygulama için bir kanca veya canlı sistem erişimi için bir MCP sunucusu ekleyin.

Claude Code hakkında daha fazla öğrenmek için Claude Code 101 ve Claude Code in Action kurslarımıza göz atın.