Hızlı Özet: Claude Code, macOS, Windows ve Linux için resmi Claude Code web sitesindeki yerel yükleyiciler aracılığıyla kurulabilir. Windows kullanıcıları Claude Code'u çalıştırmadan önce WSL2'yi kurmalıdır. Kurulumdan sonra, ilk başlatmada Claude Code tarayıcı penceresi açtığında Claude hesabınızla kimlik doğrulaması yapın ve doğrudan terminalinizden veya masaüstü uygulamanızdan yapay zeka yardımıyla kodlamaya başlayın.
Claude Code, Anthropic'in aracılı yapay zeka geliştirme araçlarına yönelik hamlesini temsil eder. Bu komut satırı yardımcısı kod tabanlarını okur, dosyaları düzenler, komutları çalıştırır ve geliştirme iş akışlarıyla entegre olur.
Ancak kurulumunu yapmak her zaman kolay değildir. Farklı platformlar farklı yaklaşımlar gerektirir. Windows ekstra kurulum gerektirir. Ve dokümantasyon, kapsamlı olsa da, yeni başlayanları bunaltabilir.
Bu rehber karmaşıklığı ortadan kaldırır. Sistem gereksinimlerini, platforma özgü kurulum adımlarını, kimlik doğrulamasını ve doğrulamayı kapsar—Claude Code'un doğru şekilde çalışması için gereken her şey.
Kurulumdan Önce Sistem Gereksinimleri
Resmi Claude Code dokümantasyonuna göre, araç macOS, Windows ve Linux'u destekler. Ancak, her platformun özel ön koşulları vardır.
macOS için gereksinimler minimum düzeydedir. Sistemin macOS 13.0 veya daha yenisine ihtiyacı var. Hem Intel hem de Apple Silicon çipleri iyi çalışır.
Windows daha fazla karmaşıklık sunar. İşletim sistemi Windows 10 Build 19041 veya daha yenisi ya da Windows 11 olmalıdır. Ancak işte püf noktası—Claude Code, Windows'ta yerel olarak çalışmaz.
Linux için Windows Alt Sistemi 2 (WSL2) zorunludur. Bu, Claude Code'un aslında çalıştığı bir Linux ortamı oluşturur. WSL2 olmadan kurulum başarısız olur.
Linux kullanıcıları 64 bit bir dağıtıma ihtiyaç duyar. Resmi dokümantasyon Ubuntu, Debian, Fedora ve diğer büyük dağıtımları desteklediğini onaylar. Alpine Linux ve musl tabanlı sistemler ek yapılandırma gerektirir.
Tüm platformlar kurulum sırasında kararlı bir internet bağlantısına ihtiyaç duyar. İndirme boyutları değişir ancak genellikle önceden kurulu olanlara bağlı olarak 50 MB ila 500 MB arasında değişir.
| Platform | Minimum Sürüm | Özel Gereksinimler |
|---|---|---|
| macOS | 13.0 | Yok |
| Windows | 10 Build 19041 veya 11 | WSL2 gerekli |
| Linux | 64 bit dağıtım | glibc tabanlı tercih edilir |
macOS'a Claude Code Kurulumu
macOS kurulum süreci yerel bir yükleyici kullanır. Bu, tüm platformlar arasındaki en basit yoldur.
İlk olarak, yükleyiciyi resmi Claude Code web sitesinden indirin. İndirme sayfası otomatik olarak macOS'u algılar ve uygun paketi sunar.
İndirilen .dmg dosyasını açın. Claude Code uygulamasını Uygulamalar klasörüne sürükleyin. Standart macOS kurulumu—burada olağandışı bir şey yok.
Bazı kullanıcılar ilk başlattıklarında bir güvenlik uyarısıyla karşılaşırlar. macOS varsayılan olarak kimliği belirsiz geliştiricilerden gelen uygulamaları engeller. Claude Code uygulamasına sağ tıklayın ve bu tek seferlik uyarıyı atlamak için "Aç" seçeneğini seçin.
Komut satırı aracı masaüstü uygulamasıyla otomatik olarak yüklenir. Terminali açın ve doğrulamak için `claude --version` yazın. Sürüm numarası görünüyorsa, kurulum başarılı olmuştur.
macOS Kurulumunu Doğrulama
Her şeyin çalıştığını doğrulamak için şu komutları çalıştırın:
| `claude --version` `claude --help` |
Her iki komut da hatasız çıktı vermelidir. Sürüm komutu yüklü Claude Code sürümünü gösterir. Yardım komutu mevcut seçenekleri ve komutları görüntüler.
Bir test dizini oluşturmak tam işlevselliği doğrulamaya yardımcı olur. Bir proje klasörüne gidin ve etkileşimli bir oturum başlatmak için `claude` komutunu çalıştırın. Araç başlatılmalı ve henüz giriş yapmadıysanız kimlik doğrulama için sizi uyarmalıdır.
WSL2 ile Windows Kurulumu
Windows kurulumu birden fazla adım gerektirir. Süreç macOS'tan daha uzun sürer ancak yönetilebilir kalır.
WSL2 önce kurulmalıdır. PowerShell'i Yönetici olarak açın ve şunu çalıştırın:
| `wsl --install` |
Bu komut varsayılan olarak WSL2 ve Ubuntu'yu kurar. Sistem yeniden başlatma gerektirecektir. Yeniden başlattıktan sonra, Ubuntu ilk kurulumu tamamlamak için otomatik olarak başlatılır.
İstendiğinde bir Unix kullanıcı adı ve şifresi oluşturun. Bu kimlik bilgileri Windows oturum açma kimlik bilgilerinden ayrıdır.
WSL2 çalıştığında, Linux kurulum süreci geçerlidir. Ubuntu terminalini (WSL2 ile kurulan) açın ve Linux için Claude Code yükleyicisini indirin.
WSL2'de Claude Code Kurulumu
Resmi dokümantasyona göre, kurulum komutu yerel yükleyiciyi indirir ve çalıştırır:
| `curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash` |
Bu betik bağımlılıkları otomatik olarak yönetir. Gerekirse Node.js'yi kurar, Claude Code ikili dosyasını ayarlar ve PATH değişkenlerini yapılandırır.
Kurulum birkaç dakika sürer. İlerleme çubukları ve durum mesajları neler olduğunu gösterir. Tamamlandığında, ortam değişkenlerini yenilemek için terminali kapatıp yeniden açın.
Kurulumu test etmek macOS ile aynı işlemi izler. Doğrulamak için `claude --version` komutunu çalıştırın.
Linux Kurulum Süreci
Linux kullanıcıları en basit kurulum yoluna sahiptir. Yerel yükleyici, WSL2 gibi ek katmanlara gerek kalmadan doğrudan çalışır.
Yükleme betiğini indirin ve çalıştırın:
| `curl -fsSL claude.ai/install.sh | bash` |
Bu, Claude Code ikili dosyasını indirir, bağımlılıkları kurar ve kabuk ortamını yapılandırır. Betik dağıtımı algılar ve buna göre ayarlar.
Ubuntu ve Debian tabanlı sistemler için betik kurulumu yapılandırır. Resmi dokümantasyon Ubuntu 20.04+, Debian 10+ ve diğer dağıtımları desteklediğini onaylar.
Alpine Linux Hususları
Alpine Linux ve musl tabanlı dağıtımlar ek adımlar gerektirir. Resmi dokümantasyon bu sistemlerin manuel yapılandırma gerektirdiğini belirtir.
Standart yükleyici Alpine'de başarısız olabilir. Bunun yerine, doğrudan sürümler sayfasından musl uyumlu ikili dosyayı indirin. Sistem PATH'indeki bir dizine, genellikle `/usr/local/bin`'e çıkarın.
Yürütülebilir izinleri ayarlayın:
| `chmod +x /usr/local/bin/claude` |
Alpine kullanıcıları devam etmeden önce uyumluluğu doğrulamalıdır. Bazı özellikler glibc tabanlı dağıtımlar kadar aynı şekilde çalışmayabilir.
Kimlik Doğrulama ve Hesap Kurulumu
Claude Code'u kurduktan sonra terminalinizde `claude` komutunu çalıştırın. İlk başlatmada Claude Code, oturum açmanız için bir tarayıcı penceresi açar.
Bu, Claude kimlik doğrulama sayfasını açar. Mevcut bir Claude hesabı ile giriş yapın veya yeni bir hesap oluşturun.
Tarayıcı bir yetkilendirme kodu görüntüler. Bu kodu kopyalayın ve terminale geri dönün. İstendiğinde kodu yapıştırın.
Başarılı kimlik doğrulama, kimlik bilgilerini yerel olarak depolar. Kimlik bilgileri süresi dolmadıkça veya manuel olarak temizlenmedikçe gelecekteki oturumlar giriş gerektirmez.
Ekip ve Kurumsal Kimlik Doğrulama
Resmi kimlik doğrulama dokümantasyonuna göre, Claude for Teams veya Enterprise kullanan ekiplerin ek seçenekleri vardır. Kuruluşlar tek oturum açma (SSO) veya bulut sağlayıcı kimlik doğrulaması yapılandırabilir.
SSO kurulumu yönetici yapılandırması gerektirir. Bireysel geliştiriciler daha sonra kişisel Claude hesapları yerine kuruluşlarının kimlik sağlayıcısı aracılığıyla kimlik doğrulaması yapar.
Bulut sağlayıcı kimlik doğrulaması, AWS, Google Cloud ve Azure dağıtımları için çalışır. Bu yöntem ayrı Claude hesapları yerine mevcut bulut kimlik bilgilerini kullanır.
| Kimlik Doğrulama Yöntemi | Kullanım Durumu | Kurulum Karmaşıklığı |
|---|---|---|
| Kişisel Hesap | Bireysel geliştiriciler | Basit |
| Ekip/Kurumsal SSO | Kuruluşlar | Yönetici gerektirir |
| Bulut Sağlayıcı | AWS/GCP/Azure kullanıcıları | Orta |
Masaüstü Uygulama Kurulumu
Claude Code hem komut satırı hem de masaüstü uygulamaları sunar. Masaüstü uygulaması, tam terminal işlevselliğini korurken grafiksel bir arayüz sağlar.
Masaüstü yükleyicisini resmi Claude web sitesinden indirin. Sayfa macOS, Windows ve Windows ARM64 sürümleri sunar. Sistem için uygun sürümü seçin.
macOS kurulumu, daha önce açıklanan .dmg işlemine benzer şekilde izler. Windows kullanıcıları, WSL2 kurulumu gerektirmeyen grafiksel bir arayüz için masaüstü uygulamasını indirebilir.
Masaüstü uygulaması, entegre terminal erişimi içerir. Harici terminal uygulamalarına geçiş yapmadan Claude Code oturumlarını başlatabilir.
Masaüstü uygulamasının bir avantajı arka plan kullanılabilirliğidir. Resmi indirme sayfasına göre, uygulama 'arka planda hazır kalır' ve herhangi bir pencereyi değiştirmeden veya odağı kaybetmeden herhangi bir uygulamadan getirilebilir.
Claude Code Stack'iniz İçin Kredileri Bulmak İçin Get AI Perks'i Kullanın
Kurulum en kolay kısımdır. Gerçek maliyet genellikle bunun etrafındaki her şeyden kaynaklanır: altyapı, destekleyici araçlar ve kurulum ve test sırasında kullanılan ücretli hizmetler. Get AI Perks, startup kredilerini ve indirimlerini tek bir yerde listeleyerek ve uygulama rehberliği ile yardımcı olabilir.
Get AI Perks ile şunları yapabilirsiniz:
- Bulut ve yapay zeka ile ilgili araçlar için krediler bulun
- Başvurmadan önce avantaj koşullarını kontrol edin
- Niteliklendirilme olasılığınız olmayan tekliflere zaman harcamaktan kaçının
- Kurulumunuzu yerine getirmenin maliyetini düşürün
Mevcut tekliflerin Claude Code ile kullanmayı planladığınız araçlarla eşleşip eşleşmediğini görmek için Get AI Perks'i ziyaret edin.
IDE Uzantıları ve Entegrasyonları
Bağımsız kurulumun ötesinde, Claude Code popüler geliştirme ortamlarıyla entegre olur. Visual Studio Code ve JetBrains IDE'leri için uzantılar mevcuttur.
VS Code uzantısı marketplace aracılığıyla kurulur. Uzantılar panelinde "Claude Code" araması yapın ve Yükle'ye tıklayın. Uzantı, komut satırı aracının önce kurulmasını gerektirir.
Bazı kullanıcılar, paketlenmiş VS Code uzantı dosyasıyla ilgili sorunlar bildirir. Otomatik kurulum "Merkezi dizin kaydı imzası bulunamadı" hatasıyla başarısız olursa, paketlenmiş .vsix dosyası bozuk olabilir.
Çözüm, CLI'nin paketlenmiş sürümüne güvenmek yerine uzantıyı Visual Studio Code marketplace'ten manuel olarak yüklemeyi içerir. Bu, iki bileşeni ayırır ve kurulum çakışmalarını önler.
JetBrains entegrasyonu benzer şekilde çalışır. IntelliJ IDEA, PyCharm, WebStorm veya diğer JetBrains ürünlerindeki JetBrains marketplace'ten eklentiyi kurun.
Kurulum Başarısını Doğrulama
Doğru doğrulama, gerçek geliştirme görevlerine başlamadan önce Claude Code'un doğru şekilde çalıştığını garanti eder.
Temel doğrulama komut kullanılabilirliğini kontrol eder:
| `claude --help` `claude --version` |
Bu komutlar hatasız çalışmalıdır. Yardım komutu mevcut seçenekleri listeler. Sürüm komutu yüklü sürümü gösterir.
İşlevsel test, bir oturum başlatmayı gerektirir. Bir test dizini oluşturun:
| `mkdir test-project` `cd test-project` `claude` |
Bu, etkileşimli bir Claude Code oturumu başlatır. Araç dizini (bu durumda boş) analiz etmeli ve bir komut istemi sunmalıdır.
Oturum içinde temel komutları deneyin. Mevcut eylemleri görmek için `help` yazın. "Bir README dosyası oluştur" veya "Ne yapabileceğini açıkla" gibi basit görevler isteyin.
Başarılı yanıtlar, doğru kurulumu gösterir. Hatalar meydana gelirse, genellikle kimlik doğrulama, ağ bağlantısı veya eksik bağımlılıklarla ilgilidir.
Güncelleme ve Sürüm Yönetimi
Claude Code varsayılan olarak otomatik güncellenir. Resmi dokümantasyon, aracın yeni sürümleri kontrol ettiğini ve kullanıcı müdahalesi olmadan kurduğunu açıklar.
Güncelleme davranışı Claude Code ayarları aracılığıyla yapılandırılabilir. Resmi dokümantasyon sürüm kanalı yapılandırmasını ve manuel güncelleme seçeneklerini kapsar.
Manuel güncellemeler, yükleme betiğini tekrar çalıştırmayı gerektirir. İlk kurulum için kullanılan aynı komut en son sürümü çeker:
| `curl -fsSL claude.ai/install.sh | bash` |
Belirli sürümleri kurmak, test veya uyumluluk nedenleriyle mümkündür. Gelişmiş kurulum dokümantasyonu sürüm sabitleme ve sürüm kanalı yapılandırmasını kapsar.
Sürüm kanalları arasında kararlı (stable), beta ve gece (nightly) bulunur. Üretim işleri için kararlı sürüm önerilir. Beta ve gece kanalları yeni özelliklere erken erişim sağlar ancak hatalar içerebilir.
Yaygın Kurulum Sorunları
Claude Code kurulumuyla ilgili topluluk tartışmalarında birkaç sorun sıklıkla görülür.
PATH yapılandırması birçok soruna neden olur. Kurulumdan sonra `claude` komutu bulunamazsa, ikili dizin sistem PATH'inde değildir.
macOS ve Linux'ta dizini PATH'e eklemek genellikle `~/.bashrc`, `~/.zshrc` veya benzeri kabuk yapılandırma dosyalarını düzenlemeyi içerir. Kurulum betiği genellikle bunu otomatik olarak halleder, ancak manuel doğrulama sorun gidermeye yardımcı olur.
WSL2'deki Windows kullanıcıları kurulumdan sonra terminali kapatıp yeniden açmaları gerekebilir. Ortam değişkenleri mevcut oturumlarda yenilenmez.
Ağ kısıtlamaları bazı kurulumları engeller. Kurumsal güvenlik duvarları veya vekil sunucular, yükleyiciyi indirmeyi veya kimlik doğrulama sunucularına bağlanmayı engelleyebilir.
Vekil yapılandırması ortam değişkenleri gerektirir:
| `export HTTP_PROXY= proxy.example.com:8080` `export HTTPS_PROXY= proxy.example.com:8080` |
Korumalı dizinlere kurulum yaparken izin hataları oluşur. Yükleyicinin `/usr/local/bin` veya eşdeğer konumlara yazma erişimine ihtiyacı vardır. `sudo` ile çalıştırmak bunu çözer ancak gerekmedikçe kaçınılmalıdır.
Sıkça Sorulan Sorular
Claude Code internet bağlantısı olmadan çalışabilir mi?
Hayır. Claude Code'un çalışması için internet bağlantısı gerekir. Araç, kod ve sorguları işlenmek üzere Anthropic'in sunucularına gönderir. Yerel önbellekleme, bazı işlemlerin geçici olarak çevrimdışı çalışmasına izin verebilir, ancak tam işlevsellik aktif bir bağlantı gerektirir.
Claude Code mevcut yapay zeka kodlama araçlarıyla çalışır mı?
Evet. Claude Code, GitHub Copilot, Cursor veya diğer yapay zeka geliştirme araçlarıyla birlikte çalışabilir. Bağımsız çalışırlar ve çakışmazlar. Ancak, birden fazla yapay zeka yardımcısını aynı anda kullanmak, hangi aracın hangi görevi üstlendiği konusunda kafa karışıklığına neden olabilir.
Tüm Windows özellikleri için WSL2 gerekli mi?
Komut satırı aracı Windows'ta WSL2 gerektirir. Ancak, masaüstü uygulaması WSL2 gerektirmeyen Windows'ta yerel olarak çalışır. Masaüstü uygulaması, saf komut satırı etkileşimi yerine grafiksel bir arayüz aracılığıyla benzer işlevsellik sağlar.
Claude Code kullanmanın maliyeti nedir?
Fiyatlandırma kullanıma ve abonelik katmanına göre değişir. Maliyetlerin ve plan yapılarının zaman içinde değiştiği için güncel fiyatlandırma için resmi Claude web sitesini kontrol edin. Bazı özellikler Claude Pro veya Kurumsal abonelikler gerektirir.
Claude Code proje dizininin dışındaki dosyaları düzenleyebilir mi?
Varsayılan olarak, Claude Code güvenlik nedeniyle dosya erişimini mevcut proje diziniyle sınırlar. Yapılandırma ayarları izinleri genişletebilir, ancak bunu yapmak açık yetkilendirme gerektirir. Kum havuzu (sandboxing) dokümantasyonu, izin yönetimini ayrıntılı olarak kapsar.
Claude Code ve Claude API arasındaki fark nedir?
Claude Code, etkileşimli kodlama yardımı için bir geliştirme aracıdır. Claude API, Claude'un yapay zeka yeteneklerini kullanan uygulamalar oluşturmak için programlı erişim sağlar. Farklı amaçlara hizmet ederler—biri kod yazan geliştiriciler için, diğeri yapay zeka özelliklerini entegre eden uygulamalar için.
Kaldırma işlemi tüm Claude Code verilerini siler mi?
Kaldırma, uygulama ikili dosyasını kaldırır ancak yapılandırma dosyalarını ve önbelleğe alınmış verileri bırakabilir. Tam kaldırma, macOS ve Linux'ta `~/.claude` dizinini veya Windows'ta eşdeğer AppData konumunu manuel olarak silmeyi gerektirir.
Kurulum Sonrası Başlangıç
Claude Code kurulup doğrulandıktan sonraki adım, onu etkili bir şekilde nasıl kullanacağını anlamaktır.
Hızlı başlangıç dokümantasyonu basit görevlerle başlamayı önerir. Mevcut bir projeye gidin ve etkileşimli bir oturum başlatmak için `claude` komutunu çalıştırın.
Claude'dan proje yapısını açıklamasını isteyin. Kod tabanının ne yaptığının bir özetini isteyin. Bu keşif sorguları, aracın kodu nasıl yorumladığını anlamaya yardımcı olur.
Küçük değişiklikler yapmayı deneyin. Claude'dan işlevlere yorum eklemesini, basit test dosyaları oluşturmasını veya temel kod bloklarını yeniden düzenlemesini isteyin. Bu görevler risk olmadan düzenleme yeteneklerini gösterir.
Proje sürüm kontrolü kullanıyorsa Git entegrasyonu otomatik olarak çalışır. Claude Code, işlem (commit) oluşturabilir, farklılıkları (diff) açıklayabilir ve değişikliklere göre iyileştirmeler önerebilir.
Resmi dokümantasyon, yaygın geliştirme görevleri için iş akışı örnekleri içerir. Bunlar hata ayıklama, özellik uygulama, kod inceleme ve otomatik testleri kapsar.
Claude Code gelişen bir araçtır. Kurulum sadece temeldir. Yeteneklerini, sınırlamalarını ve en iyi uygulamalarını anlamak deneme ve pratik gerektirir.
Claude Code'u kurmaya hazır mısınız? Platformunuz için uygun yükleyiciyi resmi web sitesinden indirin ve bu rehberde özetlenen adımları izleyin. Claude hesabınızla kimlik doğrulaması yapın, kurulumun doğru çalıştığını doğrulayın ve yapay zeka destekli geliştirme explorasyonuna başlayın.
