Claude Code, Anthropic'in terminal tabanlı AI kodlama aracıdır. İstediğinizi düz İngilizce yazarsınız, o kod tabanınızı okur, kod yazar, komutlar çalıştırır, hataları düzeltir ve değişiklikleri commit eder — hepsi terminalinizden. IDE eklentisi yok. Tarayıcı sekmeleri yok. Sadece siz ve AI, bir terminal penceresinde.
Cursor'dan (IDE içinde çalışan) veya Codex'ten (bulutta çalışan) farklı olarak, Claude Code gerçek geliştirme ortamınızda yerel olarak çalışır. Dosyalarınızı, git geçmişinizi ve terminal çıktılarınızı görür. Bu, birçok iş akışında AI ile kodunuz arasında geçiş yapmadan daha hızlı olmasını sağlar.
Bu rehber, kurulum, ilk projeniz, temel komutlar ve Claude Code'u etkili kılan iş akışını kapsar.
| Araç | En İyi Olduğu | Nerede Çalışır | İş Akışı |
|---|---|---|---|
| Claude Code | Etkileşimli ajanik kodlama | Yerel terminal | Siz yönlendirir + o adımları canlı yürütür |
| Cursor | Günlük kodlama + satır içi düzenlemeler | IDE içinde | Görünür diff'ler + otomatik tamamlama |
| Codex | Asenkron delege edilmiş görevler | Bulut sandbox | Görev gönder → PR'ı sonra incele |
Claude Code Nasıl Yüklenir
Node.js 18+ ve bir Claude hesabı (Pro veya API) gereklidir.
Adım 1: npm ile global olarak yükleyin:
npm install -g @anthropic-ai/claude-code
Adım 2: Proje dizininize gidin:
cd your-project
Adım 3: Claude Code'u çalıştırın:
claude
İlk çalıştırdığınızda, Anthropic hesabınızla kimlik doğrulamanızı isteyecek. Claude Pro ($20/ay) kullanıyorsanız, cömert bir token kotası alırsınız. API kullanıyorsanız, token başına ödeme yaparsınız (güncel oranları rate limits rehberimizde kontrol edin).
Maliyet tahmini (sürpriz yaşamayın diye)
API faturalandırması kullanıyorsanız, orta büyüklükte bir depoda tipik 30–60 dakikalık bir oturum modele ve yineleme sayısına bağlı olarak genellikle $2–$10 tutar. Düzenli olarak /cost kullanın ve uzun oturumları Vibe Coding Cost Calculator ile kontrol edin.
Claude Code ile İlk 5 Dakikanız
Claude Code çalışmaya başladığında, etkileşimli bir oturumdasınız. AI, tüm proje dizininize erişime sahiptir. Basit başlayın:
Keşfetmesini isteyin: "Bu proje nedir? Bana üst düzey bir genel bakış ver." Claude ana dosyalarınızı (package.json, README, ana giriş noktaları) okur ve bulduklarını özetler. Proje yapınızı anladığını doğrulamak için iyi bir yoldur.
Bir şey bulmasını isteyin: "Kimlik doğrulama mantığı nerede?" Claude kod tabanınızı arar ve ilgili dosyalara işaret eder. Sadece metin eşleştirmesi değil, kod yapısını anlar.
Bir şeyi değiştirmesini isteyin: "Kayıt formuna girdi doğrulama ekle. E-posta geçerli formatta olmalı, şifre en az 8 karakter." Claude form bileşenini tanımlar, doğrulama mantığını yazar ve uygulamadan önce diff'i gösterir.
Temel içgörü: Claude Code gerçek dosyalarınız üzerinde çalışır. Değişiklik yaptığında, değişiklik gerçektir — dosyalarınız diskte değiştirilir. Değişiklikleri editörünüzde görebilir, testleri çalıştırabilir ve normal şekilde commit edebilirsiniz.
Temel Komutlar
Claude Code'un davranışını kontrol eden birkaç eğik çizgi komutu vardır:
| Komut | Ne Yapar | Ne Zaman Kullanılır |
|---|---|---|
/init | Proje kök dizininde bir CLAUDE.md dosyası oluşturur | Bir depoda ilk ciddi görevinizden önce |
/compact | Bağlam sınırlarına yakın sohbet geçmişini sıkıştırır | Uzun oturumlar; kalite düşmeden önce |
/cost | Kullanılan token'ları + tahmini maliyeti gösterir | API faturalandırma, bütçe takibi |
/clear | Bağlamı koruyarak sohbeti sıfırlar | Alakasız görevler arasında geçiş yaparken |
Bundan değer mi alıyorsun? AI kodlama araçları ve iş akışları hakkında haftalık rehberler yayınlıyoruz. Posta kutuna getir →
CLAUDE.md Dosyası — Projenizin AI Bağlamı
CLAUDE.md dosyası, Claude Code iş akışınızda en önemli şeydir. Proje kök dizininizdeki bir markdown dosyasıdır ve Claude her oturum başlangıcında onu okur. Kod tabanınız için özel talimatlar olarak düşünün.
İyi bir CLAUDE.md şunları içerir:
Proje genel bakışı: Projenin ne yaptığı, teknoloji yığını ve mimariyi 3-5 cümlede.
Kod kuralları: Biçimlendirme tercihleriniz, adlandırma kuralları ve takip edilecek kalıplar. "Hook'lu fonksiyonel bileşenler kullan. İsimlendirilmiş export'ları tercih et. Stil için Tailwind kullan."
Ana dosyalar: Claude'un anlaması gereken en önemli dosyalara işaret edin. "Ana veri modelleri lib/models/ içinde. API rotaları app/api/ içinde."
Kaçınılacak şeyler: "Veritabanı göç dosyalarını değiştirme. vendor/ içindekileri değiştirme. api/ dosyalarını değiştirdikten sonra her zaman testleri çalıştır."
CLAUDE.md olmadan, Claude Code projenizin stiline uymayabilecek genel kod üretir. Onunla, ekipte aylardır olan biri tarafından yazılmış gibi hisseder. Bu, bağlam mühendisliği pratiğidir.
Gerçek İş Akışı: Bir Özellik Geliştirme
Tipik bir özellik geliştirme oturumunda Claude Code'u şöyle kullanırım:
1. Hedefle başlayın: "API'ye hız sınırlayıcı ekle. Redis kullan. /api/submit endpoint'ine IP başına dakikada 10 istek limiti uygula."
2. Claude'un plan yapmasına izin verin: Mevcut API kodunu okur, Redis'in zaten yapılandırılıp yapılandırılmadığını kontrol eder ve bir yaklaşım önerir. Kodlamaya başlamadan önce planı inceleyin.
3. Çalışmasını izleyin: Claude hız sınırlayıcı modülü oluşturur, API rotasına entegre eder, Redis bağlantısı için ortam değişkenleri ekler ve bir test yazar.
4. Test edin: Claude testleri çalıştırır. Bir şey başarısız olursa, hatayı okur, kodu ayarlar ve yeniden dener. Bu yineleme döngüsü ajanların parladığı yerdir — normalde birden fazla manuel tur alan hata ayıklama döngüsünü yönetir.
5. İnceleyin ve commit edin: Diff'i kontrol edin. Gerekli ayarlamaları yapın. Commit edin. İsterseniz Claude commit mesajını da yazabilir.
Böyle bir özellik için Claude Code, manuel yazmaya kıyasla genellikle zamanın %60-70'ini kurtarır. Gerçek tasarruf, tekrar eden ama zihinsel olarak zorlayıcı olmayan kısımda — boilerplate, entegrasyon kodu ve test yazmada olur.
Token Kullanımını Yönetme
Claude Code her etkileşim için token kullanır. Büyük kod tabanlarında uzun oturumlar API faturalandırmasında pahalı olabilir. Maliyetleri makul tutan alışkanlıklar şunlar:
/compact'i düzenli kullanın. Bağlam dolana kadar beklemeyin. Her farklı görevi tamamladıktan sonra sıkıştırın.
Spesifik olun. "Giriş formundaki hatayı düzelt" demek, "Tüm uygulamaya bak ve hataları bul" demekten daha ucuzdur. Spesifik istekler daha az kod okutur.
Alakasız görevler arasında /clear kullanın. Frontend'de çalıştıktan sonra veritabanı göçlerine geçiyorsanız, bağlamı temizleyin. Eski bağlam token israf eder ve modeli şaşırtabilir.
/cost'u sık kontrol edin. Her oturum için zihinsel bir bütçe belirleyin ve buna göre kontrol edin. Tipik 30 dakikalık özellik oturumu API faturalandırmasında $2-8 tutar.
Claude Code ile Cursor arasındaki detaylı maliyet karşılaştırması için 30 gün sonraki gerçek maliyet karşılaştırmamıza bakın.
Claude Code vs Cursor vs Codex
Hızlı karar rehberi:
| Seçenek | En iyi olduğunda... | Fedakarlık |
|---|---|---|
| Claude Code | Yerel olarak etkileşimli, repo-geniş değişiklikler istiyorsanız | Dikkatli inceleme gerektirir (gerçek dosyaları düzenler) |
| Cursor | IDE'nizin içinde AI + sıkı düzenleme döngüsü istiyorsanız | Terminal ajanlarına göre daha az özerk |
| Codex | Asenkron, PR tabanlı görev devri istiyorsanız | Daha az etkileşimli; bağlam kayabilir |
Claude Code: Tam proje bağlamı ve terminal tabanlı iş akışları isteyen geliştiriciler için en iyisi. Etkileşimli, gerçek zamanlı, gerçek dosyalarınızda çalışır. Karmaşık özellikler, yeniden düzenleme ve hata ayıklama için en iyisi.
Cursor: IDE'lerinin içinde AI isteyen geliştiriciler için en iyisi. Satır içi diff'lerle değişiklikleri gerçek zamanlı görün. AI önerileriyle günlük kodlama için en iyisi. Tam karşılaştırma burada.
Codex: Asenkron, toplu kodlama görevleri isteyen takımlar için en iyisi. Görev gönderin, PR'yi sonra inceleyin. Tamamen devretmek istediğiniz iyi tanımlanmış görevler için en iyisi. Tam karşılaştırma burada.
Birçok geliştirici ikisini veya daha fazlasını kullanır. Karmaşık özellikler için Claude Code, günlük düzenleme için Cursor, toplu görevler için Codex.
Herhangi bir AI kodlama aracı için prompt'larınızı geliştirmek ister misiniz? The Prompt Optimizer taleplerinizi daha net ve spesifik çıktı için yapılandırmanıza yardımcı olur.
Buna benzer daha fazla içerik ister misiniz? AI kodlama araçları ve geliştirici iş akışları hakkında haftalık yayın yapıyoruz. Ücretsiz abone olun →
Sıkça Sorulan Sorular
Claude Code Windows'ta çalışır mı?
Evet, WSL (Windows Subsystem for Linux), PowerShell veya Komut İstemi üzerinden. Birçok geliştirme aracı Linux doğal olduğundan WSL en iyi deneyimi sağlar.
Claude Code internete erişebilir mi?
Claude Code kendisi web'e göz atmaz, ama curl, npm install, git clone gibi komutlar çalıştırabilir. GitHub, veritabanları ve API'ler gibi harici hizmetlere erişmek için MCP sunucularını da kullanabilir.
Claude Code büyük kod tabanlarını nasıl yönetir?
Claude'un 200K token bağlam penceresi, binlerce kaynak dosyasını aynı anda yükleyip işleyebileceği anlamına gelir. Çok büyük monorepo'lar için her şeyi yüklemek yerine ilgili dosyaları seçici olarak okur. CLAUDE.md dosyası her görev için kod tabanının hangi kısımlarının önemli olduğunu bilmesine yardımcı olur.
Kodum Anthropic sunucularına mı gönderiliyor?
Evet, kodunuz işleme için Anthropic'in API'sinin gönderilir. Anthropic varsayılan olarak API girdileri üzerinde eğitim yapmaz, ancak hassas veya tescilli kodlarla çalışıyorsanız güncel şartları kontrol edin. Maksimum gizlilik için veri saklama devre dışı bırakılmış API kullanmayı düşünün.
Açıklama: Bu makaledeki bazı bağlantılar affiliate bağlantılardır. Sadece kişisel olarak test edip düzenli kullandığımız araçları öneririz. Tam açıklama politikamızı görün.