CLAUDE.md, Claude'un projeni nasıl anladığını şekillendiren tek dosyadır. İyi yazılmış bir CLAUDE.md daha az düzeltme, daha iyi kod ve gerçekten ne üzerinde çalıştıklarını bilen ajanlar demektir.
Bu kılavuz, teknoloji yığını bildirimlerinden ajana özgü ipuçlarına kadar CLAUDE.md dosyasının her bölümünü anlatır. Takip et ve kendininkini adım adım oluştur.
CLAUDE.md, projenin köküne yerleştirdiğin bir markdown dosyasıdır. Claude Code bir oturum başlattığında bu dosyayı ilk okur. İçindeki her şey Claude'un bağlamının parçası olur: teknoloji yığının, dosya yapın, ekibinin kuralları ve her ajanın uymasını istediğin özel talimatlar.
Bunu bir brifing belgesi olarak düşün. Bu dosya olmadan Claude projenin nasıl düzenlediğini tahmin etmek zorunda kalır. İyi bir CLAUDE.md ile Claude her şeyin nerede olduğunu, hangi kalıpları izlemesi gerektiğini ve nelerden kaçınması gerektiğini zaten bilir. Çıktı kalitesindeki fark önemlidir.
“CLAUDE.md'ye yapılan 10 dakikalık yatırım, projenizin kalıplarına uymayan yapay zeka kodunu düzeltmek için harcanan saatleri kurtarır.”
Yüzlerce Claude Code projesinde gözlemlenmiştir
CLAUDE.md'nin yapısı ve özgüllüğü, Claude'un kod tabanında ne kadar iyi performans gösterdiğini doğrudan etkiler.
İyi yapılandırılmış bir CLAUDE.md bu altı alanı kapsar. Her biri Claude'a hemen uygulayabileceği somut bilgi verir.
Çerçevelerini, kütüphanelerini ve sürümlerini açıkça listele. Paket yöneticini, Node sürümünü ve çalışma zamanı gereksinimlerini ekle. Claude tahmin etmeden uyumlu kod üretmek için bunu kullanır.
Anahtar dizinlerini ve her birinde ne olduğunu tanımla. Bileşenler, storeler, servisler, API rotaları, tipler. Klasör başına tek satırlık açıklamalı kısa bir ağaç diyagramı iyi çalışır.
Adlandırma kalıplarını (dosyalar için camelCase, bileşenler için PascalCase), hata yönetimi yaklaşımını, import sıralamanı ve projeye özgü kurallarını belgele. Bu, Claude'un çıktısını mevcut kodunla tutarlı tutar.
Geliştirme, derleme, test ve lint komutlarını ekle. Claude bir şeyin çalıştığını doğrulaması veya betik önermesi gerektiğinde projenin beklediği komutları kullanır.
Birden fazla ajan kullanıyorsan (QA, frontend, backend, DevOps), her rolün neye odaklanması gerektiğini tanımlayan bir bölüm ekle. Bu özellikle AgentsRoom'un çoklu ajan yapılandırmasında kullanışlıdır.
Claude'a ne YAPMAMASI gerektiğini söyle. Yapılandırma dosyalarını değiştirme, kimlik doğrulama sistemini değiştirme, veritabanı katmanını yeniden yapılandırma. Açık sınırlar ajanların istenmeyen değişiklikler yapmasını önler.
Her şeyi aynı anda yazman gerekmez. Temel bilgilerle başla ve Claude'un neyi bilmesi gerektiğini keşfettikçe genişlet.
package.json dosyanı aç ve projenin kullandığı her çerçeve, kütüphane ve aracı listele. Sürümleri not et. Çalışma zamanı gereksinimlerini kontrol et (Node sürümü, Python sürümü, veritabanı). Bu, teknoloji yığını bölümün olur.
package.json + çalışma zamanı sürümleri + veritabanı
src dizininin hızlı bir ağacını çıkar. Üst düzey klasörleri belirle ve her biri için tek satırlık açıklama yaz. Bileşenlerin, storeların, servislerin, tiplerin ve API rotalarının nerede olduğuna odaklan.
Amaç notlarıyla src/ ağacı
Mevcut koduna bak ve kalıpları not et: dosyaları nasıl adlandırıyorsun, hataları nasıl yönetiyorsun, importları nasıl yapılandırıyorsun, varsayılan mı yoksa adlandırılmış mı export kullanıyorsun. Bunları kısa kurallar olarak yaz.
Adlandırma, importlar, hata yönetimi, exportlar
Uzman ajanlarla çalışıyorsan her rol için odak alanları ekle. Frontend ajanı bileşen kütüphaneni bilmeli. DevOps ajanı dağıtım boru hattını bilmeli. QA ajanı test çerçeveni bilmeli.
Rol başına odak alanları + kaçınılacak alanlar
AgentsRoom, CLAUDE.md'yi sonradan eklenen bir düşünce değil birinci sınıf kavram olarak ele alır.
CLAUDE.md'ni sözdizimi vurgulama ve canlı kaydetme ile doğrudan AgentsRoom içinde düzenle. Metin editörüne veya IDE'ne geçiş yapmaya gerek yok.
Her ajanın CLAUDE.md'ni gerçek zamanlı nasıl yorumladığını gör. Ajanların kurallarını izlediğini ve kaçınılacak alanlarına uyduğunu doğrulamak için terminal çıktısını izle.
AgentsRoom'daki her projenin kendi CLAUDE.md'si var. Projeler arasında geçiş yap ve her ajan o kod tabanı için doğru bağlam dosyasını otomatik yükler.
AgentsRoom'un 14 ajan rolü doğrudan CLAUDE.md bölümleriyle eşlenir. Rol başına odak alanları ve kaçınılacak alanlar tanımla; her ajan kendisi için tasarlanan talimatları alır.
CLAUDE.md is prepended to every Claude turn. A bloated CLAUDE.md silently inflates Claude Code token usage on every message. AgentsRoom puts a per-session token meter on each agent so you can see exactly how much your CLAUDE.md is costing you, with a live cache hit rate to confirm it stays cached.
See the Claude Code token usage trackerAGENTS.md, yapay zeka kodlama ajanlarınızın koda dokunmadan önce okuduğu taşınabilir talimat dosyasıdır. İçine ne koyacağınız, CLAUDE.md'den farkı ve Codex, Antigravity ile Claude arasında tek bir bağlamı nasıl koruyacağınız.
Artık asıl darboğaz kod yazmak değil, iletişim. Claude, Codex, Antigravity ve Grok Build ile nasıl konuşursanız o kadar hızlı, o kadar az token harcayarak sonuca ulaşırsınız.
Claude aboneliğiniz token cinsinden tanımlanmıyor, bu yüzden hiçbir ekran size bir token bakiyesi göstermez. İşte gerçekte neyi ölçtüğü, onu gerçekten gösteren iki ekran, siz yazmazken neden azaldığı ve Eylül 2026'daki haftalık pencere değişikliğinin haftanıza ne yaptığı.
AgentsRoom'u indir ve ajanlarına ihtiyaç duyduğu bağlamı vermek için yerleşik CLAUDE.md editörünü kullan. Daha iyi talimatlar, daha iyi kod.
Yardımcı uygulama: hareket halindeyken ajanlarını izle
Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.
Hataları ve istekleri doğrudan genel backloguna gönder.