Claude Code Başlangıç Rehberi

• 0  Hızlı başlangıç
• 1  Temel kavramlar (harita)
• 2  En kritik 8 ipucu (örnekli)
• 3  83 ipucu, kategori kategori
• 4  Komut kopya kağıdı
• 5  "Hot" özellikler
• 6  Hazır paketler + çoklu-model
• 7  Repoda bile yanlış 5 şey
• 8  Nasıl kullanmalı

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.

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

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

Windows'ta PowerShell'de:

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

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

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:

claude          # proje klasöründe başlat

claude doctor   # kurulumu kontrol et

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

Kavram / Nerede / Ne işe yarar:

• Plan modu · Shift+Tab, --permission-mode plan · İş büyükse önce planlatıp onaylarsın, sonra kod yazar.
• CLAUDE.md (hafıza) · ./CLAUDE.md · Projenin kalıcı talimatı; her oturumda yüklenir.
• .claude/rules/ · .claude/rules/*.md · Kuralları böl; paths: ile sadece ilgili dosyada yüklenir.
• Alt-ajan · .claude/agents/ · Ayrı pencerede iş yapar, ana sohbet temiz kalır.
• Komut · .claude/commands/ · Tekrarlı işi /komut olarak çağırırsın.
• Skill · .claude/skills/<ad>/SKILL.md · Komutun gelişmişi: klasör + script + örnek; Claude gerektiğinde açar.
• Hook · .claude/hooks/ · Olaylara otomatik tepki (ör. düzenlemeden sonra formatla).
• MCP sunucu · .mcp.json · Claude'a dış araç bağlarsın (tarayıcı, veritabanı…).
• Plugin · marketplace · Skill + komut + ajan + hook'u tek paket olarak kur ve paylaş.
• Status line · settings.json · Bağlam doluluğu, model, dal terminal altında canlı.
• Checkpoint · otomatik · Her promptta kayıt; /rewind ile geri sararsın.
• Ayarlar · .claude/settings.json · İzinler, model, davranış; CLAUDE.md'den daha kesin.
• Komut mu, skill mi? İkisi de /ad ile çağrılır. Basit tek-dosya kısayol → komut. Script/örnek/tuzak notu gereken karmaşık iş → skill. Küçük işte komut, büyük işte skill diye düşün.

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.

# 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.)

# 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)

# 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.

# 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ı.

# 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)

# 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.

# 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).

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

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

• Meydan oku: "testini geçene kadar PR açma" / "çalıştığını ispatla". ör. main ile dalını kıyaslat. (Boris)
• Vasat düzeltmeden sonra: "bildiğin her şeyle çöpe at, zarif çözümü kur." (Boris)
• Çoğu bug'ı Claude kendi çözer: bug'ı yapıştır, "düzelt" de, nasıl yapacağını mikro-yönetme. (Boris)
• Her zaman plan moduyla başla. (Boris) (uyarı) küçük net işte atlanabilir.
• Minimal spec'le başla, AskUserQuestion ile Claude seni sorgulasın, sonra temiz bir yeni oturumda uygula. (Thariq)
• Aşamalı, her aşamada test olan plan yap (birim + entegrasyon + otomasyon). (topluluk)
• İşi dikey dilimlere böl (veritabanı + servis + arayüz bir arada); AI yatay böler, bu da uçtan uca testi sona atar. (M. Pocock)
• Planını ikinci bir Claude'a "staff engineer gibi" inceletip kıyasla. (Boris)
• Devretmeden önce ayrıntılı spec yaz, belirsizliği azalt. (Boris)
• Bazen spec yerine prototip çıkar: 20-30 versiyon dene, üretmek ucuz. (Boris)
• (uyarı) "~300-400 bin token'da çürür / ~%40'ta aptal bölge" sayıları resmi değil. Pratik: bağlam dolduysa /compact ya da /clear. (Thariq)
• Yeni göreve /clear, görev içinde ipuçlu /compact. ör. /compact testleri bırak, auth'a odaklan. (Thariq)
• Düzeltmek yerine geri sar (çift Esc / /rewind), öğrendiğinle tekrar sor. (Thariq)
• Bağlam yönetimi için alt-ajan: "tekrar bakacak mıyım, yoksa sadece sonucu mu?" (Thariq)
• Her tur bir dallanma: Devam / /rewind / /clear / /compact / alt-ajan arasından seç. (Thariq)
• Yeni görev = yeni oturum ((uyarı) kural değil, iyi alışkanlık). (Thariq)
• Geri sarmadan önce "buradan itibaren özetle" dedirt; devir notu yazsın. (Thariq)
• /compact kayıplı ama hızlı; /clear + kısa brief daha çok iş ama kontrol sende. (Thariq)
• Uzun oturumda özet (recap) kullan; /config'ten kapanır. (Boris)
• Önemli oturumu /rename ile adlandır, sonra /resume ile dön. (Cat)

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

• CLAUDE.md 200 satır altı olsun (resmi); kısa dosya daha iyi uygulanır. (Boris)
• .claude/rules/*.md CLAUDE.md gibi yüklenir; paths: ile sadece ilgili dosyaya dokununca yüklenir.
• Uzayan dosyada alana özel kuralı <important if="…"> ile sar, görmezden gelmesin. (Dex)
• Monorepo'da çok CLAUDE.md: üstteki tam, alttaki o klasör okununca yüklenir.
• "Testleri çalıştır" ilk seferde çalışmalı; çalışmıyorsa CLAUDE.md'de komutlar eksik. (Dex)
• Kod tabanını temiz tut, göçleri bitir; yarım geçiş modeli şaşırtır. (Boris)
• Kalıcı davranışı (atıf, izin, model) settings.json ile koy; CLAUDE.md'den daha kesin uygulanır.
• Genel "QA/backend" yerine özelliğe özel alt-ajan + skill kullan. (Boris)
• "Alt-ajan kullan" diyerek probleme daha çok hesap gücü at, ana bağlamı temiz tut. (Boris)
• tmux + git worktree ile alt-ajan takımı kurup paralel geliştir. (Boris) (uyarı) ileri
• Ayrı pencereler sonucu iyileştirir: bir ajan bug üretir, başka ajan bulabilir. (Boris) pratik
• İş akışların için çoğu zaman alt-ajan yerine komut kullan. (Boris)
• Günde defalarca yaptığın "iç döngü" işini slash komut yap; .claude/commands/, git'e girer. (Boris)
• Günde 1'den fazla yaptığın işi skill/komuta çevir. ör. /techdebt, /context-dump. (Boris)
• context: fork ile skill'i izole alt-ajanda çalıştır; ana bağlam sadece sonucu görür. (Lydia)
• Monorepo'da alt-klasörlerde skill kullan.
• Skill dosya değil klasördür: reference/, scripts/, examples/ (önce özet, gerektikçe gerisi). (Thariq)
• Her skill'e "Gotchas" (tuzaklar) bölümü koy; en değerli içerik budur. (Thariq)
• description alanı özet değil tetikleyicidir: "ne zaman devreye gireyim?" diye yaz. (Thariq)
• Bariz olanı yazma; Claude'u varsayılanından çıkaran şeye odaklan. (Thariq)
• Adım adım rayına oturtma; hedef + kısıt ver, reçete değil. (Thariq)
• Script/kütüphane koy ki kalıp kodu yeniden yazmasın, birleştirsin. (Thariq)
• SKILL.md içine !komut göm; çağırınca çalıştırır, modele sadece sonuç girer. (Lydia)
• Skill'lerde isteğe bağlı hook: /careful yıkıcı komutu engeller, /freeze klasör dışı düzenlemeyi durdurur. (Thariq)
• PreToolUse hook ile skill kullanımını ölç (popüler/az tetiklenen). (Thariq)
• PostToolUse hook ile kodu otomatik formatla; son %10'u halleder, CI patlamaz. (Boris)
• İzin isteklerini bir hook'la güçlü modele yönlendir; güvenliyi otomatik onaylasın. (Boris)
• Stop hook ile tur sonunda "devam et / işini doğrula" diye dürt. (Boris)

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

• /model model+akıl yürütme, /context doluluk, /usage plan limiti, /config ayar. Plan için güçlü, kod için hızlı model. (Cat)
• Düşünme modu açık + Explanatory output style (★ Insight kutuları). (Boris)
• Derin akıl yürütme için promptta ultrathink. (uyarı) Sadece o mesaj için; "think hard" tanınmaz.
• /effort ile çabayı ayarla (düşük→yüksek). (uyarı) Seviye adlarını ezberleme, menüden seç.
• (uyarı) /focus akıl yürütme DEĞİL; sadece görünüm toggle'ı (ara adımları gizler). Repo bunu karıştırmış.
• Mimariyi anlamak için bol ASCII diyagram kullan. (Boris)
• Yerel tekrarlı izleme /loop, makine kapalıyken bulut görevi /schedule. (uyarı) /loop oturum açıkken çalışır. (Boris)
• Uzun otonom görevler için "Ralph Wiggum" döngüsü. (Boris) (uyarı) ileri
• dangerously-skip-permissions yerine /permissions joker: Bash(npm run *), Edit(/docs/**). (Boris)
• /sandbox dosya+ağ izolasyonu, izin sorusunu azaltır. (uyarı) Sadece Bash; native Windows yok (WSL2). (Boris)
• Ürün doğrulama skill'lerine yatırım yap (kayıt-akışı/ödeme doğrulayıcı). (Thariq)
• dangerously-skip-permissions yerine Auto Mode: sınıflandırıcı model güvenliyi onaylar, riskliyi sorar. (uyarı) Araştırma önizlemesi, güvenlik garantisi değil. (Boris)
• fewer-permission-prompts skill'i ile güvenli komutları izinli-listeye ekle. (uyarı) Repodaki "/less-permission-prompts" yanlış. (Boris)
• Bir /go skill'i: (1) uçtan uca test (2) /simplify (3) PR açar. (Boris)
• PR'ları küçük + odaklı tut: bir özellik bir PR. (Boris) "medyan ~118 satır" Boris'in kendi 141 PR'lık verisi, Anthropic kuralı değil.
• Her zaman squash merge: temiz lineer geçmiş, kolay revert. (Boris)
• Sık commit at: en azından saatte bir, iş biter bitmez. (topluluk)
• Tekrarlayan inceleme geri bildirimini otomatik kurala çevirmek için PR'da @claude etiketle. (Boris)
• Merge'ten önce /code-review: bug + güvenlik + regresyon.
• Takıldığında ekran görüntüsü al, Claude'a ver. (topluluk)
• MCP ile (Claude in Chrome / Playwright / Chrome DevTools) Claude konsol loglarını kendi görsün.
• Logunu görmek istediğin terminali arka plan görevi olarak çalıştır. (topluluk)
• /doctor ile kurulum/kimlik/ayar sorununu teşhis et.
• QA için başka bir model kullan (ör. Codex'e plan/kod inceletme). (topluluk)
• Agentic arama (glob+grep) RAG'i döver: kod sürekli değişiyor, vektör DB senkron tutulamıyor. (Boris)
• IDE yerine terminal: iTerm / Ghostty / tmux. (Boris)
• Sesli prompt için /voice ya da Wispr Flow. (uyarı) /voice claude.ai hesabı ister. (Boris)
• Bağlam farkındalığı için status line (durum çubuğu). (Boris)
• settings.json özelliklerini keşfet (Plans Directory, Spinner Verbs). (Boris)
• Claude Code'u her gün güncelle + güne changelog okuyarak başla. (topluluk)

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

• Hazır skill'ler bundled · kurulumla gelen /code-review, /security-review gibi skill'leri hiç yazmadan kullanırsın.
• Plugin / Power-ups · marketplace'ten skill+komut+ajan+hook paketini tek seferde kur; kendi takımını sıfırdan yazma.
• Auto Mode önizleme · güvenliyi otomatik onaylar, riskliyi sorar. (uyarı) Güvenlik garantisi değil.
• /code-review ultra · bulutta çoklu-ajan derin inceleme; her bulgu bağımsız doğrulanır (claude.ai hesabı ister).
• Claude Code Web + GitHub Actions · tarayıcıdan ve PR içinde @claude ile çalıştır.
• Claude in Chrome beta · Claude tarayıcını kullanır (ücretli plan, WSL yok).
• Computer Use · masaüstünü kullanır. (uyarı) CLI'da sadece macOS; Windows'ta yalnızca Claude Desktop'ta.
• Voice Dictation /voice · sesli prompt (claude.ai hesabı ister).
• Git Worktrees --worktree · izole paralel oturum (ileri seviye).
• Agent Teams · çoklu oturum koordinasyonu. (uyarı) Deneysel, varsayılan kapalı, çok token harcar.
• Dynamic Workflows /workflows, ultracode · betikle yönetilen çoklu-ajan akışları (çok token).
• /schedule bulut routine (makine kapalıyken de) · /loop yerel, oturum açıkken.
• Fast Mode /fast · daha hızlı çıktı. (uyarı) Önizleme, sadece Opus, ek kullanım kredisi ister.
• Agent SDK · kendi ajanını kurma kütüphanesi. (uyarı) Geliştiricilere, API key ister.

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.

Shift+Tab döngüsü

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

/less-permission-prompts komutu

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

/focus ne yapar

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

/rewind Git'in yerini tutmaz

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

Context %40 / 300-400 bin token

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

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

• Claude'u sohbet botu gibi kullanma. Primitifleri öğren (ajan, komut, skill, hook), kendi akışını kur.
• Plan modu + CLAUDE.md + /clear üçlüsünü bugün dene; en hızlı fark yaratan üçlü.
• Tekrarladığın işi /komut veya skill'e çevir; zamanla kendi takımını kurarsın.
• Claude'u kendi projene yönelt: "şu CLAUDE.md'mi bu rehbere göre düzelt" de.
• Her gün güncelle ve changelog'a göz at; özellikler hızla değişiyor.
• Çoklu-model bağlama yolları: Plugin: başka modelin CLI'si Claude Code içinde. ör. /codex:review ile planını Codex'e inceletmek. MCP: Claude Code başka modeli bir araç gibi çağırır. Router: Claude Code'un bağlandığı API'yi başka sağlayıcıya çevirirsin.

Özet

Buraya kadar geldiysen…