Claude Code Nasıl Kurulur?

Claude Code, Anthropic'in terminalde çalışan, proje dosyalarını okuyup değiştirebilen yapay zekâ asistanıdır. Claude Code kurulumu, Claude Code'un bilgisayara bir komutla yüklenmesi, bir hesapla giriş yapılması ve ilk oturumun açılmasıdır. Terminal, bilgisayara yazıyla talimat verilen metin penceresidir. Komut, bu pencereye yazılıp Enter tuşuna basılınca çalışan tek bir talimattır. Oturum, Claude Code'la terminalde yapılan konuşmadır. Claude Code'un ne olduğu ve neler yapabildiği Claude Code nedir yazısında anlatılır.

Claude Code kurmak için ne gerekir?

Claude Code'u kullanmak için bir hesap ve desteklenen bir işletim sistemi gerekir. Claude Console, Anthropic'in geliştiricilere sunduğu web panelidir. Anthropic'in belgelerine göre Claude Code şu hesaplarla kullanılır:

• Pro, Max, Team ya da Enterprise planına sahip bir Claude hesabı
• Bir Claude Console hesabı
• Amazon Bedrock, Google Cloud'un Agent Platform'u ya da Microsoft Foundry üzerinden erişim

Claude'un planları Claude nedir yazısında anlatılır.

Belgelere göre Claude Code şu işletim sistemlerinde çalışır:

Belgelere göre bilgisayarda en az 4 GB bellek (RAM) ve x64 ya da ARM64 türünde bir işlemci bulunmalıdır. Kurulum ve kullanım için internet bağlantısı gerekir. Komutlar terminaldeki bir komut programıyla çalıştırılır. macOS ve Linux'ta Bash ya da Zsh, Windows'ta PowerShell ya da CMD bulunur. Claude Code, Anthropic'in desteklediği ülkelerde kullanılır.

Örnek: Bir öğretmen, okulunun web sitesinin dosyaları üzerinde Claude Code ile çalışmak ister. Bilgisayarının işletim sistemi listede yer alır ve Pro planına sahip bir Claude hesabı vardır. Öğretmen kuruluma bu hesapla başlar.

Claude Code macOS, Linux ve Windows'ta nasıl kurulur?

Anthropic'in önerdiği yol, belgelerde Native Install adıyla geçen kurulumdur. Bu yolda tek bir komut, kurulum betiğini indirip çalıştırır. Betik, bir dizi komutu sırayla çalıştıran küçük programdır. WSL (Windows Subsystem for Linux), Windows'ta Linux programlarını çalıştırmayı sağlayan bir Windows özelliğidir.

macOS, Linux ve WSL için kurulum komutu şudur:

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

Windows PowerShell için kurulum komutu şudur:

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

Windows CMD için kurulum komutu şudur:

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

Kurulum şu adımlarla yapılır:

1. Terminali aç. macOS'ta Cmd + Space tuşlarına bas. Açılan arama kutusuna Terminal yaz ve Enter tuşuna bas. Windows'ta Windows logolu tuşla X tuşuna (Win + X) birlikte bas ve menüden Windows PowerShell'i ya da Terminal'i seç. Linux'ta Ctrl + Alt + T tuşlarına bas ya da uygulama menüsünde Terminal'i ara.
2. Windows'ta CMD açtıysan bunu satırın başındaki yazıdan anlarsın. Belgelere göre PowerShell'de satırın başında PS C:\ yazar, CMD'de ise PS yazmaz. CMD'deysen CMD komutunu kullan.
3. Sistemine uygun komutu kopyala, terminale yapıştır ve Enter tuşuna bas. Kurulum betiği çalışırken ekranda yazılar akar ve iş bitince kurulumun başarıyla bittiğini söyleyen bir mesaj görünür.
4. Kurulum bitince yeni bir terminal penceresi aç.
5. Yeni pencerede claude --version komutunu çalıştır. Ekranda bir sürüm numarası ve ardından (Claude Code) yazısı görünür.

Belgelere göre Windows'ta kurulum komutunu yönetici (Administrator) olarak çalıştırmak gerekmez. Git for Windows, Windows'a Git Bash adlı komut programını kuran pakettir. Belgeler, Windows'ta Git for Windows'u kurmayı önerir. Git for Windows kuruluysa Claude Code, çalıştıracağı komutlar için Git Bash'i kullanır. Kurulu değilse yerine PowerShell devreye girer. WSL kullanan bilgisayarda Claude Code, WSL terminalinde kurulur ve başlatılır.

Paket yöneticisi, yazılımları komutla kuran ve güncelleyen araçtır. Belgelere göre Claude Code paket yöneticileriyle de kurulur:

Belgelerde npm (Node.js paket yöneticisi) ile ve Linux'taki apt, dnf ve apk paket yöneticileriyle kurulum da anlatılır. Terminal kullanmak istemeyen kullanıcı, Claude Code'u masaüstü uygulamasıyla da kullanabilir. Belgelere göre masaüstü uygulaması macOS ve Windows için indirilebilir, Linux için ise beta sürümü vardır.

Örnek: Windows kullanan bir öğrenci PowerShell'i açar ve satırın başında PS yazısını görür. PowerShell komutunu yapıştırıp çalıştırır. Kurulum bitince yeni bir pencere açar ve claude --version yazar. Ekranda sürüm numarası görünür.

Claude Code kurulumu nasıl doğrulanır?

Kurulumun çalışıp çalışmadığı iki komutla kontrol edilir. İlk kontrol için yeni bir terminal penceresinde şu komutu çalıştır:

claude --version

Belgelere göre çalışan bir kurulum, sürüm numarasını ve ardından (Claude Code) yazısını gösterir. Daha ayrıntılı kontrol için şu komut kullanılır:

claude doctor

Belgelere göre bu komut oturum başlatmadan kurulumun durumunu gösterir. Komut, ayar dosyalarındaki hataları ve çözüm öneren uyarıları da listeler.

Örnek: Bir kişi kurulum bitince yeni bir terminal penceresi açar ve claude doctor komutunu çalıştırır. Ekranda kurulumun durumu görünür ve ayar dosyalarında hata olmadığı belirtilir.

Claude Code'a nasıl giriş yapılır?

Claude Code ilk kullanımda bir hesapla giriş ister. Giriş şu adımlarla yapılır:

1. Terminale claude yaz ve Enter tuşuna bas. Claude Code bir oturum başlatır ve giriş yapmanı ister.
2. Claude Code'un tarayıcıda açtığı sayfada Claude hesabınla ya da Claude Console hesabınla giriş yap.
3. Giriş bitince terminale dön.

API, bir yazılımın başka bir yazılıma istek gönderip cevap alabildiği arayüzdür. Belgelere göre giriş için şu hesap türleri kullanılır:

Workspace, Claude Console'da kullanımın ayrı gruplar hâlinde izlendiği bölümdür. Belgelere göre Claude Console hesabıyla ilk girişte Console'da "Claude Code" adlı bir workspace kendiliğinden oluşur. Bu workspace, Claude Code kullanımının maliyetini tek yerde izlemeyi sağlar.

Belgelere göre giriş bilgileri kaydedilir ve sonraki açılışlarda yeniden giriş gerekmez. Hesap değiştirmek ya da yeniden giriş yapmak için çalışan oturumda /login komutu yazılır. API anahtarı, bir yazılımın API'ye kimliğini göstermek için kullandığı gizli koddur. Ortam değişkeni ise bilgisayardaki programların okuyabildiği adlı bir ayardır. Bilgisayarda ANTHROPIC_API_KEY adlı ortam değişkeni tanımlıysa Claude Code tarayıcıyı açmaz. Claude Code bu durumda anahtarın bir kez onaylanmasını ister.

Örnek: Pro planına sahip bir tasarımcı terminale claude yazar. Tarayıcıda açılan sayfada Claude hesabıyla giriş yapar ve terminale döner. Ertesi gün Claude Code'u açtığında yeniden giriş yapması gerekmez.

Claude Code'da ilk oturum nasıl açılır?

Proje klasörü, bir yazılım projesinin dosyalarının bulunduğu klasördür. Terminalde klasör değiştirmek için cd komutu kullanılır. Belgelerdeki örnekte ilk oturum şu iki komutla açılır:

cd /path/to/your/project
claude

İlk oturum şu adımlarla açılır:

1. Terminalde cd komutuyla proje klasörüne geç. Komuttaki /path/to/your/project yerine kendi klasörünün yolunu yaz.
2. Aynı klasörde claude komutunu çalıştır. Claude Code'un mesaj alanı açılır ve alanın üstünde sürüm, kullanılan yapay zekâ modelinin adı ve çalışılan klasör görünür.
3. İlk mesaj olarak "Bu projenin ne işe yaradığını anlat" yaz. Claude Code dosyaları inceler ve projenin bir özetini yazar.

Belgelere göre Claude Code proje dosyalarını gerektikçe kendisi okur. Dosyaları oturuma elle eklemek gerekmez. Claude Code'dan küçük bir kod değişikliği de istenebilir. Claude Code ilgili dosyayı bulur ve değişikliği gösterir.

Claude Code değişiklikten önce onay isterse Yes seçeneğini seç.

Hangi işlerin onay istenmeden yapılacağını permission mode ayarı belirler. Permission mode, Claude Code'un dosya değiştirmeden ya da komut çalıştırmadan önce sorup sormayacağını ayarlayan seçenektir. Permission mode seçenekleri Claude Code nedir yazısında anlatılır.

Belgelere göre sık kullanılan komutlar şunlardır:

Örnek: Bir blog sahibi, sitesinin dosyalarının bulunduğu klasöre geçer ve claude komutunu çalıştırır. İlk mesajında Claude Code'dan klasör yapısını açıklamasını ister. Claude Code klasörleri anlatır ve sayfaların hangi dosyalarda durduğunu gösterir.

Claude Code nasıl güncellenir?

Belgelere göre Native Install ile kurulan Claude Code arka planda kendiliğinden güncellenir. Claude Code açılışta ve çalışırken yeni sürüm olup olmadığını denetler. Güncelleme arka planda iner ve Claude Code bir sonraki başlatıldığında devreye girer. Güncellemeyi hemen yapmak için şu komut kullanılır:

claude update

Belgelere göre komut, güncelleme kurulduğunda eski ve yeni sürüm numarasını gösterir. Sürüm zaten güncelse ekranda Claude Code is up to date mesajı görünür.

Belgelere göre Homebrew ve WinGet ile yapılan kurulumlar varsayılan olarak kendiliğinden güncellenmez. Bu kurulumlar şu komutlarla güncellenir:

Belgelere göre Linux'taki apt, dnf ve apk kurulumları sistemin olağan güncellemeleriyle güncellenir. Claude Code iki güncelleme kanalından birini izler. Varsayılan kanal olan latest, yeni sürümleri çıktıkları anda verir. Diğer kanal olan stable, çoğunlukla bir hafta kadar önce çıkmış sürümü sunar. Bu kanal, büyük sorun çıkaran sürümleri atlar. Native Install'da kanal, oturumda /config komutuyla açılan ayarlardaki Auto-update channel seçeneğinden değiştirilir. Homebrew'da kanal kurulan paketin adıyla seçilir: claude-code stable, claude-code@latest latest kanalını izler.

Örnek: Homebrew ile kurulum yapan bir geliştirici, Claude Code'un yeni sürümünü kullanmak ister. Terminalde brew upgrade claude-code komutunu çalıştırır. Ardından claude --version komutuyla yeni sürümün kurulduğunu görür.

Sonraki adım

Terminali aç, sistemine uygun kurulum komutunu çalıştır ve yeni bir pencerede claude --version yaz. Sürüm numarasını gördükten sonra küçük bir proje klasörüne geç ve claude komutuyla ilk oturumu aç. İlk mesaj olarak Claude Code'dan projedeki dosyaların ne işe yaradığını anlatmasını iste.

Bu kurulum, kod işlerini Claude Code ile yürüttüğün kalıcı bir çalışma düzeninin ilk adımıdır.