Komut İstemcisinde Claude Code Kullanmak İçin Yapılması Gerekenler

Claude Code, Anthropic'in geliştirdiği ve doğrudan terminalde (komut istemcisinde) çalışan yapay zekâ destekli bir kodlama aracıdır. Ona doğal dille ne yapmak istediğinizi söylersiniz; o da projenizdeki dosyaları okur, kod yazar, düzenler, komut çalıştırır ve hataları ayıklar. Bir sohbet botundan farkı, projenizin içinde ajan (agent) gibi davranmasıdır: görevi baştan sona kendisi planlayıp uygular. Bu yazıda, sıfırdan kuruluma ve ilk kullanıma kadar yapılması gereken her adımı sırasıyla anlatacağım.

1. Ön Gereksinimler

Kuruluma başlamadan önce şunlara ihtiyacınız var:

• İşletim sistemi: Windows 10 veya üzeri, macOS 10.15+, ya da güncel bir Linux dağıtımı (Ubuntu 20.04+ gibi). Windows'ta hem doğrudan hem de WSL üzerinden çalışır.
• Git for Windows (Windows kullanıcıları için): Claude Code bazı işlemler için bash kabuğu kullanır; Windows'ta bunun için Git for Windows kurulu olmalıdır. Zaten Git kullanıyorsanız bu adım tamamdır.
• Bir Claude hesabı: İki seçenek var — Claude Pro/Max aboneliği (claude.ai hesabınızla giriş yaparsınız, ek ücret yoktur) veya Anthropic Console üzerinden kullandıkça öde (API) hesabı. Yeni başlayanlar için abonelik yolu daha pratiktir.
• Node.js 18+ (yalnızca npm ile kuracaksanız): Aşağıdaki yerel (native) kurulum yöntemini kullanırsanız Node.js gerekmez.

2. Kurulum

Windows (PowerShell)

PowerShell'i açın ve tek satırlık kurulum komutunu çalıştırın:

irm https://claude.ai/install.ps1 | iex

macOS ve Linux

Terminali açın ve şu komutu çalıştırın:

curl -fsSL https://claude.ai/install.sh | bash

Alternatif: npm ile kurulum

Bilgisayarınızda Node.js 18 veya üzeri kuruluysa, Claude Code'u npm üzerinden global paket olarak da kurabilirsiniz:

npm install -g @anthropic-ai/claude-code

Kurulumu doğrulama

Kurulum bittikten sonra terminali kapatıp yeniden açın ve sürümü kontrol edin:

claude --version

Bir sürüm numarası görüyorsanız kurulum başarılıdır. Bir sorun olduğunu düşünüyorsanız claude doctor komutu kurulumun sağlığını denetler ve eksikleri raporlar.

3. İlk Çalıştırma ve Giriş Yapma

Claude Code, içinde bulunduğunuz klasörü "proje" olarak kabul eder. Bu yüzden önce çalışmak istediğiniz projenin klasörüne geçin, sonra aracı başlatın:

cd C:\projeler\benim-projem
claude

İlk çalıştırmada sizden giriş yapmanız istenir. Tarayıcınızda bir yetkilendirme sayfası açılır:

• Claude aboneliğiniz varsa (Pro/Max): claude.ai hesabınızla giriş yapın. Kullanım, aboneliğinize dahildir.
• API ile kullanacaksanız: Anthropic Console hesabınızı seçin; kullanım, konsol bakiyenizden token bazlı ücretlendirilir.

Giriş tek seferliktir; oturum bilgisi bilgisayarınızda saklanır. Daha sonra hesap değiştirmek isterseniz Claude Code içinde /login komutunu kullanabilirsiniz.

4. Temel Kullanım

Artık her şey hazır. Claude Code açıkken doğal dille istekte bulunmanız yeterli:

> bu projenin ne yaptığını özetle
> login sayfasındaki hata mesajını Türkçeleştir
> bu fonksiyon için birim testleri yaz ve çalıştır

Bilmeniz gereken temel komutlar şunlar:

• /init — Projenizi analiz edip bir CLAUDE.md dosyası oluşturur. Bu dosya, Claude'un her oturumda okuduğu proje notlarıdır (kullanılan teknolojiler, derleme komutları, kod standartları vb.). Yeni bir projede ilk yapılması gereken şeydir.
• /help — Tüm komutları listeler.
• /clear — Konuşma geçmişini temizler; yeni bir göreve başlarken kullanın.
• /model — Kullanılan yapay zekâ modelini değiştirir.
• Shift+Tab — İzin modları arasında geçiş yapar: normal mod (her değişiklik için onay ister), otomatik kabul (dosya düzenlemelerini sormadan yapar) ve plan modu (önce plan sunar, kod yazmaz).

Terminalden tek seferlik soru sormak için interaktif oturum açmadan -p bayrağını da kullanabilirsiniz:

claude -p "bu klasördeki en büyük 5 dosyayı listele"

Aracı güncel tutmak için ise:

claude update

5. Verimli Kullanım İçin İpuçları

• Git ile birlikte kullanın. Claude Code dosyalarınızı gerçekten değiştirir; projeniz bir git deposuysa her değişikliği git diff ile inceleyip beğenmediğinizi kolayca geri alabilirsiniz.
• Büyük işlerde önce plan isteyin. Plan moduna geçip (Shift+Tab) Claude'un ne yapacağını görün, onayladıktan sonra uygulamasına izin verin.
• CLAUDE.md dosyasını güncel tutun. Projeye özgü kurallarınızı (örn. "yorumları Türkçe yaz", "testleri şu komutla çalıştır") buraya ekledikçe Claude her oturumda bunlara uyar.
• Net görev tanımlayın. "Kodu iyileştir" yerine "UserService sınıfındaki tekrar eden veritabanı sorgularını tek metoda topla" gibi somut istekler çok daha iyi sonuç verir.
• İzin isteklerini okuyarak onaylayın. Claude komut çalıştırmadan veya dosya silmeden önce onay ister; özellikle ilk zamanlarda bu istekleri okuyarak neyin çalıştığını anlamak hem güvenli hem öğreticidir.

Sonuç

Özetle yapılması gerekenler: (1) varsa Git for Windows'u kurun, (2) tek satırlık komutla Claude Code'u yükleyin, (3) proje klasörünüzde claude yazıp hesabınızla giriş yapın, (4) /init ile CLAUDE.md oluşturun ve doğal dille görev vermeye başlayın. Kurulum genellikle beş dakikadan kısa sürer; asıl fark, aracı git ve net görev tanımlarıyla birlikte disiplinli kullanmayı alışkanlık haline getirdiğinizde ortaya çıkar. Terminalden korkmayan herkes için Claude Code, günlük geliştirme işlerini ciddi ölçüde hızlandıran bir yardımcıdır.