Claude · Gelişmiş · 201 Claude Code temeli · Konu 3 / 10
3.3 Kurulum ve ilk oturum
Kurulumu doğrula, proje klasöründe oturum aç.
Bu sayfada ne öğreneceksin
Bu dersten sonra Claude Code'u kendi sistemine kurup proje klasöründe ilk oturumu açabileceksin.
- Sistemine uygun kurulum komutunu seçmeyi
- Giriş yapıp proje klasöründe oturum açmayı
- Kendi kurulumunu denetleyip hata için doğru kaynağa gitmeyi
Kısaca
Daha basit anlat
Claude Code, bilgisayarında terminal denen pencerede çalışan bir yardımcıdır; sohbetteki Claude yazışarak yardım eder, Claude Code ise bilgisayarındaki dosyalarla çalışır. Önce kurulur, sonra dosyalarının olduğu klasörde başlatılır. Kurulumdan sonra yeni bir terminal penceresi açıp claude --version yazarak çalıştığını görürsün; ekranda bir sürüm numarası görürsen kurulum tamamdır. İlk açılışta tarayıcıda hesabına giriş yaparsın. Giriş için ücretli bir Claude planı ya da Console hesabı gerekir; planlar için resmî fiyat sayfasına bak.
Terminalde kullanmak için Claude Code'u kur, yeni bir terminalde kurulumu doğrula ve çalışacağın proje klasörüne gir. claude oturumu başlatır.
Girişte Claude aboneliği, Console hesabı veya kuruluşunun desteklenen bulut sağlayıcısı kullanılabilir. Desktop ve web gibi diğer yüzeylerin başlangıç yolu farklıdır; aşağıda bağlantıları var.
Daha derin
Kurulum native (kurulum betiği) ya da paket yöneticisiyle (Homebrew, WinGet) yapılır. Native kurulum arka planda kendini günceller; Homebrew ve WinGet kurulumları kendiliğinden güncellenmez. Giriş, abonelik ya da Console hesabıyla tarayıcı üzerinden tamamlanır; ANTHROPIC_API_KEY tanımlıysa ve onaylanırsa giriş ekranı atlanır. Masaüstü uygulamasında Code sekmesi ayrı bir yüzeydir ve CLI kurulumu gerektirmez. Kaynak: Claude Code belgeleri, Quickstart ve Advanced setup.
Resmî kaynakta oku: Claude Code belgeleri: Advanced setup ↗
Adım adım
Daha basit anlat
1) Terminali aç. Terminal, komut yazarak bilgisayara iş verdiğin penceredir. Mac'te Cmd+Space'e basıp 'Terminal' yaz ve Enter'a bas. Windows'ta Win+X'e basıp listeden 'Windows PowerShell' ya da 'Terminal' seç. Linux'ta Ctrl+Alt+T'yi dene ya da uygulama menüsünde 'Terminal' ara. 2) Aşağıdaki Kurulum komutları bölümünden işletim sistemine uyan satırın kopyala düğmesine bas. Windows'ta PowerShell açtıysan 'Windows PowerShell' başlıklı satırı al. Pencereye yapıştır (Mac'te Cmd+V, Windows'ta Ctrl+V, Linux'ta Ctrl+Shift+V) ve Enter'a bas. İndirme sırasında ilerleme görünmez, pencereyi kapatma. 3) Kurulum bitince yeni bir terminal penceresi aç; resmî kılavuz bu kontrolü yeni pencerede yapmanı söyler. 4) Yeni pencerede claude yazıp Enter'a bas; ilk açılışta tarayıcı açılır, ekrandaki adımları izleyip hesabınla giriş yap. 5) Dosyalarınla çalışmaya hazır olunca terminalde cd yaz, bir boşluk bırak, klasörün adını yaz ve Enter'a bas; sonra claude yaz. Claude Code açıldığı klasördeki dosyaları görür.
- Erişimini kontrol et. Claude aboneliği (Pro, Max, Ultra, Team veya Enterprise), Console hesabı ya da desteklenen bir bulut sağlayıcısıyla erişim gerekir.
- Terminali aç. İlk kez kullanıyorsan resmî terminal rehberine bak.
- Sistemine uygun komutu çalıştır. Aşağıdaki macOS/Linux/WSL, PowerShell veya CMD komutundan uygun olanı seç. İndirme sırasında ilerleme görünmeyebilir. Hata alırsan Troubleshoot installation sayfasında hata mesajını ara.
- Yeni bir terminalde doğrula.
claude --versionçalıştır. Komut bulunamazsa resmî PATH düzeltme adımlarına bak. - Proje klasöründe başlat.
cdile çalışacağın klasöre geç, ardındanclaudeyaz. - Giriş adımlarını izle. Claude aboneliği veya Console için tarayıcıdaki adımları tamamla.
ANTHROPIC_API_KEYtanımlıysa ve sorulduğunda bu anahtarı kullanmayı onaylarsan giriş ekranı atlanır. Console ile ilk girişte “Claude Code” adlı çalışma alanı otomatik oluşturulur. - Oturumu denetle.
/helpkomutları gösterir;/loginhesap değiştirme veya yeniden giriş içindir./doctorkurulum ve yapılandırma sorunlarını denetler. Oturumdan/exitile çıkabilirsin.
Daha derin
Sıranın nedeni: resmî kılavuz kurulumdan sonra doğrulamayı yeni bir terminal penceresinde yapmanı söyler; komut bulunamazsa kurulum klasörü PATH'e henüz eklenmemiş olabilir. Komut bulunamazsa PATH düzeltmesi gerekir. Oturum içinde /doctor (denetim) kurulum ve yapılandırma sorunlarını denetler; /login (giriş) Anthropic hesabına giriş yapmanı sağlar. Kurulum ve giriş hatalarının resmî listesi Troubleshoot installation and login sayfasındadır.
Resmî kaynakta oku: Claude Code belgeleri: Troubleshoot installation and login ↗
Kurulum komutları
Daha basit anlat
İşletim sistemine göre tek satırlık bir kurulum komutu var. Mac ve Linux'ta aynı komut kullanılır; Windows'ta iki komut var: PowerShell için olan ve CMD için olan. Hangisinde olduğunu terminaldeki istem satırının başından anlarsın: PowerShell'de PS C:\ görünür. Komutu terminal penceresine yapıştırıp Enter'a basman yeterli; kurulum bu tek komutla bilgisayarına iner.
Komutlar resmî kaynaktaki haliyle verilmiştir. Komut zamanla değişebilir; çalıştırmadan önce resmî sayfaya bak.
macOS, Linux ve 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
Homebrew veya WinGet kullanıyorsan:
brew install --cask claude-code
winget install Anthropic.ClaudeCode
Homebrew ve WinGet kurulumları kendiliğinden güncellenmez; ilgili yöntemle güncelleme yapman gerekir. Ayrıntı için resmî başlangıç sayfasını kontrol et.
Native Windows'ta Bash aracı için Git for Windows önerilir; kurulu değilse kabuk aracı PowerShell olur. WSL için Git for Windows gerekmez.
Daha derin
Kurulum betiği indirme sırasında ilerleme göstermez; bitince yeni terminalde claude --version çalıştırılır. Homebrew iki cask sunar: kararlı sürüm kanalı ve en yeni kanal; güncelleme komutu seçilen caska göre değişir. WinGet kurulumu düzenli olarak yükseltme komutuyla güncellenir. Native Windows'ta Bash aracı için Git for Windows önerilir; WSL için gerekmez. Kaynak: Advanced setup, Install Claude Code.
Resmî kaynakta oku: Claude Code belgeleri: Advanced setup ↗
Hazır komutlar
Kurulumu doğrula:
claude --version
Yolu kendi proje klasörünle değiştir:
cd /klasorun/yolu/deneme-projesi
claude
Oturum açıldığında kendi projen üzerinde sor:
Bu projenin amacı ne? Klasörlerin hangi işleri üstlendiğini açıkla.
Kurulum ve yapılandırmayı denetlemek için oturum içinde:
/doctor
Diğer yüzeyler
Daha basit anlat
Claude Code yalnız terminalde değil; masaüstü uygulamasında ve tarayıcıda da çalışır. Hangisini seçersen seç, aynı yardımcı farklı bir kapıdan açılır.
- VS Code: Extensions görünümünde “Claude Code” ara. Kurulumdan sonra komut paletinde “Claude Code” yazıp Open in New Tab seç.
- JetBrains: JetBrains Marketplace'ten Claude Code eklentisini kur ve IDE'yi yeniden başlat. Eklenti için CLI ayrıca kurulu olmalıdır.
- Desktop: Uygulamayı açıp giriş yaptıktan sonra Code sekmesine tıkla. Claude Code uygulamanın içindedir; CLI'ı ayrıca kurman gerekmez. Hesap koşullarını resmî sayfadan kontrol et.
- Web: claude.ai/code adresine git.
Daha derin
Arayüzler aynı ajan döngüsünü paylaşır; araç erişimi ve oturum davranışı yüzeye göre değişir. Masaüstü uygulamasında Code sekmesi yerel klasörlerle çalışır; web sürümü bulut oturumları kullanır. Ayrıntı: How Claude Code works, Interfaces başlığı ve Overview, Use Claude Code everywhere.
Resmî kaynakta oku: Claude Code belgeleri: How Claude Code works ↗
Sık yapılan hata
- Kabuğa uymayan komut seçmek. PowerShell ve CMD farklı komut kullanır; hata mesajını kurulum rehberiyle eşleştir.
- Kurulumdan sonra eski terminalde denemek. Yeni bir terminal açıp doğrula; komut hâlâ bulunamazsa PATH yardımını oku.
- Giriş ekranı çıkmayınca kurulumu bozuk sanmak. Onayladığın API anahtarıyla giriş adımı atlanmış olabilir.
Video
Video: yakında.
Kendini dene
Kaynaklar
Bu sayfada ne öğreneceksin
- Claude Code belgeleri: Quickstart · Bölüm: “Step 1: Install Claude Code” · Ne aldık: Kurulum, doğrulama ve ilk oturumun resmî sırasını. · Doğrulandı: 13 Kasım 2026
Kısaca
- Claude Code belgeleri: Quickstart · Bölüm: “Quickstart” · Ne aldık: Kurulumdan sonra yeni terminalde doğrulama ve proje klasöründe oturum başlatma akışını. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: Advanced setup · Bölüm: “Authenticate” · Ne aldık: Girişte abonelik, Console hesabı ya da bulut sağlayıcısı kullanılabildiğini. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: How Claude Code works · Bölüm: “How Claude Code works” · Ne aldık: Claude Code'un terminalde çalışan bir yardımcı olduğunu ve yerelde bilgisayardaki dosyalara eriştiğini. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: Quickstart · Bölüm: “Before you begin” · Ne aldık: Başlamak için Claude aboneliği (Pro, Max, Ultra, Team ya da Enterprise) ya da Claude Console hesabı gerektiğini. · Doğrulandı: 13 Kasım 2026
Adım adım
- Claude Code belgeleri: Terminal guide for new users · Bölüm: “Terminal guide for new users” · Ne aldık: Terminalin ne olduğunu ve macOS'te Spotlight, Linux'ta Ctrl+Alt+T, Windows'ta Win+X ile (Windows PowerShell ya da Terminal) açılışını; komutun yapıştırma tuşlarıyla (Cmd+V, Ctrl+Shift+V, Ctrl+V) yapıştırılıp Enter ile çalıştırıldığını; Windows'ta PowerShell ve CMD'nin ayrı olduğunu. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: Quickstart · Bölüm: “Step 2: Start your first session” · Ne aldık: Oturumun proje klasöründe başladığını, girişte tarayıcı adımlarının izlendiğini ve API anahtarı onaylanırsa giriş ekranının atlandığını. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: Advanced setup · Bölüm: “Verify your installation” · Ne aldık: Kurulumun claude --version komutuyla doğrulandığını. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: Troubleshoot installation and login · Bölüm: “Verify your PATH” · Ne aldık: Komut bulunamazsa PATH düzeltmesinin resmî adımlarını. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: Troubleshoot installation and login · Bölüm: “Run diagnostic checks” · Ne aldık: Oturum içindeki /doctor komutunun kurulum ve yapılandırmayı denetlediğini. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: Commands · Bölüm: “All commands” · Ne aldık: /help, /login, /exit ve /doctor komutlarının ne yaptığını. · Doğrulandı: 13 Kasım 2026
Kurulum komutları
- Claude Code belgeleri: Advanced setup · Bölüm: “Install Claude Code” · Ne aldık: İşletim sistemine göre kurulum komutlarını ve Homebrew ile WinGet seçeneklerini. · Doğrulandı: 13 Kasım 2026
Hazır komutlar
- Claude Code belgeleri: Quickstart · Bölüm: “Essential commands” · Ne aldık: Oturum içinde en sık kullanılan komutların listesini. · Doğrulandı: 13 Kasım 2026
Diğer yüzeyler
- Claude Code belgeleri: Overview · Bölüm: “Use Claude Code everywhere” · Ne aldık: Terminal dışındaki yüzeylerin (masaüstü, web, IDE) resmî listesini. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: How Claude Code works · Bölüm: “Interfaces” · Ne aldık: Aynı aracın farklı arayüzlerde nasıl çalıştığını. · Doğrulandı: 13 Kasım 2026
Sık yapılan hata
- Claude Code belgeleri: Troubleshoot installation and login · Bölüm: “Find your error” · Ne aldık: Hata mesajını resmî listede arama yöntemini. · Doğrulandı: 13 Kasım 2026
- Claude Code belgeleri: Troubleshoot installation and login · Bölüm: “Wrong install command on Windows” · Ne aldık: PowerShell ile CMD komutlarının karıştırılmasının ayrı bir hata başlığı olduğunu. · Doğrulandı: 13 Kasım 2026
Bizim deneyimimiz
- Bizim deneyimimiz · Ne aldık: İlk oturumda projenin klasör yapısını sormanın, aracın ne gördüğünü anlamanın en hızlı yolu olduğunu gördük. · Denedik: 13 Kasım 2026
Son doğrulama: 2026-11-13