Doğan Mert ZENFELT.
Rehberler• İçerik• Hakkımda• İş için
Bana yaz
Rehberler ›Claude Code

Claude Code Başlangıç Rehberi

60 binden fazla yıldızlı "best practice" derlemesinin Türkçeye çevrilmiş ve resmi Claude Code dokümanıyla doğrulanmış hali: 83 ipucu, komut kopya kağıdı ve repoda bile yanlış olan 5 şey.

Ücretsiz · tamamı bu sayfada, indirmeye gerek yok
83 ipucu Komut kopya kağıdı 5 yanlış Doğrulanmış

Claude Code, terminalde çalışan bir AI kodlama ajanı: ne istediğini yazarsın, dosyaları kendi okur, kod yazar, komut çalıştırır, test eder.

Aşağısı 8 bölüm: hızlı kurulum, en kritik 8 ipucu, 83 ipuçluk tam liste, komut kopya kağıdı ve "repoda bile yanlış olan 5 şey". Kaynak 60 binden fazla yıldızlı bir topluluk derlemesi; her madde resmi Claude Code dokümanıyla tek tek karşılaştırıldı. Sade Türkçe; geliştirici olman şart değil.

Dürüstlük notu
Kesin sayılar, sürüm numaraları ve bazı komut isimleri hızla değişir; o yüzden sürüm/sayı ezberletilmedi. "Kişiye göre pratik" olanlar Boris, Thariq ve topluluk rozetiyle işaretlendi, resmi kural gibi sunulmadı. Repoda bile birkaç yanlış vardı; doğruları 7. bölümde.

İçindekiler

Hızlı başlangıç

Bölüm 0

Claude Code nedir? Terminalde çalışan bir AI kodlama ajanı. Tek tek komut vermek yerine ne istediğini söylüyorsun; dosyaları kendi okuyor, kod yazıyor, komut çalıştırıyor, test ediyor.

Önce plan
Claude Code ücretli bir Claude planı (Pro, Max, Team ya da Enterprise) veya API kredisi ister. Ücretsiz claude.ai planı Claude Code'u kapsamaz. Sadece denemek istersen platform.claude.com'da hesap açınca verilen yaklaşık 5 dolarlık ücretsiz API kredisiyle de başlayabilirsin.

Kurulum · en kolay yol (macOS / Linux / WSL):

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

Windows'ta PowerShell'de:

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

Ya da npm ile (Node.js 18+ gerekir):

NPM 
npm install -g @anthropic-ai/claude-code

Sonra proje klasöründe başlat. İlk açılışta tarayıcıdan Claude hesabınla giriş yaparsın:

TERMINAL 
claude          # proje klasöründe başlat
TERMINAL 
claude doctor   # kurulumu kontrol et

İlk gün için 3 alışkanlık

  1. 1
    Büyük işe plan moduyla başla (önce planlasın, sen onayla, sonra yazsın).
  2. 2
    Projenin köküne bir CLAUDE.md koy (kurulum, test, çalıştırma komutları orada dursun). /init otomatik bir başlangıç dosyası üretir.
  3. 3
    Yeni işe geçerken /clear at (eski bağlam Claude'u yavaşlatır).

Temel kavramlar (harita)

Bölüm 1

Kavram / Nerede / Ne işe yarar:

En kritik 8 ipucu (örnekli)

Bölüm 2

1 Plan moduyla başla · Büyük işte doğrudan koda atlama. Plan modunda Claude önce ne yapacağını anlatır, sen onaylarsın, sonra yazar. Ne zaman: çok dosyaya dokunacak ya da mimari karar gereken işlerde. Tek satırlık net düzeltmede (typo, log) plana gerek yok.

ÖRNEK 
# 1 Plan moduyla başla
Shift+Tab → plan moduna geç, sonra:
"Kullanıcı profili sayfası ekle, mevcut tasarımı koru."
→ planı oku, onayla, sonra yazsın.

2 Mikro-yönetme, meydan oku (Boris) · Hatayı yapıştır, sadece "düzelt" de; nasıl düzelteceğini Claude'a bırak. Çözüm vasatsa: "Bildiğin her şeyle baştan, en zarif halini kur." Güven için: "Bunun çalıştığını bana ispatla." Ne zaman: Claude'a güvenip çözümü ona bıraktığında. (Boris'in pratiği, resmi kural değil.)

ÖRNEK 
# 2 Mikro-yönetme, meydan oku
"Bu testi geçir. Nasıl yapacağını sana bırakıyorum."
Çözüm vasatsa: "Bildiğin her şeyle baştan, en zarif halini kur."
Güven için: "Bunun çalıştığını bana ispatla."

3 Context'i temiz tut · Sohbet uzayıp bağlam dolunca Claude'un odağı dağılır. Ne zaman: konu değişince /clear; uzun iş ortasında ipuçlu /compact. (Uyarı) "%40'ta aptallaşır / 300-400 bin token" kesin sayıları resmi değil, uygulamacı gözlemi. (Thariq)

ÖRNEK 
# 3 Context'i temiz tut
/clear                         # yeni işe geç
/compact auth refactor'a odaklan   # uzun işte
/context                       # doluluğu gör

4 Düzeltme yığma, geri sar · Bir şey ters gidince üstüne düzeltme bindirme; başarısız denemeler bağlamı kirletir. Ne zaman: bir yaklaşım tutmayınca, baştan denemek için. (Uyarı) Sadece Claude'un kendi dosya düzenlemelerini geri alır; rm/mv ve dış değişiklikleri değil. Git'in yerini tutmaz.

ÖRNEK 
# 4 Düzeltme yığma, geri sar
Boş promptta çift Esc (ya da /rewind)
→ hatadan önceki checkpoint'i seç
→ öğrendiğinle tekrar sor.

5 CLAUDE.md yaz · Projenin köküne koy; projenin hafızası bu. Kurulum, test, çalıştırma komutlarını yaz. Ne zaman: her projede, en başta. 200 satır altı tut (resmi tavsiye). Ölçü: yeni biri "testleri çalıştır" deyince ilk seferde çalışmalı.

ÖRNEK 
# 5 Örnek CLAUDE.md
## Komutlar
- Kurulum: npm install
- Test: npm test
- Çalıştır: npm run dev
## Kurallar
- TypeScript kullan, any yasak

6 Tekrarlı işi komuta/skill'e çevir · Günde birden fazla yaptığın işi bir kez yaz, sonra tek satırla çağır. Ne zaman: aynı prompt'u günde 1'den fazla yazıyorsan. (Boris)

ÖRNEK 
# 6 Tekrarlı işi komuta/skill'e çevir
.claude/commands/pr.md  ← içine prompt'unu yaz
sonra sohbette:  /pr

7 Alt-ajan kullan · Ayrı bir pencerede çalışır; dosya okumaları, aramalar, çıkmazlar onun penceresinde kalır, sana sadece sonuç döner. Ne zaman: çok dosya okutacak keşif / paralel iş. Bir ajanın gözünden kaçanı başka biri yakalayabilir.

ÖRNEK 
# 7 Alt-ajan kullan
"Alt-ajan kullanarak ödeme modülünü
araştır ve nasıl çalıştığını özetle."

8 Birleştirmeden önce /code-review · Birden çok ajan mantık hatası, güvenlik açığı ve regresyon tarar. Ne zaman: her PR öncesi. (Boris) PR'ları küçük tutup hepsini squash merge yapıyor (tek commit, kolay geri alma).

ÖRNEK 
# 8 Birleştirmeden önce /code-review
/code-review        # merge'ten ÖNCE

83 ipucu, kategori kategori

Bölüm 3

Rozetler: Boris yaratıcının pratiği · Thariq/Cat ekipten · topluluk gözlemi · (uyarı) kaveat. Rozetsizler resmi dokümanla doğrulandı. ör. = örnek kullanım.

💬 Prompting · Planlama · Context · Oturum yönetimi

📄 CLAUDE.md · Alt-ajanlar · Komutlar · Skill'ler · Hook'lar

⚙ Workflow · Git · PR · Hata ayıklama · Araçlar

Komut kopya kağıdı

Bölüm 4 · Komut / Ne yapar / Örnek-not.

KomutNe işe yarar
İzin modunu değiştirir; plan moduna böyle girilir · default → acceptEdits → plan
Yeni göreve temiz bağlamla başlar · proje hafızası kalır
Sohbeti özetleyip sıkıştırır · ör. /compact auth'a odaklan
Bağlam doluluğunu gösterir · token dökümü
Maliyet + plan limiti
çift Esc · Önceki checkpoint'e geri sarar · (uyarı) sadece Claude'un edit'leri, Git değil
/effort · Model + akıl yürütme çabası · plan için güçlü, kod için hızlı
/doctor · Ayarlar · kurulum teşhisi
/resume · Oturumu adlandır · dön · çoklu Claude'da işe yarar
Çoklu-ajan inceleme · merge'ten önce
İzin kuralları (joker) · Bash(npm run *)
Bash izolasyonu · (uyarı) native Windows yok
/mcp · Sesli dikte · MCP yönetimi
O mesaj için daha derin düşünür · prompt içine yaz

"Hot" özellikler

Bölüm 5

Repoda 29 madde var; başlangıç-orta seviye için en işine yarayacakları seçtim.

Hazır paketler + çoklu-model

Bölüm 6

Hazır iş-akışı paketleri. Kendi takımını kurmadan, hazır metodolojiler var (Superpowers, Everything Claude Code, Spec Kit). Hepsi aynı desende: Araştır → Planla → Uygula → İncele → Yayınla. Şablon gibi kurup üstüne kendi düzenini eklersin.

Çoklu-model (cross-model). Claude Code'u tek başına kullanmak zorunda değilsin; başka modelleri (Codex/GPT, Gemini) yanında çalıştırabilirsin:

(İpucu) En yaygın kullanım: bir modele yazdır, başka bir modele inceletip QA yaptır. Farklı modeller birbirinin gözden kaçırdığını yakalar.

Repoda bile yanlış olan 5 şey

Bölüm 7 · Orijinal repo topluluk derlemesi; resmi dokümanla kıyaslayınca birkaç hata çıktı. Doğruları:

Yanlış bilinen

Shift+Tab döngüsü

✗ Shift+Tab döngüsü "Ask → Plan → Auto" değil.

→ Doğrusu: default → acceptEdits → plan. "Auto" şartlar sağlanınca opt-in eklenir.

Yanlış bilinen

/less-permission-prompts komutu

✗ /less-permission-prompts diye komut yok.

→ Doğrusu: fewer-permission-prompts skill'i.

Yanlış bilinen

/focus ne yapar

✗ /focus bir akıl yürütme komutu değil.

→ Sadece görünüm toggle'ı. Derin düşünme için /effort ya da ultrathink.

Yanlış bilinen

/rewind Git'in yerini tutmaz

✗ /rewind Git'in yerini tutmaz.

→ Sadece Claude'un kendi düzenlemelerini izler; rm/mv ve dış değişiklikleri değil.

Yanlış bilinen

Context %40 / 300-400 bin token

✗ "Context %40'ta aptallaşır / 300-400 bin token" resmi değil.

→ Uygulamacı gözlemi; "Anthropic böyle açıkladı" deme. Pratik: dolduysa /compact veya /clear.

Nasıl kullanmalı

Bölüm 8

Bunu bir kurs gibi oku; önce referans, sonra uygula.

Özet

Plan modu + CLAUDE.md + /clear üçlüsü en hızlı fark yaratan üçlü; bugün dene.

Büyük işe plan moduyla başla: önce planlasın, sen onayla, sonra yazsın.

Projenin köküne 200 satır altı bir CLAUDE.md koy; kurulum, test, çalıştırma komutları orada dursun.

Yeni işe geçerken /clear at; uzun iş ortasında ipuçlu /compact kullan.

Mikro-yönetme: bug'ı yapıştır, "düzelt" de, nasıl yapacağını Claude'a bırak.

Düzeltme yığma; çift Esc / /rewind ile geri sar, öğrendiğinle tekrar sor (Git'in yerini tutmaz).

Tekrarladığın işi /komut veya skill'e çevir.

Çok dosya okutacak keşif için alt-ajan kullan, ana bağlamı temiz tut.

Merge'ten önce /code-review çalıştır: bug + güvenlik + regresyon.

Claude'u sohbet botu gibi kullanma; primitifleri (ajan, komut, skill, hook) öğrenip kendi akışını kur.

Buraya kadar geldiysen…

Faydalı olduysa takip et: @doganmertai (Instagram · YouTube · TikTok). Bir sorun olursa ya da "şunu da anlat" dersen, yorumdan yaz.
@doganmertai takip et

Kaynak: github.com/shanraisshan/claude-code-best-practice (★ 60 binden fazla) · resmi Claude Code dokümanı (code.claude.com/docs) ile doğrulandı · @doganmertai

← Tüm rehberler © 2026 Zenfelt · Doğan Mert Saatçı · zenfelt.com