Claude Code, tarayıcıda çalışan bir sohbet penceresi değil. Terminalinizde açılıyor, projenizin dosyalarını kendisi okuyor, düzenleme yapıyor, testi çalıştırıyor ve commit atıyor. “Şu hatayı düzelt” dediğinizde ilgili dosyayı bulup değiştirmesi bekleniyor.

Bu yazı kurulumdan ilk kod değişikliğine kadar olan yolu adım adım anlatıyor. Ücretsiz kullanım sorusunun net cevabı da içinde 🧑‍💻

Kısa Cevap

Bir dakikanız varsa
  • Kurulum (Windows PowerShell): irm https://claude.ai/install.ps1 | iex
  • Kurulum (macOS, Linux, WSL): curl -fsSL https://claude.ai/install.sh | bash
  • Başlatma: proje klasörüne girip claude yazın
  • Ücretsiz sürüm yok: Claude aboneliği (Pro, Max, Team, Enterprise) veya ön ödemeli Console hesabı gerekiyor
  • İlk iş: /init ile projeye CLAUDE.md üretin
Reklam

Claude Code Nedir?

Claude Code, Anthropic’in terminalde çalışan kodlama ajanı. Klasik yapay zeka asistanlarından farkı, sadece metin üretmemesi. Dosya okuma, dosya yazma, komut çalıştırma, web araması gibi araçları var ve bunları kendi kararıyla sırayla kullanıyor.

Pratikte şu döngü işliyor: siz ne istediğinizi yazıyorsunuz, Claude gerekli dosyaları buluyor, okuyor, değişikliği yapıyor, testi çalıştırıyor, çıktıya bakıp gerekirse düzeltiyor. Buna ajansal döngü deniyor.

Terminal tek arayüz değil. Aynı ürün masaüstü uygulaması, VS Code ve JetBrains eklentisi, tarayıcı sürümü ve GitHub Actions entegrasyonu olarak da var. Bu rehber terminal sürümünü anlatıyor, çünkü diğerlerinin hepsi aynı mantıkla çalışıyor.

Sohbet penceresinden farkı

Claude’un web arayüzünde kod istediğinizde size kodu verir, kopyalayıp yapıştırmak size kalır.

Claude Code aynı kodu uygular. Dosyayı bulur, düzenler, çalıştırır ve sonucu gösterir. Bağlamı da siz yapıştırmazsınız, ihtiyaç duydukça projeyi kendisi okur.

Claude Code Ücretsiz mi?

Hayır. Ücretsiz bir plan yok. Çalışması için şunlardan birine ihtiyacınız var:

Hesap türüNasıl çalışır
Claude aboneliği (Pro, Max, Team, Enterprise)Önerilen yol. Kullanım aboneliğe dahil, ayrıca token ücreti ödemezsiniz. Kullanım hakkı beş saatlik ve haftalık pencerelerde yenilenir
Claude ConsoleÖn ödemeli API kredisiyle çalışır, token başına ücretlendirilir. İlk girişte hesabınızda otomatik olarak "Claude Code" adlı bir çalışma alanı açılır
Bulut sağlayıcılarAmazon Bedrock, Google Cloud Agent Platform ve Microsoft Foundry üzerinden kurumsal kullanım. Fatura bulut hesabınıza gider

Güncel abonelik fiyatları için claude.com/pricing doğru kaynak, rakamlar değişiyor.

API tarafını merak edenler için Anthropic’in kendi dokümantasyonundaki kurumsal ortalama şöyle: geliştirici başına aktif günde yaklaşık 13 dolar, ayda 150-250 dolar. Kullanıcıların yüzde 90’ı aktif günde 30 doların altında kalıyor. Abonelikte bu rakamlar sizi ilgilendirmez, sabit ücret ödersiniz.

Ücretsiz kullanma yolları arıyorsanız

Arama sonuçlarında “bedava Claude Code” vaat eden hesap paylaşımı ve token satışı ilanları çıkıyor. Bunlar hesap askıya alınmasıyla sonuçlanıyor, çoğu da doğrudan dolandırıcılık.

Bütçe sıkışıksa mantıklı yol Console hesabına küçük bir kredi yükleyip token başına ödemek. Deneme amaçlı birkaç dolar yeterli oluyor.

Kurulum

Kurulum tek satır. Aşağıdakilerden işletim sisteminize uyanı seçin.

Windows

PowerShell açıp şunu çalıştırın:

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

CMD kullanıyorsanız komut farklı:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Hangisinde olduğunuzu bilmiyorsanız prompt satırına bakın. Başında PS C:\ yazıyorsa PowerShell’desiniz, sadece C:\ yazıyorsa CMD’desiniz.

WinGet tercih ederseniz:

winget install Anthropic.ClaudeCode
Windows'ta Git for Windows kurun

Claude Code, komut çalıştırmak için Bash aracını kullanıyor. Git for Windows kurulu değilse PowerShell’e düşüyor ve bazı komutlar beklediğiniz gibi çalışmıyor.

WSL üzerinde çalışıyorsanız buna gerek yok.

macOS, Linux ve WSL

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

Homebrew kullanıyorsanız:

brew install --cask claude-code

Homebrew’da iki kasa var. claude-code kararlı kanalı takip eder, genelde bir hafta geriden gelir ve büyük hata içeren sürümleri atlar. claude-code@latest ise yeni sürümleri çıkar çıkmaz alır.

Debian, Fedora, RHEL ve Alpine’da apt, dnf ve apk paket yöneticileriyle de kurulabiliyor.

Kurulumu Doğrulama

claude --version

Sürüm numarasının ardından (Claude Code) yazıyorsa kurulum tamam.

Otomatik güncelleme her kurulumda yok

Native kurulum (curl ve PowerShell yöntemi) arka planda kendini günceller.

Homebrew ve WinGet güncellemez. Elle yapmanız gerekir:

brew upgrade claude-code veya winget upgrade Anthropic.ClaudeCode

Giriş Yapma

Terminalde claude yazın. İlk çalıştırmada giriş ekranı açılır:

claude

Tarayıcıda kimlik doğrulamayı tamamlayınca kimlik bilgileriniz kaydedilir, bir daha sorulmaz. Hesap değiştirmek isterseniz oturum içinde /login yazmanız yeterli.

ANTHROPIC_API_KEY ortam değişkeni tanımlıysa giriş ekranı atlanır, Claude Code doğrudan o anahtarı onaylamanızı ister.

İlk Oturum

Proje klasörüne girip başlatın:

cd C:\projeler\benim-projem
claude

Prompt’un üstünde sürüm, aktif model ve çalışma dizini görünür. İlk yazacağınız şey komut değil, soru olsun:

bu proje ne yapıyor?

Claude dosyaları tarayıp özet çıkarır. Bağlamı elle yapıştırmanız gerekmez, ihtiyaç duyduğu dosyayı kendisi okur.

Tanışma turu için işe yarayan diğer sorular:

bu projede hangi teknolojiler kullanılıyor?

giriş noktası hangi dosya?

klasör yapısını açıkla

/init ile Projeyi Tanıtın

Oturum içinde /init yazın. Claude projeyi inceleyip kök dizine CLAUDE.md adında bir rehber dosyası üretir. Bu dosya her yeni oturumda otomatik yükleniyor, yani projenin kurallarını bir kez yazıp her seferinde tekrarlamaktan kurtuluyorsunuz.

Kısa tutun. 200 satırı geçen bir CLAUDE.md her oturumda bağlam yiyor. İçine sadece koda bakarak anlaşılamayacak şeyleri yazın: build komutları, ekip kuralları, tuzaklar.

Nasıl Çalışıyor: İzin Modları

Claude Code varsayılan olarak dosyayı değiştirmeden önce size sorar. Shift+Tab ile modlar arasında geçiş yaparsınız:

ModDavranışNe zaman
VarsayılanHer değişiklik için onay isterYeni projede, tanımadığınız kodda
acceptEditsDosya düzenlemelerini otomatik onaylarNe yapacağını bildiğiniz rutin işlerde
planHiçbir şeyi değiştirmez, önce planını sunarBüyük değişikliklerde, ilk adım olarak

Bazı hesaplarda ayrıca auto modu var. Arka planda güvenlik kontrolü çalıştırıp riskli işlemleri engelliyor, tekrarlanan engellemelerden sonra soru sormaya dönüyor.

--dangerously-skip-permissions

Bu bayrak tüm izin sorularını kapatır. Claude dosya silme dahil her aracı sormadan kullanır.

Yalnızca kaybını göze aldığınız, sürüm kontrolü altındaki izole bir ortamda kullanın. Günlük çalışmada plan modu çok daha makul bir başlangıç.

İlk Kod Değişikliği

Basit bir işle başlayın:

ana dosyaya bir hello world fonksiyonu ekle

Claude dosyayı bulur, değişikliği gösterir, onayınızı ister ve uygular.

Sonra gerçek bir işe geçin. Hata düzeltirken belirsiz cümle kurmayın:

Kötü istek:

hatayı düzelt

İyi istek:

kullanıcı yanlış şifre girince boş ekran gelen giriş hatasını düzelt

Fark şurada: ilk cümle Claude’u bütün projeyi taramaya iter, ikincisi doğrudan ilgili dosyaya götürür. Hem daha hızlı sonuç verir hem daha az token harcar.

Git ile Kullanım

Git işlemleri konuşma diliyle yürüyor:

hangi dosyaları değiştirdim?

değişikliklerimi açıklayıcı bir mesajla commit et

feature/giris-ekrani adında yeni bir dal aç

merge çakışmalarını çözmeme yardım et

Commit atmadan önce /diff ile ne değiştiğine bakmak iyi bir alışkanlık. Bir adım ötesi /code-review, mevcut farkı hata ve temizlik için inceler.

Günlük Kullanımda İşe Yarayan 8 Alışkanlık

Kurulumu yapan herkes çalıştırabiliyor. Farkı bu alışkanlıklar açıyor.

1. Konu değişince /clear yazın. Eski bağlam her mesajda tekrar gönderiliyor. Alakasız bir işe geçtiyseniz bağlamı taşımanın maliyeti var, faydası yok.

2. Büyük işe plan moduyla girin. Shift+Tab ile plan moduna geçip Claude’un yaklaşımını okuyun. Yanlış yöne gidiyorsa daha tek satır kod yazılmadan düzeltirsiniz.

3. Yanlış gidince Escape’e basın. Beklemeyin. Escape anında durdurur, çift Escape veya /rewind konuşmayı ve kodu kontrol noktasına geri alır.

4. Doğrulama hedefi verin. “Şu test geçsin”, “çıktı şöyle görünsün”, ekran görüntüsü yapıştırın. Claude kendi işini doğrulayabildiğinde siz düzeltme istemeden hatayı yakalar.

5. Modeli işe göre seçin. Sonnet günlük kodlamanın çoğunu görüyor ve daha ucuz. Opus’u karmaşık mimari kararlar ve çok adımlı akıl yürütme için saklayın. /model ile oturum ortasında değiştirebilirsiniz.

6. Bağlamı /context ile izleyin. Neyin yer kapladığını gösterir: şişmiş MCP sunucuları, uzun CLAUDE.md, biriken konuşma. Genelde suçlu bellidir.

7. Adım adım isteyin. Üç işi tek cümlede istemek yerine numaralı liste verin. Claude sırayla ilerler, siz her adımda kontrol edersiniz.

8. Kullanılmayan MCP sunucularını kapatın. /mcp ile listeyi açıp aktif kullanmadıklarınızı devre dışı bırakın. Her sunucu bağlamdan pay alıyor.

Uzun oturum neden çok harcıyor

Claude Code her istekte konuşmanın tamamını gönderiyor. Sabah açtığınız oturumda akşam sorduğunuz tek satırlık soru, gün boyu birikmiş geçmişin tamamını taşıyor.

Önbellek bunun maliyetini düşürüyor ama sıfırlamıyor. İşiniz bittiğinde /clear, ara vereceğinizde /rename sonra /clear, dönmek istediğinizde /resume.

Güncelleme

Native kurulum kendini günceller. Elle kontrol etmek isterseniz:

claude update

Kurulumda bir sorun olduğunu düşünüyorsanız teşhis komutu ayrı:

claude doctor

Oturum içinde /doctor daha kapsamlı çalışır: mükerrer kurulum, PATH sorunu, bozuk ayar dosyası, yavaş hook ve kullanılmayan skill’leri bağlam maliyetiyle birlikte listeler.

Sırada Ne Var?

Kurulum ve ilk oturum bittiğinde Claude Code’u kendi işinize göre şekillendirme aşaması başlıyor:

Sıkça Sorulan Sorular (SSS)

Claude Code ücretsiz mi? Hayır, ücretsiz plan yok. Claude Pro, Max, Team veya Enterprise aboneliğiyle ya da ön ödemeli kredi yüklenmiş bir Claude Console hesabıyla çalışıyor. Kurumsal kullanıcılar Amazon Bedrock, Google Cloud Agent Platform ve Microsoft Foundry üzerinden de bağlanabiliyor.

Claude Code Windows’a nasıl kurulur? PowerShell açıp irm https://claude.ai/install.ps1 | iex komutunu çalıştırın. CMD kullanıyorsanız curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd komutu doğru olanı. WinGet ile winget install Anthropic.ClaudeCode da çalışır. Kurulum sonrası claude --version ile doğrulayın.

Claude Code nasıl başlatılır? Terminalde proje klasörüne girip claude yazın. İlk çalıştırmada tarayıcı üzerinden giriş yapmanız istenir, sonraki oturumlarda doğrudan açılır.

Claude Code ile Claude’un web sürümü arasındaki fark nedir? Web sürümü kodu size verir, kopyalayıp yapıştırmak size kalır. Claude Code kodu uygular: dosyayı bulur, düzenler, testi çalıştırır ve sonucu gösterir. Bağlamı da siz yapıştırmazsınız, projeyi ihtiyaç duydukça kendisi okur.

Claude Code kodumu değiştirmeden önce soruyor mu? Varsayılan modda evet, her değişiklik için onay ister. Shift+Tab ile mod değiştirebilirsiniz: acceptEdits düzenlemeleri otomatik onaylar, plan hiçbir şeyi değiştirmeden önce planını sunar.

Claude Code nasıl güncellenir? Native kurulum arka planda kendini günceller. Elle kontrol için claude update çalıştırın. Homebrew ile kurduysanız brew upgrade claude-code, WinGet ile kurduysanız winget upgrade Anthropic.ClaudeCode gerekir, bu ikisi otomatik güncellenmez.

Claude Code neden bu kadar token harcıyor? Her istekte konuşmanın tamamı gönderiliyor. Uzun süre açık kalan oturumda tek satırlık soru bile birikmiş geçmişin tümünü taşır. Konu değiştiğinde /clear, bağlamı neyin doldurduğunu görmek için /context kullanın.

Claude Code’da CLAUDE.md ne işe yarar? Projenin kök dizininde duran ve her oturumda otomatik yüklenen rehber dosyası. Build komutları, ekip kuralları ve tuzaklar buraya yazılır, böylece her oturumda tekrar anlatmanız gerekmez. /init komutu bu dosyayı sizin için üretir. 200 satırı geçmemesi önerilir.

Özet

Kurulum tek satır, ilk oturum beş dakika. Asıl fark kurulumdan sonra başlıyor.

En çok kazandıran üç alışkanlık: konu değişince /clear, büyük işe plan moduyla girmek ve belirsiz cümle kurmamak. Üçü de ücretsiz, üçü de hem sonucu hem maliyeti doğrudan etkiliyor.

Ücretsiz sürüm arıyorsanız yok. Ama Console hesabına birkaç dolarlık kredi yükleyip denemek mümkün, aylık taahhüt gerektirmiyor 👀