Claude Code Nasıl Kullanılır?
Claude Code’u temel düzeyde kullanmak için izlenebilecek en pratik akış şöyledir:
- Üzerinde çalışacağınız projenin kök klasörüne gidin.
- Claude Code oturumunu başlatın.
- Yapmak istediğiniz görevi açık ve ölçülebilir şekilde tarif edin.
- Gerekirse ilgili dosya veya klasörleri @ ile referans gösterin.
- Büyük veya riskli değişikliklerde önce plan mode kullanın.
- Claude’un yaptığı değişiklikleri test, build veya diff üzerinden kontrol edin.
- Son kodu mutlaka geliştirici gözüyle inceleyin.
Örneğin terminalde temel başlangıç akışı şu şekildedir:
cd /path/to/project
claude
Bu komutla Claude Code, ilgili proje klasöründe oturum başlatır. Bundan sonra doğal dille görev verebilirsiniz:
Bu kod tabanının genel yapısını açıkla.
Ya da daha hedefli bir görev isteyebilirsiniz:
src/auth klasöründeki oturum yenileme akışını incele. Hata risklerini çıkar ve değişiklik yapmadan önce çözüm planı öner.
Bu yaklaşım, Claude Code’u kontrolsüz şekilde kod yazdırmak yerine, geliştiricinin yönettiği bir yardımcı gibi kullanmanızı sağlar.
Claude Code Kullanımına Başlamadan Önce Bilinmesi Gerekenler
Claude Code, klasik bir sohbet botu gibi yalnızca cevap üretmez. Çalıştığı proje dizinindeki dosyaları okuyabilir, komut çalıştırabilir, kod üzerinde değişiklik yapabilir ve yaptığı işi test veya çıktı kontrolleriyle doğrulamaya çalışabilir.
Bu nedenle kullanımda üç temel nokta önemlidir:
Görev net olmalıdır.
“Bu hatayı düzelt” gibi geniş bir ifade yerine, hatanın nerede görüldüğü, nasıl tekrarlandığı ve başarılı sonucun ne olduğu belirtilmelidir.
Doğrulama kriteri verilmelidir.
Claude Code test çalıştırabiliyor, build alabiliyor veya komut çıktısını yorumlayabiliyorsa daha güvenilir sonuç üretir. Resmi best practices dokümanlarında da Claude’a test, ekran görüntüsü veya beklenen çıktı gibi doğrulama imkânı vermenin en yüksek etkili pratiklerden biri olduğu vurgulanır.
İzinler bilinçli seçilmelidir.
Claude Code’un dosya düzenleme veya komut çalıştırma yetenekleri, seçilen permission mode’a göre değişir. Bu yüzden özellikle ilk kullanımda daha kontrollü modlarla başlamak daha sağlıklıdır.
Claude Code’u Proje Klasöründe Başlatma
Claude Code’u kullanırken en doğru başlangıç noktası, üzerinde çalışılacak projenin kök dizinidir. Çünkü Claude Code, çalıştığı dizindeki dosyaları ve proje yapısını bağlam olarak kullanır.
Temel akış:
cd /path/to/project
claude
Bu noktadan sonra Claude Code’a proje hakkında soru sorabilir, belirli dosyaları analiz ettirebilir veya geliştirme görevi verebilirsiniz. Örneğin yeni bir projeyi anlamak için şu komut kullanılabilir:
Bu kod tabanının genel mimarisini açıkla. Ana modüller neler ve uygulama hangi akışlarla çalışıyor?
Resmi common workflows dokümanında da yeni bir kod tabanını anlamak için önce proje kök dizinine gidilmesi, Claude Code’un başlatılması ve yüksek seviyeli bir genel bakış istenmesi önerilir.
İlk Görev Nasıl Verilir?
Claude Code’a görev verirken amaç yalnızca ne istediğinizi söylemek değil, Claude’un doğru bağlamda çalışmasını sağlamaktır. İyi bir görev tanımı şu üç unsuru içerir:
- Ne yapılacak?
- Hangi dosya, modül veya davranışla ilgili?
- Sonucun doğru olduğu nasıl anlaşılacak?
Zayıf bir prompt örneği:
Login hatasını düzelt.
Daha iyi bir prompt:
Kullanıcılar oturum süresi dolduktan sonra tekrar giriş yaparken hata alıyor. Auth akışını src/auth klasöründe incele. Önce olası nedeni açıkla, sonra çözüm planı öner. Değişiklikten sonra ilgili testleri çalıştır.
Bu ikinci örnek daha güçlüdür çünkü Claude Code’a bağlam, hedef ve doğrulama yöntemi verir.
Yeni bir özellik için de benzer yaklaşım kullanılabilir:
Profil sayfasına kullanıcı tercihleri bölümü eklemek istiyorum. Önce mevcut profil bileşenlerini incele, kullanılan pattern’leri çıkar ve dosya değiştirmeden önce uygulama planı hazırla.
Bu tarz prompt’lar Claude Code’un doğrudan rastgele değişiklik yapmasını engeller ve önce projeyi anlamasını sağlar.
Dosya ve Klasörler Claude Code’a Nasıl Gösterilir?
Claude Code’da belirli dosya veya klasörleri konuşmaya dahil etmek için @ referansları kullanılabilir. Bu özellik, Claude’un hangi kaynağa bakması gerektiğini netleştirir ve özellikle büyük projelerde gereksiz dosya keşfini azaltır.
Tek dosya referansı:
@src/utils/auth.js dosyasındaki login doğrulama mantığını açıkla.
Klasör referansı:
@src/components klasörünün yapısını özetle.
Birden fazla dosya karşılaştırması:
@src/auth.ts ve @src/session.ts dosyalarını karşılaştır. Oturum yenileme akışında hangi sorumluluklar hangi dosyada?
Bu yöntem, Claude Code’a “şuraya bak” demenin en pratik yollarından biridir. Özellikle hata ayıklama, refactor, test yazımı ve kod inceleme işlerinde dosya referansı kullanmak sonucu belirgin şekilde iyileştirir.
Plan Mode ile Değişiklikleri Önceden İnceleme
Plan mode, Claude Code’un dosya değiştirmeden önce araştırma yapıp uygulama planı çıkarmasını sağlar. Bu modda Claude dosyaları okuyabilir, proje yapısını inceleyebilir ve öneri sunabilir; ancak kullanıcı onay vermeden kaynak dosyalarda değişiklik yapmaz.
CLI’da plan mode ile başlamak için:
claude --permission-mode plan
Plan mode özellikle şu durumlarda tercih edilmelidir:
- Değişiklik birden fazla dosyayı etkileyecekse
- Kod tabanı size yabancıysa
- Refactor riski yüksekse
- Mimari karar gerekiyorsa
- Önce yaklaşımı görmek istiyorsanız
Örnek prompt:
Ödeme akışına yeni bir doğrulama adımı eklemek istiyorum. Önce ilgili dosyaları incele, hangi dosyaların değişmesi gerektiğini çıkar ve riskleriyle birlikte uygulama planı öner. Henüz dosya değiştirme.
Plan mode küçük yazım hataları veya tek satırlık düzenlemeler için gereksiz yavaşlatıcı olabilir. Ancak kapsamı belirsiz veya riskli işlerde, Claude Code’u daha güvenli kullanmanın en iyi yollarından biridir.
Permission Modes: Hangi İzin Modu Ne Zaman Kullanılır?
Claude Code’un nasıl davranacağını belirleyen en önemli ayarlardan biri permission modes, yani izin modlarıdır. Bu modlar, Claude’un dosya düzenleme, komut çalıştırma veya ağ isteği gibi işlemlerde ne zaman kullanıcı onayı isteyeceğini belirler.
Default Mode
Yeni başlayanlar ve hassas işler için en güvenli başlangıç modudur. Claude okuma işlemleriyle ilerleyebilir, fakat dosya düzenleme veya komut çalıştırma gibi eylemler için onay ister.
Ne zaman kullanılmalı?
İlk kullanımda, üretime yakın projelerde veya Claude’un her aksiyonunu görmek istediğiniz durumlarda.
AcceptEdits Mode
Claude’un dosya düzenlemelerini daha az kesintiyle yapmasına izin verir. Geliştirici değişiklikleri tek tek onaylamak yerine sonrasında diff veya editör üzerinden inceleyebilir.
Ne zaman kullanılmalı?
Kod üzerinde hızlı iterasyon yaparken, ancak değişiklikleri sonradan dikkatle inceleyeceğiniz durumlarda.
Plan Mode
Claude’un önce araştırma ve planlama yapmasını sağlar. Kaynak dosyalar, siz onay vermeden değiştirilmez.
Ne zaman kullanılmalı?
Büyük refactor, yeni özellik, karmaşık hata çözümü veya bilmediğiniz kod tabanlarında.
Auto Mode
Daha uzun görevlerde onay yorgunluğunu azaltmak için tasarlanmıştır. Bazı işlemler arka plandaki güvenlik kontrolleriyle değerlendirilir. Ancak resmi dokümanda auto mode’un güvenliği garanti etmediği ve hassas işlemlerde insan denetiminin yerini tutmadığı belirtilir.
Ne zaman kullanılmalı?
Yönünden emin olduğunuz, fakat çok sayıda küçük aksiyon gerektiren işlerde.
DontAsk Mode
Yalnızca önceden izin verilmiş araçların çalışmasına izin verir; diğer işlemleri sormadan reddeder.
Ne zaman kullanılmalı?
CI, script veya kısıtlı otomasyon senaryolarında.
BypassPermissions Mode
İzin kontrollerini büyük ölçüde devre dışı bırakır. Dokümanda bu modun yalnızca izole container, VM veya güvenli dev ortamlarında kullanılması gerektiği vurgulanır.
Ne zaman kullanılmalı?
Normal geliştirme ortamında önerilmez. Yalnızca izole ve geri döndürülebilir ortamlarda düşünülmelidir.
CLAUDE.md ile Proje Kurallarını Tanıtma
Claude Code’un daha tutarlı çalışması için en önemli yapılardan biri CLAUDE.md dosyasıdır. Bu dosya, Claude’un her oturum başında okuduğu proje talimatlarını içerir. Build komutları, test komutları, kodlama standartları, mimari kararlar ve ekip kuralları bu dosyaya yazılabilir.
Örnek CLAUDE.md:
# Proje Kuralları
## Komutlar
- Test: npm test
- Lint: npm run lint
- Build: npm run build
## Kod Stili
- TypeScript strict mode kullanılmalı.
- Default export yerine named export tercih edilmeli.
- Yeni özelliklerde ilgili test dosyası da güncellenmeli.
## İş Akışı
- Büyük değişikliklerden önce plan çıkar.
- Kod değişikliğinden sonra ilgili testleri çalıştır.
Claude Code dokümanında CLAUDE.md talimatlarının bağlam olarak çalıştığı, yani katı bir güvenlik kuralı gibi zorlayıcı olmadığı belirtilir. Bu nedenle dosya kısa, net ve çelişkisiz olmalıdır. Dokümanlarda CLAUDE.md için 200 satırın altında kalmanın hedeflenmesi ve talimatların somut yazılması önerilir.
Yeni projelerde /init komutu başlangıç CLAUDE.md dosyası oluşturmak veya mevcut dosyada iyileştirme önermek için kullanılabilir.
Auto Memory ve /memory Ne İşe Yarar?
Claude Code’da CLAUDE.md dışında auto memory yapısı da bulunur. Auto memory, Claude’un önceki oturumlardan öğrendiği bazı bilgileri kendi notları olarak saklamasına yardımcı olur. Bunlar build komutları, hata ayıklama notları, proje alışkanlıkları veya kullanıcının tekrar eden tercihleri olabilir.
/memory komutu ise mevcut oturumda hangi CLAUDE.md, CLAUDE.local.md ve rules dosyalarının yüklendiğini görmeyi sağlar. Ayrıca auto memory ayarlarını incelemek ve bellek dosyalarına erişmek için kullanılabilir.
Pratikte şöyle düşünmek daha doğru olur:
- Ekip standardı olan kurallar CLAUDE.md içinde tutulmalı.
- Claude’un zamanla öğrendiği yardımcı notlar auto memory’de kalabilir.
- Kritik veya değişmez kurallar yalnızca auto memory’ye bırakılmamalıdır.
Claude Code ile En Yaygın Kullanım Senaryoları
Claude Code günlük yazılım geliştirme işlerinde birçok farklı amaçla kullanılabilir. Resmi common workflows dokümanı; kod tabanı keşfi, hata düzeltme, refactor, test yazma, PR hazırlama ve dokümantasyon gibi iş akışlarını öne çıkarır.
Kod Tabanını Anlamak
Yeni bir projeye başlarken Claude Code’dan genel bir mimari özet istenebilir:
Bu kod tabanının genel yapısını açıkla. Ana modüller neler ve uygulama hangi akışlarla çalışıyor?
Daha sonra soru daraltılabilir:
Kimlik doğrulama akışı nasıl çalışıyor? Frontend’den veritabanına kadar süreci takip et.
Bu yöntem, yeni geliştiricilerin projeye daha hızlı adapte olmasına yardımcı olabilir.
Hata Düzeltmek
Hata çözümünde Claude’a yalnızca hatayı söylemek yerine, tekrar üretme adımlarını ve beklenen sonucu vermek daha iyi sonuç üretir:
npm test çalıştırınca auth.test.ts dosyasında token refresh hatası alıyorum. Hatanın kaynağını bul, önce çözüm seçeneklerini açıkla, sonra en güvenli çözümü uygula ve ilgili testi tekrar çalıştır.
Bu prompt, Claude Code’un hem araştırma hem uygulama hem de doğrulama yapmasını sağlar.
Refactor Yapmak
Refactor isteğinde davranışın korunması gerektiği açıkça belirtilmelidir:
utils.js dosyasını modern JavaScript özellikleriyle refactor et. Mevcut davranışı değiştirme. Değişiklikten sonra ilgili testleri çalıştır.
Büyük refactor’larda önce plan mode kullanmak daha güvenlidir.
Test Yazmak
Claude Code mevcut test yapısını inceleyerek proje stiline uygun testler yazabilir:
NotificationsService içinde test kapsamı olmayan fonksiyonları bul. Mevcut test stilini incele ve eksik senaryolar için test ekle.
Daha iyi sonuç için hangi davranışın test edileceği de belirtilmelidir:
Kullanıcı çıkış yapmışken bildirim gönderilmemesi gereken senaryo için test ekle. Mevcut test framework’ünü ve assertion stilini takip et.
Pull Request Hazırlamak
Claude Code, yapılan değişiklikleri özetlemek ve PR açıklaması hazırlamak için kullanılabilir:
Auth modülünde yaptığım değişiklikleri özetle. Riskleri, test edilen senaryoları ve geriye dönük uyumluluk notlarını da ekle.
Ardından:
Bu değişiklikler için açıklayıcı bir PR açıklaması hazırla.
PR açıklaması Claude tarafından oluşturulsa bile son diff, test sonucu ve açıklama geliştirici tarafından incelenmelidir.
Dokümantasyon Güncellemek
Claude Code kod dışı dokümantasyon dosyalarında da çalışabilir:
Auth modülündeki public fonksiyonlar için eksik JSDoc açıklamalarını bul ve mevcut dokümantasyon stiline uygun şekilde tamamla.
Hedef kitle belirtmek kaliteyi artırır:
Bu açıklamaları yeni katılan bir backend geliştiricinin anlayacağı sadelikte yaz.
Claude Code Kullanırken En İyi Pratikler
Claude Code’dan yüksek verim almak için bazı çalışma alışkanlıkları önemlidir.
Önce keşfet, sonra planla, sonra uygula.
Özellikle kapsamı belirsiz işlerde Claude’un doğrudan kod yazmasını istemek yerine önce ilgili dosyaları incelemesini ve plan çıkarmasını isteyin. Resmi best practices dokümanında da bu yaklaşım, yanlış problemi çözme riskini azaltan önemli bir pratik olarak sunulur.
Başarı kriteri verin.
Test geçmeli, build başarılı olmalı, mevcut davranış değişmemeli veya yalnızca belirli klasörde değişiklik yapılmalı gibi kriterleri açık yazın.
Mevcut örnekleri gösterin.
Yeni component, endpoint veya test yazdırırken projedeki benzer dosyaları @ ile referans verin.
Değişiklikleri mutlaka inceleyin.
Claude Code kod yazabilir, test çalıştırabilir ve çıktı yorumlayabilir. Fakat güvenlik, performans, mimari uyum ve iş mantığı açısından son değerlendirme geliştiriciye aittir.
CLAUDE.md dosyasını kısa tutun.
Claude’un her oturumda bilmesi gereken proje kurallarını yazın; uzun eğitim notları, genel temiz kod tavsiyeleri veya dosya dosya proje açıklamaları eklemeyin.
İlgisiz görevler arasında bağlamı temizleyin.
Uzun oturumlarda bağlam penceresi gereksiz dosya içerikleri ve komut çıktılarıyla dolabilir. Farklı görevlere geçerken /clear kullanmak daha temiz sonuç verir.
Yaygın Hatalar ve Kaçınma Yolları
Claude Code kullanırken yapılan hataların çoğu aracın kendisinden değil, yanlış çalışma biçiminden kaynaklanır.
Çok genel görev vermek
“Bu projeyi iyileştir” veya “hataları düzelt” gibi geniş görevler Claude’u gereksiz keşfe iter.
Daha iyi yaklaşım:
Görevi dosya, modül, hata veya beklenen davranış düzeyinde daraltın.
Doğrulama kriteri vermemek
Claude’un yaptığı işin doğru olup olmadığını anlaması için test, çıktı veya kabul kriteri gerekir.
Daha iyi yaklaşım:
“Değişiklikten sonra npm test çalıştır” veya “bu senaryo artık hata vermemeli” gibi net kriterler yazın.
Tek oturumda çok fazla farklı iş yapmak
Aynı oturumda hata düzeltme, refactor, dokümantasyon ve PR açıklaması gibi ilgisiz işler birikirse bağlam dağılır.
Daha iyi yaklaşım:
İlgisiz görevler arasında /clear kullanın.
CLAUDE.md dosyasını gereksiz uzatmak
Çok uzun veya çelişkili talimat dosyaları Claude’un önemli kuralları kaçırmasına neden olabilir.
Daha iyi yaklaşım:
CLAUDE.md dosyasını kısa, somut ve proje özelinde tutun.
İzin modlarını dikkate almamak
Auto veya bypassPermissions gibi modları yanlış ortamda kullanmak risklidir.
Daha iyi yaklaşım:
İlk kullanımda default veya plan mode ile başlayın; daha serbest modları yalnızca riskleri anladığınızda kullanın.
Sonuç: Claude Code’u Verimli Kullanmanın Anahtarı
Claude Code, doğru kullanıldığında yazılım geliştirme sürecini ciddi biçimde hızlandırabilir. Kod tabanını anlamaya, hata gidermeye, refactor yapmaya, test yazmaya, dokümantasyon güncellemeye ve PR hazırlamaya yardımcı olur.
Ancak Claude Code’dan iyi sonuç almak için araca yalnızca görev vermek yeterli değildir. Proje bağlamını doğru kurmak, CLAUDE.md dosyasını sade tutmak, permission modes mantığını anlamak, plan mode’u yerinde kullanmak, doğrulama kriterleri vermek ve değişiklikleri mutlaka incelemek gerekir.
En sağlıklı yaklaşım, Claude Code’u kontrolsüz bir otomasyon aracı gibi değil; geliştiricinin yönettiği, denetlenebilir ve üretken bir kodlama ajanı gibi kullanmaktır.
