Claude Code En İyi Uygulamaları: 'Kullanılabilir'den 'Gerçekten Faydalı'ya

Claude Code'u yarım yıldan fazladır kullanıyorum ve yazdığım kod satırından daha çok tuzağa düştüm.

Başlangıçta Claude Code'un sadece "daha gelişmiş bir Copilot" olduğunu sanıyordum—terminalde yazıyorsun, kod yazıyor, bitiyor. Sonra fark ettim ki bu aracın tavanı hayal ettiğimden çok daha yüksek, ama yeter ki nasıl kullanacağını bil.

Bu yazı, resmi dokümantasyon ve pratik deneyimi birleştirerek en önemli kullanım ipuçlarını derliyor. Bazıları zor yoldan öğrenilen dersler, bazılarıysa dokümanları okuyarak keşfettiğim gizli özellikler.

1. CLAUDE.MD: En Hafife Alınan Özellik

Bu yazıdan sadece bir şey hatırlayacaksanız, şu olsun: CLAUDE.md dosyanızı iyi yazın.

CLAUDE.md, Claude Code'un her sohbetin başında otomatik olarak okuduğu talimat dosyasıdır. Yeni bir iş arkadaşınız için yazdığınız bir oryantasyon belgesi gibidir—bilmelerini istediğiniz her şeyi oraya yazarsınız.

Çoğu kişi CLAUDE.md yazmaz veya sadece birkaç satır yazar. Sonuç olarak her sohbette proje yapısını, kodlama standartlarını ve teknoloji tercihlerini sıfırdan anlatmak zorunda kalırsınız. Bu, her sabah iş arkadaşınıza şirketi yeniden tanıtmak gibidir.

İyi bir CLAUDE.md şunları içermelidir:

1# Proje Adı
2
3## Derleme ve Test Komutları
4- Bağımlılıkları yükle: npm install
5- Testleri çalıştır: npm test
6- Tek test: npm test -- --grep "test adı"
7- Biçimlendirme: npm run format
8
9## Kodlama Standartları
10- Python: Biçimlendirme için ruff kullan, satır genişliği 88
11- Test: pytest kullan, her servis için bir test dosyası
12- API Rotaları: Çoğul dosya adları kullan: users.py, orders.py
13- Commit mesajları: İngilizce, format: type(scope): description
14
15## Mimari Kararlar
16- Takım standardize ettiği için CSS Modules yerine Tailwind seçildi
17- Kullanıcı izin kontrolleri middleware'de yapılır; her rotada tekrarlama
18- Redis önbellek anahtar öneki: app:v1:
19
20## Yaygın Tuzaklar
21- Veritabanı bağlantı havuzu limiti 20'dir; döngülerde yeni bağlantı açma
22- Veritabanını mock'lama; geçen sefer mock'lar geçti ama production migrasyonu başarısız oldu

Ana prensipler:

Birincisi, Claude'un koddan çıkaramayacağı şeyleri yazın. Bir projenin "neden"i, "ne" olduğundan daha önemlidir. React'in nasıl kullanılacağını açıklamanıza gerek yok, ancak "Tailwind'i takım standardize ettiği için seçtik" demeniz gerekir.

İkincisi, 200 satırın altında tutun. Resmi dokümantasyon, CLAUDE.md çok uzunsa Claude'un kuralları görmezden gelebileceğini açıkça belirtiyor. Markdown başlıkları ve listeleri kullanarak taranabilir hale getirin.

Üçüncüsü, sık değişen içerik koymayın. Detaylı API dokümanları veya dosya bazında açıklamalar CLAUDE.md'ye ait değildir. Sadece bağlantılar verin.

CLAUDE.md'nin Dört Seviyesi

Claude Code, en yüksekten en düşüğe doğru sıralanmış dört seviyede CLAUDE.md'yi destekler:

Global CLAUDE.md dosyama genellikle şunları yazarım:

1- Ben bir full-stack mühendisim; temel kavramları fazla açıklamana gerek yok
2- Yanıtları kısa tut; gereksiz kibarlıkları atla
3- Kod değişikliklerinden sonra ne yaptığını özetleme; diff'i kendim kontrol ederim
4- Basit çözümleri önceliklendir; aşırı mühendislikten kaçın

Bu dört satır, yüzlerce tekrarlayan düzeltmeden kurtarabilir.

İleri Seviye: .claude/rules/ ile Kuralları Düzenleyin

Proje büyüdükçe, tek bir CLAUDE.md dosyası her şeyi tutamaz. Resmi çözüm daha zarif: Kuralları .claude/rules/ dizinine ayırın.

1.claude/rules/
2├── testing.md        # Test standartları
3├── api-style.md      # API yazım stili
4└── frontend.md       # Ön uç kuralları

Daha da güçlüsü, kuralları belirli dosyalarla sınırlamak için YAML frontmatter kullanabilirsiniz:

1---
2paths: ["src/api/**/*.ts", "src/routes/**/*.ts"]
3---
4
5API rotaları girdi doğrulama ve hata yönetimi içermelidir.
6Tüm yüksek noktalar, tests/api/ içinde entegrasyon testleri gerektirir.

Bu şekilde kural, yalnızca Claude eşleşen dosyalara eriştiğinde yüklenir ve bağlam alanından tasarruf sağlar.

2. Prompt Kalitesi, Çıktı Kalitesini Belirler

Kulağa bir klişe gibi geliyor ama birçok kişinin Claude Code'u şöyle kullandığını gördüm:

"Bana bir giriş özelliği yaz"

Sonra ortaya çıkan devasa kod yığını karşısında endişeleniyorlar—ben bunu istememiştim.

İyi bir talimat üç öğe içermelidir: Hedef, Kısıtlamalar ve Bağlam.

Kötü Talimat vs. İyi Talimat

Kötü: "Kullanıcı listesine bir arama özelliği ekle"

İyi: "@src/pages/UserList.tsx'deki tablonun üstüne bir arama kutusu ekle. Arama, arka uç API'si /api/users?search=xxx'i kullanmalı, ön uç filtreleme yok. 300ms debounce kullan ve stili mevcut Filter bileşeniyle tutarlı tut."

Fark mı? İyi talimatlar belirsizliği azaltır. Claude Code, ön uç mu yoksa arka uç mu arama istediğinizi, debounce süresini veya stil standartlarını tahmin etmek zorunda kalmaz.

Resmi Olarak Önerilen Prompt İpuçları

1. Belirli dosyalara başvurmak için @ kullanın

Claude Code, dosya içeriğini doğrudan bağlama çekmek için @dosyayolu kullanımını destekler. "Şu kimlik doğrulama kodu" demek yerine, @src/auth/login.ts yazmak çok daha kesindir. Hatta satır aralıkları bile belirtebilirsiniz: @src/auth/login.ts#5-30.

2. Ekran görüntüleri ve görseller yapıştırın

Görselleri doğrudan yapıştırmak için Ctrl+V kullanın. UI sorunlarını hata ayıklarken, "şu anki hali" vs "istediğim hal" ekran görüntüsü, metin açıklamasından on kat daha etkilidir.

3. Doğrulama kriterleri sağlayın

Sadece "bu hatayı düzeltmeme yardım et" demeyin, şöyle deyin:

"Oturum zaman aşımından sonra yeniden kimlik doğrulamanın başarısız olduğu sorunu düzelt. Düzeltmeden sonra, token süresi dolduğunda herhangi bir butona tıklamak otomatik olarak giriş sayfasına yönlendirmeli. Test senaryoları @tests/auth.test.ts'de; düzeltmeden sonra geçtiklerini doğrulamak için çalıştır."

Claude'a kendi kendini doğrulayabileceği bir standart verin—test senaryoları, ekran görüntüleri, beklenen çıktı—böylece kendi iş kalitesini kontrol edebilir ve gidiş-dönüşleri azaltabilir.

4. Ne YAPILMAMASI gerektiğini netleştirin

Claude Code bazen aşırı hevesli olabilir—bir hatayı düzeltmesini istersiniz, o da etraftaki kodu yeniden düzenler. Açıkça "sadece bu fonksiyonu değiştir, diğer koda dokunma" demek çok iş kurtarır.

Belirsiz talimatlar ne zaman işe yarar

Her durum hassasiyet gerektirmez. Belirsiz talimatlar aslında keşif görevleri için daha iyidir:

• "Bu dosyada ne geliştirilebilir?"
• "Bu modülün mimarisini anlamama yardım et"
• "Bu kodla ilgili potansiyel sorunlar var mı?"

Ancak uygulama aşamasına geldiğinizde, hassasiyet moduna geri dönün.

3. PLAN MODE: Harekete Geçmeden Önce Net Düşünün

Claude Code'un bir Plan Modu var ve bunu en hafife alınan iş akışı olarak görüyorum.

Plan Modu'na Nasıl Girilir

Üç yol:

1# Doğrudan plan modunda başlat
2claude --permission-mode plan
3
4# Sohbet sırasında geçiş yap (Shift+Tab'e iki kez basın)
5Shift+Tab Shift+Tab
6
7# Promptta söyleyin
8"Henüz kodu değiştirme, bir plan yapmama yardım et"

Plan Modu'nda Claude Code yalnızca dosyaları okuyabilir ve kod arayabilir; herhangi bir değişiklik yapamaz. Kod tabanını keşfeder, gereksinimlerinizi analiz eder ve ayrıntılı bir uygulama planı sunar.

Plan Modu'nu Doğru Kullanma Yöntemi

Anahtar işlem: Planı düzenleyicide açmak ve düzenlemek için Ctrl+G'ye basın.

Bu, şunları yapabileceğiniz anlamına gelir:

1. Claude'un bir başlangıç planı oluşturmasına izin verin
2. Planı açmak için Ctrl+G'ye basın, katılmadığınız kısımları silin ve kendi fikirlerinizi ekleyin
3. Normal moda geri dönün (Shift+Tab) ve Claude'un değiştirilen plana göre yürütmesine izin verin

Bir planı değiştirmek bir cümle sürer; zaten yazılmış kodu değiştirmek on kat daha uzun sürer.

Karmaşık Görevler İçin Önerilen İş Akışı

Resmi standart süreç dört adımdır: Keşfet → Planla → Uygula → Doğrula.

11. Plan Modu'na gir
22. Claude'a ilgili kodu okut: "Oturum mantığını anlamak için src/auth/ içindeki kodu oku"
33. Bir plan iste: "Bir OAuth2 geçiş planı geliştir"
44. Planı gözden geçirip düzenlemek için Ctrl+G'ye bas
55. Normal moda geri dön
66. "Plana göre uygula, yazdıktan sonra testleri çalıştır"
77. Claude'un gereksinimlere karşı kendi kendini kontrol etmesini sağla

Plan Modu'na Ne Zaman İhtiyacınız Yok

• Bir değişken adını değiştirmek
• Bariz bir yazım hatasını düzeltmek
• Tek bir günlük satırı eklemek

Kriter basit: Görevi uygulamanın tek bir yolu varsa, doğrudan yapın. Birden fazla seçenek varsa, önce planlayın.

4. ALT-ETMENLER: Claude Code'un Çoklu Görev Gücü

Alt-etmenler güçlü bir mekanizmadır—Claude Code, görevleri paralel olarak işlemek için bağımsız AI süreçleri başlatabilir. Her alt-etmen kendi bağlam penceresine sahiptir ve ana sohbetinizi karıştırmaz.

Yerleşik Alt-Etmen Türleri

Alt-Etmenlerin En Büyük Değeri: Bağlam İzolasyonu

Claude'dan testleri çalıştırmasını, günlükleri analiz etmesini veya birçok dosyayı aramasını istediğinizde, bu işlemler bağlam pencerenizi dolduran büyük miktarda çıktı üretir. Bu görevler için alt-etmenleri kullanın; çıktı alt-etmenin bağlamında kalır ve size yalnızca bir özet döndürülür.

Örneğin:

"Tüm testleri çalıştırmak ve başarısız olanları listelemek için bir alt-etmen kullan"

"Kullanılmayan API'leri kullanan tüm dosyaları aramak için bir alt-etmen kullan"

Arka Planda Çalıştırma: Ctrl+B

Bir alt-etmeni arka plana almak için Ctrl+B'ye basın. Claude'la başka konular hakkında sohbet etmeye devam edebilirsiniz ve arka plan görevi tamamlandığında bildirim alırsınız.

Şunlar için uygundur:

• Test paketlerini çalıştırma (genellikle dakikalar sürer)
• Büyük ölçekli kod aramaları
• Acil olmayan kod incelemeleri

Özel Alt-Etmenler

.claude/agents/ dizininde özel etmenler oluşturabilirsiniz:

1---
2name: kod-incelemeci
3description: Kod inceleme uzmanı. Kod değişikliklerinden sonra otomatik tetiklenir.
4tools: Read, Grep, Glob, Bash
5model: sonnet
6---
7
8Kıdemli bir kod incelemecisisiniz. Aşağıdaki boyutları kontrol edin:
9- Kod netliği ve okunabilirliği
10- Hata yönetiminin eksiksizliği
11- Hassas bilgilerin ifşası
12- Girdi doğrulama
13- Performans tuzakları

Ardından sohbette @"kod-incelemeci (agent)" kullanarak çağırın.

5. Bağlam Yönetimi: En Çok Gözden Kaçan Anahtar

Claude Code'un bağlam penceresi büyük olsa da (1M token'a kadar), sonsuz değildir ve bağlam yönetimi çıktı kalitesini doğrudan belirler.

Bağlamda Ne Var?

• Sohbet geçmişiniz
• Claude tarafından okunan tüm dosya içerikleri
• Komut yürütme çıktısı
• CLAUDE.md dosyası (her seferinde yüklenir)
• Bellek dosyası (ilk 200 satır)
• Yüklenen Skill ve MCP araç tanımları

Beş Pratik Strateji

1. /clear: Görev bittiğinde temizleyin

Hata düzeltme, özellik ekleme ve yeniden düzenleme işlemlerini aynı sohbette yapmayın. /clear, CLAUDE.md'yi korurken bağlamı boşaltır ve ücretsiz bir yeniden başlatma gibi çalışır.

2. /compact: Bağlamı manuel olarak sıkıştırın

Sohbet uzadığında, Claude'un önceki diyaloğu otomatik olarak özetlemesi ve sıkıştırması için /compact kullanın. Daha iyi bir yol, sıkıştırmaya bir odak eklemektir:

/compact API değişiklikleri ve test sonuçlarına odaklan

Bu şekilde Claude, sıkıştırma sırasında önemsediğiniz içeriği tutmaya öncelik verir.

3. /context: Bağlamınızı neyin tükettiğini görün

Mevcut kullanımı görmek için /context yazın—hangi dosyaların kaç token aldığını ve MCP araç tanımlarının ne kadar yer kapladığını görün. Sık sık gereksiz MCP sunucularının büyük miktarda yer kapladığını buluyorum.

4. Gürültüyü izole etmek için Alt-Etmenleri kullanın

Testleri çalıştırmak ve günlükleri analiz etmek çok fazla çıktı üretir. Ana sohbet bağlamını temiz tutmak için alt-etmenlerin yapmasına izin verin.

5. CLAUDE.md'ye sıkıştırma saklama talimatları yazın

Claude'a sıkıştırma sırasında neyin tutulması gerektiğini söyleyebilirsiniz:

1# Sıkıştırma Talimatları
2Bağlamı sıkıştırırken her zaman şunları tut:
3- Değiştirilen dosyaların tam listesi
4- Test komutları ve sonuçları
5- Ana mimari kararlar

Bellek vs CLAUDE.md

Bellek ne içindir: Tercihleriniz ("bu kişi kısa yanıtları sever"), proje kuralları ("dağıtımın özel bir adımı vardır"), geçmiş kararlar ("geçen sefer X nedeniyle A seçeneğini seçtik").

Bellek ne için DEĞİLDİR: Kod detayları, Git geçmişi, geçici durumlar—bunlar kod ve Git'ten daha doğru bir şekilde alınır.

Yüklenen tüm Bellek'i görüntülemek ve yönetmek için /memory komutunu kullanın.

6. İzin Yönetimi: Güvenlik ve Verimlilik Arasında Denge

Claude Code, sohbette Shift+Tab ile döngüye alınan beş izin modu sağlar:

İzin Kuralı Yapılandırması

.claude/settings.json dosyasında, her araç için izinleri ince ayarla kontrol edebilirsiniz:

1{
2  "permissions": {
3    "allow": [
4      "Bash(npm run *)",
5      "Bash(git commit *)",
6      "Edit(src/**/*.ts)",
7      "Read(*.md)"
8    ],
9    "deny": [
10      "Bash(rm -rf *)",
11      "Edit(.env)"
12    ]
13  }
14}

Kural önceliği: deny → ask → allow (deny en yüksek önceliğe sahiptir).

Bu, yaygın komutlara cesurca izin verirken, hassas dosyaları korumak için deny kullanabileceğiniz anlamına gelir. Örneğin, .env dosyaları asla düzenlenmemelidir.

Ayar Dosyalarının Hiyerarşisi

CLAUDE.md'ye benzer şekilde, ayarların birden çok seviyesi vardır:

1Organizasyon Politikası (En Yüksek Öncelik)
2  ↓
3CLI Argümanları
4  ↓
5.claude/settings.local.json (Yerel, Git'e eklenmez)
6  ↓
7.claude/settings.json (Proje seviyesi, ekiple paylaşılır)
8  ↓
9~/.claude/settings.json (Global, kişisel)
10  ↓
11Varsayılan Değerler (En Düşük Öncelik)

Tavsiyem: Takımla paylaşılan kuralları .claude/settings.json'a, kişisel tercihleri ~/.claude/settings.json'a ve hassas yapılandırmaları .claude/settings.local.json'a koyun (.gitignore'a eklemeyi unutmayın).

7. HOOKS: Kuralları Demir Yasalar Haline Getirin

CLAUDE.md'deki talimatlar "önerilerdir"—Claude çoğu zaman onları takip eder, ancak bazen unutur. Hook'lar "demir yasalardır"—ne olursa olsun yürütülürler.

Hook'lar, belirli yaşam döngüsü olayları tarafından otomatik olarak tetiklenen ve settings.json'da yapılandırılan kabuk komutlarıdır.

Anahtar Olay Türleri

Pratik Örnekler

Otomatik biçimlendirme—Her düzenlemeden sonra Prettier'ı çalıştırın:

1{
2  "hooks": {
3    "PostToolUse": [{
4      "matcher": "Edit|Write",
5      "hooks": [{
6        "type": "command",
7        "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
8      }]
9    }]
10  }
11}

Kritik dosyaları koruma—Production yapılandırmalarını değiştirmeyi engelleyin:

1{
2  "hooks": {
3    "PreToolUse": [{
4      "matcher": "Edit|Write",
5      "hooks": [{
6        "type": "command",
7        "command": ".claude/hooks/protect-files.sh"
8      }]
9    }]
10  }
11}

Çıkış kodu 0 döndüren bir hook komutu izin verildiği anlamına gelir; çıkış kodu 2 engellendiği anlamına gelir. Bu, herhangi bir karmaşık mantık yazabileceğiniz anlamına gelir.

Bağlam sıkıştırmasından sonra anahtar bilgileri yeniden ekleme:

1{
2  "hooks": {
3    "SessionStart": [{
4      "matcher": "compact",
5      "hooks": [{
6        "type": "command",
7        "command": "echo 'Bun kullan, npm değil. Commit'ten önce bun test'i çalıştır.'"
8      }]
9    }]
10  }
11}

Bu, yaygın bir sorunu çözer: uzun bir sohbet sıkıştırıldığında, daha önce bahsedilen önemli talimatlar kaybolabilir. Hook'lar, her sıkıştırmadan sonra bunları otomatik olarak yeniden ekleyebilir.

Dört Tür Hook

8. GIT İŞ AKIŞI: WORKTREE'den İyi Yararlanın

Claude Code, Git komutlarını yürütebilir, bu da iki ucu keskin bir kılıçtır. Ancak resmi araç harika bir güvenlik ağı sağlar: Worktree.

Git Worktree: İzole Edilmiş Çalışma Alanları

1# İzole bir worktree'de Claude'u başlat
2claude --worktree feature-auth
3claude --worktree bugfix-123
4
5# Otomatik olarak bir ad oluştur
6claude --worktree

Worktree, .claude/worktrees/ altında bağımsız bir Git dalı kopyası oluşturur. Claude'un içeride yaptığı hiçbir şey ana dalınızı etkilemez. Çıkışta:

• Değişiklik yoksa → Otomatik temizlik
• Değişiklik varsa → Saklama veya silme seçeneği sunar

Bu, özellikle keşif görevleri için kullanışlıdır. Bir yeniden düzenleme planının işe yarayıp yaramayacağından emin değil misiniz? Bir worktree'de deneyin; başarısız olursa, sıfır riskle atın.

Birkaç Git Demir Yasası

1. Claude Code'un asla otomatik push yapmasına izin vermeyin

Commit yapabilir, ancak push işlemi sizin tarafınızdan onaylanmalıdır. Uzak depoya bir kez pushlandığında, geri alma maliyeti önemli ölçüde artar.

2. Sık sık commit yapın

Küçük bir özelliği bitirdikten sonra commit yapın. Commit kayıtlarınız olduğu sürece herhangi bir kontrol noktasına geri dönmek için /rewind kullanın.

3. Yıkıcı işlemlere dikkat edin

Claude Code git reset --hard, git push --force veya rm -rf yürütmek istiyorsa, onaylamadan önce sonuçlarını düşünün. Bu işlemlerin geri alması yoktur. Ayrıca bu komutları izin kurallarında reddedebilirsiniz.

4. Bir PR'den bağlamı geri yükleyin

Bu, PR değişikliklerini ve tartışmalarını otomatik olarak bağlam olarak yükler; kod incelemeleri veya başkasının işine devam etmek için mükemmeldir.

1claude --from-pr 123

9. Kısayollar ve Komut Referansı

Bu kısayolları her gün kullanıyorum; ezberlemenizi şiddetle tavsiye ederim:

En Yaygın Kısayollar

En Yaygın Eğik Çizgi Komutları

1/compact [odak]     # Bağlamı sıkıştır, odak belirtilebilir
2/clear              # Sohbeti temizle, yeniden başla
3/context            # Bağlam kullanımını görüntüle
4/memory             # Belleği görüntüle ve yönet
5/rewind             # Bir kontrol noktasına geri dön
6/resume [ad]        # Önceki bir sohbeti devam ettir
7/model              # Modelleri değiştir
8/effort [seviye]     # Akıl yürütme derinliğini ayarla: low/medium/high/max
9/init               # CLAUDE.md'yi otomatik oluştur
10/mcp                # MCP sunucularını yönet
11/permissions        # İzin kurallarını görüntüle
12/cost               # Token tüketimini görüntüle

/init özellikle yeni projeler için kullanışlıdır—kod tabanınızı otomatik olarak analiz eder ve bir taslak CLAUDE.md oluşturmaya yardımcı olur. Genellikle manuel ayar gerektirse de, sıfırdan başlamaktan çok daha hızlıdır.

10. GENİŞLETİLMİŞ DÜŞÜNME: Claude'un Daha Derin Düşünmesini Sağlayın

Karmaşık sorunlar için, Claude'un yanıtlamadan önce daha fazla zaman harcamasına izin veren Genişletilmiş Düşünme modunu etkinleştirebilirsiniz.

Nasıl Kullanılır

1# Kısayol geçişi
2Option+T (Mac) / Alt+T (Windows/Linux)
3
4# Veya komutla
5/effort high    # Daha derin akıl yürütme
6/effort max     # Maksimum akıl yürütme derinliği
7/effort low     # Basit görevler, token tasarrufu sağlar

Ne Zaman Kullanılır

• Karmaşık mimari kararlar
• Zor hata ayıklama (elenmesi gereken birden çok olası neden)
• Çok adımlı yeniden düzenleme tasarımı
• Birden çok çözümün artılarını ve eksilerini tartma

Ne Zaman Kullanılmaz

• Basit kod değişiklikleri
• Biçimlendirme, yeniden adlandırma
• Zaten net olan hata düzeltmeleri

İpucu: Promptta "ultrathink" yazmak, effort ayarlarını manuel olarak değiştirmeden en yüksek akıl yürütme derinliğini zorlayabilir.

11. MCP SUNUCUSU: Claude'u Dış Dünyaya Bağlayın

MCP (Model Context Protocol), Claude Code'un harici araçlarla (GitHub, veritabanları, Slack, Notion vb.) iletişim kurmasını sağlar.

Hızlı Ekleme

1claude mcp add github -- npx @anthropic-ai/mcp-server-github
2claude mcp add postgres -- npx @anthropic-ai/mcp-server-postgres postgresql://localhost:5432/mydb

Yapılandırma Dosyası

MCP, .mcp.json içinde yapılandırılır:

1{
2  "mcpServers": {
3    "github": {
4      "type": "stdio",
5      "command": "npx",
6      "args": ["@modelcontextprotocol/server-github"],
7      "env": {
8        "GITHUB_TOKEN": "$GITHUB_TOKEN"
9      }
10    }
11  }
12}

Bağlam Yükünü Not Edin

Her MCP sunucusu, araç tanımları için fazladan 100-500+ token tüketir. Her sunucunun yükünü kontrol etmek için /mcp komutunu kullanın ve kullanılmayanları devre dışı bırakın.

Benim deneyimim: Açgözlü olmayın. 2-3 yaygın kullanılan MCP sunucusu yeterlidir. Çok fazla kurmak, araç tanımlarıyla bağlam alanını tüketir ve bu da kod analizi kalitesini düşürebilir.

12. IDE ENTEGRASYONU: Terminalden Daha Fazlası

VS Code

Claude Code uzantısını yükledikten sonra, terminale geçmeden doğrudan VS Code'da Claude'u kullanabilirsiniz.

Kullanışlı özellikler:

• Yan yana diff görünümü: Claude'un değişiklikleri diff olarak gösterilir, tek bakışta net
• Option+K / Alt+K: Geçerli dosyaya @referansları hızlıca ekleyin
• Çok sekmeli sohbetler: Farklı sekmelerde birden çok bağımsız sohbet açın
• Cmd+Shift+Esc: Hızlıca yeni bir sohbet sekmesi açın

JetBrains

IntelliJ, PyCharm, WebStorm ve diğer JetBrains IDE'leri de bir Claude Code eklentisine sahiptir. Plugins pazarında "Claude Code" arayarak yükleyin.

13. Kodu İnceleme: Güven Ama Doğrula

Claude Code'un kod kalitesi genellikle iyidir, ancak körü körüne güvenmemelisiniz.

Yaygın Sorunlar

1. Aşırı mühendislik

Basit bir yardımcı fonksiyon istersiniz, size jenerikler, arayüzler ve fabrika desenleriyle dolu tam bir soyutlama katmanı verir. Sineği öldürmek için balyoz kullanmak gibi.

Çözüm: CLAUDE.md'ye "basit çözümleri önceliklendir" yazın veya talimatta açıkça "soyutlamaya gerek yok" deyin.

2. Hayal edilmiş API'ler

Bazen var olmayan API'ler veya eski sözdizimi kullanır, özellikle niş kütüphanelerin yeni sürümleri için.

Çözüm: Testleri çalıştırın. Bu nedenle talimatlar doğrulama standartları içermelidir.

3. Kapsam genişlemesi

Bir fonksiyonu değiştirmesini istersiniz, tüm dosyayı yeniden düzenler.

Çözüm: Açıkça "sadece X'i değiştir, diğer koda dokunma" deyin. Veya düzenleme kapsamını belirli dizinlerle sınırlamak için /freeze komutunu kullanın.

Yazar/İnceleyici Modu

Resmi olarak önerilen gelişmiş bir mod: "Yazar" ve "İnceleyici" rollerini oynamak için iki bağımsız oturum kullanın.

İki oturumun bağımsız bağlamları vardır; İnceleyici, Yazar'ın mantığından etkilenmez ve kör noktaları bulabilir.

1Oturum A (Yazar): "API hız sınırlama middleware'ini uygula"
2Oturum B (İnceleyici): "@src/middleware/rateLimiter.ts'deki hız sınırlama uygulamasını incele, 
3                     özellikle uç durumlar, yarış koşulları ve tutarlılığa odaklan"
4Oturum A: "İnceleme geri bildirimini düzelt: [B'nin çıktısını yapıştır]"

14. Claude Code ile YAPILMAMASI Gerekenler

"Ne yapılmalı" hakkında çok şey söyledik, şimdi "ne yapılmamalı"dan bahsedelim.

1. Hiç anlamadığınız şeyleri yapmasına izin vermeyin

Kubernetes hakkında hiçbir şey bilmiyorsanız, Claude Code'un sizin için doğrudan kullanacağınız dağıtım yapılandırmaları yazmasına izin vermeyin. Anlamadığınız bir şeyi inceleyemezsiniz.

2. Sürüm kontrolü olmayan ortamlarda kullanmayın

Git yoksa geri alma yeteneği de yoktur. Claude Code'un değişiklikleri dosyalarınızın üzerine yazabilir; sürüm kontrolü olmadan kullanmak, filesiz bir ip cambazı gibidir.

3. Büyük bir görevi birden ona atmayın

"Tüm projeyi JavaScript'ten TypeScript'e taşı"

Bu talimat, Claude Code'a tam serbestlik verir ve sonucu kontrol edilemez hale getirir. Küçük adımlara bölün ve bir sonrakine geçmeden önce her adımı onaylayın.

4. İlk denemede mükemmellik beklemeyin

Yineleme normaldir. Geri dönmek için /rewind kullanın ve "neyin yanlış olduğunu" tanımlamak için hassas geri bildirim kullanın.

Özet

Claude Code'u kullanmanın temel felsefesi basittir:

Son derece yetenekli bir işbirlikçidir, ancak bir otopilot değildir. Direksiyon her zaman sizin elinizdedir.

Önem sırasına göre tavsiyelerim:

1. CLAUDE.md’yi iyi yazın — Bir kez yatırım yapın, her konuşmada faydasını görün
2. Kesin talimatlar verin — Hedef + Kısıtlamalar + Doğrulama standartları
3. Plan Modu’nu kullanın — Önce planlayın, karmaşık görevlerde sonra harekete geçin
4. Bağlamı yönetin — /clear, /compact, Alt Ajanlar
5. İzinleri kontrol edin — Tehlikeli işlemleri reddedin, yaygın komutlara izin verin
6. Sık sık commit yapın — Geri alma yeteneğini koruyun

Bunları yaparsanız, Claude Code verimliliğinizi birkaç kata kadar artırabilir. Yapmazsanız, sadece kaosu daha hızlı yaratmanıza yardımcı olur.

Bir aracın değeri her zaman onu kullanan kişiye bağlıdır.

Yukarıdakiler, Claude Code resmi dokümantasyonu ve pratik deneyimin bir birleşimidir. Daha iyi uygulamalarınız varsa, paylaşmaktan çekinmeyin.