İçeriğe geçin
Birlikte çalışalım
Menü

Nasıl yapılır · Kod ajanları ve editörler

Claude Code kurulumu: macOS, Windows ve VS Code'da adım adım

Ahmet Eren Ahmet Eren · Yayın: · Son kontrol:

Kısa cevap

Claude Code macOS, Linux ve WSL'de curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell'de irm https://claude.ai/install.ps1 | iex komutuyla kurulur. Kurulumdan sonra yeni bir terminalde claude --version ile doğrulanır, proje klasöründe claude yazılarak açılır ve ilk açılışta tarayıcıdan oturum açılır. Ücretsiz Claude planı yetmez; Pro, Max, Team, Enterprise ya da Console hesabı gerekir. VS Code ve Cursor için ayrı eklenti, masaüstü için ayrı uygulama vardır.

Sonuç: ne kurmuş olacaksınız

Bu rehberin sonunda bilgisayarınızda çalışan bir Claude Code kurulumu, aboneliğinizle açılmış bir oturum, projenize özel bir CLAUDE.md dosyası ve ilk küçük değişikliği yapılmış bir proje olacak. Bütün komutlar Anthropic'in resmi dokümanından alındı ve 22 Ekim 2026'da kontrol edildi.

Gerekenler

  • Hesap: Claude Pro, Max, Team ya da Enterprise aboneliği ya da Claude Console hesabı. Ücretsiz plan Claude Code'u kapsamıyor. Plan farkları için Claude Pro mu Max mı.
  • İşletim sistemi: macOS 13, Windows 10 1809 ya da Windows Server 2019, Ubuntu 20.04, Debian 10 ya da Alpine Linux 3.19 ve üstü.
  • Donanım: en az 4 GB RAM, x64 ya da ARM64 işlemci.
  • Ağ ve konum: internet bağlantısı; Anthropic'in desteklenen ülkelerinden birinde olmak. Türkiye listede.
  • Bir proje klasörü: boş bir klasör de olur, var olan bir kod deposu da.

Hangi yolla kuracaksınız

Yol Kime uygun Komut ya da adım Güncelleme
Yerel kurulum (önerilen) macOS, Linux, WSL Aşağıdaki ilk komut Arka planda kendiliğinden
Windows PowerShell Windows Aşağıdaki ikinci komut Arka planda kendiliğinden
Homebrew macOS'ta paket yöneticisi kullananlar brew install --cask claude-code brew upgrade claude-code
WinGet Windows'ta paket yöneticisi kullananlar winget install Anthropic.ClaudeCode winget upgrade Anthropic.ClaudeCode
VS Code eklentisi Terminal yerine editör paneli isteyenler Uzantılarda "Claude Code" aratıp kurun Uzantıyla birlikte
Masaüstü uygulaması Terminal kullanmayanlar Claude uygulamasını indirip Code sekmesi Uygulamayla birlikte

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

Adım adım kurulum

  1. Terminali açın. macOS'ta Terminal, Windows'ta PowerShell. Windows'ta istem satırı PS C:\ ile başlıyorsa PowerShell'desiniz.
  2. Kurulum komutunu çalıştırın. Yukarıdaki komutlardan sisteminize uyanı yapıştırıp Enter'a basın. Komut indirirken ilerleme göstermiyor, bitmesini bekleyin.
  3. Yeni bir terminal açıp doğrulayın. claude --version yazın; bir sürüm numarası ve yanında "(Claude Code)" görmelisiniz. Daha ayrıntılı denetim için claude doctor.
  4. Projeye girip başlatın. cd proje-klasoru ve ardından claude.
  5. Oturum açın. İlk açılışta tarayıcı açılıyor; aboneliğinizin hesabıyla giriş yapın. Kimlik bilgileri saklanıyor, bir daha sorulmuyor. Hesap değiştirmek için oturum içinde /login.
  6. Proje dosyasını oluşturun. Oturumda /init yazın. Claude kod tabanını inceleyip derleme komutları, test talimatları ve proje kurallarıyla bir başlangıç CLAUDE.md dosyası yazıyor. Dosya zaten varsa üzerine yazmıyor, iyileştirme öneriyor.
  7. İlk soruyu sorun. "Bu proje ne yapıyor?" gibi bir soruyla başlayın; Claude dosyaları gerektikçe kendisi okuyor.
  8. İlk değişikliği yaptırın. Küçük bir iş verin. Değişiklikten önce izin isterse onaylayın. Shift+Tab izin modları arasında geçiş yapıyor; plan modu da bu döngüde.

VS Code'da çalışacaksanız: Uzantılar görünümünü Ctrl+Shift+X (Mac'te Cmd+Shift+X) ile açın, "Claude Code" aratıp kurun, editörün sağ üstündeki Spark simgesine tıklayın ve oturum açın. Eklenti VS Code 1.94 ve üstünü istiyor. Aynı eklenti Cursor'a ve Devin Desktop gibi VS Code tabanlı editörlere de kuruluyor. Editör entegre terminalinde claude komutunu da kullanacaksanız CLI'ı ayrıca kurmanız gerekiyor.

Örnek: ilk CLAUDE.md ve ilk istemler

/init dosyayı oluşturduktan sonra Claude'un koddan çıkaramayacağı kuralları ekleyin. Anthropic dosyayı 200 satırın altında tutmayı öneriyor. Türkçe bir proje için örnek eklemeler:

# Proje kuralları

- Cevapları Türkçe yaz; kod, değişken ve commit mesajları İngilizce kalsın.
- Testleri `npm test` ile çalıştır; testler geçmeden commit önerme.
- `src/legacy/` klasörüne dokunma, sadece oku.
- Yeni bağımlılık eklemeden önce sor.

İlk oturum için kopyalayabileceğiniz istemler:

Bu proje ne yapıyor? Ana giriş noktalarını ve önce okumam gereken dosyaları göster.
Kayıt formuna e-posta doğrulaması ekle, önce planını yaz ve onayımı bekle.
Değiştirdiğim dosyaları listele ve açıklayıcı bir mesajla commit et.

Sık hatalar

  • claude bulunamadı. Kurulum klasörü PATH'te değil. Önce yeni bir terminal açın; sürerse resmi sorun giderme sayfasındaki PATH adımlarına bakın.
  • Yanlış Windows kabuğu. "The token '&&' is not a valid statement separator" görüyorsanız PowerShell'desiniz, CMD komutunu çalıştırmışsınız. "'irm' is not recognized" görüyorsanız CMD'desiniz.
  • sudo npm install -g. Anthropic bunu yapmamanızı açıkça söylüyor; izin sorunlarına ve güvenlik riskine yol açıyor.
  • API ücreti çıkması. ANTHROPIC_API_KEY ortam değişkeni tanımlıysa ve onaylarsanız Claude Code aboneliğiniz yerine bu anahtarı kullanıyor.
  • Eski sürümde kalmak. Homebrew ve WinGet kendiliğinden güncellenmiyor; yeni modeller daha yeni bir Claude Code sürümü isteyebiliyor.
  • Limitin hızlı dolması. Uzun açık kalan oturum her istekte bütün konuşmayı gönderiyor; ilgisiz işe geçerken /clear kullanın. Ayrıntısı Claude limitleri rehberinde.

Kurulumdan sonra aracın ne yapabildiğini Claude Code araç sayfasında, izin modlarından auto mode'u auto mode yazımızda anlatıyoruz.

Bilinen sınırlar

  • Ücretsiz planda kullanılamaz; masaüstü uygulamasındaki Code sekmesi ücretli abonelik ister.
  • Abonelikte 5 saatlik ya da haftalık sınır dolunca, usage credits açık değilse sıfırlanmayı beklemek gerekir; model değiştirmek bu sınırı aşmaz.
  • JetBrains eklentisi tek başına çalışmaz, Claude Code CLI ayrıca kurulmalıdır.
  • Fable modelleri plana ve koltuğa göre dahil kullanım yerine usage credits'ten düşebilir.
  • Terminalden masaüstüne /desktop devri sadece macOS ve x64 Windows'ta çalışır ve claude.ai aboneliği ister.

Veri, KVKK ve ödeme

Claude Code. Free, Pro ve Max hesaplarında veriler, kullanıcı model geliştirme ayarını açtıysa yeni modellerin eğitiminde kullanılır; ayar claude.ai/settings/data-privacy-controls adresinden her an değişir. Ayar açıkken saklama 5 yıl, kapalıyken 30 gün. Team, Enterprise ve API verisi eğitimde kullanılmaz, standart saklama 30 gün. Claude Code yerelde çalışır, istem ve çıktılar TLS ile Anthropic API'ye gider; bulut oturumları Anthropic'in yönettiği izole sanal makinelerde çalışır. Web aboneliği USD ile; App Store Türkiye'de TL fiyatlı uygulama içi satın alma var. Anthropic'e göre mobil fiyatlar mağazaya göre değişebilir.

Bu bölüm hukuki görüş değildir; kişisel veri içeren işlerde sağlayıcının güncel sözleşmesini ve KVKK yükümlülüklerinizi kontrol edin.

Sık sorulanlar

Claude Code kurmak için Node.js gerekir mi?
Önerilen yerel kurulum için gerekmiyor. Sadece npm ile kuracaksanız Node.js 22 ya da üstü isteniyor; npm paketi de aynı yerel ikili dosyayı kuruyor.
Claude Code Windows'ta nasıl kurulur?
PowerShell'de irm https://claude.ai/install.ps1 | iex komutunu çalıştırın; yönetici yetkisi gerekmiyor. Git for Windows kuruluysa Claude Code Git Bash'i, değilse PowerShell'i kullanıyor. Linux araçlarıyla çalışacaksanız WSL içinde Linux komutuyla kurmak da mümkün.
Claude Code VS Code'da nasıl kullanılır?
Uzantılar görünümünde Claude Code'u aratıp kurun, sağ üstteki Spark simgesine tıklayın ve ilk açılışta oturum açın. Uzantı VS Code 1.94 ve üstünü istiyor ve sohbet paneli için kendi CLI kopyasını getiriyor.
claude komutu bulunamadı hatası neden çıkıyor?
Kurulum klasörü henüz PATH'te değil. Önce yeni bir terminal penceresi açıp tekrar deneyin; sorun sürerse Anthropic'in kurulum sorun giderme sayfasındaki PATH adımlarını izleyin.
Claude Code nasıl güncellenir?
Yerel kurulum arka planda kendini güncelliyor; hemen güncellemek için claude update yazın. Homebrew ve WinGet kurulumları kendiliğinden güncellenmiyor: brew upgrade claude-code ya da winget upgrade Anthropic.ClaudeCode gerekiyor.
Ücretsiz hesapla giriş yapabilir miyim?
Hayır. Anthropic'in kurulum sayfasına göre ücretsiz claude.ai planı Claude Code erişimi içermiyor; Pro, Max, Team, Enterprise ya da Console hesabı gerekiyor.

Kaynaklar

  1. Anthropic, Claude Code Quickstart
  2. Anthropic, Claude Code Advanced setup
  3. Anthropic, Use Claude Code in VS Code
  4. Anthropic, How Claude remembers your project
  5. Anthropic, Claude Code Overview
  6. Anthropic, Claude Plans and Pricing
  7. Anthropic, What is the Max plan
  8. Anthropic, Claude Code Manage costs
  9. Anthropic, Claude Code Model configuration
  10. Anthropic, Claude Code Data usage
  11. Anthropic, Claude Code Settings reference (language)
  12. App Store Türkiye, Claude by Anthropic

Değişiklik günlüğü

  1. : İlk yayın. Kurulum komutları, sistem gereksinimleri ve VS Code adımları 22 Ekim 2026'da resmi dokümandan kontrol edildi.

Bu sayfada sponsorlu içerik ya da satış ortaklığı bağlantısı yok. Sıralama ve öneriler hiçbir üreticiden ücret alınmadan yazıldı. Nasıl gelir elde ettiğimizi ve sponsorluk kurallarımızı reklam ve işbirliği sayfasında anlatıyoruz.

Devamı

İlgili sayfalar

Kod ajanları ve editörler

Claude Code nedir? Ne işe yarar, ücretsiz mi, nasıl kurulur

Claude Code, Anthropic'in kod tabanını okuyup dosya düzenleyen ve komut çalıştıran ajanıdır. Ücretsiz değil, Pro ile gelir. Kurulum, fiyat ve kime uygun.

Kod ajanları ve editörler

Claude limiti neden hemen doluyor? Claude Code limit hatası ve çözümü

Claude ve Claude Code limitinin hızlı dolmasının nedenleri: uzun bağlam, alt ajanlar, model seçimi, API anahtarı. Resmi dokümana göre kontrol ve çözüm adımları.

Kod ajanları ve editörler

Cursor mu Claude Code mu? Editör ile ajan farkı, fiyat ve limitler

Cursor ajanlı bir kod editörü, Claude Code terminal ve IDE'de çalışan bir ajan. Ekim 2026 planları, Claude modellerine erişim ve hangisi kime uygun.

Claude Code

Claude Code auto mode nedir? Yeni oturumlar artık onunla açılıyor

Claude Code'da yeni oturumlar artık auto mode'da açılıyor. Anthropic'in testinde insanlar tehlikeli komutların %13,6'sını durdurdu, auto mode %89'unu.

Kod ajanları ve editörler

Claude Opus mu Sonnet mi? Opus 5.5, Sonnet 5.5 ve Fable farkı

Opus 5.5 uzun süren ajan işleri, Sonnet 5.5 hız ve maliyet dengesi için. Ekim 2026 resmi model sayfasına göre fiyat, hız, bağlam ve Claude Code'da seçim.

Kod ajanları ve editörler

GitHub Copilot mu Cursor mu? Eklenti ile editör farkı, fiyat ve kredi

Copilot mevcut editörünüze eklenti olarak gelir, Cursor ayrı bir ajanlı editördür. Ekim 2026 planları, kredi sınırları, model erişimi ve öğrenci planı.

Eğitim

Yapay zeka ajanlarıyla ürün kurmayı adım adım öğrenin.

Akademi'de ajanlarla gerçek bir ürünü baştan sona kurup yayına almayı anlatıyoruz. Açılış yakında; şimdilik eğitimlerimizi ve 1-1 danışmanlığı inceleyebilirsiniz.