# Claude her oturuma kör başlar.

Canonical source: https://maguyva.ai/tr/for-claude-code

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

`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.

> 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.

```text
> 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ı](https://code.claude.com/docs/en/memory) 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 *repoda ne bulunduğ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 graf 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, graf 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 grafın 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ş.

### 01. Test taslağını değil, gerçek implementasyonu bulun

```text
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.
```

### 02. Refactor etmeden önce etki yarıçapını kontrol edin

```text
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.
```

### 03. Diff'i kabul etmeden önce ajanı doğrulayın

```text
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 dizinlenmiş repo satırı, kart gerektirmez.

### 01. maguyva.ai’de bir repo dizinleyin

İyi bildiğiniz bir repo seçin, böylece cevapları doğrulayabilirsiniz. Free katmanı 3 repo, 50K'ya kadar dizinlenmiş repo satırı kapsıyor.

### 02. Claude Code’da Maguyva eklentisini kurun

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

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

### 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.

Tam talimatlar [Maguyva’nın dokümanlarında](https://maguyva.ai/tr/docs) yer alır.

## Zaten bildiğiniz bir reponuzu dizinleyin.

Yanıtını doğrulayabileceğiniz bir soru sorun. Onboarding’in tamamı bu.