Claude Code rehberi: kurulumdan ilk birleştirilen pull request'e

Claude Code, Anthropic'in terminalde çalışan kodlama agent'ı: deponu okur, dosyaları düzenler ve iş bitene kadar komut çalıştırır. Bu rehber seni kurulumdan incelenmiş bir pull request'e götürüyor; her adımda gereken komutlar, ayarlar ve prompt'lar içinde.

Claude Code rehberine başlamadan önce neye ihtiyacın var?

Üç şeye ihtiyacın var: bir terminal, git deposundaki bir proje ve ücretli bir Claude hesabı. Claude Code; Pro, Max, Team ya da Enterprise aboneliğiyle, önceden yüklenmiş API kredisi olan bir Claude Console hesabıyla ya da Amazon Bedrock gibi bir bulut sağlayıcısıyla çalışıyor. Ücretsiz claude.ai planı Claude Code'u kapsamıyor.

Yazıyı yazdığımız sırada (Ekim 2026) Claude'un fiyatlandırma sayfası Pro'yu aylık 20 dolar (yıllık ödemede aylık 17 dolar), Max'i aylık 100 dolardan başlayan fiyatla listeliyor. Öğrenmek için Pro yeterli. Her gün uzun agent oturumları çalıştırmayı planlıyorsan, plan seçmeden önce Claude Code kullanım sınırlarının nasıl işlediğini oku. Dolar bazlı aboneliği Türk kartıyla ödediğinde tutarı bankan çevirir.

Sistem gereksinimleri mütevazı: macOS 13 ve sonrası, Windows 10 1809 ve sonrası, Ubuntu 20.04 ve sonrası, Debian 10 ve sonrası ya da Alpine 3.19 ve sonrası, 4 GB RAM ile. Bu rehber için gerçek bir proje seç, tercihen test paketi olan bir proje. Oyuncak bir depo sana komutları öğretir ama muhakemeyi öğretmez.

Claude Code nasıl kurulur?

Claude Code'u yerel kurulum aracıyla (native installer) kur; bu araç kendini arka planda güncel de tutar. Bir terminal aç ve sistemine uygun komutu çalıştır.

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

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

Sonra yeni bir terminal penceresi aç ve kurulumu doğrula:

claude --version

Ardından (Claude Code) gelen bir sürüm numarası görmelisin. Kabuk claude bulunamadı diyorsa, kurulum klasörü henüz PATH'inde değil; sorun giderme sayfası her kabuk için çözümü anlatıyor.

Başka kurulum yöntemleri de var, her birinin artıları ve eksileri ile:

İleride bir şey ters görünürse, claude doctor oturum başlatmadan kurulumun ve ayarların için salt okunur bir tanı çıktısı verir.

İlk Claude Code oturumu nasıl başlatılır?

Proje klasörünün içinde claude çalıştırarak bir oturum başlatırsın. İlk açılışta giriş yapman için bir tarayıcı açılır; sonrasında kimlik bilgileri saklanır ve bir daha sorulmaz.

cd ~/code/my-appclaude

İlk prompt'ların değişiklik değil soru olmalı. Claude Code dosyaları gerektikçe kendisi okur, kodu yapıştırmana gerek yok. Şunları dene:

what does this project do, and where is the main entry point?

how do I run the tests here, and do they pass right now?

İşe yarayan ikincisi. Claude testlerini bulup çalıştırabiliyorsa, ileride kendi işini kontrol edebilir. Çalıştıramıyorsa önce bunu düzelt: geri kalan her şeyin ne kadar iyi gideceğini en çok bu belirler. Prompt'ları Türkçe de yazabilirsin; Claude Türkçeyi iyi anlar.

Günlük kullanımın çoğunu şu kabuk komutları karşılar:

/exit ile ya da Ctrl+D'ye iki kez basarak çıkarsın.

Claude Code izin modları nasıl çalışır?

İzin modu (permission mode), Claude'un hangi işlemleri sana sormadan yapacağını belirler. Oturum sırasında Shift+Tab ile mod değiştirirsin; prompt'un altındaki durum çubuğu etkin modu gösterir.

Ekim 2026 itibarıyla, Claude Code v2.1.283 ve sonrasında yeni etkileşimli oturumlar auto modunda başlıyor: Claude rutin onay istemeden çalışırken ayrı bir sınıflandırıcı model her işlemi inceler ve isteğinin ötesine geçen her şeyi engeller. Eski sürümler bazı planlarda Manual modunda başlıyordu.

Auto modundan Shift+Tab önce Manual'a, sonra accept-edits'e, sonra plan moduna geçer. İlk haftanda Manual ya da accept-edits sana en çok şeyi öğretir, çünkü Claude'un çalıştırmak istediği her komutu ve nedenini görürsün.

Modların üstüne, kalıcı kuralları .claude/settings.json (ekibinle paylaşılır) ya da .claude/settings.local.json (yalnızca sen) dosyasına ekleyebilirsin. Deny kuralları her modda geçerlidir.

{  "permissions": {    "allow": ["Bash(npm run *)", "Bash(git commit *)"],    "deny": ["Bash(git push *)", "Read(./.env)"]  }}

Bu ayar, Claude'un her npm script'ini çalıştırmasına ve commit etmesine izin verir; ama push yapamaz ve .env dosyanı okuyamaz. İzin referansı joker karakter kurallarını ayrıntılı anlatıyor: Bash(npm run *), npm run test ile eşleşir ama npm install ile eşleşmez. Agent'ları gözetimsiz çalıştırmadan önce agent güvenliği yazımıza da göz at.

Projem için CLAUDE.md nasıl hazırlanır?

CLAUDE.md, Claude Code'un her oturumun başında yüklediği, talimatlardan oluşan bir markdown dosyası. Bir oturumun içinde /init çalıştırırsan Claude, depoda bulduklarından ilk taslağı yazar.

Taslak yalnızca bir başlangıç noktası. Onu Claude'un kendi başına çıkaramayacağı şeylere indir: tam komutlar, varsayılanlardan farklı kurallar ve ekibinin gerçekten uyguladığı kurallar. Bellek belgeleri dosya başına 200 satırın altında kalmayı öneriyor; daha uzun dosyalar context harcar ve Claude'un onlara uyma oranını düşürür.

## Commands- Install: `pnpm install`- Dev server: `pnpm dev` (port 3000)- Tests: `pnpm test` (Vitest); run one file with `pnpm test path/to/file`- Lint and types: `pnpm lint && pnpm typecheck`, run both before you say a task is done## Conventions- TypeScript strict mode, no `any`- Server code lives in `src/server`, UI in `src/app`- Use the existing `logger` from `src/lib/logger.ts`, never `console.log`## Workflow- Work on a new branch named `feat/<short-name>` or `fix/<short-name>`- Keep each change focused; ask before adding a dependency

Dosyanın nerede durduğu, kimin için geçerli olduğunu belirler:

Başka dosyaları @path/to/file ile içeri alabilirsin (örneğin @docs/architecture.md); /memory ise CLAUDE.md dosyalarını düzenlemen için açar. CLAUDE.md için en iyi uygulamalar rehberimiz yapıyı ve bakımı daha ayrıntılı anlatıyor.

İlk önce hangi Claude Code slash komutlarını öğrenmelisin?

Kullanabileceğin tüm komutları ve skill'leri görmek için oturumda / yaz. Onlarca komutun arasından ilk ay yaklaşık sekizi önemli:

En çok dertten kurtaran alışkanlık, alakasız görevler arasında /clear kullanmak. Dünkü hata ayıklamayla dolu bir konuşma, Claude'u artık geçerli olmayan varsayımlara iter.

Büyük değişikliklerde plan modu nasıl kullanılır?

Plan modu, Claude'un kaynak kodunu düzenlemeden araştırma yapıp bir değişiklik önermesini sağlar. Bir ya da iki dosyadan fazlasına dokunan her işte kullan.

Plan moduna, durum çubuğu plan mode on gösterene kadar Shift+Tab tuşuna basarak, prompt'u /plan ile başlatarak ya da claude --permission-mode plan ile açarak girersin. Claude kodu okur, keşif için komut çalıştırabilir, sonra üç seçenekle bir plan sunar:

1. Yes, and use auto mode: onayla ve Claude'un uygulamasına izin ver.
2. Yes, manually approve edits: onayla, ama her düzenlemeyi ayrı ayrı onayla.
3. No, keep planning: Claude'a planda neyi değiştireceğini söyle.

Planı onaylamadan önce kendi metin editöründe açıp değiştirmek için Ctrl+G tuşuna bas. Pahalı hataları burada yakalarsın: yanlış bir dosya, kimsenin istemediği bir migration, yeni bir bağımlılık. Bir planı düzeltmek bir cümleye, bir uygulamayı düzeltmek bir inceleme turuna mal olur.

Uygulamalı örnek: issue'dan pull request'e ilk gerçek görevin

Baştan sona eksiksiz bir ilk görev. Küçük ve gerçek bir issue seç: net biçimde tekrar üretilebilen bir hata ya da bir öğleden sonraya sığan bir özellik.

1. Temiz başla. git status temiz olsun ve ana dalında ol, sonra claude çalıştır.
2. Görevi kabul kriterleriyle anlat. Belirsiz prompt'lar belirsiz iş üretir.

/plan Users who enter a wrong password see a blank screen instead of an error.Expected: the login form shows "Email or password is incorrect" under thepassword field and keeps the email filled in.Write a failing test for this first, then fix it.Create a branch named fix/login-error-message before editing.Don't change the API response format.

3. Planı oku. Hangi dosyaları andığına, bir testle başlayıp başlamadığına ve verdiğin kapsamın içinde kalıp kalmadığına bak. Gerekirse "No, keep planning" seç ve düzelt.
4. Onayla ve izle. İlk birkaç görevinde manuel onayı seç. Her düzenlemeyi ve her komutu kabul etmeden önce oku.
5. Claude'a kanıtlat. Tüm test paketini, linter'ı ve tip denetleyicisini çalıştırmasını ve çıktıyı göstermesini iste.

run pnpm test, pnpm lint and pnpm typecheck and show me the results.Then summarize what you changed and why, file by file.

6. Diff'i kendin incele. git diff main çalıştır ya da değişiklikleri editöründe aç. Birleştirildikten sonra bu kodun sahibi sensin, bu yüzden onu bir iş arkadaşının pull request'i gibi oku.
7. Commit et ve pull request aç. İnceleyenlerin neye ihtiyaç duyduğunu söylediğinde Claude iyi commit mesajları ve açıklamalar yazar.

commit with a clear message, push the branch, and open a pull request withthe GitHub CLI. In the description, explain the bug, the fix, and how to test it.

Ayarlarında git push'u yasakladıysan Claude durur ve sana sorar; amaç da bu. GitHub CLI (gh) kurulu değilse push'u kendin yap ve pull request'i tarayıcıda aç. İnceleme ve CI geçtikten sonra her zamanki gibi birleştir.

Daha büyük işlerde sonucu büyük ölçüde 2. adımın kalitesi belirler. Yapay zeka kodlama agent'larına nasıl görev yazılır rehberimizde bunun için şablonlar var.

Yeni başlayanlar Claude Code ile hangi hataları yapıyor?

İlk dönemdeki hayal kırıklıklarının çoğu birkaç alışkanlıktan gelir ve her birinin basit bir çözümü var:

• Devasa ilk görevler. "Faturalama sistemini kur" sana büyük, incelemesi zor bir diff getirir. Her biri geçen testlerle biten adımlara böl.
• Doğrulama yolu yok. Test ya da çalıştırılabilir bir kontrol olmadan Claude değişikliğinin çalışıp çalışmadığını yalnızca tahmin edebilir. Ona başarıyı kanıtlayan bir komut ver.
• Hiç bitmeyen tek konuşma. Context dolar ve eski ayrıntılar sıkıştırılır. Görevler arasında /clear kullan, kalıcı kuralları CLAUDE.md'de tut.
• Okumadan onaylamak. Her onay istemini otomatik pilotta kabul etmek incelemenin amacını boşa çıkarır. Onay istemleri çok sıksa bunun yerine allow kuralları ekle.
• Tekrarlayarak düzeltmek. Claude iki kez yanlış yöne giderse, karışmış bir konuşmanın üstüne düzeltme yığmak yerine hatadan öncesine dön (rewind) ve isteği yeniden yaz.
• Uzun görevleri laptop'ta çalıştırmak. Makine uyuduğunda ya da terminal kapandığında oturum ölür.

Sonuncusu, görevlerin bir saat ve daha uzun sürmeye başladığında önem kazanır. Oturumları bir sunucuda tmux ile, başsız bir claude -p çalıştırmasıyla ya da barındırılan bir makineyle canlı tutabilirsin; Claude Code'u 7/24 çalıştırma rehberimiz seçenekleri karşılaştırıyor. Orkio bunlardan biri: Claude Code'un sen laptop'unu kapattıktan sonra da kendi Claude hesabınla çalışmaya devam ettiği, her zaman açık bir bulut kutusu. Pull request'leri sonra telefonundan ya da web'den incelersin.

İlk hafta kontrol listen

İlk birkaç oturumunda bu listeyi tamamla:

• Yerel kurulum aracıyla kur ve claude --version ile doğrula
• Claude'dan testlerini bulup çalıştırmasını iste; onu engelleyen her şeyi düzelt
• /init çalıştır, sonra CLAUDE.md'yi komutlara ve gerçek kurallara indir
• Güvenli komutlar için allow, git push ve sırlar için deny kuralları ekle
• Manual ya da accept-edits modunda her diff'i okuyarak üç küçük görev yap
• Çok dosyalı ilk değişikliğinde /plan kullan ve onaylamadan önce planı düzenle
• Bir değişikliği bir ekip arkadaşının incelediği bir pull request olarak gönder

Bunlar rutine döndüğünde, her düzenlemeden sonra formatter'ını otomatik çalıştırmak için Claude Code hook'larına, Claude'u issue takip aracın gibi araçlara bağlamak için de MCP sunucularına bak.

Sık sorulanlar