Yeni Başlayanlar İçin Claude Code: Kur, Giriş Yap ve İlk Görevini Çalıştır

Çoğu kişi Claude Code ile her yeni araçla tanıştığı gibi tanışır: bir terminal açar, kaybolmuş hisseder ve kodu bir sohbet penceresine yapıştırmaya geri döner. Bu işe yarar, ama Claude Code'u farklı kılan tek şeyi çöpe atar. Senden hiçbir şey yapıştırmanı beklemez.

Bu rehber seni hiçbir şey kurulu değilken bitmiş bir ilk göreve götürür. Kuracak, giriş yapacak, gerçek bir proje hakkında soru soracak, küçük bir değişiklik yapacak ve ilk haftanın çoğunu kapsayan birkaç komutu öğreneceksin.

Claude Code aslında nedir

Claude Code, terminalinde, projenin klasöründe çalışan bir asistandır. Ona bir görev verdiğinde üç aşamalı bir döngüyle ilerler: bağlam toplar, harekete geçer ve sonucu doğrular. Görev bitene kadar bu döngüyü tekrarlar; sen de istediğin an araya girebilirsin.

Sohbetten farkı araçlardır. Sohbet yalnızca metinle yanıt verebilir. Claude Code ise dosyalarını okuyabilir, düzenleyebilir, projede arama yapabilir, test paketin gibi komutları çalıştırabilir ve git kullanabilir. Her sonuç bir sonraki kararı besler.

Diyelim ki ondan başarısız testleri düzeltmesini istedin. Büyük olasılıkla testleri çalıştırıp neyin başarısız olduğuna bakar, hata çıktısını okur, ilgili dosyaları arar, okur, düzenler ve testleri yeniden çalıştırır. Sen tek bir cümle yazdın. O altı adım attı.

Claude Code'un yaptığın iş için doğru araç olup olmadığına hâlâ karar vermeye çalışıyorsan önce Claude Code, Projects ve Sohbet karşılaştırmasını oku. Bu rehber, kararını verdiğini varsayar.

Başlamadan önce

Üç şeye ihtiyacın var ve hiçbirini edinmek zor değil.

Claude Code ücretsiz Claude planına dahil değildir, bu yüzden bu hesaplardan biri gerekir. Hiç terminal açmadıysan resmî terminal rehberi nasıl açılacağını ve komutun nasıl yapıştırılacağını gösterir. Yaklaşık iki dakika sürer.

1. Adım: Claude Code'u kur

Kurmanın birkaç yolu var. Önerilen yol yerel (native) yükleyicidir, çünkü arka planda kendini günceller.

Sistemine uyanı seç, terminale yapıştır ve Enter'a bas. Yükleyici indirirken ilerleme göstermez, bu yüzden donduğunu düşünme.

Linux'ta Debian, Fedora, RHEL ve Alpine için apt, dnf veya apk ile de kurabilirsin. Yerel Windows'ta, Claude Code'un Bash aracını kullanabilmesi için Git for Windows önerilir. O olmadan Claude Code onun yerine PowerShell kullanır. WSL kullanıyorsan Git for Windows'a gerek yok.

Çalıştığını kontrol et

Yükleyici bitince yeni bir terminal penceresi aç. Bu önemli: eski pencere yeni programı henüz tanımaz. Sonra sürüm komutunu çalıştır.

$ claude --version2.1.283 (Claude Code)

Kabuğun claude komutunu bulunamadı ya da tanınmadı diyorsa, kurulum klasörü henüz PATH'inde değildir. Terminali kapatıp yeniden açmak çoğu zaman çözer. Çözmezse resmî kurulum sorun giderme sayfası her hata mesajını bir çözümle eşleştirir.

2. Adım: İlk oturumunu başlat

Proje klasörüne git ve programın adını yaz.

$ cd ~/projects/my-website$ claude

İlk seferde Claude Code senden giriş yapmanı ister. Claude aboneliği ya da Console hesabı için tarayıcını açar, girişi orada onaylarsın ve terminale dönersin. Kimlik bilgilerin saklanır, yani bunu bir daha yapmazsın.

Şunlardan herhangi biriyle giriş yapabilirsin:

• Claude Pro, Max, Team veya Enterprise hesabı; önerilen yol budur.
• Bir Claude Console hesabı. İlk girişte, maliyetini izleyebilmen için otomatik olarak bir "Claude Code" çalışma alanı oluşturulur.
• Amazon Bedrock, Google Cloud veya Microsoft Foundry; şirketi erişimi bu yolla sağlayanlar için.

ANTHROPIC_API_KEY ortam değişkenini ayarladıysan ve sorulduğunda anahtarı onaylarsan, Claude Code giriş adımını atlar.

İçeri girdiğinde sürümü, geçerli modeli ve üzerinde çalıştığın klasörü gösteren bir istem görürsün. Komutları listelemek için /help, eski bir konuşmaya devam etmek için /resume, hesap değiştirmen gerekirse sonradan /login yaz.

3. Adım: Bir şeyi değiştirmeden önce soru sor

İlk promptların hiçbir şeyi değiştirmemeli. Sorular, Claude Code'un projeni nasıl okuduğunu görmenin en güvenli yoludur ve onun zaten ne bildiğini öğretir.

Claude ihtiyaç duyduğu dosyaları okur ve yanıtlar. Dosyaları elle eklemezsin, onları kendisi bulur. Daha dar sorularla, tek tek devam et:

> bu proje ne yapıyor?package.json, README.md, src/ okunuyor ...Bu, Next.js ile geliştirilmiş statik bir pazarlama sitesi. Sayfalar src/app içinde, ortak bileşenler src/components içinde, içerik ise content/ klasöründe duruyor.

Claude Code'a kendisi hakkında da soru sorabilirsin. "Claude Code neler yapabilir?" ya da "Claude Code'da özel skill'ler nasıl oluşturulur?" gibi sorular gerçek yanıtlar alır, çünkü kendi dokümantasyonunu bilir.

Claude Tutorial içinde

Harekete geçmeden önce sormak, kazanmaya değer bir alışkanlıktır

Değişiklik istemeden önce asistana gördüklerini açıklatmak, uygulamanın yalnızca kod için değil her tür iş için öğrettiği disiplinin aynısıdır.

Çok yakında

Şuradan indir:App Store

BURADAN İNDİR:Google Play

4. Adım: İlk değişikliğini yap

Şimdi küçük ve geri alması kolay bir şey iste.

Claude Code doğru dosyayı bulur ve yapmak istediği değişikliği sana gösterir. Ayarlarına bağlı olarak önce onayını isteyebilir. İsterse önerdiğini oku ve Yes seç.

Bu prompt bilerek çok küçük. Bu adımın amacı fonksiyon değil. Tüm döngüyü bir kez görmek: sen istersin, Claude dosyayı bulur, düzenlemeyi gösterir, sen onaylarsın ve dosya değişir.

Claude Code'un sormadan neler yapabileceğini oturumun izin modu (permission mode) belirler. Modlar arasında geçmek için istediğin an Shift+Tab'a bas. Yeni sürümler etkileşimli terminal oturumlarını auto modunda başlatır; burada arka plandaki bir kontrol, her biri için sana sormak yerine riskli eylemleri engeller. Eski sürümler ya da başka kurulumlar daha sık sorar. Hangi modda olduğunu görmek için durum satırına bak. Sıradaki rehber, Claude Code İzin Modları ve Plan Modu Açıklaması, her modu ve hangisinin ne zaman kullanılacağını anlatır.

5. Adım: Git'i konuşarak kullan

Projen git kullanıyorsa onu konuşma yoluyla çalıştırabilirsin. Bunların hepsi yazıldığı gibi çalışır.

Ona güvensen bile kabul etmeden önce commit mesajını ve diff'i oku. Claude Code'un ürettiği her şeyin gözden geçireni sensin.

6. Adım: Bir hatayı düzelt ya da bir özellik ekle

Gerçek görevler gerçek ayrıntıyla daha iyi gider. Aynı düzeltmeyi istemenin şu iki yolunu karşılaştır.

Daha iyi sürümler belirtiyi, yeri ve bitmiş halin neye benzediğini söyler. Claude Code dosyaları kendisi bulabilir, bu yüzden onları sıralaman gerekmez; ama hangi sorunu kastettiğini senin aklından okuyamaz.

Daha büyük işlerde, işi numaralı bir listede adımlara böl.

Kod tabanını henüz tanımıyorsan önce Claude'un keşfetmesine izin ver: ikisinden birini değiştirmesini istemeden önce veritabanı şemasını ya da ödeme akışının nasıl çalıştığını analiz etmesini iste. Birkaç dakikalık okuma çoğu zaman yanlış bir değişikliği önler.

Her gün kullanacağın komutlar

Bazı komutları kabuğunda, Claude Code başlamadan önce; bazılarını ise oturumun içinde çalıştırırsın.

Birkaç tuş çok zaman kazandırır. Sahip olduğun tüm komutları ve skill'leri görmek için / yaz. Bir komutu tamamlamak için Tab, önceki promptları geri getirmek için ↑, izin modunu değiştirmek için Shift+Tab kullan. Claude yanlış yöne giderse hemen durdurmak için Esc'ye bas.

İlk gün işler ters gittiğinde

Bunlar insanların en sık karşılaştığı sorunlar ve her birinin anlamı.

Bunların hiçbiri uymuyorsa Claude Code'un kendisine sor. Mesajı yapıştırarak "bu hatayı nasıl düzeltirim?" gibi bir şey yaz. /doctor komutu da kurulum ve yapılandırma sorunlarını teşhis eden bir kurulum kontrolü çalıştırır.

Terminal kullanmak zorunda değilsin

Terminal, Claude Code'un asıl evidir ve yukarıdaki her şey orada geçerlidir. Aynı asistan masaüstü uygulaması olarak, VS Code ve JetBrains editörlerinin içinde, claude.ai/code adresinde web üzerinde, Slack'te ve GitHub Actions ile GitLab üzerindeki otomatik işlem hatlarında da bulunur. Arayüz, onu nasıl gördüğünü ve onunla nasıl konuştuğunu değiştirir. Bağlam toplama, harekete geçme ve doğrulama döngüsü her yerde aynıdır.

Sık sorulan sorular

Claude Code ücretsiz mi?

Hayır. Claude Pro, Max, Team veya Enterprise aboneliği, API kredili bir Claude Console hesabı ya da desteklenen bir bulut sağlayıcısı üzerinden erişim gerekir. Ücretsiz Claude planı onu içermez.

Claude Code'u kullanmak için kod yazmayı bilmem gerekir mi?

Onu yönlendireceğin bir projen olmalı ve projeyi ne kadar iyi anlarsan işini o kadar iyi değerlendirirsin. Kodu kendin yazman gerekmez. Yeni başlayanlar en çok 3. Adım'daki önce sor alışkanlığından yararlanır: değiştirmesini istemeden önce Claude'dan açıklamasını iste.

Dosyalarımı düzenlemesine izin vermek güvenli mi?

Sormadan neler yapabileceğini izin moduyla sen denetlersin ve dosya düzenlemeleri Esc tuşuna iki kez basarak geri sarılabilir. Çıktısına bir iş arkadaşının pull request'i gibi davran: commit etmeden önce diff'i oku. Her değişikliğin incelenmesi ya da geri alınması kolay olsun diye projeni git içinde tut.

Claude Code ile sohbetteki Claude arasındaki fark nedir?

Sohbet, yapıştırdığın şey hakkında metinle yanıt verir. Claude Code projenin içinde çalışır: dosyaları kendisi okur, düzenler, komut çalıştırır ve kendi işini kontrol eder. Düşünmek için sohbeti, yapmak için Claude Code'u kullan.

Claude Code oturumlar arasında projemi hatırlar mı?

Her oturum taze bir bağlamla başlar. Bilgiyi oturumlar arasında taşımak için onu CLAUDE.md adlı bir dosyaya yazarsın; Claude Code ayrıca tercihlerine dair kendi notlarını da tutar. Bir sonraki rehberden sonraki rehber, CLAUDE.md Açıklaması, bunun nasıl yapıldığını gösterir.

İlk gün kontrol listen

Okumaya devam et

• Claude Code İzin Modları ve Plan Modu Açıklaması: Claude Code'un sormadan ne kadar şey yapabileceğine karar vermek için.
• CLAUDE.md Açıklaması: Claude Code'a Projeni Bir Kez Öğret: aynı yönergeleri her oturumda tekrarlamayı bırakman için.
• Claude Code En İyi Uygulamalar: Daha İyi Sonuç Getiren Alışkanlıklar: promptlar, kontroller ve bağlam yönetimi için.
• Claude Code ile Çok Dosyalı Değişiklikler Nasıl Yapılır: birçok dosyaya dokunan ilk değişikliğin için.
• Claude'u Kendi Verilerine ve Araçlarına MCP ile Bağlamak: kendi klasörünün ötesine ulaşmak için.