Claude Code kullanıcıları için

Claude her oturuma kör başlar.

CLAUDE.md, Claude’a nasıl davranacağını söyler. Reponuzda ne olduğunu söylemez. Maguyva kod tabanını dizinler ve MCP üzerinden geri sunar; böylece Claude sanki kodu zaten okumuş gibi düzenler.

Ücretsiz başla Claude Code kurulumunu okuyun

Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

Davranış için CLAUDE.md’yi kullanın. Güncel kod tabanı bilgileri için Maguyva’yı kullanın.

CLAUDE.md bir en iyi uygulamadır. Onu kullanın.

> cat CLAUDE.md
# proje kuralları, komutlar, sınırlandırılmış kurallar

Kalıcı talimatlar CLAUDE.md içinde yer alır. Şunlar için doğru yerdir:

Ajanın çalıştırması gereken derleme, test ve lint komutları.
Kodlama stili kuralları ve adlandırma kuralları.
Bir dizine sınırlandırılmış “her zaman X yap / asla Y yapma” kuralları.
Kanonik dokümanlara ve karar günlüklerine işaretçiler.

Anthropic’in bellek dokümanları bunu iyi anlatıyor. Kısa tutun. Kapsamını belirleyin. Commit’leyin.

Ama CLAUDE.md hiçbir zaman kod tabanınızın bir haritası olması için tasarlanmadı.

CLAUDE.md’nin yetmemeye başladığı yer

Yalnızca markdown’ın düzeltemeyeceği dört başarısızlık modu.

// dosya kod tabanı değildir

Claude’a nasıl davranacağını söylemek, ona ne olduğunu söylemez. Bilinmeyen bir repodaki ilk düzenleme, dosya yolları, fonksiyon isimleri ve çağrı noktaları hakkında bir tahmindir. CLAUDE.md her sembolü listeleyemez, zaten bunu istemezsiniz.

// dokümanlar eskir, kod eskimez

Kimlik doğrulama akışınızı açıklayan bir CLAUDE.md bloğu, biri kimlik doğrulamayı refactor edene kadar doğrudur. Kod artık gerçeğin kaynağıdır ve dokümanlar kendinden emin bir şekilde yanlıştır. Claude yanlış olanı okur.

// bağımlılıklar markdown’da değildir

“Bu fonksiyonu değiştirirsem ne bozulur?” bir grafik sorusudur. Bir doküman dosyasıyla yanıtlanamaz. Claude ya grep atıp dua eder ya da dosyaları sohbete yapıştırmanızı ister.

// bağlam pencerelerinin bir bütçesi vardır

Claude “yeterince bilene” kadar CLAUDE.md’yi doldurmak, akıl yürütme için ödemesi gereken token’ları yer. Birkaç KB’ın ötesinde bağlam hacmi için yanıt kalitesinden ödün verirsiniz.

Maguyva, CLAUDE.md’nin kapsamadığı katmandır

Claude Code’a şunları veren uzak bir MCP sunucusu:

Anlamsal, AST, grafik ve metin araması dizinlenmiş reponuz üzerinde, dosya yolları ve satır numaralarıyla döndürülür.
Bağımlılık, tip ve çağrı noktası aramaları bir grafiğin yanıtlayabileceği ve bir doküman dosyasının yanıtlayamayacağı sorular.
Dal farkında sonuçlar böylece Claude, gerçekte düzenlediği kod sürümünü görür.
Çalışma alanı fiyatlandırması koltuk başına değil. 1 repo veya 50 repo dizinleyin; ajanlar koltuk için ödemez.

CLAUDE.md, Claude’a nasıl davranacağını söyler.
Maguyva, Claude’a kodun sorgulanabilir bir haritasını verir.

Üç iş akışı

Numaralandırılmış, kod bloğu ağırlıklı. Claude’a zaten sorduğunuz sorular, gerçek satırlara temellendirilmiş.

// workflow 01

Test taslağını değil, gerçek implementasyonu bul

Siz: "Ödeme istemcimizde retry nasıl çalışıyor?"

Maguyva olmadan → Claude retry için grep yapar, 14 sonuç bulur, birini seçer (çoğu zaman bir test mock'u).
Maguyva ile    → Maguyva, sembol tanımını, çağrı noktalarını ve gerçek
                   implementasyonun dosya:satır bilgisini sıralanmış şekilde döndürür.

// workflow 02

Refactor etmeden önce blast radius'u kontrol et

Siz: "normalizePhoneNumber'ı kim çağırıyor?"

Maguyva şunu döndürür: 4 pakette, gRPC stub üzerinden onu import eden bir Python servisi dahil
7 çağrı noktası. Claude, değişikliği CI kırmızıya dönmeden önce
migrasyon listesiyle birlikte öneriyor.

// workflow 03

Diff'i kabul etmeden önce ajanı doğrula

Claude: "Token yenilemeyi düzeltmek için src/auth/session.ts:142 dosyasını düzenledim."

Maguyva'ya sor: "Bana session.ts:130-160 aralığını ve session'ı import eden her şeyi göster."

Maguyva canlı dosya kesitini + 3 import eden dosyayı döndürür. Diff artık Claude’un
#11.000. token'daki hatırlamasına değil, gerçek satırlara dayanıyor.

Claude Code’da kurulum

Üç adım. Free katmanı: 3 repo, 50K'ya kadar indekslenmiş repo satırı, kart gerektirmez.

// step 01
maguyva.ai’de bir repo dizinleyin
İyi bildiğin bir repo seç, böylece cevapları doğrulayabilirsin. Free katmanı 3 repo, 50K'ya kadar indekslenmiş repo satırı kapsıyor.

// step 02

Claude Code’da Maguyva eklentisini kurun

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

# the plugin reads your key from the environment
export MAGUYVA_API_KEY=mgv_xxxx

// step 03
Yanıtını zaten bildiğiniz bir soru sorun
Tüm şirketiniz yerine bir repo ve doğrulanabilir bir soruyla başlayın. Yanıt sizin söyleyeceğinizle eşleşiyorsa, hazırsınız demektir.