Sistem Istemleri ve CLAUDE.md

--system-prompt ile bir kodlama kurali ekliyorsunuz. Calisiyor — ancak simdi Claude guvenlik yonergelerini, kod stili tercihlerini ve CLAUDE.md dosyalarinizdan gelen tum talimatlari unutmus durumda. Eklemek istediginizde tum sistem istemini degistirdiniz. Bu, uretim botlarini bozar — aniden icerik politikalarini gormezden gelirler ve onay almadan yikici islemler gerceklestirirler.

Claude’a istemin otesinde talimat vermenin uc yolu vardir: --append-system-prompt varsayilanlarin uzerine kurallar ekler, --system-prompt varsayilanlari tamamen degistirir ve CLAUDE.md dosyalari sikilamayi (compaction) atlatan kalici proje duzeyinde yapilandirma saglar. Dogru olani secmek, Claude’un guvenlik yonergelerini koruyup korumayacagini, cagri basina ne kadar odeyeceginizi ve kurallarinizin oturumlar arasinda gecerli kalip kalmayacagini belirler.

Ozel bir nedeniniz olmadikca --append-system-prompt kullanin. --system-prompt her seyi degistirir — yalnizca korumalı bir sohbet botu kisililigi veya dosya sistemi erisimi olmayan saf bir JSON donusturucu gibi bir sey insa ederken kullanin.

—append-system-prompt

Bu guvenli, eklemeli yaklasimdir. Metniniz varsayilan sistem isteminin sonuna eklenir, boylece Claude tum yerlesik guvenlik yonergelerini, arac talimatlarini ve kodlama kurallarini korur. Kurallariniz bunlarin uzerine katmanlanir.

Eklenen metin Claude’un gordugu sistem isteminin bir parcasi olur, ancak hicbir sey cikarilmaz. Bu, cogu kullanim senaryosu icin dogru secimdir: karmasik istekler icin plan modunu zorlamak, kod inceleme kriterleri eklemek, “her zaman TypeScript strict modu kullan” gibi alana ozgu kurallar enjekte etmek veya cikti formati kisitlamalari belirlemek.

# Force plan-first behavior for complex tasks
claude -p "Refactor the auth module" \
  --append-system-prompt "When the user brings a list of changes, \
immediately call EnterPlanMode and research the codebase before presenting a plan."

# Security review with structured output rules
claude -p "Review auth.py" \
  --append-system-prompt "Focus exclusively on SQL injection and XSS vulnerabilities. \
Rate each finding as Critical, High, Medium, or Low."

—system-prompt

Bu bayrak varsayilan Claude Code sistem isteminin tamamini degistirir. Yerlesik her sey — guvenlik yonergeleri, arac kullanim talimatlari, kodlama kurallari, izin yonetimi kurallari, git guvenlik protokolleri, ton ve stil yonergeleri — gider. Claude yalnizca sizin sagladiginiz seyleri takip eden bos bir sayfa olur.

Tam degistirme, Claude’un tamamen farkli bir kisilik olmasi gerektiginde dogru aractir — bir Gandalf sohbet botu, bir dil ogretmeni, saf bir JSON donusturucu. Dosya sistemi erisimini devre disi birakmak ve korumalı bir kisilik olusturmak icin --tools "" ile eslestirin:

# Pure persona with no tool access
claude -p "Tell me about yourself" \
  --system-prompt "You are Gandalf the Grey. Speak in character." \
  --tools ""

CLAUDE.md

Hem --system-prompt hem de --append-system-prompt gecicidir. Yalnizca mevcut claude -p cagrisina uygulanirlar ve bir oturumu --resume ile devam ettirdiginizde korunmazlar. Kalici, proje duzeyinde talimatlar icin CLAUDE.md kullanin.

Bir CLAUDE.md dosyasi oturum baslangicinda diskten yuklenir ve sikistirmadan (compaction) sonra yeniden okunur. Bu, kurallarinizin /compact komutunu ve otomatik sikilamayi tetikleyen uzun oturumlari atlattigini anlamir. Dosyayi proje kokunuze yerlestirin ve o dizinden baslanan her oturum talimatlari devralir.

## Coding Standards
- Use TypeScript strict mode for all new files
- Prefer named exports over default exports
- All functions must have JSDoc comments

## Git Rules
- Never commit directly to main
- Prefix commit messages with feat:, fix:, or chore:

Hangisi Ne Zaman Kullanilir

Token Maliyeti: Degistirme ve Ekleme

Sectiginiz sistem istemi mekanizmasi token sayilari ve maliyet uzerinde dogrudan etkiye sahiptir. Kisa bir istemle tam degistirme, ~14K varsayilandan daha az onbellege alinmis token kullanir. Ekleme, birlesmis istem icin yeni cache girisleri olusturur.

Degistirme cagrisi 8.811 onbellek okuma tokeniyle $0.015’e mal olur. Ekleme cagrisi 9.124 onbellek olusturma tokeniyle $0.061’e mal olur cunku birlesmis varsayilan-arti-eklenmis istem ilk kez onbellege alinmak zorundaydi. Ayni eklenen metinle yapilan sonraki cagrilarda, onbellek yeniden kullanildikca olusturma maliyeti duser.

Uc Katmanin Hepsi Birlesir

Yaygin bir yanlis kanı: --system-prompt CLAUDE.md’yi degistirir. Degistirmez. Uc baglam katmaninin hepsi ayni anda aktiftir:

--system-prompt "pirate speak" + --append-system-prompt "end with ARRR" + “TEST_PROJECT’dan bahset” iceren bir CLAUDE.md calistirmak — uc talimat da her yanıtta gorulur. Etkili yigin sudur: [--system-prompt VEYA varsayilan] + [CLAUDE.md hiyerarsisi] + [--append-system-prompt].

Dikkat Edilmesi Gerekenler

CLAUDE.md Boyutlandirma Rehberi

CLAUDE.md dosyalari her oturum baslangicinda baglama yuklenir ve sikilamayi atlatir. Boyutlari baslangic maliyetini, yanit kalitesini ve ilk yanit gecikmesini dogrudan etkiler.

Onerilen limitler:

• Tek bir CLAUDE.md icin 10.000 kelimenin altinda — optimum performans icin topluluk konsensüsü
• 2.800+ satir olculebilir bozulmaya neden olur — ~2.100 ek baslangic tokeni ve 10-12 saniye ilk yanit gecikmesi
• 47.000 kelime felaket boyutunda — bu olcekte performans dramatik olarak duser

Monorepo bolme stratejisi: Tek bir devasa kok CLAUDE.md yerine alt dizine ozgu dosyalara bolun:

project/
├── CLAUDE.md                    # 2,000 words — global conventions only
├── frontend/CLAUDE.md           # 3,000 words — React patterns, component structure
├── backend/CLAUDE.md            # 3,000 words — API conventions, database patterns
└── infrastructure/CLAUDE.md     # 2,000 words — deployment, CI/CD specifics

Claude, dizin hiyerarsisindeki (kokten cwd’ye kadar) tum CLAUDE.md dosyalarini yukler. Alt dizin dosyalari ust dosyalara eklenir — onlari degistirmez. Yalnizca mevcut calisma dizininize giden yoldaki CLAUDE.md dosyalari yuklenir, boylece bir frontend gelistirici backend CLAUDE.md tokenleri icin odeme yapmaz.