everything-claude-code/docs/tr/the-shortform-guide.md

Claude Code'un Her Şeyine Dair Kısa Kılavuz

---

Şubat ayında deneysel kullanıma sunulduğundan beri hevesli bir Claude Code kullanıcısıyım ve @DRodriguezFX ile birlikte tamamen Claude Code kullanarak zenith.chat projesiyle Anthropic x Forum Ventures hackathon'unu kazandım.

İşte 10 aylık günlük kullanım sonrası eksiksiz kurulumum: skill'ler, hook'lar, subagent'lar, MCP'ler, plugin'ler ve gerçekten işe yarayanlar.

---

Skill'ler ve Command'lar

Skill'ler, belirli kapsamlar ve iş akışlarıyla sınırlandırılmış kurallar gibi çalışır. Belirli bir iş akışını yürütmeniz gerektiğinde prompt'lara kısayol görevi görürler.

Opus 4.5 ile uzun bir kodlama oturumundan sonra ölü kodu ve gevşek .md dosyalarını temizlemek mi istiyorsunuz? /refactor-clean çalıştırın. Test mi gerekli? /tdd, /e2e, /test-coverage. Skill'ler ayrıca codemap'leri de içerebilir - Claude'un keşfe context harcamadan kod tabanınızda hızlıca gezinmesi için bir yöntem.

Command'ları zincirleme

Command'lar, slash command'lar aracılığıyla yürütülen skill'lerdir. Örtüşürler ancak farklı şekilde saklanırlar:

• Skill'ler: ~/.claude/skills/ - daha geniş iş akışı tanımları
• Command'lar: ~/.claude/commands/ - hızlı çalıştırılabilir prompt'lar

# Örnek skill yapısı
~/.claude/skills/
  pmx-guidelines.md      # Projeye özel desenler
  coding-standards.md    # Dile özgü en iyi uygulamalar
  tdd-workflow/          # README.md ile çok dosyalı skill
  security-review/       # Kontrol listesi tabanlı skill

---

Hook'lar

Hook'lar, belirli olaylarda tetiklenen otomasyonlardır. Skill'lerin aksine, araç çağrıları ve yaşam döngüsü olaylarıyla sınırlıdırlar.

Hook Türleri:

1. PreToolUse - Bir araç çalıştırılmadan önce (doğrulama, hatırlatmalar)
2. PostToolUse - Bir araç bittikten sonra (biçimlendirme, geri bildirim döngüleri)
3. UserPromptSubmit - Bir mesaj gönderdiğinizde
4. Stop - Claude yanıt vermeyi bitirdiğinde
5. PreCompact - Context sıkıştırmasından önce
6. Notification - İzin istekleri

Örnek: uzun süren komutlardan önce tmux hatırlatması

{
  "PreToolUse": [
    {
      "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm|pnpm|yarn|cargo|pytest)\"",
      "hooks": [
        {
          "type": "command",
          "command": "if [ -z \"$TMUX\" ]; then echo '[Hook] Consider tmux for session persistence' >&2; fi"
        }
      ]
    }
  ]
}

PostToolUse hook çalıştırırken Claude Code'da aldığınız geri bildirimin örneği

Pro ipucu: JSON'u manuel yazmak yerine hook'ları konuşarak oluşturmak için hookify plugin'ini kullanın. /hookify çalıştırın ve ne istediğinizi açıklayın.

---

Subagent'lar

Subagent'lar, ana Claude'unuzun (orchestrator) sınırlı kapsamlarla görev devredebileceği süreçlerdir. Arka planda veya ön planda çalışabilir, ana agent için context'i serbest bırakırlar.

Subagent'lar skill'lerle güzel çalışır - skill'lerinizin bir alt kümesini yürütebilen bir subagent'a görevler devredebilir ve bu skill'leri özerk olarak kullanabilir. Ayrıca belirli araç izinleriyle sandbox'lanabilirler.

# Örnek subagent yapısı
~/.claude/agents/
  planner.md           # Özellik uygulama planlaması
  architect.md         # Sistem tasarım kararları
  tdd-guide.md         # Test odaklı geliştirme
  code-reviewer.md     # Kalite/güvenlik incelemesi
  security-reviewer.md # Güvenlik açığı analizi
  build-error-resolver.md
  e2e-runner.md
  refactor-cleaner.md

Uygun kapsam belirleme için her subagent için izin verilen araçları, MCP'leri ve izinleri yapılandırın.

---

Rule'lar ve Memory

.rules klasörünüz, Claude'un HER ZAMAN izlemesi gereken en iyi uygulamaları içeren .md dosyalarını barındırır. İki yaklaşım:

1. Tek CLAUDE.md - Her şey tek bir dosyada (kullanıcı veya proje seviyesi)
2. Rules klasörü - Endişelere göre gruplandırılmış modüler .md dosyaları

~/.claude/rules/
  security.md      # Sabit kodlanmış secret yok, girişleri doğrula
  coding-style.md  # Değişmezlik, dosya organizasyonu
  testing.md       # TDD iş akışı, %80 coverage
  git-workflow.md  # Commit formatı, PR süreci
  agents.md        # Subagent'lara ne zaman delege edilir
  performance.md   # Model seçimi, context yönetimi

Örnek rule'lar:

• Kod tabanında emoji yok
• Frontend'de mor tonlardan kaçın
• Kodu dağıtmadan önce her zaman test edin
• Mega dosyalar yerine modüler kodu önceliklendirin
• Asla console.log commit etmeyin

---

MCP'ler (Model Context Protocol)

MCP'ler Claude'u doğrudan harici hizmetlere bağlar. API'lerin yerini tutmaz - bunların etrafında prompt odaklı bir sarmalayıcıdır, bilgide gezinmede daha fazla esneklik sağlar.

Örnek: Supabase MCP, Claude'un belirli verileri çekmesine, SQL'i kopyala-yapıştır olmadan doğrudan upstream çalıştırmasına izin verir. Veritabanları, dağıtım platformları vb. için de aynı.

Supabase MCP'nin public şemasındaki tabloları listeleyen örneği

Claude'da Chrome: Claude'un tarayıcınızı özerk olarak kontrol etmesine izin veren yerleşik bir plugin MCP'sidir - işlerin nasıl çalıştığını görmek için etrafta tıklar.

KRİTİK: Context Window Yönetimi

MCP'lerle seçici olun. Tüm MCP'leri kullanıcı yapılandırmasında tutarım ancak kullanılmayan her şeyi devre dışı bırakırım. /plugins'e gidin ve aşağı kaydırın veya /mcp çalıştırın.

/plugins kullanarak MCP'lere giderek şu anda hangi MCP'lerin yüklü olduğunu ve durumlarını görme

Sıkıştırmadan önce 200k context window'unuz, çok fazla araç etkinleştirilmişse sadece 70k olabilir. Performans önemli ölçüde düşer.

Genel kural: Yapılandırmada 20-30 MCP bulundurun, ancak 10'dan az etkin / 80'den az aktif araç tutun.

# Etkin MCP'leri kontrol edin
/mcp

# ~/.claude.json içinde projects.disabledMcpServers altında kullanılmayanları devre dışı bırakın

---

Plugin'ler

Plugin'ler, sıkıcı manuel kurulum yerine kolay kurulum için araçları paketler. Bir plugin, birleştirilmiş bir skill + MCP veya birlikte paketlenmiş hook'lar/araçlar olabilir.

Plugin'leri yükleme:

# Bir marketplace ekleyin
# @mixedbread-ai tarafından mgrep plugin
claude plugin marketplace add https://github.com/mixedbread-ai/mgrep

# Claude'u açın, /plugins çalıştırın, yeni marketplace'i bulun, oradan yükleyin

Yeni yüklenen Mixedbread-Grep marketplace'i gösterme

LSP Plugin'leri, Claude Code'u sık sık editör dışında çalıştırıyorsanız özellikle kullanışlıdır. Language Server Protocol, Claude'a IDE açık olmadan gerçek zamanlı tip kontrolü, tanıma gitme ve akıllı tamamlamalar verir.

# Etkin plugin'ler örneği
typescript-lsp@claude-plugins-official  # TypeScript zekası
pyright-lsp@claude-plugins-official     # Python tip kontrolü
hookify@claude-plugins-official         # Hook'ları konuşarak oluşturma
mgrep@Mixedbread-Grep                   # ripgrep'ten daha iyi arama

MCP'lerle aynı uyarı - context window'unuzu izleyin.

---

İpuçları ve Püf Noktaları

Klavye Kısayolları

• Ctrl+U - Tüm satırı sil (backspace spam'inden daha hızlı)
• ! - Hızlı bash komutu öneki
• @ - Dosya arama
• / - Slash command'ları başlatma
• Shift+Enter - Çok satırlı girdi
• Tab - Düşünme görüntüsünü değiştir
• Esc Esc - Claude'u kesme / kodu geri yükleme

Paralel İş Akışları

• Fork (/fork) - Paralelde çakışmayan görevler yapmak için sıraya alınan mesaj spam'i yerine konuşmaları fork'layın
• Git Worktree'ler - Çakışma olmadan paralel Claude'lar için örtüşen iş. Her worktree bağımsız bir checkout'tur

git worktree add ../feature-branch feature-branch
# Şimdi her worktree'de ayrı Claude instance'ları çalıştırın

Uzun Süren Komutlar için tmux

Claude'un çalıştırdığı log'ları/bash süreçlerini stream edin ve izleyin:

https://github.com/user-attachments/assets/shortform/07-tmux-video.mp4

tmux new -s dev
# Claude burada komutlar çalıştırır, ayrılıp yeniden bağlanabilirsiniz
tmux attach -t dev

mgrep > grep

mgrep, ripgrep/grep'ten önemli bir gelişmedir. Plugin marketplace aracılığıyla yükleyin, ardından /mgrep skill'ini kullanın. Hem yerel arama hem de web aramasıyla çalışır.

mgrep "function handleSubmit"  # Yerel arama
mgrep --web "Next.js 15 app router changes"  # Web araması

Diğer Kullanışlı Command'lar

• /rewind - Önceki bir duruma geri dön
• /statusline - Branch, context %, todo'larla özelleştir
• /checkpoints - Dosya seviyesi geri alma noktaları
• /compact - Context sıkıştırmasını manuel olarak tetikle

GitHub Actions CI/CD

PR'larınızda GitHub Actions ile kod incelemesi kurun. Claude yapılandırıldığında PR'ları otomatik olarak inceleyebilir.

Claude bir bug düzeltme PR'ını onaylıyor

Sandboxing

Riskli işlemler için sandbox modunu kullanın - Claude gerçek sisteminizi etkilemeden kısıtlı ortamda çalışır.

---

Editörler Hakkında

Editör seçiminiz Claude Code iş akışını önemli ölçüde etkiler. Claude Code herhangi bir terminalden çalışırken, yetenekli bir editörle eşleştirmek gerçek zamanlı dosya takibi, hızlı gezinme ve entegre komut yürütme sağlar.

Zed (Benim Tercihim)

Ben Zed kullanıyorum - Rust ile yazılmış, bu nedenle gerçekten hızlı. Anında açılır, büyük kod tabanlarını terletmeden işler ve sistem kaynaklarına zar zor dokunur.

Neden Zed + Claude Code harika bir kombinasyon:

• Hız - Rust tabanlı performans, Claude hızla dosyaları düzenlediğinde gecikme olmadığı anlamına gelir. Editörünüz ayak uydurur
• Agent Panel Entegrasyonu - Zed'in Claude entegrasyonu, Claude düzenlerken dosya değişikliklerini gerçek zamanlı takip etmenizi sağlar. Editörü terk etmeden Claude'un referans verdiği dosyalar arasında geçiş yapın
• CMD+Shift+R Command Palette - Tüm özel slash command'larınıza, debugger'larınıza, aranabilir bir UI'da build script'lerinize hızlı erişim
• Minimal Kaynak Kullanımı - Ağır işlemler sırasında Claude ile RAM/CPU için rekabet etmez. Opus çalıştırırken önemli
• Vim Modu - Bu sizin tarzınızsa tam vim keybinding'leri

CMD+Shift+R kullanarak özel komutlar açılır menüsü olan Zed Editor. Following modu sağ altta hedef işareti olarak gösterilmiş.

Editörden Bağımsız İpuçları:

1. Ekranınızı bölün - Bir tarafta Claude Code ile terminal, diğer tarafta editör
2. Ctrl + G - Claude'un üzerinde çalıştığı dosyayı Zed'de hızlıca açın
3. Otomatik kaydetme - Otomatik kaydetmeyi etkinleştirin böylece Claude'un dosya okumaları her zaman güncel olur
4. Git entegrasyonu - Claude'un değişikliklerini commit etmeden önce incelemek için editörün git özelliklerini kullanın
5. Dosya izleyiciler - Çoğu editör değiştirilen dosyaları otomatik yeniden yükler, bunun etkin olduğunu doğrulayın

VSCode / Cursor

Bu da geçerli bir seçimdir ve Claude Code ile iyi çalışır. LSP işlevselliğini etkinleştiren \ide ile editörünüzle otomatik senkronizasyon ile terminal formatında kullanabilirsiniz (artık plugin'lerle biraz gereksiz). Veya Editor ile daha entegre olan ve eşleşen bir UI'ya sahip extension'ı tercih edebilirsiniz.

VS Code extension, doğrudan IDE'nize entegre edilmiş Claude Code için native bir grafik arayüz sağlar.

---

Benim Kurulumum

Plugin'ler

Yüklü: (Genellikle bunlardan sadece 4-5'i aynı anda etkin tutuluyor)

ralph-wiggum@claude-code-plugins       # Loop otomasyonu
frontend-design@claude-code-plugins    # UI/UX desenleri
commit-commands@claude-code-plugins    # Git iş akışı
security-guidance@claude-code-plugins  # Güvenlik kontrolleri
pr-review-toolkit@claude-code-plugins  # PR otomasyonu
typescript-lsp@claude-plugins-official # TS zekası
hookify@claude-plugins-official        # Hook oluşturma
code-simplifier@claude-plugins-official
feature-dev@claude-code-plugins
explanatory-output-style@claude-code-plugins
code-review@claude-code-plugins
context7@claude-plugins-official       # Canlı dokümantasyon
pyright-lsp@claude-plugins-official    # Python tipleri
mgrep@Mixedbread-Grep                  # Daha iyi arama

MCP Server'ları

Yapılandırılmış (Kullanıcı Seviyesi):

{
  "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] },
  "firecrawl": { "command": "npx", "args": ["-y", "firecrawl-mcp"] },
  "supabase": {
    "command": "npx",
    "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=YOUR_REF"]
  },
  "memory": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-memory"] },
  "sequential-thinking": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
  },
  "vercel": { "type": "http", "url": "https://mcp.vercel.com" },
  "railway": { "command": "npx", "args": ["-y", "@railway/mcp-server"] },
  "cloudflare-docs": { "type": "http", "url": "https://docs.mcp.cloudflare.com/mcp" },
  "cloudflare-workers-bindings": {
    "type": "http",
    "url": "https://bindings.mcp.cloudflare.com/mcp"
  },
  "clickhouse": { "type": "http", "url": "https://mcp.clickhouse.cloud/mcp" },
  "AbletonMCP": { "command": "uvx", "args": ["ableton-mcp"] },
  "magic": { "command": "npx", "args": ["-y", "@magicuidesign/mcp@latest"] }
}

Bu anahtar - 14 MCP yapılandırılmış ancak proje başına sadece ~5-6'sı etkin. Context window'u sağlıklı tutar.

Ana Hook'lar

{
  "PreToolUse": [
    { "matcher": "npm|pnpm|yarn|cargo|pytest", "hooks": ["tmux reminder"] },
    { "matcher": "Write && .md file", "hooks": ["block unless README/CLAUDE"] },
    { "matcher": "git push", "hooks": ["open editor for review"] }
  ],
  "PostToolUse": [
    { "matcher": "Edit && .ts/.tsx/.js/.jsx", "hooks": ["prettier --write"] },
    { "matcher": "Edit && .ts/.tsx", "hooks": ["tsc --noEmit"] },
    { "matcher": "Edit", "hooks": ["grep console.log warning"] }
  ],
  "Stop": [
    { "matcher": "*", "hooks": ["check modified files for console.log"] }
  ]
}

Özel Status Line

Kullanıcı, dizin, kirli göstergeli git branch, kalan context %, model, zaman ve todo sayısını gösterir:

Mac root dizinimde örnek statusline

affoon:~ ctx:65% Opus 4.5 19:52
▌▌ plan mode on (shift+tab to cycle)

Rules Yapısı

~/.claude/rules/
  security.md      # Zorunlu güvenlik kontrolleri
  coding-style.md  # Değişmezlik, dosya boyutu limitleri
  testing.md       # TDD, %80 coverage
  git-workflow.md  # Conventional commit'ler
  agents.md        # Subagent delegasyon kuralları
  patterns.md      # API yanıt formatları
  performance.md   # Model seçimi (Haiku vs Sonnet vs Opus)
  hooks.md         # Hook dokümantasyonu

Subagent'lar

~/.claude/agents/
  planner.md           # Özellikleri parçalara ayırma
  architect.md         # Sistem tasarımı
  tdd-guide.md         # Önce testleri yaz
  code-reviewer.md     # Kalite incelemesi
  security-reviewer.md # Güvenlik açığı taraması
  build-error-resolver.md
  e2e-runner.md        # Playwright testleri
  refactor-cleaner.md  # Ölü kod kaldırma
  doc-updater.md       # Dokümantasyonu senkronize tut

---

Temel Çıkarımlar

1. Aşırı karmaşıklaştırmayın - yapılandırmayı mimari değil, ince ayar gibi ele alın
2. Context window değerlidir - kullanılmayan MCP'leri ve plugin'leri devre dışı bırakın
3. Paralel yürütme - konuşmaları fork'layın, git worktree'leri kullanın
4. Tekrarlananları otomatikleştirin - biçimlendirme, linting, hatırlatmalar için hook'lar
5. Subagent'larınızı kapsamlandırın - sınırlı araçlar = odaklanmış yürütme

---

Referanslar

• Plugin'ler Referansı
• Hook'lar Dokümantasyonu
• Checkpoint'leme
• Interactive Mode
• Memory Sistemi
• Subagent'lar
• MCP Genel Bakış

---

Not: Bu bir detay alt kümesidir. Gelişmiş desenler için Longform Kılavuzu'na bakın.

---

NYC'de @DRodriguezFX ile zenith.chat oluşturarak Anthropic x Forum Ventures hackathon'unu kazandım