Claude Code VS Code Kurulum Rehberi

Bu rehber, Claude Code’u VS Code üzerinde sıfırdan kurmak ve kullanmaya başlamak isteyenler için hazırlanmıştır. Adımları sırasıyla takip ederek birkaç dakika içinde kuruluma sahip olabilirsiniz.

İçindekiler

1. Ön Gereksinimler
2. Adım 1: VS Code’u İndir ve Kur
3. Adım 2: Proje Klasörü Oluştur
4. Adım 3: Claude Code’u Kur
5. Adım 4: VS Code Eklentisini Kur
6. Adım 5: claude Komutunu Çalıştır
7. Adım 6: Kişiselleştirme Seçenekleri
8. Adım 7: Hesabını Bağla (Login)
9. Adım 8: İlk Kullanım
10. Temel Komutlar
11. İpuçları
12. Sorun Giderme

Ön Gereksinimler

Başlamadan önce şunlara sahip olduğundan emin ol:

• Bir bilgisayar (macOS, Windows veya Linux)
• İnternet bağlantısı
• Claude aboneliği (Pro, Max, Team veya Enterprise) veya Claude Console hesabı (API kredisi ile)
• Terminal/komut istemi kullanmaktan korkmuyor olmak (endişelenme, gerekli komutları aşağıda paylaşıyorum)

Not: Windows kullanıcılarının native kurulum için Git for Windows yüklü olması gerekiyor.

Adım 1: VS Code’u İndir ve Kur

1. Tarayıcında https://code.visualstudio.com adresine git.
2. Download butonuna tıkla. Site otomatik olarak işletim sistemine uygun sürümü önerir.
   • macOS → .zip dosyası
   • Windows → .exe yükleyici
   • Linux → .deb veya .rpm
3. İndirdiğin dosyayı çalıştır ve kurulum sihirbazını tamamla.
   • Windows: Kurulum sırasında “Add to PATH” ve “Register Code as an editor for supported file types” seçeneklerini işaretlemeni öneririm.
   • macOS: İndirdiğin Visual Studio Code.app dosyasını Applications klasörüne sürükle.
4. VS Code’u aç. Karşına hoş geldin ekranı çıkacaktır.

Adım 2: Proje Klasörü Oluştur

Claude Code’un üzerinde çalışacağı bir klasöre ihtiyacı var.

1. Bilgisayarında uygun bir konuma yeni bir klasör oluştur. Örnek:
   • macOS/Linux: ~/Documents/projem
   • Windows: C:\Users\KullaniciAdin\Documents\projem
2. VS Code’u aç → File → Open Folder… → az önce oluşturduğun klasörü seç.
3. Sol panelde klasörün VS Code Explorer’ında göründüğünü göreceksin.

İpucu: VS Code’un dahili terminalini açmak için Ctrl + ` (backtick) tuşlarına bas (macOS’te de aynı kombinasyon). Komutları doğrudan bu terminalden çalıştırabilirsin.

Adım 3: Claude Code’u Kur

İşletim sistemine uygun komutu seç ve VS Code terminaline yapıştır.

macOS / Linux / WSL

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

Windows (PowerShell)

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

Windows (CMD)

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Alternatif: Homebrew (macOS / Linux)

Eğer Homebrew kullanıyorsan:

brew install --cask claude-code

Alternatif: WinGet (Windows)

winget install Anthropic.ClaudeCode

Not: Native (önerilen) kurulum kendini otomatik günceller. Homebrew ve WinGet kurulumları otomatik güncellenmez — düzenli olarak brew upgrade claude-code veya winget upgrade Anthropic.ClaudeCode çalıştırman gerekir.

Kurulum bittiğinde terminalde başarı mesajı göreceksin.

Adım 4: VS Code Eklentisini Kur

Claude Code’u VS Code içinden kullanmak için resmi eklentiyi de yüklemen gerekiyor.

Yöntem 1: Marketplace Üzerinden

1. VS Code’da sol kenardaki Extensions ikonuna tıkla (veya Ctrl/Cmd + Shift + X).
2. Arama kutusuna Claude Code yaz.
3. Anthropic tarafından yayınlanan eklentiyi seç.
4. Install butonuna tıkla.

Yöntem 2: Komut ile

VS Code terminaline şunu yapıştır:

code --install-extension anthropic.claude-code

Veya doğrudan: Marketplace bağlantısı

Kurulumdan sonra VS Code’u kapatıp yeniden açman önerilir.

Adım 5: claude Komutunu Çalıştır

VS Code terminalini aç (Ctrl + `) ve proje klasöründe olduğundan emin ol.

claude

İlk çalıştırmada Claude Code seni karşılayacak ve birkaç kişiselleştirme sorusu soracaktır.

Adım 6: Kişiselleştirme Seçenekleri

İlk başlatmada karşına şu seçenekler gelecek:

1. Tema Seçimi

• Dark mode veya Light mode
• Terminalinin renklerine uygun olanı seç. Sonradan /config komutuyla değiştirebilirsin.

2. Login Yöntemi

İki ana seçenek var:

• Claude hesabı ile giriş (Pro / Max / Team / Enterprise abonen varsa — önerilen)
• API anahtarı ile giriş (Anthropic Console’dan kredili kullanım için)

3. Terminal Entegrasyonu

• VS Code terminalin için klavye kısayollarının kurulumuna izin verir misin? → Yes demeni öneririm.

4. Telemetri / Analitik

• Anonim kullanım verisi paylaşmak isteyip istemediğini sorar. Tercihine göre seç.

Tüm bu seçenekleri istediğin zaman /config komutuyla değiştirebilirsin.

Adım 7: Hesabını Bağla (Login)

Claude Code’un çalışması için hesabını bağlaman gerekiyor.

/login

Komutu çalıştırınca tarayıcında bir Anthropic giriş sayfası açılır.

Hesap Türleri

1. Tarayıcıda mevcut Claude hesabınla giriş yap (veya yeni bir hesap aç).
2. Authorize Claude Code butonuna tıkla.
3. Tarayıcı seni terminale geri yönlendirir.
4. Terminalde “Successfully logged in” mesajını göreceksin.

Bir kez giriş yaptıktan sonra kimlik bilgilerin yerel olarak saklanır. Tekrar giriş yapmana gerek kalmaz. Hesap değiştirmek için yine /login komutunu kullanabilirsin.

Adım 8: İlk Kullanım

Tebrikler! Artık Claude Code’u kullanabilirsin. İlk denemen için aşağıdaki komutları sırayla yazıp Enter’a basabilirsin.

Projeyi Tanıt

bu projenin amacı nedir?

Yapı Hakkında Bilgi Al

klasör yapısını açıkla

İlk Kod Değişikliği

ana dosyaya bir hello world fonksiyonu ekle

Claude:

1. İlgili dosyayı bulur
2. Önereceği değişiklikleri sana gösterir
3. Onayını bekler
4. Sen onayladıktan sonra düzenlemeyi yapar

Claude Code, dosyaları değiştirmeden önce her zaman izin ister. Tüm değişiklikleri tek tek onaylayabilir veya bir oturum boyunca Accept all modunu açabilirsin.

Git Komutları (Eğer Git Kullanıyorsan)

hangi dosyaları değiştirdim?

değişikliklerimi açıklayıcı bir mesajla commit'le

Temel Komutlar

İpuçları

1. Net ve Spesifik Ol

Yerine: “hatayı düzelt” Şöyle de: “yanlış şifre girildiğinde boş ekran çıkıyor, login hatasını düzelt”

2. Karmaşık Görevleri Adımlara Böl

1. kullanıcı profilleri için yeni bir veritabanı tablosu oluştur
2. profil bilgilerini güncellemek için API endpoint'i yaz
3. kullanıcının kendi bilgilerini görüp düzenleyebileceği bir sayfa hazırla

3. Önce Keşfetmesine İzin Ver

Kod değişikliği istemeden önce projeyi tanıması için:

veritabanı şemasını analiz et

4. Klavye Kısayolları

• ? → tüm klavye kısayollarını göster
• Tab → komut tamamlama
• ↑ → önceki komut
• / → tüm slash komutları listele

Sorun Giderme

“command not found: claude”

• Terminali kapatıp yeniden açmayı dene.
• macOS/Linux’ta ~/.zshrc veya ~/.bashrc dosyasının kuruluma eklediği PATH satırını içerdiğinden emin ol.
• Windows’ta sistemini yeniden başlat.

PowerShell vs CMD karışıklığı

• Komut başında PS C:\ görüyorsan → PowerShell’desin (irm komutunu kullan)
• Sadece C:\ görüyorsan → CMD’desin (curl komutunu kullan)

VS Code Eklentisi claude CLI’ı bulamıyor

• Önce CLI kurulumunun (Adım 3) tamamlandığından emin ol.
• VS Code’u tamamen kapatıp yeniden aç.
• Eklentinin ayarlarından CLI yolunu manuel olarak belirtebilirsin.

Tarayıcı login penceresi açılmıyor

• Terminalde gösterilen URL’yi kopyalayıp tarayıcıya manuel yapıştır.
• Eğer SSH üzerinden uzak bir makineye bağlıysan, claude --setup-token komutuyla token tabanlı girişi dene.

Daha fazla yardım için:

• Resmi dokümantasyon: https://code.claude.com/docs
• Anthropic Discord topluluğu: https://www.anthropic.com/discord
• Claude Code içinde: /help

Sonraki Adımlar

Temelleri öğrendikten sonra şu konuları araştırabilirsin:

• CLAUDE.md dosyaları ile projeye özel bağlam tanımlama
• Skills (özel yetenek) oluşturma
• MCP (Model Context Protocol) sunucularıyla entegrasyon
• Hooks ile özel olay tetikleyicileri
• Slash komutları ile kısayollar

Detaylar için: https://code.claude.com/docs/en/best-practices

Bu rehber, code.claude.com/docs/en/quickstart adresindeki resmi belgelerden derlenmiştir.