Claude Code ile Başlangıç (2026 Kurulum Rehberi)

Hızlı Özet: Claude Code, npm veya Homebrew gibi paket yöneticileri aracılığıyla kurulum gerektiren ve ardından Anthropic API anahtarıyla kimlik doğrulama yapılan Anthropic'in terminal tabanlı yapay zeka kodlama yardımcısıdır. Kurulumdan sonra geliştiriciler, hata ayıklama ve yeniden düzenlemeden git iş akışlarına ve çoklu dosya düzenlemelerine kadar kodlama görevlerini yürütmek için doğal dil komutlarını kullanabilirler. Araç, mevcut projelerle doğrudan entegre olur ve kancalar, eklentiler ve yapılandırma dosyaları aracılığıyla özelleştirmeyi destekler.

Claude Code, Anthropic tarafından geliştirilen ve doğrudan terminalde yaşayan bir ajan kodlama aracıdır. Bir IDE uzantısı veya bulut arayüzü değildir; kod tabanlarını anlayan, rutin görevleri yürüten ve hata ayıklamadan git iş akışlarına kadar her şeyi doğal dil aracılığıyla yöneten bir komut satırı yardımcısıdır.

Geleneksel kodlama yardımcılarının aksine, Claude Code özerk çalışır. Minimum insan müdahalesiyle dosyaları okuyabilir, komutları yürütebilir ve çoklu dosya düzenlemeleri yapabilir. Çıktı kalitesi tamamen doğru kurulum ve bağlam yönetimine bağlıdır.

Bu kılavuz, kurulumdan ilk iş akışlarına kadar her şeyi kapsar. Gereksiz ayrıntı yok, sadece gerçekten önemli olan pratik adımlar.

Sistem Gereksinimleri ve Önkoşullar

Kurulum işlemine başlamadan önce sistemin temel gereksinimleri karşıladığını doğrulayın. Claude Code, macOS, Linux ve Windows 10/11'de WSL2 aracılığıyla çalışır.

İhtiyaç duyulanlar şunlardır:

• Bu gereksinimi kaldırın veya 'Belirli kurulum yöntemleri için Node.js gerekebilir' olarak yumuşatın — kaynak malzeme Node.js 18'i sistem gereksinimi olarak belirtmiyor
• Kurulu ve yapılandırılmış Git
• Kabuk izinlerine sahip terminal erişimi
• API çağrıları için kararlı internet bağlantısı
• API erişimi olan bir Anthropic hesabı

Özellikle Windows kullanıcıları için Claude Code, Windows'ta yerel olarak çalışamaz. Araç, Claude Code'un etkili bir şekilde çalıştığı bir Linux ortamı oluşturmak için Windows Subsystem for Linux 2 (WSL2) gerektirir. WSL2 kurulumu için Windows 10 Sürüm 1903 veya daha yenisi (Build 18362+) gereklidir.

Kurulum sırasındaki toplam indirme boyutu genellikle WSL2 dahil (yaklaşık 500MB), Node.js (yaklaşık 30MB) ve bağımlılıkları olan Claude Code (yaklaşık 50MB) dahil olmak üzere 1GB'ın altındadır.

Başlamadan Önce Yapay Zeka Aracı Kredilerini Bulun

Claude Code ile başlamak genellikle etrafındaki diğer yapay zeka araçlarını seçmeyi gerektirir. Get AI Perks, yapay zeka ve bulut araçları için başlangıç kredilerini ve yazılım indirimlerini tek bir yerde toplayarak bu konuda yardımcı olur. Platform, Claude, Anthropic, OpenAI, Gemini, ElevenLabs, Intercom ve diğerlerinden gelen tekliflerin yanı sıra bunları talep etme koşulları ve adımlarını içeren 200'den fazla avantajı içermektedir.

Başvurmadan Önce Yapay Zeka Kredileri mi Arıyorsunuz?

Şunu yapmak için Get AI Perks'i kontrol edin:

• Claude ve diğer yapay zeka araçlarının tekliflerine göz atın
• Hangi avantajların şirketiniz için uygun olduğunu görün
• Mevcut kredileri talep etmek için kılavuzları izleyin

👉 Mevcut yapay zeka yazılım avantajlarını karşılaştırmak için Get AI Perks'i ziyaret edin.

Claude Code'u Yükleme

Yükleme işlemi işletim sistemine göre biraz farklılık gösterir ancak aynı genel deseni izler.

macOS ve Linux'ta Yükleme

Homebrew kurulu macOS kullanıcıları için işlem basittir:

Homebrew olmadan npm kullanın:

Linux kullanıcıları aynı npm yaklaşımını izleyebilir. Global kurulum bayrağı (-g), Claude Code'un proje özelinde değil, sistem genelinde kullanılabilir olmasını sağlar.

Windows'ta WSL2 Aracılığıyla Yükleme

Windows kurulumu önce WSL2 kurulumu gerektirir. PowerShell'i Yönetici olarak açın ve şunu çalıştırın:

Bu komut varsayılan olarak WSL2'yi Ubuntu ile birlikte yükler. Kurulum tamamlandıktan sonra sistemi yeniden başlatın. Yeniden başlatmada, Ubuntu kullanıcı adı ve parola oluşturma ile kurulumu tamamlamak için otomatik olarak başlatılır.

WSL2 Linux ortamı içinde Node.js'yi yükleyin:

Ardından yukarıda gösterildiği gibi npm kullanarak Claude Code'u yükleyin.

Şunu çalıştırarak kurulumu doğrulayın:

Komut mevcut sürüm numarasını döndürmelidir. Döndürmezse, kurulum yolu sistem PATH değişkeninde olmayabilir.

Kimlik Doğrulama ve Hesap Kurulumu

Claude Code, işlevsel hale gelmeden önce bir Anthropic API anahtarıyla kimlik doğrulama gerektirir.

API Anahtarı Alma

Anthropic Console'a console.anthropic.com adresinden gidin ve bir hesap oluşturun veya oturum açın. API bölümünde yeni bir API anahtarı oluşturun. Bu anahtarı hemen kopyalayın; sayfadan ayrıldıktan sonra tekrar gösterilmeyecektir.

API erişimi kullanıma göre ödeme esasına göre çalışır. Resmi belgelere göre, fiyatlandırma farklı Claude modelleri için farklı oranlarla token başına model üzerinden işler. Olduğu gibi bırakın — resmi kaynak materyalinde doğrulandı, 'Minimum satın alma: 5$' ve 'Önerilen: test ve başlangıç projeleri için 20-30$' diyor

Claude Code'u API'ye Bağlama

Herhangi bir proje dizininde Claude Code'u ilk kez çalıştırın:

Araç kimlik doğrulama isteyecektir. Oturum açmak için bir tarayıcı penceresi açar veya manuel olarak yapıştırmanız için bir URL sağlar. Tarayıcı üzerinden kimlik doğrulama yaptıktan sonra Claude Code yetkilendirme alır ve kimlik bilgilerini yerel olarak depolar.

Kimlik doğrulama işlemi, ana dizinde yapılandırma dosyaları oluşturur. Bu dosyalar oturumlar arasında kalıcıdır, bu nedenle kimlik bilgileri manuel olarak iptal edilmedikçe kimlik doğrulama yalnızca bir kez yapılır.

Her şeyin düzgün çalıştığını doğrulamak için şunu çalıştırın:

Bu tanılama komutu yaygın yapılandırma sorunlarını, API bağlantısını ve izin sorunlarını kontrol eder.

İlk Claude Code Oturumunuzu Çalıştırma

Kimlik doğrulama tamamlandıktan sonra Claude Code gerçek iş için hazırdır.

Etkileşimli Modu Başlatma

Herhangi bir proje dizinine gidin ve şunu çalıştırın:

Bu, birden fazla komut ve dosya düzenlemesi boyunca bağlamı koruyan kalıcı bir oturum olan etkileşimli modu başlatır. Terminal, Claude Code'un aktif olduğunu ve talimat beklemediğini gösteren bir istem görüntüler.

Temel Komut Kalıpları

Claude Code üç ana komut formatını kabul eder:

Etkileşimli mod, birden çok adımı içeren karmaşık iş akışları için en kullanışlıdır. Tek seferlik görevler hızlı düzeltmeler veya otomatik komut dosyaları için iyi çalışır. Sorgu modu (-p bayrağı), dosya değişiklikleri yapmadan bilgi sağlar.

İlk Kod Değişikliğinizi Yapma

Etkileşimli modda basit bir görev deneyin:

Claude Code dosyayı analiz eder, ana fonksiyonu belirler ve uygun try-catch blokları veya hata kontrol mantığıyla değişiklikler önerir. Değişiklikleri uygulamadan önce bir fark önizlemesi gösterir.

Araç, dosyalarda değişiklik yapmadan önce onay ister. Önerilen değişiklikleri dikkatlice gözden geçirin. 'Evet' yazarak onaylayın veya değişiklik talep etmek için 'hayır' ile reddedin.

Temel İş Akışları ve Yaygın Görevler

Claude Code, temel kod düzenlemelerinin ötesinde çok çeşitli geliştirme iş akışlarını yönetir.

Git Entegrasyonu

Claude Code, git iş akışlarını yerel olarak anlar. Şu gibi komutlar doğal olarak çalışır:

• "Giriş özelliği için yeni bir dal oluştur"
• "Bu değişiklikleri açıklayıcı bir mesajla kaydet"
• "Son kayıttan bu yana nelerin değiştiğini bana göster"
• "Özellik dalını birleştir ve çakışmaları çöz"

Araç, git geçmişini okuyabilir, dal yapısını anlayabilir ve kod değişikliklerine dayalı uygun commit mesajları oluşturabilir.

Hata Ayıklama ve Sorun Giderme

Hatalar ortaya çıktığında, Claude Code inceleyebilir ve düzeltmeler önerebilir:

• "API çağrısının neden başarısız olduğunu ayıkla"
• "Bu null işaretçi istisnayı kaynakla bul"
• "Bu fonksiyon neden beklenen değeri döndürmüyor"

Claude Code, hata mesajlarını inceler, yürütme yollarını izler ve kök nedenleri belirlemek için ilgili dosyaları kontrol eder.

Kod Yeniden Düzenleme

Büyük ölçekli yeniden düzenleme, çoklu dosya farkındalığı ile yönetilebilir hale gelir:

• "Bu mantığı ayrı bir yardımcı modüle çıkar"
• "Bu sınıfı miras yerine kompozisyon kullanacak şekilde yeniden düzenle"
• "Bu dosyayı taşıdıktan sonra tüm içe aktarmaları güncelle"

Araç, dosyalar arasındaki bağımlılıkları izler ve referansları otomatik olarak günceller.

Test Desteği

Claude Code testler üretebilir, test kümelerini çalıştırabilir ve hataları yorumlayabilir:

• "Kimlik doğrulama modülü için birim testleri yaz"
• "Test kümesini çalıştır ve herhangi bir hatayı açıkla"
• "Doğrulama fonksiyonu için kenar durum testleri ekle"

Test üretimi, projede kullanılan gelenekleri ve mevcut test çerçevesi kalıplarını izler.

Bağlam Yönetimi ve Yapılandırma

Claude Code'un etkinliği, projeye sağlanan bağlama büyük ölçüde bağlıdır.

AGENTS.md Standardı

Kalıcı bağlam sağlamanın en etkili yolu, proje kök dizininde bir AGENTS.md dosyası kullanmaktır. Bu dosya, yapay zeka kodlama ajanlarını proje yapısı, gelenekleri ve gereksinimleri hakkında bilgilendirmek için evrensel bir standart görevi görür.

Temel bir AGENTS.md şunları içerebilir:

• Proje genel bakışı ve mimarisi
• Kodlama gelenekleri ve stil tercihleri
• Test gereksinimleri ve kalıpları
• Derleme ve dağıtım süreçleri
• Dosya organizasyonu yapısı

Claude Code, o dizindeki oturumları başlatırken AGENTS.md içeriğini otomatik olarak okur ve dahil eder.

Otomasyon İçin Kancalar

Kancalar, belirli olaylar meydana geldiğinde kabuk komutlarının otomatik olarak çalıştırılmasını sağlar. Resmi belgelere göre Claude Code, SessionStart, UserPromptSubmit, PreToolUse, PostToolUse ve Notification dahil olmak üzere birden fazla kanca olayını destekler.

Kancalar, hangi komutların hangi olaylar için çalışacağını belirten bir JSON dosyasında yapılandırılır. Örneğin, bir PostToolUse kancası, Claude Code dosyaları değiştirdikten sonra otomatik olarak testleri çalıştırabilir veya kodları proje standartlarına göre biçimlendirebilir.

Kancalar için varsayılan zaman aşımı 10 dakikadır, ancak bu kanca başına yapılandırılabilir. Kancalar senkron olarak (Claude Code'un tamamlanmasını bekleyerek) veya asenkron olarak (arka planda çalışarak) çalışabilir.

Cursor Kuralları ve Alternatif Formatlar

Claude Code ile birlikte Cursor veya diğer yapay zeka kodlama araçlarını kullanan projeler için, .cursorrules dosya formatı AGENTS.md'ye bir alternatif sunar. AGENTS.md evrensel standart olsa da, Cursor kuralları Cursor'a özgü özelliklerle daha sıkı entegrasyon sunar.

Projeler her iki dosyayı da tutabilir. Claude Code, AGENTS.md'yi önceliklendirir ancak mevcut olduğunda diğer yapılandırma formatlarına saygı duyar.

Etkili Kullanım İçin Pratik İpuçları

Gerçek dünya kullanımı, Claude Code'un etkinliğini önemli ölçüde artıran kalıpları ortaya çıkarır.

Talimatlarda Belirli Olun

Belirsiz komutlar belirsiz sonuçlar üretir. "Bu kodu geliştirin" yerine, ne anlama geldiğini belirtin: "bu fonksiyonu döngüsel karmaşıklığı azaltacak şekilde yeniden düzenleyin" veya "bu veritabanı sorgusunu yürütme süresini azaltacak şekilde optimize edin."

Proje Bağlamını Cömertçe Kullanın

Talimat verirken belirli dosyalara, fonksiyonlara veya kalıplara atıfta bulunun. Claude Code, "UserController'daki kalıbı takip ederek" veya "Mevcut API işleyicilerimizin stilini eşleştirerek" gibi bağlamları anlar.

Kabul Etmeden Önce Değişiklikleri Gözden Geçirin

Claude Code güçlüdür ancak hatasız değildir. Her zaman fark önizlemesindeki değişiklikleri gözden geçirin. Özellikle birden çok dosyayı etkileyen yeniden düzenleme işlemleri sırasında istenmeyen yan etkileri arayın.

Git Güvenlik Ağlarından Yararlanın

Büyük Claude Code işlemlerinden önce çalışan kodu kaydedin. Değişiklikler ters giderse, git kolay bir geri alma yolu sunar. Bu güvenlik ağı, daha iddialı görevlerle deneme yapmayı teşvik eder.

Net Hedeflerle Oturum Başlatın

Oturuma açık hedeflerle başlamak, Claude Code'un odaklanmasına yardımcı olur. "Kullanıcı kimlik doğrulaması ekliyoruz" veya "Ödeme işleme akışını ayıklıyoruz" sonraki komutlar için bağlam oluşturur.

Yaygın Sorunlar ve Sorun Giderme

Doğru kurulumlara rağmen zaman zaman sorunlar ortaya çıkar.

İzin Hataları

Claude Code'u asla sudo veya yükseltilmiş izinlerle çalıştırmayın. Bu, güvenlik açıklarına ve dosya sahipliği sorunlarına yol açar. İzin hataları oluşursa, proje dizinindeki dosya izinlerini kontrol edin ve mevcut kullanıcının uygun erişime sahip olduğundan emin olun.

API Bağlantı Sorunları

Bağlantı hataları genellikle ağ sorunlarını veya geçersiz API kimlik bilgilerini gösterir. Anthropic Console aracılığıyla API anahtarının geçerliliğini doğrulayın. Güvenlik duvarlarının veya VPN'lerin API isteklerini engellemediğinden emin olun.

Windows WSL2'de Beklenmedik Davranış

Yol sorunları, WSL2'de Windows ve Linux yollarını karıştırırken yaygın olarak ortaya çıkar. Performansı artırmak ve yol çevirme sorunlarını önlemek için projeleri Windows sürümlerini (/mnt/c/) kullanmak yerine Linux dosya sisteminde (/home/username/) tutun.

Uzun Oturumlar Sırasında Bağlam Kaybı

Uzun süreli oturumlar bağlam sınırlarına ulaşabilir ve Claude Code'un önceki konuşmaları unutmasına neden olabilir. Bu olduğunda, yeni bir oturum başlatın veya proje hedefleri ve son değişiklikler hakkında açık hatırlatmalar yapın.

Keşfedilmeye Değer Gelişmiş Özellikler

Temelleri öğrendikten sonra, birkaç gelişmiş özellik ek yetenekler sunar.

Özel Komutlar

Projeler, .claude/commands dizininde özel komutlar tanımlayabilir. Bu komutlar, "@deploy.md staging" veya "@benchmark.md performance" gibi proje özelindeki iş akışlarıyla Claude Code'u genişletir.

Komutlar, bağımsız değişkenler ve bağlam enjeksiyonu için özel söz dizimine sahip markdown olarak yazılır. Claude Code'un resmi eklentilerindeki komut geliştirme becerisi şablonlar ve örnekler sunar.

Ajan Ekipleri

Karmaşık işlemler için Claude Code, birlikte çalışan birden fazla özel ajanı koordine edebilir. Bir ajan arka uç değişikliklerini hallederken, diğeri ön uç bileşenlerini güncelleyebilir ve üçüncüsü veritabanı geçişlerini yönetebilir.

Ajan ekipleri yapılandırma gerektirir ancak büyük özellikler veya yeniden düzenleme projeleri üzerinde paralel çalışmayı sağlar.

Sıkça Sorulan Sorular

Claude Code ile İleriye

Claude Code ile başlamak, basit kurulum, kimlik doğrulama ve temel komut kalıplarını öğrenmeyi içerir. Aracın gerçek gücü, tutarlı kullanım ve doğru bağlam yönetimiyle ortaya çıkar.

Basit görevlerle başlayın — hata düzeltmeleri, belgeler güncelleme veya tek dosya yeniden düzenleme. Konfor arttıkça, özellik uygulaması veya mimari değişiklikler gibi daha iddialı iş akışlarını ele alın. Doğal dil komutları söz dizimi ezberlemeyi azalttığı için öğrenme eğrisi yumuşaktır.

Sık kullanılan projeler için AGENTS.md dosyalarını yapılandırın. Bu yatırım, geliştirilmiş Claude Code anlayışı ve daha ilgili önerilerle karşılığını verir.

En önemlisi, Claude Code'u geliştirici yargısının bir yerine koymak yerine işbirlikçi bir araç olarak görün. Önerilerini eleştirel bir şekilde gözden geçirin, net talimatlar verin ve git güvenlik ağlarını koruyun. Doğru kullanıldığında, Claude Code kod kalitesinden ödün vermeden geliştirmeyi hızlandırır.

Terminal iş akışınızı dönüştürmeye hazır mısınız? Bugün Claude Code'u yükleyin ve geliştiricilerin çalıştığı yöntemlerle gerçekten entegre olan yapay zeka destekli geliştirme deneyimini yaşayın. Ayrıntılı referans materyalleri ve gelişmiş yapılandırma seçenekleri için docs.anthropic.com adresindeki resmi belgelere göz atın.