Claude Code ile Terminalde Yapay Zekâ Destekli Geliştirme: İlk Adımlar

Claude Code nedir?

Claude Code, Anthropic'in terminalde çalışan ajan tabanlı kodlama aracıdır. Sohbet penceresine kod yapıştırmak yerine Claude'u doğrudan proje klasörünüzde çalıştırırsınız: Claude dosyaları okur, değişiklik önerir, sizin izninizle düzenler, test ve derleme komutlarını çalıştırır. VS Code ve JetBrains editörleri için eklentileri de vardır; bu derste terminal üzerinden ilerliyoruz.

Bu derste şunları öğreneceksiniz:

• Claude Code'u kurup bir projede başlatmak
• Projenizi CLAUDE.md dosyasıyla tanıtmak
• İlk görevi küçük ve doğrulanabilir biçimde vermek
• İzinler ve Git ile güvenli çalışmak

Kurulum

Claude Code, Node.js yüklü bir bilgisayarda npm ile kurulabilir. Kurulumdan sonra proje klasörünüze geçip claude komutunu çalıştırmanız yeterlidir:

npm install -g @anthropic-ai/claude-code
cd ~/projeler/fatura-uygulamasi
claude

İlk açılışta tarayıcı üzerinden Claude hesabınızla (abonelik ya da API hesabı) giriş yapmanız istenir. Kurulum yöntemleri zamanla güncellenebildiği için takıldığınızda Anthropic'in resmî Claude Code belgelerindeki güncel komutu kullanın.

Projenizi tanıtın: CLAUDE.md

Claude her oturuma projenizi tanımadan başlar. Proje kökündeki CLAUDE.md dosyası her oturumda okunur ve kalıcı bir "proje notu" görevi görür. Oturum içinde /init komutunu verdiğinizde Claude projeyi tarayıp bu dosyanın ilk taslağını kendisi hazırlar; siz de düzenlersiniz:

# Proje notları
- PHP 8.2 + MySQL; giriş noktası public/index.php
- Testleri çalıştırma: composer test
- Kod stili: PSR-12, açıklamalar Türkçe
- Veritabanı şemasını değiştirmeden önce migrations/ altına göç dosyası yaz
- .env ve config/secrets.php dosyalarını asla okuma ya da değiştirme

İyi bir CLAUDE.md kısa ve somuttur: hangi komutla test edileceği, hangi klasörün neye yaradığı ve dokunulmaması gereken yerler. Uzun ve genel cümleler yerine "şunu yap / şunu yapma" biçiminde maddeler yazın.

İlk görev: küçük ve doğrulanabilir

Claude Code'dan en iyi sonucu, sonucu ölçülebilen net görevlerle alırsınız. Örneğin:

src/Fatura.php içindeki toplam() metoduna KDV oranı parametresi ekle
(varsayılan %20). tests/FaturaTest.php dosyasına yeni oran için bir test yaz,
ardından composer test komutunu çalıştır ve sonucu özetle.

Claude önce ilgili dosyaları okur, yapacağı değişikliği anlatır ve dosya düzenlemeden ya da komut çalıştırmadan önce onayınızı ister. Büyük işlerde "önce bir plan yaz, onaylamadan kod değiştirme" demek, yanlış yöne giden değişiklikleri baştan önler.

İzinler ve güvenli çalışma

• Onayları okuyun: Claude bir dosyayı düzenlemek ya da komut çalıştırmak istediğinde ne yapacağını gösterir. Emin olmadığınız komutu onaylamayın.
• Git ile çalışın: Göreve başlamadan önce temiz bir commit'iniz olsun. Her adımdan sonra git diff ile değişikliği inceleyin; beğenmediğinizi kolayca geri alırsınız.
• Gizli bilgileri koruyun: API anahtarları, .env dosyaları ve müşteri verilerini oturuma yapıştırmayın; CLAUDE.md içinde bu dosyalara dokunulmamasını açıkça yazın.

Faydalı oturum komutları

• /help – kullanılabilir komutları listeler.
• /init – projeyi tarayıp CLAUDE.md taslağı hazırlar.
• /clear – konuşma geçmişini temizler; birbirinden bağımsız görevlere geçerken bağlamı sıfırlamak için kullanın.

İpuçları

• Görevleri parçalayın: "tüm projeyi düzenle" yerine "önce şu modülü, sonra testlerini".
• Hata çıktısını olduğu gibi verin; Claude hata mesajından ve yığın izinden (stack trace) çok şey çıkarır.
• Beğendiğiniz kalıpları CLAUDE.md'ye ekleyin; bir sonraki oturumda aynı açıklamayı tekrar yapmazsınız.

Sık yapılan hatalar

• Testi olmayan büyük değişiklikleri tek seferde istemek ve sonucu doğrulamadan kabul etmek.
• Bağımsız işleri aynı uzun oturumda sürdürüp eski bağlamın yeni görevi karıştırmasına izin vermek.
• Üretim sunucusunda doğrudan çalıştırmak; Claude Code'u yerel kopyanızda ya da bir dalda kullanın.

Özet

Claude Code, projenizi tanıyan ve sizin onayınızla değişiklik yapan bir eş geliştirici gibi çalışır. Kurulum, iyi yazılmış bir CLAUDE.md, küçük ve test edilebilir görevler ve Git disiplini bu akışın temelidir. Sonraki adım olarak kendi projenizde /init ile CLAUDE.md oluşturup küçük bir hata düzeltmesiyle başlayın.