CLAUDE.md, Claude'un projenizi 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 edin ve kendinizinkini adım adım oluşturun.
CLAUDE.md, projenizin köküne yerleştirdiğiniz 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ız, dosya yapınız, ekibinizin kuralları ve her ajanın uymasını istediğiniz özel talimatlar.
Bunu bir brifing belgesi olarak düşünün. Bu dosya olmadan Claude projenizin 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'nizin yapısı ve özgüllüğü, Claude'un kod tabanınızda 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çevelerinizi, kütüphanelerinizi ve sürümlerini açıkça listeleyin. Paket yöneticinizi, Node sürümünüzü ve çalışma zamanı gereksinimlerini ekleyin. Claude tahmin etmeden uyumlu kod üretmek için bunu kullanır.
Anahtar dizinlerinizi ve her birinde ne olduğunu tanımlayın. 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ızı (dosyalar için camelCase, bileşenler için PascalCase), hata yönetimi yaklaşımınızı, import sıralamanızı ve projeye özgü kurallarınızı belgeleyin. Bu, Claude'un çıktısını mevcut kodunuzla tutarlı tutar.
Geliştirme, derleme, test ve lint komutlarınızı ekleyin. Claude bir şeyin çalıştığını doğrulaması veya betik önermesi gerektiğinde projenizin beklediği komutları kullanır.
Birden fazla ajan kullanıyorsanız (QA, frontend, backend, DevOps), her rolün neye odaklanması gerektiğini tanımlayan bir bölüm ekleyin. Bu özellikle AgentsRoom'un çoklu ajan yapılandırmasında kullanışlıdır.
Claude'a ne YAPMAMASI gerektiğini söyleyin. 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ız gerekmez. Temel bilgilerle başlayın ve Claude'un neyi bilmesi gerektiğini keşfettikçe genişletin.
package.json dosyanızı açın ve projenizin kullandığı her çerçeve, kütüphane ve aracı listeleyin. Sürümleri not edin. Çalışma zamanı gereksinimlerinizi kontrol edin (Node sürümü, Python sürümü, veritabanı). Bu, teknoloji yığını bölümünüz olur.
package.json + çalışma zamanı sürümleri + veritabanı
src dizininizin hızlı bir ağacını çıkarın. Üst düzey klasörleri belirleyin ve her biri için tek satırlık açıklama yazın. Bileşenlerin, storeların, servislerin, tiplerin ve API rotalarının nerede olduğuna odaklanın.
Amaç notlarıyla src/ ağacı
Mevcut kodunuza bakın ve kalıpları not edin: dosyaları nasıl adlandırıyorsunuz, hataları nasıl yönetiyorsunuz, importları nasıl yapılandırıyorsunuz, varsayılan mı yoksa adlandırılmış mı export kullanıyorsunuz. Bunları kısa kurallar olarak yazın.
Adlandırma, importlar, hata yönetimi, exportlar
Uzman ajanlarla çalışıyorsanız her rol için odak alanları ekleyin. Frontend ajanı bileşen kütüphanenizi bilmeli. DevOps ajanı dağıtım boru hattınızı bilmeli. QA ajanı test çerçevenizi 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'nizi sözdizimi vurgulama ve canlı kaydetme ile doğrudan AgentsRoom içinde düzenleyin. Metin editörünüze veya IDE'nize geçiş yapmaya gerek yok.
Her ajanın CLAUDE.md'nizi gerçek zamanlı nasıl yorumladığını görün. Ajanların kurallarınızı izlediğini ve kaçınılacak alanlarınıza uyduğunu doğrulamak için terminal çıktısını izleyin.
AgentsRoom'daki her projenin kendi CLAUDE.md'si var. Projeler arasında geçiş yapın 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ımlayın; 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 indirin ve ajanlarınıza ihtiyaç duyduğu bağlamı vermek için yerleşik CLAUDE.md editörünü kullanın. Daha iyi talimatlar, daha iyi kod.
Yardımcı uygulama: hareket halindeyken ajanlarınızı izleyin
Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.
Hataları ve istekleri doğrudan genel backlogunuza gönderin.