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
- Terminali açın. macOS'ta Terminal, Windows'ta PowerShell. Windows'ta istem satırı
PS C:\ile başlıyorsa PowerShell'desiniz. - 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.
- Yeni bir terminal açıp doğrulayın.
claude --versionyazın; bir sürüm numarası ve yanında "(Claude Code)" görmelisiniz. Daha ayrıntılı denetim içinclaude doctor. - Projeye girip başlatın.
cd proje-klasoruve ardındanclaude. - 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. - Proje dosyasını oluşturun. Oturumda
/inityazı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. - İlk soruyu sorun. "Bu proje ne yapıyor?" gibi bir soruyla başlayın; Claude dosyaları gerektikçe kendisi okuyor.
- İlk değişikliği yaptırın. Küçük bir iş verin. Değişiklikten önce izin isterse onaylayın.
Shift+Tabizin 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
claudebulunamadı. 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_KEYortam 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
/clearkullanı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?
Claude Code Windows'ta nasıl kurulur?
Claude Code VS Code'da nasıl kullanılır?
claude komutu bulunamadı hatası neden çıkıyor?
Claude Code nasıl güncellenir?
Ücretsiz hesapla giriş yapabilir miyim?
Kaynaklar
- Anthropic, Claude Code Quickstart
- Anthropic, Claude Code Advanced setup
- Anthropic, Use Claude Code in VS Code
- Anthropic, How Claude remembers your project
- Anthropic, Claude Code Overview
- Anthropic, Claude Plans and Pricing
- Anthropic, What is the Max plan
- Anthropic, Claude Code Manage costs
- Anthropic, Claude Code Model configuration
- Anthropic, Claude Code Data usage
- Anthropic, Claude Code Settings reference (language)
- App Store Türkiye, Claude by Anthropic
Değişiklik günlüğü
- : İ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.