Başlamadan Önce
Claude Code, bilgisayarının terminalinde — komutları yazdığın metin penceresinde çalışır. Ayrıca ücretli bir Claude planına (Pro veya Max) ihtiyacın olacak; ücretsiz planda Claude Code bulunmuyor.
İyi haber: resmi yükleyici ile Node.js kurmana gerek yok. Tek bir komutla hallediliyor.
Öncelikle Windows kullanıyorsan yapman gereken bir şey var: Claude Code'un çalışması için Git for Windows adında ücretsiz bir araca ihtiyacı var (arka planda kullanıyor — kendin Git'i öğrenip kullanmana gerek kalmaz). Windows kullanıyorsan ve henüz kurulu değilse, devam etmeden önce kurmalısın:
git-scm.com/downloads/win adresine git ve yükleyiciyi indir.
Yükleyiciyi çalıştır. Her ekranda varsayılan ayarları kabul etmek için İleri'ye tıkla — birkaç ekran olsa da hiçbir şeyi değiştirmen gerekmiyor.
Hangi düzenleyiciyi kullanacağını sorarsa, varsayılanı bırak ve İleri'ye tıkla.
"PATH ortamını ayarlama" başlıklı ekrana geldiğinde, zaten seçili olan seçeneği işaretli bırak.
Git'in olup olmadığından emin değil misin? Yine de kur — yeniden kurmak sorun yaratmaz. Mac kullanıcıları burayı atlayabilir; ek bir şeye gerek yok.
1. Adım — Terminalini aç
Bilgisayarında terminali aç. Bunu yapmanın yolu sistemine göre değişir:
Windows 10: Windows tuşu + R tuşlarına bas,
cmdyaz ve Enter'a bas. Komut İstemi açılacaktır.Windows 11: Görev çubuğundaki arama kutusuna tıkla (veya Windows tuşuna bas),
Terminalyaz ve sonuçlarda Terminal'e tıkla. Alternatif olarak, Başlat düğmesine sağ tıklayıp Terminal'i seç.Mac: Spotlight'ı açmak için Cmd + Boşluk tuşlarına bas,
Terminalyaz ve Enter'a bas.
Yazabileceğin boş bir satırla bir pencere açılacak. Aşağıdaki tüm komutlar buraya yazılacak.
2. Adım — Yükleyiciyi çalıştır
Sistemine uygun komutu kopyala, terminale yapıştır ve Enter'a bas.
Mac:
curl -fsSL https://claude.ai/install.sh | bash
Windows 11 (ve Terminal/PowerShell kullanan Windows 10):
irm https://claude.ai/install.ps1 | iex
Windows 10 (eğer 1. Adım'da cmd ile Komut İstemi'ni açtıysan):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Çalışırken bazı metinlerin akıp gittiğini göreceksin. Bittiğinde, Claude Code'un başarıyla yüklendiğini onaylayan bir mesaj göreceksin. Bunun yerine bir hata görürsen, aşağıdaki Sorun Giderme bölümüne bak.
3. Adım — Yeni bir terminal penceresi aç
Bu adımı atlamak kolaydır, ancak önemlidir. Terminal pencerenizi tamamen kapatın ve yeni bir tane açın (1. Adım'daki yöntemi kullanarak).
Yükleyici Claude Code'u sisteminize ekler, ancak terminaliniz bu değişikliği yalnızca yeni bir pencere başlattığınızda fark eder. Bunu atlamak, bir sonraki adımın "çalışmıyor" gibi görünmesinin en yaygın nedenidir.
4. Adım — Claude Code'u başlat ve oturum aç
Yeni terminal pencerenizde şunu yaz:
claude
İlk çalıştırdığında nasıl oturum açmak istediğini soracaktır. API anahtarıyla değil, Claude hesabınızla oturum açmayı seçin. Claude hesabınıza giriş yapacağınız bir tarayıcı penceresi açılacaktır. Giriş yaptıktan sonra terminale dönebilirsin — artık Pro veya Max aboneliğin Claude Code'da çalışacaktır.
İşte bu kadar. Artık doğrudan terminale soru veya istek yazabilirsin.
Sorun Giderme
Kurulum adımları her sistemde aynıdır, ancak bir şeyler ters giderse, kullandığın şeye bağlı olarak çözüm farklılık gösterebilir. İşte en yaygın sorunlar.
Yüklendikten sonra "claude tanınmıyor" veya "komut bulunamadı"
Bu neredeyse her zaman 3. Adım'ı atladığın anlamına gelir. Terminali tamamen kapat, yepyeni bir pencere aç ve claude komutunu tekrar yaz. Terminal, yalnızca yeni bir oturum başlattığında yeni yüklenen komutları algılar.
Windows: "irm tanınmıyor" (PowerShell değil, Komut İstemi'ndesin)
Eğer irm komutu "bir iç veya dış komut, çalıştırılabilir program veya toplu iş dosyası olarak tanınmıyor" gibi bir hata veriyorsa, PowerShell yerine Komut İstemi'ndesin. Hangi pencereyi kullandığını satırın başından anlayabilirsin: PowerShell PS C:\... gösterirken, Komut İstemi sadece C:\... gösterir.
Bunun yerine Komut İstemi'ne özel komutu kullan:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 10: "SSL/TLS güvenli kanalı oluşturulamadı"
Bu eski Windows 10 sistemlerinde olabilir. PowerShell'de aşağıdaki satırı önce çalıştır, sonra yükleyici komutunu tekrar çalıştır:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iex
Windows: "Claude Code on Windows requires git-bash"
Bu, Git for Windows'un yüklü olmadığı (veya Claude Code'un onu bulamadığı) anlamına gelir. Yukarıdaki "Başlamadan Önce" bölümüne geri dön ve Git for Windows'u kur, sonra terminalini kapat, yeni bir tane aç ve claude komutunu tekrar çalıştır.
Mac: bir güvenlik veya "izin" mesajı
Resmi yükleyici Claude Code'u sana ait bir klasöre (kendi ev dizinin içine) kurduğu için, eski kurulum yöntemlerinin neden olduğu izin hataları burada oluşmaz. Eğer Mac'in claude komutunu ilk çalıştırdığında uygulamayı doğrulayamadığına dair bir güvenlik uyarısı gösterirse, Sistem Ayarları → Gizlilik ve Güvenlik'i aç, claude hakkındaki mesajı aşağı kaydır ve Yine de İzin Ver'e tıkla. Sonra terminalde claude komutunu tekrar çalıştır.
Hala takıldın mı?
Kurulumdan sonra, Claude Code'un kendi kendini kontrol etmesi ve sorunları belirtmesi için şu komutu çalıştırabilirsin:
claude doctor
Kurulumunu ve yaygın ayarlarını inceler ve genellikle neyi düzeltmen gerektiğini tam olarak söyler.