# Claude Code

> trkit projelerinde Claude Code kullanımı; CLAUDE.md, MCP sunucusu ve örnek iş akışları.

create-trkit-app ile oluşturulan projeler Claude Code için hazırdır; ek ayar gerekmez.

## Hazır gelenler

**`CLAUDE.md`**: Claude Code her oturumda bu dosyayı okur. trkit'in `CLAUDE.md` dosyası `@AGENTS.md` satırıyla proje kurallarını içe aktarır. Claude'a özel talimatlarınızı bu dosyaya, tüm araçlarda geçerli olanları `AGENTS.md`'ye yazın.

**`.mcp.json`**: trkit MCP sunucusu proje kapsamında tanımlıdır:

```json title=".mcp.json"
{
  "mcpServers": {
    "trkit": { "command": "npx", "args": ["-y", "@trkit-app-pack/mcp"] }
  }
}
```

Projeyi Claude Code'da ilk açtığınızda bu sunucuyu onaylamanız istenir. Bağlı sunucuları `/mcp` komutuyla görebilirsiniz.

## Başlarken

```bash
cd benim-sitem
claude
```

İlk istek olarak şirket bilgilerini doldurtabilirsiniz:

```text
trkit.config.ts dosyasını şu bilgilerle doldur: unvan "Örnek Gıda Ltd. Şti.",
MERSİS 0123456789000015, adres "...", telefon "0212 ...", e-posta "info@...".
Site Vercel'de barınıyor. Sonra npx trkit check çalıştır ve kalan uyarıları açıkla.
```

## MCP'yi elle eklemek

trkit dışında oluşturulmuş bir projede:

```bash
# Yalnızca bu proje için, ekip arkadaşlarıyla paylaşılır (.mcp.json'a yazar)
claude mcp add --scope project trkit -- npx -y @trkit-app-pack/mcp

# Tüm projeleriniz için
claude mcp add --scope user trkit -- npx -y @trkit-app-pack/mcp

# Kendi yayınladığınız uzak sunucu
claude mcp add --transport http trkit https://<sunucunuz>/mcp
```

## Önerilen iş akışı

1. **Planla:** Büyük işlerde önce plan isteyin: "iyzico entegrasyonu için plan çıkar, trkit_guide odeme rehberine uy."
2. **Bileşeni ekle:** Claude `npx trkit add odeme` komutunu çalıştırır veya `trkit_get_files` aracıyla dosyaları alır.
3. **Doğrula:** "npm run build çalıştır ve hataları düzelt." `AGENTS.md` bunu zaten ister.
4. **Gözden geçir:** Ödeme ve yasal metin değişikliklerini kendiniz kontrol edin.

## İpuçları

- Uzun oturumlarda Claude'a "AGENTS.md'deki trkit kurallarını hatırla" demek bağlamı tazeler.
- Yeni bir trkit sürümüne geçtiğinizde Claude'a "trkit_list ile yeni bileşenleri kontrol et" diyebilirsiniz.
- Tekrarlayan işler için `.claude/commands/` altında kendi slash komutlarınızı yazabilirsiniz, örneğin yeni bir yasal sayfa ekleyip footer'a bağlayan bir komut.