Claude Kod Kurulumu: Kapsamlı 2026 Rehberi

Hızlı Özet: Claude Code, macOS ve Linux'ta yerel olarak veya WSL2 aracılığıyla Windows'ta çalışan terminal tabanlı bir AI kodlama yardımcısıdır. Kurulumu, bir Anthropic API anahtarı oluşturmayı, platforma özel bir yükleyici çalıştırmayı, anahtarla kimlik doğrulamayı ve bir test komutuyla kurulumu doğrulayın. 

Claude Code, Anthropic'in resmi terminal tabanlı kodlama yardımcısıdır. Doğrudan komut satırında yaşar ve doğal dil komutları aracılığıyla kod oluşturmaktan hata düzeltmeye kadar her şeyi halleder.

Ancak kurulum süreci her zaman sorunsuz değildir. Windows kullanıcılarının WSL2'ye ihtiyacı vardır. API kimlik doğrulaması ilk kez kullananları zorlayabilir. Sürüm çakışmaları yaşanır.

Bu kılavuz, sistem gereksinimlerinden ilk kodlama oturumunuza kadar tüm platformlar için eksiksiz kurulum sürecini anlatır.

Claude Code Gerçekten Nedir

Claude Code, geliştirme ortamlarıyla entegre olan bir ajans terminal uygulamasıdır. Kod tabanlarını anlar, rutin görevleri yürütür ve konuşma komutları aracılığıyla git iş akışlarını yönetir.

Tarayıcı tabanlı araçların aksine, Claude Code terminalde yerel olarak çalışır. Proje dosyalarına doğrudan erişir, oturumlar boyunca bağlamı korur ve mevcut geliştirme iş akışlarıyla entegre olur. Resmi Claude Code belgelerine göre, araç Anthropic'in API'sine bağlanır ve Amazon Bedrock, Google Cloud Vertex AI ve Azure AI ile entegrasyonu destekler.

Araç, geleneksel kodlama yardımcılarından farklı çalışır. Gerçek konuşma: kod tamamlama aracından çok terminalinizde bir çift programcıya sahip olmak gibidir.

Claude Code İçin Sistem Gereksinimleri

Kurulumdan önce, sistemlerin belirli gereksinimleri karşılaması gerekir. Her platformun ihtiyacı olanlar şunlardır:

Tüm platformlar, API çağrıları için kararlı bir internet bağlantısına ihtiyaç duyar. Claude Code indirmeleri genellikle yaklaşık 50MB gerektirir, Windows'ta WSL2, Linux alt sistemi için yaklaşık 500MB ekler.

Depolama açısından en az 4GB boş alan bekleyin. Uygulamanın kendisi küçüktür, ancak bağımlılıklar ve proje dosyaları için yer önemlidir.

Windows'a Özel Gereksinimler

Claude Code, Node.js yüklüyse PowerShell veya Komut İstemi aracılığıyla Windows'ta çalışabilir. Araç, bir Linux ortamı oluşturmak için Windows Subsystem for Linux 2'yi gerektirir.

claude.ai'den gelen kurulum kılavuzlarına göre, Windows 10 sistemlerinin Sürüm 1903 veya üstü ve Build 19041 veya daha yüksek sürüme ihtiyacı vardır. Windows 11 kullanıcılarında yerleşik WSL2 desteği vardır. İlk WSL2 kurulumu için yönetici ayrıcalıkları gereklidir.

Süreç, BIOS'ta sanallaştırmayı etkinleştirmeyi, Windows özelliklerini etkinleştirmeyi ve bir Linux dağıtımı yüklemeyi içerir. Ubuntu 22.04 LTS, uyumluluk için önerilen dağıtımdır.

Claude Code Kurulumu: Adım Adım Süreç

Kurulum süreci platforma göre değişiklik gösterir. Claude Code'u her işletim sisteminde çalıştırmak için izlenmesi gereken adımlar şunlardır.

macOS ve Linux'a Kurulum

macOS ve Linux kurulumları aynı deseni izler. Her iki platform da ek kurulum gerektirmeden yerel kurulumu destekler.

Süreç yükleyiciyi indirmekle başlar. Bir terminal açın ve şunu çalıştırın:

curl -fsSL claude.ai/install.sh | sh

Betik işletim sistemini algılar, uygun ikili dosyayı indirir ve Claude Code'u yerel bin dizinine yükler. Kurulum genellikle kararlı bir bağlantıyla iki dakikadan kısa sürede tamamlanır.

Curl olmayan sistemler için wget bir alternatif olarak çalışır. Yükleyici, Claude Code'u sistem PATH'ine otomatik olarak ekler.

Windows'a WSL2 Üzerinden Kurulum

Windows kurulumu önce WSL2'yi kurmayı gerektirir. İşte eksiksiz süreç:

PowerShell'i Yönetici olarak açın ve WSL'yi etkinleştirin:

wsl --install

Bu komut gerekli Windows özelliklerini etkinleştirir, WSL2 çekirdeğini indirir ve varsayılan olarak Ubuntu'yu yükler. Sistem bir yeniden başlatma isteyecektir. Yeniden başlattıktan sonra, kullanıcı kurulumunu tamamlamak için Ubuntu otomatik olarak başlatılır.

İstendiğinde bir kullanıcı adı ve parola oluşturun. Bu kimlik bilgileri, Windows oturum bilgilerinden ayrı olarak Linux ortamı içindir.

WSL2 çalıştıktan sonra, Linux kurulum süreci geçerli olur. Ubuntu terminalinde, yukarıdaki macOS/Linux bölümündeki curl komutunu çalıştırın.

Yükleyici gerisini halleder. Claude Code, WSL2 ortamına yüklenir ve Ubuntu terminali aracılığıyla çalışır.

Anthropic API Anahtarı Alma

Claude Code, kimlik doğrulama için bir Anthropic API anahtarı gerektirir. Anahtar, yerel kurulumu Anthropic'in sunucularına bağlar.

Anthropic Console'u console.anthropic.com adresinde ziyaret edin. Bir hesap oluşturun veya mevcut kimlik bilgilerinizle giriş yapın. Hesap ayarlarında API Anahtarları'na gidin.

Yeni bir API anahtarı oluşturmak için "Anahtar Oluştur"a tıklayın. Anahtar bir kez görünür—hemen kopyalayın. Anthropic, sayfadan ayrıldıktan sonra tam anahtarı tekrar göstermez.

Anahtarı güvenli bir şekilde saklayın. Anthropic API'sine ve ilgili tüm faturalandırmaya tam erişim sağlar.

API Maliyetlerini Anlama

Claude Code, Anthropic API aracılığıyla kullanıma bağlı bir modelle çalışır. claude.ai kurulum kılavuzlarından alınan verilere dayanarak, maliyetler modele göre değişir:

Faturalandırmayı etkinleştirmek için minimum satın alma 5 ABD dolarıdır, ancak topluluk tartışmaları 20-30 ABD dolarının test için daha iyi bir alan sağladığını öne sürüyor. Alternatif abonelik seçenekleri arasında yoğun kullanım için ayda 20 ABD doları Claude Pro veya ayda 100 ABD doları Claude Max bulunur.

Varsayılan davranış, kullanım sınırlarının %50'sine ulaşılana kadar Opus'u kullanır, ardından maliyet verimliliği için Sonnet'e geçer.

Kimlik Doğrulama ve İlk Başlatma

Kurulumdan sonra, Claude Code ilk kullanımdan önce kimlik doğrulaması gerektirir. Şunu çalıştırarak Claude Code'u başlatın:

claude

İlk başlatma, API anahtarını ister. Anthropic Console'dan anahtarı yapıştırın ve Enter'a basın. Claude Code, anahtarı doğrular ve yerel yapılandırma dosyalarında güvenli bir şekilde saklar.

Kimlik doğrulama oturumlar boyunca kalır. API anahtarının tekrar girilmesi gerekmez, ancak açıkça kaldırılırsa veya hesaplar değiştirilirse.

Kimlik doğrulamanın başarılı olduğunu doğrulamak için Claude Code bir karşılama mesajı ve komut istemi görüntüler. Arayüz, kullanılabilir komutları gösterir ve Anthropic'in API'sine bağlantıyı onaylar.

Model Tercihlerini Yapılandırma

Claude Code, otomatik model seçimini varsayılan olarak ayarlar, ancak manuel yapılandırma mümkündür. Resmi belgelere göre, kullanıcılar /model komutu aracılığıyla veya CLAUDE_CODE_EFFORT_LEVEL ortam değişkenini ayarlayarak model seçimini ayarlayabilir.

Çaba seviyesi, Opus 4.6 ve Sonnet 4.6 modelleri için düşünce derinliğini kontrol eder: düşük, orta veya yüksek. Daha yüksek çaba seviyeleri, muhakeme derinliğini artırır ancak maliyeti ve yanıt süresini de artırır.

Derin analiz gerektiren projeler için, "ultrathink" kelimesini istemlere eklemek, o belirli dönüş için çabayı geçici olarak yüksek olarak ayarlar.

Kurulum Başarısını Doğrulama

Kimlik doğrulamasından sonra, Claude Code'un doğru çalıştığını doğrulayın. Şu temel testleri çalıştırın:

claude --help
claude --version

yardım komutu kullanılabilir seçenekleri ve komutları görüntüler. Sürüm çıktısı hangi sürümün yüklü olduğunu onaylar. Her iki komut da hatasız olarak çalışmalıdır.

Ardından, bir proje dizininde Claude Code'u test edin. Bir test klasörü oluşturun:

mkdir test-project
cd test-project
echo "# Test Project" > README.md
claude

Claude Code oturumu içinde, temel etkileşimleri deneyin:

• Kullanılabilir komutları görmek için "help" yazın
• "explain what you can do" (ne yapabileceğini açıkla) diye sorun
• "summarize this project" (bu projeyi özetle) isteyin
• /help komutunu test edin

Bu etkileşimler, Claude Code'un proje dosyalarını okuyabildiğini ve istemlere yanıt verebildiğini onaylar. Başarılı yanıtlar, kurulumun işlevsel olduğu anlamına gelir.

Projeler İçin Claude Code Yapılandırması

Claude Code, proje özel ayarlarını yapılandırma dosyalarında saklar. Bu dosyalar davranışı özelleştirir, bellek tanımlar ve iş akışları oluşturur.

Ana yapılandırma dosyası, proje kökündeki CLAUDE.md'dir. Bu dosya, Claude Code'un oturumlar sırasında başvurduğu talimatları, bağlamı ve proje özel yönergeleri içerir.

Temel bir CLAUDE.md dosyası oluşturun:

# Proje Bağlamı

Bu, [teknolojiler] ile oluşturulmuş bir [proje türü]'dür.

## Ana Yönergeler
– [Önemli kural 1]
– [Önemli kural 2]

## Proje Yapısı
[Klasör organizasyonunun kısa açıklaması]

Dosya Markdown biçimlendirmesini kabul eder. Claude Code, oturum başlangıcında bu bağlamı okur ve konuşma boyunca korur.

Gelişmiş Yapılandırma Seçenekleri

Temel bağlamın ötesinde, Claude Code .claude dizini aracılığıyla gelişmiş yapılandırmayı destekler. Bu dizin şunları içerebilir:

• Yetenekler: .claude/skills/SKILL.md'de tanımlanan özel yetenekler
• Komutlar: .claude/commands/*.md'de özel eğik çizgi komutları
• Kancalar: Olaylarla tetiklenen otomatik iş akışları
• Eklentiler: Programatik entegrasyon yoluyla genişletilmiş işlevsellik

Resmi Agent SDK belgelerine göre, bu özellikler karmaşık özelleştirmelere olanak tanır. Yetenekler yeniden kullanılabilir yetenekleri tanımlar. Komutlar yaygın görevler için kısayollar oluşturur. Kancalar dosya değişikliklerine veya araç kullanımına yanıtları otomatikleştirir.

Claude Code Kullanımı: Temel İş Akışları

Kurulum tamamlandıktan sonra, Claude Code yaygın geliştirme görevlerini doğal dil aracılığıyla halleder.

Bir proje dizinine gidin ve şunu çalıştırarak bir oturum başlatın:

claude

İstem, düz metin isteklerini kabul eder. Bazı yaygın iş akışları:

• Kod Üretimi: "Doğru hata işleme ile e-posta adreslerini doğrulayan bir Python fonksiyonu oluşturun."
• Hata Düzeltme: "Bu fonksiyon bir null pointer istisnası atıyor. Sorunu tespit edip düzeltebilir misin?"
• Yeniden Düzenleme: "Bu bileşeni doğrudan örnekleme yerine bağımlılık enjeksiyonu kullanacak şekilde yeniden düzenleyin."
• Git İşlemleri: "Yeni bir dal oluşturun, bu değişiklikleri açıklayıcı bir mesajla commit edin ve origin'e push yapın."

Claude Code, oturum boyunca bağlamı korur. Önceki etkileşimleri hatırlar, dosya değişikliklerini izler ve daha geniş proje yapısını anlar.

Plan Modunu Anlama

Karmaşık değişiklikler için, Claude Code Plan Modu sunar. Bu mod, değişiklik yapmadan önce ayrıntılı bir yürütme planı oluşturur.

İsteklere "plan:" ile ön ek vererek veya /plan komutunu kullanarak Plan Modunu etkinleştirin. Claude Code daha sonra önerilen değişiklikleri özetler, gerekçeyi açıklar ve yürütmeden önce onay bekler.

Plan Modu, yeniden düzenleme, mimari değişiklikler veya birden fazla dosyayı etkileyen değişiklikler için özellikle kullanışlıdır. Değişikliklere bağlı kalmadan önce Claude Code'un ne yapmayı amaçladığına dair görünürlük sağlar.

VS Code ve IDE'lerle Entegrasyon

Claude Code terminalde çalışırken, kod editörleriyle entegrasyon iş akışını geliştirir. Resmi VS Code uzantısı, Claude Code yeteneklerini doğrudan editöre getirir.

VS Code marketplace'ten uzantıyı yükleyin. "Claude Code" araması yapın ve Yükle'ye tıklayın. Uzantı, kenar çubuğuna bir Claude Code paneli ekler.

Resmi VS Code belgelerine göre, uzantı şunları destekler:

Uzantı, IDE'ye özgü kolaylıklar olan yerleşik farklar ve @-mention dosya referansları ile terminal sürümüyle aynı özellik seviyesini korur.

Claude Code Güncelleme ve Yönetimi

Claude Code varsayılan olarak otomatik olarak güncellenir. Uygulama periyodik olarak yeni sürümleri kontrol eder ve güncellemeleri arka planda yükler.

Manuel olarak güncellemek için şunu çalıştırın:

claude --update

Bu, bir anında kontrol ve en son sürümün yüklenmesini zorlar. Güncelleme süreci, yapılandırma dosyalarını ve kimlik doğrulama bilgilerini korur.

Sürüm kontrolü gerektiren kuruluşlar için otomatik güncellemeler devre dışı bırakılabilir. CLAUDE_CODE_AUTO_UPDATE ortam değişkenini yanlış olarak ayarlayın veya sunucu tarafından yönetilen ayarlar aracılığıyla yapılandırın.

Belirli bir sürümü yüklemek için şunu kullanın:

curl -fsSL claude.ai/install.sh | sh -s -- --version=X.Y.Z

Hedef sürüm numarasıyla X.Y.Z'yi değiştirin.

Yaygın Kurulum Sorunları ve Çözümleri

Kurulum sırasında yaygın olarak birkaç sorun ortaya çıkar. İşte bunları çözme yolları:

• API Anahtarı Reddi: Claude Code API anahtarını reddederse, ekstra boşluk veya karakter olmadığından emin olun. Anahtarı Anthropic Console'dan yeniden kopyalayın. Faturalandırmanın etkinleştirildiğini kontrol edin—ödeme yöntemi olmadan anahtarlar çalışmayacaktır.
• WSL2 Kurulum Hataları: Windows sistemleri bazen sanallaştırma ayarları nedeniyle WSL2 kurulumunda başarısız olur. BIOS'a girin ve sanallaştırmayı etkinleştirin (Intel VT-x veya AMD-V). Windows sürümünün minimum gereksinimleri karşıladığından emin olun.
• Komut Bulunamadı: Terminal, claude komutunu tanımıyorsa, PATH doğru güncellenmemiştir. Terminali kapatıp yeniden açın. Kalıcı sorunlar için, kurulum dizinini PATH'e manuel olarak ekleyin.
• Bağlantı Zaman Aşımları: Ağ kısıtlamaları veya güvenlik duvarları API çağrılarını engelleyebilir. Claude Code, api.anthropic.com'a HTTPS erişimi gerektirir. Kurumsal ağlar proxy yapılandırması gerektirebilir.
• İzin Hataları: Linux ve macOS kurulumları zaman zaman izin sorunlarıyla karşılaşır. Yükleyiciyi uygun izinlerle çalıştırın veya sistem genelindeki konumlara yerine kullanıcı dizinine yükleyin.

Claude Code Kurmadan Önce Mevcut Yapay Zeka Kredilerini Kontrol Edin

Claude Code kurulumu genellikle deney yapmayı içerir—bir şeyler üretime geçmeden önce istemleri çalıştırmak, entegrasyonları test etmek ve küçük prototipler oluşturmak. Bu erken aşama genellikle çok fazla API kullanımıyla sonuçlanır. Her isteğe hemen ödeme yapmak yerine, birçok geliştirici önce kredi veya bu başlangıç maliyetlerini azaltmaya yardımcı olan başlangıç programları arar.

Get AI Perks, bu fırsatları tek bir yerde toplar. Platform, yapay zeka sağlayıcıları, bulut platformları ve geliştirici araçları genelinde yapay zeka kredilerini, indirimleri ve ortaklık programlarını listeler, talep etme yollarını açıklayan adım adım kılavuzlarla birlikte. Toplamda, veritabanı 200'den fazla araçtan gelen avantajları ve yeni başlayanların ve oluşturucuların başvurabileceği milyonlarca dolarlık mevcut kredileri içerir.

Claude Code kurulumunu tamamlamadan önce, Get AI Perks'i kontrol edin ve ilk deneylerinizi kapsayabilecek yapay zeka kredilerini talep edin.

Sıkça Sorulan Sorular

Claude Code ile İleriye Dönük Adımlar

Claude Code, yapay zeka yardımını doğrudan komut satırına entegre ederek terminal tabanlı geliştirmeyi dönüştürür. Kurulum, platforma özel kurulum, API kimlik doğrulaması ve temel yapılandırma gerektirir, ancak doğru adımlar izlendiğinde süreç sorunsuzdur.

Araç, rutin geliştirme görevlerinde, kod üretiminde ve git iş akışı yönetiminde mükemmeldir. Plan Modu, karmaşık işlemler için güvenlik sağlar. IDE entegrasyonu, terminalin ötesinde yetenekleri genişletir.

Claude Code'un istekleri nasıl yorumladığını anlamak için basit görevlerle başlayın. Bilgi birikimi arttıkça daha karmaşık iş akışlarına doğru ilerleyin. Temiz bağlamı korumak için farklı görevler arasında /clear komutunu kullanın. Proje özel yönergeler için CLAUDE.md dosyalarını yapılandırın.

Ekipler sunucu tarafından yönetilen ayarları ve eklenti marketlerini keşfedebilir. Bireysel geliştiriciler, sık kullanılan desenlere özel olarak uyarlanmış yetenekler ve özel komutlardan yararlanabilir.

anthropics/claude-code adresindeki GitHub deposu ek örnekler, topluluk eklentileri ve sorun giderme kaynakları içerir. docs.anthropic.com adresindeki resmi belgeler kapsamlı teknik referanslar sağlar.

Şimdi kodlamaya başlama zamanı. Bir projeye gidin, Claude Code'u başlatın ve yapay zeka destekli geliştirmenin iş akışınızı nasıl değiştirdiğini görün.