Claude Code ile ilk iş

Claude Code, Claude'un terminalde çalışan hâli. Sohbet penceresinden farkı: dosyalarınızı kendisi okur, düzenler, komut çalıştırır. Biz FS Labs'te sitelerin yayınından video üretimine kadar işlerin çoğunu bununla yürütüyoruz. Bu rehber ilk kurulumdan ilk gerçek göreve kadar götürür.

1. Kurulum

Bilgisayarınızda Node.js 18 ya da üstü kurulu olmalı. Terminali açıp:

npm install -g @anthropic-ai/claude-code

Sonra çalışacağınız klasöre girip başlatın:

cd projem
claude

İlk açılışta tarayıcıda Claude hesabınızla giriş yapmanız istenir. Ücretli Claude planınız ya da API hesabınız olmalı. Güncel kurulum seçenekleri için resmî belgeye bakın.

2. Projeyi tanıtın: CLAUDE.md

Klasörün köküne CLAUDE.md adlı bir dosya koyun. Claude Code her oturumda bunu okur. İçine projeyi anlatan kısa kurallar yazın:

# Proje: fslabb.com
- Statik HTML site, build adımı yok.
- Dil: içerik Türkçe, commit mesajları Türkçe.
- Yayın: değişikliği test etmeden canlıya alma.

İlk kez başlıyorsanız Claude Code içinde /init yazın; projeyi tarayıp bir taslak CLAUDE.md hazırlar. Sonra kendiniz düzeltin.

3. İzinler: neye kendi karar versin?

Claude Code dosya düzenlemeden ya da komut çalıştırmadan önce izin ister. Başta her şeye siz onay verin, neyi nasıl yaptığını görün. Güven oluştukça sık kullandığınız güvenli komutlara (test çalıştırmak gibi) kalıcı izin verin. Geri alınamayan işler (silme, canlıya alma, para) için onayı hep elinizde tutun.

4. İlk gerçek görev

Küçük ama gerçek bir işle başlayın. Örnek:

iletisim sayfasındaki telefon numarasını +90 545 000 00 00 yap,
sitedeki tüm sayfalarda aynı numara geçiyorsa onları da güncelle,
sonunda hangi dosyaları değiştirdiğini listele.

Claude önce dosyaları arar, değişiklikleri gösterir, onayınızı alır. Bitince değişiklik listesini kontrol edin.

5. İyi alışkanlıklar

• Git kullanın. Her işten önce temiz bir commit; beğenmezseniz geri dönmek tek komut.
• Görevi tek cümleye sığdırmayın. Ne, nerede, nasıl kontrol edilecek: üçünü de yazın.
• Uzun oturumu bölün. Konuşma uzadıkça maliyet ve hata artar; iş bitince yeni oturum açın, devri bir dosyaya yazdırın.
• Sonucu kendiniz görün. "Çalışıyor" demesi yetmez; sayfayı açın, testi çalıştırın.