Claude Code Nasıl Kullanılır? Gerçek Projeden Rehber

Claude Code nasıl kullanılır sorusunun kısa cevabı şu: projenizin klasöründe terminali açıp claude yazarsınız, gerisini sohbetle yönetirsiniz. Claude Code, Anthropic'in kod tabanınızı okuyan, dosyaları düzenleyen ve komut çalıştıran yapay zekâ aracıdır. Bu rehberi, bu siteyi ve portalını geliştirirken edindiğimiz gerçek deneyimle yazdık.

Kısaca:

Kurulum tek komut; ardından proje klasöründe claude yazıp giriş yapıyorsunuz.

CLAUDE.md dosyası projenin kurallarını her oturumda hatırlatır; /init ilk sürümünü yazar.

İzin modları neyin sorulmadan yapılacağını belirler; terminalde Shift+Tab ile değişir.

En iyi sonuç işi doğrulatarak alınır: derleme, test ve önizleme.

Claude Code nedir?

Claude Code, Anthropic'in ajan tipinde çalışan kodlama aracıdır. Kod tabanınızı okur, dosyaları düzenler, komut çalıştırır ve geliştirme araçlarınızla birlikte çalışır (Claude Code dokümantasyonu). Terminalde, VS Code ve JetBrains eklentilerinde, masaüstü uygulamasında ve tarayıcıda kullanılabilir.

Klasik kod tamamlama araçlarından farkı, tek satır önermek yerine işi baştan sona üstlenebilmesidir. "Şu hatayı bul ve düzelt" dediğinizde ilgili dosyaları kendisi bulur, değişikliği yapar ve testleri çalıştırır. Siz de her adımı görür, onaylar ya da yön verirsiniz.

Claude Code nasıl kurulur?

Kurulum tek komutla yapılıyor. macOS, Linux ve WSL için:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell için:

irm https://claude.ai/install.ps1 | iex

Kurulumdan sonra proje klasörünüze geçip claude yazmanız yeterli. İlk açılışta giriş yapmanız istenir. Çoğu kullanım için bir Claude aboneliği ya da Anthropic Console hesabı gerekiyor.

Projeyi Claude Code'a nasıl tanıtırız?

Her oturum boş bir bağlamla başlar. Projenin kurallarını her seferinde anlatmamak için CLAUDE.md dosyası kullanılır. Bu dosyaya derleme ve test komutlarını, kod kurallarını ve mimari kararları yazarsınız; Claude Code her oturumun başında okur (hafıza dokümantasyonu).

İlk sürümü elle yazmanız gerekmiyor. /init komutu kod tabanını inceleyip bulduğu komut ve kurallarla bir CLAUDE.md oluşturur. Dosya zaten varsa üzerine yazmaz, iyileştirme önerir. Claude Code ayrıca düzeltmelerinizden kendi notlarını tutar; buna otomatik hafıza deniyor.

Bizim deneyimimizde en işe yarayan notlar, kodda görünmeyen bilgiler oldu. "Veri düzeltmeleri sunucuda değil, portal üzerinden yapılır" ya da "commit mesajlarına şu satırı ekleme" gibi kurallar, aynı hatanın ikinci kez yapılmasını önlüyor.

Gerçek bir görev nasıl veriliyor?

Bu sitenin kaynak kodu Angular (sunucu tarafında render), Spring Boot ve PostgreSQL üzerine kurulu. Proje 11 Eylül 2026'da başladı. O günden bu yana depoya 150'ye yakın commit girdi ve günlük geliştirmeyi Claude Code ile yapıyoruz.

Bir örnek: Search Console'da ABD'den bir günde 191 gösterim ama sıfır tıklama gördük. Claude Code'a tek cümleyle "bunu analiz et" dedik. Tarayıcıda Search Console verisini okudu, canlı sayfaların HTML'ini ve schema kayıtlarını inceledi, öncelik sıralı bir liste çıkardı.

Analiz, gösterimlerin yüzde 95'inin masaüstünden geldiğini ve bir kısmının otomatik sorgulara benzediğini gösterdi. Listeden seçtiğimiz dört maddeyi (yazar sayfası, şirket bilgisi, hreflang ayarı ve IndexNow) aynı oturumda uyguladı. Her değişiklikten sonra frontend'i derledi, backend testlerini çalıştırdı ve sonucu yerel önizlemede kontrol etti. Commit ve push'tan sonra GitHub Actions siteyi 3-4 dakikada yayına aldı.

İzin modları neden önemli?

Claude Code, izin modlarıyla neyi sormadan yapabileceğini belirler. Manuel modda dosya düzenlemeden ve komut çalıştırmadan önce onay ister. Plan modu, değişiklik yapmadan önce kodu incelemek içindir. Otomatik modda ise eylemleri sizin yerinize ayrı bir güvenlik denetimi gözden geçirir.

Modlar arasında terminalde Shift+Tab ile geçilir (izin modları). Biz bazı sınırları moddan bağımsız tutuyoruz. Şifreleri Claude Code girmiyor; Search Console ve portal girişlerini kendimiz yapıyoruz. Canlı sunucuya doğrudan erişim de vermiyoruz: sunucuda çalışması gereken komutları hazırlıyor, biz çalıştırıyoruz.

Hatalar nasıl yakalanır?

Claude Code da hata yapar; önemli olan hatanın yayına çıkmadan yakalanması. Aynı oturumda eklediği bir SEO kontrolü, .com uzantılı Türk sitelerini yabancı kaynak sayıyordu. Bir yazı taslağını incelerken bunu kendisi fark etti, düzeltti ve test ederek doğruladı.

Tersi de oldu: kodu okurken, İngilizce yazıların adresinin her çeviride değiştiği eski bir hatayı buldu. Değişen adres, Google'da indekslenmiş sayfaları 404'e düşürebilirdi. İki örnekte de işe yarayan şey aynıydı: işi doğrulatmak ve değişikliği okumak.

Claude Code nasıl kullanılır: pratik öneriler

Görevi beklediğiniz sonuçla tarif edin: "ABD'de tıklama neden yok, analiz et" gibi.
Büyük işlerde önce plan isteyin ve hangi dosyalara dokunacağını görün.
"Derle, testleri çalıştır, önizlemede kontrol et" adımını görevin parçası yapın.
Tekrar eden düzeltmeleri CLAUDE.md dosyasına yazın.
API kullanan otomasyonların maliyetini izleyin. Blogumuzdaki otomatik çeviri her düzenlemede ücretli istek atıyordu; onu isteğe bağlı hale getirdik.

Sıkça sorulan sorular

Claude Code ücretsiz mi?

Genellikle hayır. Çoğu kullanım için bir Claude aboneliği ya da kullandıkça ödenen bir Anthropic Console hesabı gerekiyor. Güncel seçenekler resmi dokümantasyonda yer alıyor.

Claude Code hangi ortamlarda çalışır?

Terminalde, VS Code ve JetBrains eklentilerinde, masaüstü uygulamasında ve tarayıcıda çalışır. Hepsi aynı motoru kullanır; CLAUDE.md dosyaları ve ayarlar her ortamda geçerlidir.

CLAUDE.md dosyasına ne yazılmalı?

Derleme ve test komutları, kod kuralları, proje yapısı ve "her zaman şunu yap" türünden kurallar. Tek bir işe özel uzun prosedürler için dokümantasyon ayrı mekanizmalar öneriyor.

Claude Code kodu kendi başına yayına alabilir mi?

İzin verirseniz commit ve push yapabilir. Biz yayına alma adımını onaya bağlı tutuyor, canlı sunucuya erişim vermiyoruz.

Claude Code nasıl kullanılır sorusunun asıl cevabı pratikte ortaya çıkıyor: net bir görev, iyi bir CLAUDE.md ve her adımda doğrulama. Claude'un bulut oturumlarında kullanılan krediler için Claude Session Credit rehberimize göz atabilirsiniz. Kendi projenizde benzer bir geliştirme akışı kurmak isterseniz web uygulama geliştirme sayfamızdan bize ulaşabilirsiniz.