Claude Code’a giriş: kurulum ve ilk çalışma düzeni

Bu derste Claude Code’un ne olduğunu, bilgisayarınıza nasıl kurulduğunu ve ilk oturumu nasıl açacağınızı öğreneceksiniz. Ardından bir işi keşfet, planla, uygula, kaydet sırasıyla yürütmeyi göreceksiniz.

Not: Claude Code için ücretli bir erişim gerekir. Anthropic’in belgesi şu seçenekleri sayıyor: Claude aboneliği (Pro, Max, Team ya da Enterprise), Claude Console hesabı ya da desteklenen bir bulut sağlayıcısı.

Aklınıza bir soru mu takıldı?

Sorunuzu ya da aradığınız konuyu yazın Ders bul

Bu derste neler öğreneceksiniz?

• Claude Code’un ne işe yaradığını ve nerelerde çalıştığını.
• Kendi sisteminize uygun kurulum komutunu seçip ilk oturumu açmayı.
• Keşfet, planla, uygula, kaydet düzeniyle işi güvenli biçimde ilerletmeyi.

Claude Code nedir?

Anthropic’in belgesine göre Claude Code, terminalde çalışan bir araçtır. Terminal, komutları yazıp çalıştırdığınız metin penceresidir. Claude Code projenizin dosyalarını okur, sorularınızı yanıtlar ve istediğiniz değişiklikleri yapar. Belge, aracın web sürümünün, masaüstü uygulamasının, VS Code ve JetBrains eklentilerinin, Slack’in ve GitHub Actions ile GitLab’ın içinde de bulunduğunu söylüyor. Bu ders terminal sürümünü anlatıyor.

Kod bilmeniz gerekmez; isteğinizi kendi cümlelerinizle yazarsınız. Yine de Claude’un yaptığı değişikliği okumak ve onaylamak sizin sorumluluğunuzdadır. Terminal hiç kullanmadıysanız belgede ayrıca bir terminal rehberi var.

Kurulum

Belgenin önerdiği yol, sisteminize uygun tek bir komutu terminale yapıştırmaktır. Komutları yalnızca resmî belgeden kopyalayın; internetten indirilip çalıştırılan komutlar bilgisayarınızda iş yapar.

# macOS, Linux ve WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell (satır başında PS C:\ görünür)
irm https://claude.ai/install.ps1 | iex

# Windows CMD (satır başında PS olmadan C:\ görünür)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Belge iki seçenek daha veriyor: macOS için Homebrew (brew install --cask claude-code) ve Windows için WinGet (winget install Anthropic.ClaudeCode). Belgenin önerdiği (native) kurulum arka planda kendiliğinden güncellenir; Homebrew ve WinGet ile kurulumda güncellemeyi siz yaparsınız. Windows’ta Git for Windows’un kurulu olması öneriliyor.

Kurulum bitince yeni bir terminal penceresi açın ve claude --version yazın. Sürüm numarası görüyorsanız kurulum tamamdır. Komut bulunamadı hatası alırsanız belge bunun kurulum klasörünün PATH’e eklenmemesinden kaynaklandığını söylüyor ve sorun giderme sayfasına yönlendiriyor.

İlk oturum

Terminali çalışacağınız klasörde açın ve claude yazın. İlk kullanımda Claude Code giriş yapmanızı ister; tarayıcıda açılan adımları izlersiniz. Belgeye göre giriş bilgileriniz saklanır ve her seferinde yeniden girmezsiniz.

İlk sorunuz için belge what does this project do? gibi bir soru öneriyor; yani projenin ne işe yaradığını sormakla başlamak yeterlidir. Oturumda işinize yarayacak komutlar şunlar:

• /help: kullanılabilir komutları gösterir.
• /resume: önceki bir konuşmaya devam ettirir.
• /clear: konuşma geçmişini temizler.
• /exit: çıkış yapar.
• Shift+Tab: izin modunu değiştirir. İzin modu, Claude’un hangi işleri size sormadan yapabileceğini belirler.

Keşfet, planla, uygula, kaydet

Aşağıdaki dört adım, Anthropic’in belgelerinde ayrı ayrı anlatılan önerilerin sıraya dizilmiş hâlidir. Belgelerde bu dört ad tek bir başlık altında geçmez.

1. Keşfet: Değişiklik istemeden önce Claude’a projeyi anlattırın. Belge give me an overview of this codebase gibi geniş bir soruyla başlayıp sonra ayrıntıya inmeyi öneriyor.
2. Planla: Plan modunda Claude dosyaları okur ve bir plan önerir, siz onaylayana kadar hiçbir şeyi değiştirmez. Moda Shift+Tab ile geçebilir ya da claude --permission-mode plan komutuyla başlayabilirsiniz. Durum çubuğunda plan modunun açık olduğu yazar.
3. Uygula: Belirli bir istek yazın: dosyayı, sorunu ve “düzeldi” demenin ölçüsünü söyleyin. Belge ayrıca Claude’a çalıştırabileceği bir kontrol vermeyi, örneğin testleri çalıştıran komutu söylemeyi öneriyor.
4. Kaydet: Önce what files have I changed? diye sorup değişiklikleri görün. Sonra commit my changes with a descriptive message isteğiyle değişiklikleri Git’e kaydettirin. Commit, projenin o anki hâlini geri dönülebilir bir nokta olarak saklamaktır.

Videoyla izleyin

İzlerken şuna dikkat edin: Video, kod bilmeyen birinin Claude Code’a yaptırmak istediği işi düz bir dille tarif ederek bir tablodan çalışan bir uygulama elde etmesini gösteriyor. Plan modunda (plan mode) Claude’un planı siz onaylamadan hiçbir dosyaya dokunmadığına ve izin ayarlarına dikkat edin. Video, uygulamanın paylaşılmasını anlatan bölümden sonra kendiliğinden durur.

Video: Kevin Stratvert, bağımsız eğitmen (İngilizce). Türkçe altyazı için YouTube’da altyazı ayarını açabilirsiniz.

Adım adım uygulama

Gerçek işlerinizi riske atmamak için önce bir deneme klasörüyle çalışın.

1. Sisteminize uygun kurulum komutunu çalıştırın.
2. Yeni bir terminal açıp claude --version ile kurulumu doğrulayın.
3. İçinde birkaç deneme metni olan bir kopya klasör hazırlayın. Kişisel veri içermesin.
4. Terminalde o klasöre girip claude yazın ve tarayıcıdan giriş yapın.
5. Önce klasörü anlatmasını isteyin.
6. Yukarıdaki komutla plan isteyin; planı okuyun.
7. Planı onaylayıp küçük bir değişiklik yaptırın, her onay isteğini okuyarak ilerleyin.
8. İsterseniz değişikliği commit ettirin ve /exit ile çıkın.

Kontrol listesi

• claude –version bir sürüm numarası gösteriyor.
• Giriş yaptım ve ilk soruma yanıt aldım.
• Önce keşfettim, sonra plan istedim.
• Değişikliği onaylamadan önce okudum.
• Komutlara parola ya da anahtar yazmadım.

Sık yapılan hatalar

• Belirsiz istek: “Şunu düzelt” yerine dosyayı ve beklediğiniz sonucu yazın.
• Okumadan onaylamak: Claude’un önerdiği değişiklik ve komutları onaylamadan önce okuyun.
• Yedeksiz denemek: Önemli dosyalarınızın kopyası yokken doğrudan onlar üzerinde çalışmayın.
• Gizli bilgi yazmak: Parola, API anahtarı ya da başkalarının kişisel verilerini isteğe yapıştırmayın. Kişisel veri içeren klasörlerde KVKK yükümlülüklerinizi düşünün.
• PowerShell ile CMD’yi karıştırmak: Belgeye göre && ile ilgili bir hata alıyorsanız PowerShell’desinizdir; irm tanınmadı hatası alıyorsanız CMD’desinizdir. Her ortamın komutu farklıdır.

Kendinizi deneyin

Kaynaklar

• Quickstart – Claude Code Docs (İngilizce)
• Common workflows – Claude Code Docs (İngilizce)
• Best practices for Claude Code – Claude Code Docs (İngilizce)
• Kevin Stratvert: Claude Code Tutorial for Non-Coders (YouTube videosu) (İngilizce)

Son kontrol: 11 Kasım 2026

Kaynak: yzdersleri.com/ders/claude-code-giris/ · Yapay Zeka Dersleri