Context eklemek

Claude Code, repo’da olanı kendi başına keşfeder — ama repo dışındaki context’i sen vermek zorundasın. Bu ders, “Claude’un göremediği” tüm tipleri ve nasıl aktaracağını gösterir.

1. Açık dosya referansı: @

Belirli bir dosyaya doğrudan dikkat çek:

@src/api/users.ts dosyasındaki getUsers fonksiyonunu refactor et;
async/await kullansın, mevcut testler bozulmasın.

@ Claude’a “bunu önce oku, sonra cevap ver” der. Grep ile arama yapmasını beklemekten hızlı ve net.

2. URL’ler — web context’i

Bir doc, RFC, blog post veya GitHub issue paylaşmak:

Bu blog post'unda anlatılan zod validation kalıbını
projemizde @src/api/users.ts'e uygula:
https://example.com/zod-validation-pattern

Claude WebFetch tool’u ile URL’yi okur ve içeriği context’e alır.

3. Issue ve PR’lar (GitHub)

GitHub entegrasyonu olmadan da çalışır — sadece URL paylaş:

https://github.com/anthropics/anthropic-sdk-python/issues/123 — bu issue'da
bahsedilen retry davranışını SDK'mıza uyarla.

Daha derin entegrasyon için gh CLI veya MCP GitHub server (sonraki derslerde) kullanılır.

4. Image / screenshot

Bug raporu, design mockup, terminal hatası — görseli sürükle bırak veya yapıştır (Ctrl/Cmd+V):

[ekran görüntüsü eklendi]
Bu hatadaki stack trace'i okuyup neden olduğunu söyle ve düzelt.

Claude görüntüyü vision ile okur. Özellikle:

• Terminal hata mesajları
• UI mockup’lar (HTML/CSS çıktısı isterken)
• Network tab screenshot’ları

5. Yapıştırılmış metin

Uzun log, transcript veya doc parçası:

Aşağıda 3 sayfalık bir API doc var. Buna göre @src/clients/payment.ts'i güncelle:

---
[3 sayfa metin]
---

Üçlü tire (---) blok ayırıcı, prompt’un nerede bitip context’in nerede başladığını netleştirir.

6. CLAUDE.md ile kalıcı context

Tek seferlik olmayan bilgiyi (mimari kararlar, takım kuralları, deploy adımları) her oturumda yeniden anlatma — CLAUDE.md’ye yaz. Claude her açılışta otomatik okur.

Ne zaman ne kullanılır?

Tip	Ne için	Kalıcı mı?
@dosya	Belirli dosyaya dikkat	Hayır
URL	Dış kaynak	Hayır
Image	Bug, mockup, ekran	Hayır
Yapıştırılmış metin	Doc, log, transcript	Hayır
CLAUDE.md	Takım/proje kuralları	Evet

Özet

Claude codebase’i kendisi keşfeder; repo dışını sen ver. @ ile yön ver, URL/image/text ile dış context yükle, kalıcı bilgi CLAUDE.md’ye gitsin.

Sırada ne var?

Sıradaki derste ilk değişikliği yaptıracağız ve Claude’un diff sunum + onay akışını yakından göreceğiz.