Context eklemek

Not: Yukarıdaki video, kaldırılmış olan eski bir # “memory mode” kısayolunu gösteriyor. Bunun yerine /memory ve doğrudan CLAUDE.md düzenlemelerini kullanan aşağıdaki metni takip edin.

Claude ile coding projelerinde çalışırken context yönetimi kritik öneme sahiptir. Projenizde onlarca veya yüzlerce file olabilir, ancak Claude’un size etkili bir şekilde yardımcı olabilmesi için yalnızca doğru bilgilere ihtiyacı vardır. Çok fazla ilgisiz context aslında Claude’un performansını düşürür, bu yüzden onu ilgili file’lara ve dokümantasyona yönlendirmeyi öğrenmek esastır.

/init Komutu

Claude’u yeni bir projede ilk başlattığınızda, /init komutunu çalıştırın. Bu, Claude’a tüm codebase’inizi analiz etmesini ve şunları anlamasını söyler:

• Projenin amacı ve mimarisi
• Önemli komutlar ve kritik file’lar
• Coding pattern’leri ve yapısı

Claude kodunuzu analiz ettikten sonra bir özet oluşturur ve bunu bir CLAUDE.md file’ına yazar. Claude bu file’ı oluşturmak için izin istediğinde, her yazma işlemini onaylamak için Enter’a basabilir veya Claude’un oturumunuz boyunca file’ları serbestçe yazmasına izin vermek için Shift+Tab’a basabilirsiniz.

CLAUDE.md File’ı

CLAUDE.md file’ı iki ana amaca hizmet eder:

• Önemli komutlar, mimari ve coding style’a işaret ederek Claude’u codebase’inizde yönlendirir
• Claude’a spesifik veya özel yönergeler vermenizi sağlar

Bu file, Claude’a yaptığınız her istekte dahil edilir, bu yüzden projeniz için kalıcı bir system prompt’a sahip olmak gibidir.

CLAUDE.md File Konumları

Claude, üç yaygın konumda üç farklı CLAUDE.md file’ını tanır:

• CLAUDE.md — /init ile oluşturulur, source control’e commit edilir, diğer mühendislerle paylaşılır
• CLAUDE.local.md — Diğer mühendislerle paylaşılmaz, Claude için kişisel talimatlar ve özelleştirmeler içerir
• ~/.claude/CLAUDE.md — Makinenizdeki tüm projelerle kullanılır, Claude’un tüm projelerde takip etmesini istediğiniz talimatları içerir

Özel Talimatlar Eklemek

CLAUDE.md file’ınıza talimatlar ekleyerek Claude’un nasıl davrandığını özelleştirebilirsiniz. Örneğin, Claude koda çok fazla yorum ekliyorsa, file’ı güncelleyerek bunu çözebilirsiniz. CLAUDE.md file’ını doğrudan editor’ünüzde düzenleyin veya file’ı açmak için Claude Code içinde /memory çalıştırın. Şuna benzer bir talimat ekleyin: Use comments sparingly. Only comment complex code.

Claude bu file’ı her konuşmanın başında okur, böylece değişiklikler bir sonraki mesajınızda geçerli olur.

’@’ ile File Mention’ları

Claude’un spesifik file’lara bakmasını istediğinizde, file path’inden önce @ sembolünü kullanın. Bu, o file’ın içeriğini Claude’a yaptığınız isteğe otomatik olarak dahil eder.

Örneğin, authentication sisteminiz hakkında soru sormak istiyorsanız ve ilgili file’ları biliyorsanız, şunu yazabilirsiniz:

How does the auth system work? @auth

Claude size seçim yapmanız için auth ile ilgili file’ların bir listesini gösterecek, ardından seçilen file’ı konuşmanıza dahil edecektir.

CLAUDE.md İçinde File Referansları

File’ları aynı @ syntax’ını kullanarak doğrudan CLAUDE.md file’ınızda da mention edebilirsiniz. Bu, özellikle projenizin birçok yönüyle ilgili olan file’lar için kullanışlıdır.

Örneğin, veri yapınızı tanımlayan bir database schema file’ınız varsa, bunu CLAUDE.md file’ınıza ekleyebilirsiniz:

The database schema is defined in the @prisma/schema.prisma file. Reference it anytime you need to understand the structure of data stored in the database.

Bir file’ı bu şekilde mention ettiğinizde, içeriği her isteğe otomatik olarak dahil edilir, böylece Claude her seferinde schema file’ını arayıp okumak zorunda kalmadan veri yapınız hakkında soruları anında yanıtlayabilir.

Bu, repo’nuzda başka bir tool için zaten bir AGENTS.md file’ı varsa da kullanışlıdır. Talimatları çoğaltmanıza gerek yok; CLAUDE.md file’ınızın ilk satırına @AGENTS.md ekleyin ve Claude önce o file’ın içeriğini yükleyecektir. Ardından, import’un altına Claude’a özgü talimatları ekleyebilirsiniz.