Hızlı Özet: Windows'a Claude Code yüklemek, WSL2'yi (Windows için Linux Alt Sistemi) ayarlamayı, Ubuntu yüklemeyi ve basit bir yükleme betiği çalıştırmayı gerektirir. Bu işlem, Windows kullanıcılarının Anthropic'in yapay zeka kodlama yardımcısına terminalleri aracılığıyla erişmesine olanak tanır. Yerel Windows ikili dosyaları mevcuttur, ancak Windows yüklemesi için WSL2 hala en iyi uygulamadır.
Claude Code, geliştiricilerin özellik oluşturmasına, hataları düzeltmesine ve geliştirme görevlerini otomatikleştirmesine yardımcı olan, doğrudan terminalde çalışan yapay zeka destekli bir kodlama yardımcısıdır. Ancak Windows kullanıcıları için bir zorluk var.
Claude Code, yerel bir Windows çalıştırılabilir dosyası olarak mevcuttur ve WSL2 olmadan npm veya doğrudan ikili dosya indirmesi yoluyla yüklenebilir. Ancak, Windows için Linux Alt Sistemi'ni (WSL2) gerektirir ve resmi yükleme yöntemi hala WSL2'ye dayanmaktadır.
İşte Windows 11 veya Windows 10'da nasıl çalıştırabileceğiniz.
Sistem Gereksinimleri
Yüklemeye başlamadan önce Windows makinenizin bu gereksinimleri karşıladığını doğrulayın:
- Windows 10 1809+ veya Windows Server 2019+
- Windows 11 (herhangi bir sürüm)
- En az 4 GB boş RAM
- Sistemde Yönetici ayrıcalıkları
- WSL2 ve Ubuntu indirmek için internet bağlantısı
Yükleme, WSL2, Ubuntu ve Claude Code için disk alanı gerektirir.
Adım 1: Windows için Linux Alt Sistemini Etkinleştirme
WSL2, doğrudan Windows içinde bir Linux ortamı sağlar. Claude Code'un işlev görmesini sağlayan temel budur.
PowerShell'i Yönetici olarak açın. Başlat düğmesine sağ tıklayın ve Windows 11'de "Windows PowerShell (Yönetici)" veya "Terminal (Yönetici)" seçeneğini seçin.
Bu komutu çalıştırın:
wsl --install
Bu komut, gerekli Windows özelliklerini etkinleştirir ve varsayılan Linux dağıtımı olarak Ubuntu'yu yükler. Sistem büyük olasılıkla yeniden başlatma isteyecektir.
Yeniden başlattıktan sonra, WSL2 kurulumunu otomatik olarak tamamlar. Ubuntu başlatılır ve kullanıcı adı ile parola ister. Bu kimlik bilgileri yalnızca Linux ortamı içindir; Windows kimlik bilgilerinizle eşleşmesi gerekmez.
Adım 2: WSL2 Kurulumunu Doğrulama
Sistem yeniden başlatıldıktan ve Ubuntu ilk kurulumunu tamamladıktan sonra, WSL2'nin doğru çalıştığını doğrulayın.
Ubuntu terminalini açın (Başlat menüsünde "Ubuntu" diye aratın) ve şunu çalıştırın:
wsl --version
Bu, WSL sürüm bilgilerini görüntüler. Çıktıda "WSL version: 2.x.x" ifadesini arayın.
Komut WSL1 gösterirse, şununla WSL2'ye yükseltin:
wsl --set-default-version 2
Adım 3: Claude Code'u Yükleme
Şimdi asıl Claude Code yüklemesine geçelim. Resmi belgeler tek satırlık bir yükleme betiği sunar.
Ubuntu terminalinde şunu çalıştırın:
curl -fsSL claude.ai/install.sh | bash
Betiği Claude Code ikili dosyasını indirir, gerekli izinleri ayarlar ve sisteme PATH'e ekler. Yükleme süresi internet hızına ve sistem özelliklerine bağlı olarak değişir.
Resmi Claude Code belgelerine göre, yükleyici sistem mimarisini otomatik olarak algılar ve uygun ikili dosya sürümünü indirir.
Yaygın Yükleme Sorunları
Bazı Windows kullanıcıları yükleme sonrasında "command not found: claude" hatası aldıklarını bildiriyor. Bu genellikle PATH değişkeninin güncellenmemiş olmasından kaynaklanır.
Ubuntu terminalini kapatıp yeniden açın, ardından tekrar deneyin. Sorun devam ederse, bu yol yapılandırması resmi olmayan bir çözüm olarak yardımcı olabilir:
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Adım 4: Claude Code'u Kimlik Doğrulama
Claude Code, kullanımdan önce bir Anthropic hesabıyla kimlik doğrulaması gerektirir.
Bu komutu çalıştırın:
claude
Terminal bir URL görüntüler ve kimlik doğrulaması ister. İşlem, bireysel kullanıcılar ve ekip hesapları için biraz farklılık gösterir:
| Hesap Türü | Kimlik Doğrulama Yöntemi | Gerekenler |
|---|---|---|
| Bireysel | Kişisel API anahtarı | API erişimi olan Anthropic hesabı |
| Ekip/Kuruluş | Kuruluş belirteci | Yönetici tarafından sağlanan kimlik doğrulama belirteci |
Sağlanan URL'yi bir tarayıcıda açın, Anthropic hesabınıza giriş yapın ve Claude Code'a izin verin. Terminal başarılı kimlik doğrulamayı onaylar.
WSL2'de Windows Projeleriyle Çalışma
İşlerin karıştığı yer burasıdır. Windows dosya sistemleri ve WSL2 dosya sistemleri ayrıdır.
Windows dosyalarına WSL2'den /mnt/c/ (C: sürücüsü için), /mnt/d/ (D: sürücüsü için) ve diğerleri gibi yollardan erişilebilir. Ancak bunun bir performans maliyeti vardır. Topluluk tartışmaları, Windows'a bağlanmış ve yerel WSL2 dizinleri arasındaki performans farklarını gösteriyor.
En iyi performans için proje dosyalarını WSL2 ev dizinine kopyalayın:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
Ödünleşme mi? IDE entegrasyonu daha karmaşık hale gelir. Visual Studio Code, Remote-WSL uzantısıyla bunu iyi bir şekilde yönetir, ancak diğer IDE'ler zorlanabilir.
Yüklemeyi Test Etme
Basit bir testle Claude Code'un doğru çalıştığını doğrulayın.
Bir proje dizinine gidin (veya bir test klasörü oluşturun):
mkdir ~/claude-test
cd ~/claude-test
claude "basit bir hello world Python betiği oluştur"
Claude Code yanıt vermeli, dosyayı oluşturmalı ve kodu görüntülemelidir. Bu, yüklemenin başarılı olduğunu doğrular.
Fazla Ödeme Yapmayı Bırakın, Önce Mevcut Yapay Zeka Kredilerini Talep Edin
Windows'a Claude Code yüklemek genellikle hızlıdır. Gerçek maliyet, geliştiriciler komutları test etmeye, betikleri çalıştırmaya ve modeli uygulamalara entegre etmeye başladığında ortaya çıkar. Bu deney aşaması çok sayıda API çağrısı üretebilir ve birçok ekip maliyeti ancak inşa etmeye başladıktan sonra fark eder.
Kullanım için para harcamadan önce, yapay zeka kredileri veya iş ortağı programlarından yararlanıp yararlanamayacağınızı kontrol etmeye değer. Get AI Perks, yapay zeka sağlayıcıları, bulut platformları ve geliştirici araçlarından elde edilen kredileri ve indirimleri, bunları nasıl talep edeceğinize dair basit talimatlarla birlikte tek bir yerde toplar.
İlk Claude Code projenizi çalıştırmadan önce, Get AI Perks adresini kontrol edin ve geliştirme maliyetlerinizi karşılayabilecek yapay zeka kredilerini talep edin.
Sıkça Sorulan Sorular
Claude Code, WSL2 olmadan yerel olarak Windows'ta çalışabilir mi?
Evet, ancak WSL2 hala Windows için en iyi yükleme yöntemi olmaya devam ediyor.
Claude Code, Windows Terminal ile çalışır mı?
Evet. Windows Terminal, ayrı bir Ubuntu penceresine geçmeden Claude Code'a erişim sağlayan Ubuntu sekmelerini açabilir. Windows Terminal'de, açılan ok simgesine tıklayın ve profil listesinden Ubuntu'yu seçin.
Mevcut Windows geliştirme araçlarım Claude Code ile çalışacak mı?
Araca bağlıdır. Visual Studio Code, Remote-WSL uzantısı aracılığıyla iyi entegre olur. JetBrains IDE'leri ve diğer araçlar ek yapılandırma gerektirebilir. Resmi belgeler VS Code ve JetBrains'i desteklenen platformlar olarak belirtmektedir.
Windows'ta Claude Code'u nasıl güncellerim?
Claude Code varsayılan olarak otomatik olarak güncellenir. Manuel olarak güncellemek için Ubuntu terminalinde `claude update` komutunu çalıştırın. Otomatik güncelleme özelliği, kurumsal ortamlar için gerekirse yapılandırma dosyaları aracılığıyla devre dışı bırakılabilir.
Claude Code ve Claude API arasındaki fark nedir?
Claude Code, komutları çalıştıran ve dosyaları düzenleyen terminal tabanlı bir kodlama yardımcısıdır. Claude API, özel uygulamalar oluşturmak için Claude'un dil modeline programatik erişim sağlar. Farklı amaçlara hizmet ederler ve farklı kurulum süreçleri gerektirirler.
Windows'ta Claude Code'u .NET projeleriyle kullanabilir miyim?
Evet, ancak bazı çekincelerle. Topluluk tartışmaları, WSL2'deki .NET SDK desteğinin çalıştığını ancak Ubuntu içine Linux sürümü .NET SDK'sının yüklenmesini gerektirdiğini belirtiyor. Windows'ta yüklenen .NET, WSL2'den erişilebilir olmayacaktır.
Claude Code ne kadar ücretlidir?
Fiyatlandırma kullanıma ve hesap türüne bağlıdır. Güncel fiyatlandırma katmanları ve ekip planları için resmi Anthropic web sitesini kontrol edin, çünkü maliyetler API tüketimine ve kurumsal gereksinimlere göre değişiklik gösterir.
Kurulum Sonrası Sonraki Adımlar
Claude Code yüklendikten sonra yeteneklerini keşfetmeye başlayın. Hızlı başlangıç belgeleri, daha karmaşık işlemlere geçmeden önce kod açıklamaları gibi basit görevlerle başlamanızı önerir.
Aşina olmak için şu komutları deneyin:
- claude "bu fonksiyonu açıkla" -- Kod açıklamaları alın
- claude commit -- Git commit mesajları oluşturun
- claude -c -- En son konuşmayı devam ettirin
Resmi belgeler, IDE entegrasyonu, eklenti yükleme ve gelişmiş yapılandırma seçenekleri için ayrıntılı kılavuzlar sunar. Ekipler için sunucu yönetimi ayarları ve analiz takibi, Claude Code dağıtımları üzerinde ek kontrol sağlar.
WSL2 kurulumu, yerel Windows uygulamalarına kıyasla ek adımlar gibi görünebilir, ancak şu anda Windows'ta Claude Code çalıştırmanın tek yoludur. İyi haber mi? Yapılandırıldıktan sonra sorunsuz çalışır ve çoğu geliştirme iş akışıyla entegre olur.
