Claude Kodunun Bağlamını Yönetmek: pratik bir el kitabı

Anthropic'in Claude Kodu ve daha geniş Claude ailesi artık geliştiricilere benzeri görülmemiş bir kontrol sağlıyor ne kadar model görür ve ne kadar derin Mantık yürütüyor. Son ürün güncellemeleri (özellikle Sonnet 4 1 milyon jetonlu bağlam penceresi ve Claude'un genişletilmiş "düşünme" kontrolleri), bağlam yönetimini hem daha güçlü hem de daha önemli hale getiriyor: Tüm depoları tek bir oturumda işleyebilirsiniz; ancak yalnızca komut istemlerini, dosyaları ve oturum durumunu bilinçli bir şekilde yapılandırırsanız. Bu makale, Claude Code bağlamını nasıl güvenilir bir şekilde yöneteceğinizi açıklıyor: komutlar ve kullanım, düşünme bütçesi kontrolü, CLAUDE.md kalıpları, alt aracı iş akışları, ileri düzey kullanıcı ipuçları, sorun giderme ve kopyalayıp yapıştırabileceğiniz somut kod örnekleri.

Nedir? Claude Kodu?

Claude Kodu Antropiktir aracı kodlama CLI — Geliştirme ortamınızı Claude modellerine bağlayan ve böylece yardımcının deponuzu okuyabilmesini, komutları çalıştırabilmesini, dosyaları düzenleyebilmesini, testleri çalıştırabilmesini, commit'ler oluşturabilmesini ve terminalden çok adımlı iş akışlarını yürütebilmesini sağlayan terminal odaklı bir araçtır. Yapay zekanın kabuğunuzda "yaşayabilmesi" ve kod tabanınız üzerinde işlem yapabilmesi için tasarlanmıştır. Depo tarama, eğik çizgi komutları, alt aracılar (izole bağlamlı özel yardımcılar) ve harici araçlar için Model Bağlam Protokolü (MCP) entegrasyonları gibi özellikler sunar.

---

Neden yönetmeliyim? bağlam Claude Kanunu'nun mu?

Çünkü bağlam = alaka + maliyet + güvenlik. Kontrol edilmeyen uzun geçmişler şunlara yol açar:

• Daha yüksek token kullanımı (daha fazla maliyet, daha yavaş yanıtlar).
• Bağlam kayması (eski/ilgisiz bilgiler çıktıları karıştırır).
• Bilgi sızıntısı (sırların veya hassas kayıtların oturumda kalması).
  Bağlamın yönetilmesi çıktıların doğru, öngörülebilir ve daha ucuz olmasını sağlar.

Claude Code proje bağlamını nasıl düzenliyor ve koruyor?

Claude Code, deponuzu, araçlarınızı ve yapılandırmanızı birinci sınıf bağlam kaynakları olarak ele alan bir aracı CLI'dır. Proje dosyalarını okur, CLAUDE.md, yerel araçlar ve yapılandırılmış MCP sunucuları; ayrıca, her biri kendi bağlam penceresine sahip olan alt ajanları da destekler (ana görüşmenin kirlenmesini önlemek için faydalıdır). Bunu, ana düzey stratejiyi özel ajan belleğinden (örneğin, test çalıştırıcısı, kod inceleyicisi) ayrı tutmak için kullanın.

Claude Code depo bağlamını ve yardımcı dosyalarını nasıl alır?

• Çalışma dizinini ve eklediğiniz tüm ekstra dizinleri tarar (--add-dir).
• O arıyor .claude/ alt klasörler (komutlar, aracılar) ve CLAUDE.md.
• Model Context Protocol (MCP) sunucularını harici araç erişimi için bağlayabilirsiniz; Claude Code bu araçları kendi araç setine aktarabilir.

Claude kodunda bağlamı yönetmek için hangi yöntemleri kullanabilirim?

1. Bağlam için temel CLI komutlarına hakim olun. Uzun komutları tekrar tekrar yapıştırmaktan kaçınmak için yeniden kullanılabilir komutları .claude/commands/ dizininde eğik çizgi komutları olarak saklayın.
2. CLAUDE.md dosyasını uygun şekilde tasarlayın. Hedefleri, izin verilen araçları, stili, yükseltme kurallarını ve kullanışlı eğik çizgi komutlarını tanımlamak için CLAUDE.md dosyasını depo köküne ekleyin. (Claude Code bunu otomatik olarak okur ve yetkili bir kılavuz olarak kullanır.)
3. Görev izolasyonu için alt aracılar kullanın; her alt aracı kendi bağlam penceresine ve araç izinlerine sahip olur, böylece ana oturumun sorgulanması engellenir. Alt aracıları .claude/agents/ dizininde saklayın ve sürüm kontrolü yapın.

Temel bağlam yönetimi komutları nelerdir?

Claude Code'da konuşma durumunu yönetmek için en sık kullanacağınız komutlar aşağıda listelenmiştir. Davranışları, örnek kullanımları, önerilen senaryoları ve ilgili CLI işaretlerine yönelik işaretçileri listeliyorum.

---

/clear — “yeniden başla”

Ne yapar: Mevcut konuşma geçmişini oturumdan siler, böylece sonraki istemler temiz bir sayfadan başlar. REPL oturumu devam eder, ancak ileri geri mesajlar modelin bağlamından kaldırılır. (Proje dosyaları ve CLAUDE.md (Claude Kodu'na erişilebilir kalır.)

Ne zaman kullanılır?

• Bir özelliği veya bileti tamamladıktan sonra ilgisiz bir görev için temiz bir oturum istiyorsunuz.
• Eğer oturumda çok fazla keşif dönüşü birikmişse ve cevaplar kötüleşiyorsa.
• Oturumu başka bir kullanıcıya/aracıya devretmeden önce önceki konuşma durumunun sızdırılmasını önleyin.

kullanım

# in the interactive REPL

/clear

Notlar ve ipuçları

• /clear o oturumun konuşma geçmişi için yıkıcıdır; kullanın /resume/--continue Eğer diskte kayıtlı eski oturumlarınıza geri dönmek istiyorsanız.

---

/compact — “özetle ve yoğunlaştır”

Ne yapar: Mevcut konuşmayı, önemli gerçekleri ve kararları koruyan daha kısa bir özete sıkıştırır ve ardından ayrıntılı geçmişi bu özetle değiştirir, böylece oturum önemli bağlamı kaybetmeden devam edebilir. Bu, sürekliliği korurken token kullanımını azaltır.

Ne zaman kullanılır?

• İş parçacığının önemli durumunu korumak ancak belirteç ayak izini azaltmak istediğinizde.
• Aksi takdirde bağlam penceresini sınırlara doğru itecek uzun yeni bir görevden önce.
• Önemli kararları korurken özlü bir oturum "hafızası" istediğinizde.

kullanım

# in the interactive REPL

/compact
# or with an instruction to guide the summary

/compact Summarize decisions, open TODOs, and config changes only

Notlar ve ipuçları

• auto-compact, microcompact, ve diğer akıllı sıkıştırma davranışları, bazı sürümlerde veya kurulumlarda konuşma uzunluğu sınırlara yaklaştığında otomatik olarak çalışabilir; bu özellikler kullanıma sunuluyor ve kurulumunuzda veya barındırılan ortamınızda görünebilir. (Topluluk ve değişiklik günlükleri, mikro sıkıştırma ve otomatik sıkıştırma davranışlarını tartışmaktadır.)

---

--continue, --resumeve oturum kontrolleri (CLI düzeyi)

Ne yaparlar: CLI'dan kontrol oturumu kalıcılığı ve seçimi.

• claude --continue (Ya da claude -c) — mevcut proje dizinindeki en son konuşmayı yeniden açın ve devam ettirin.
• claude --resume (Ya da claude -r <session-id>) — etkileşimli bir seçici gösterir (veya kimliğe göre belirli bir oturumu devam ettirir). Birçok oturum kaydettiğinizde ve devam etmek için birini seçmek istediğinizde kullanışlıdır.

Kullanım örnekleri

# continue the most recent session

claude --continue

# open an interactive session picker

claude --resume

# resume by id (non-interactive)

claude --resume 550e8400-e29b-41d4-a716-446655440000

---

Bağlam açısından önemli olan etkileşimli mod kısayolları (terminal UX)

• Ctrl+L — terminal ekranını (görsel) temizler, ancak tutar konuşma geçmişini kullanın. /clear aslında geçmişi sıfırlamak için.
• Ctrl+D — oturumu sonlandır (EOF).
• Ctrl+C — mevcut jenerasyonu iptal et.
  Bunlar kolaylık denetimleridir; açıkça çalıştırmadığınız sürece yalnızca terminal davranışını etkilerler /clear or --continue/--resume.

---

Diğer bağlamla ilgili denetimler ve işaretler

• --add-dir <path> — Claude'un okuyabileceği ek dizinler ekleyin (Claude'un erişebileceği kapsamı belirlemek ve gereksiz dosya okumalarını azaltmak için iyi).
• --allowedTools — Claude'un tekrarlanan izin istemlerine gerek kalmadan araçları çalıştırabilmesi için önceden izin verin (ileri geri ve gürültülü araç izin diyaloglarını azaltır).
• Eğik çizgi komutları (/.claude/commands/ veya MCP tarafından sağlanan) — sık kullanılan, jeton açısından verimli istemleri depolar; uzun istemleri tekrar tekrar yapıştırmaktansa eğik çizgi komutunu çağırmak daha ucuzdur.

Proje bağlamını kontrol etmek için CLAUDE.md dosyasını nasıl tasarlamalıyım?

CLAUDE.md nedir ve neden önemlidir?

CLAUDE.md Claude Code'un bir depoda başlatıldığında otomatik olarak okuduğu, ön kontrol, proje düzeyinde bir komut istemidir. Proje hakkında kısa, eyleme geçirilebilir ve tutarlı bilgiler (isimler, mimari, standartlar) eklemek için kullanın. Model, CLAUDE.md'yi komut istemine aktardığı için, iyi hazırlanmış bir dosya aynı bilgileri tekrar tekrar yapıştırma ihtiyacını azaltır ve değerli token bütçesini korur.

CLAUDE.md: pratik şablon (önerilir)

Şu kuralları koruyun: kısa (mümkünse 100-200 satır), hiyerarşik (genel → proje → alt dizin geçersiz kılmaları) ve makine tarafından okunabilir bölümler.

# CLAUDE.md — top of repository

Project: Acme Payment Gateway
Primary language: typescript
Build: pnpm build
Run tests: pnpm test
API routing: src/api/*
Database: Postgres via prisma (schema at prisma/schema.prisma)

# Conventions

- commit format: Conventional Commits
- test coverage threshold: 80%
- style: eslint + prettier (configs in .eslintrc, .prettierrc)

# What I'm asking Claude to do

- When asked to create a feature, always include tests and update the CHANGELOG.
- When modifying DB schema, present migration plan and migration files.

Notlar:

• Önce yüksek değerli öğeleri (API'ler, önemli dosyalar, altyapı komutları, test komutu) koyun.
• Ayrı kullanın CLAUDE.md Farklı modüllerin farklı kuralları olduğunda dosyaları alt dizinlere yerleştirir; Claude daha spesifik dosyaları birleştirir ve öncelik sırasına koyar.

Bağlamı yönetmek ve işi paralel hale getirmek için iş akışlarını ve alt acenteleri nasıl bir araya getirebilirim?

Alt acenteler nelerdir?

Alt temsilciler, ana temsilcinin ayrı görevleri alt temsilcilere devrettiği Claude Kodu kalıplarıdır (örneğin: frontend-agent, backend-agent, qa-agent) ve ardından ana aracı çıktılarını uzlaştırır. Alt aracılar, her şeyi tek bir sohbete sıkıştırmadan sistemin farklı bölümleri üzerinde paralel olarak çalışmanıza olanak tanır.

Örnek iş akışı: özellik uygulaması (paralel aracılar)

1. main-agent CLAUDE.md'yi okur, plan oluşturur.
2. frontend-agent (alt ajan) odaklanmış bağlamı alır: kullanıcı arayüzü sözleşmeleri, hikaye kitabı, belirli dosyalar.
3. backend-agent (alt ajan) DB şemasını, API sözleşmelerini alır ve uç noktaları uygular.
4. qa-agent testleri çalıştırır, başarısız testleri geri yazar main-agent.
5. main-agent commit'leri, birleştirme isteklerini düzenler ve CLAUDE.md'yi günceller.

CLI deseni:

# start main session

claude --session main

# spawn frontend subagent (conceptually: new session with scoped CLAUDE.md)

claude --session frontend --cwd frontend/

İpucu: Kapsamlı oluşturun CLAUDE.md alt dizinlerdeki dosyalar (frontend/CLAUDE.md, backend/CLAUDE.md) böylece her alt ajan ihtiyaç duyduğu en az bağlamla başlar.

Örnek alt acente: .claude/agents/code-reviewer.md

---
name: code-reviewer
description: Focused code reviewer. Limited tools: Read, Grep, Bash
---

You are a code reviewer. When invoked:
1. Run `git diff --name-only` to see changed files.
2. Prioritize security, correctness, tests.
3. Return a patch (diff) and a 3-item actionable checklist.

---

Güçlü kullanıcıların bağlamı sağlıklı tutmak ve maliyetleri düşürmek için ipuçları nelerdir?

1) CLAUDE.md'yi yalın ve hiyerarşik tutun

Devasa, monolitik CLAUDE.md dosyalarından kaçının. Geliştiricinin tercihleri ​​için tek bir genel dosya, alan özellikleri içinse küçük modül dosyaları kullanın. Önceki şablona bakın.

2) Fiiller için eğik çizgi komutlarını, isimler için CLAUDE.md'yi kullanın

CLAUDE.md'yi bunun için bir yer haline getirin gerçekler (hangi dosyaların mevcut olduğu, mimari) ve eğik çizgi komutları yer için prosedürler (testler oluşturun, yeniden düzenlemeyi çalıştırın). Bu, prosedürel mantığın her oturumda yeniden gönderilmesini önler. Topluluk bilgisi bu ayrımı vurgular.

3) Ayrıntılı mod + hata ayıklama aracı olarak plan modu

Claude beklenmedik bir şekilde davrandığında, tam bağlamı görmek için ayrıntılı modunu çalıştırın ve düzenlemelerden önce onaylayabileceğiniz açık bir planı zorlamak için plan modunu kullanın.

4) Bütçeyi dikkatlice düşünün

Varsayılan/minimum düşünme tokenlarıyla başlayın ve yalnızca görevler çok adımlı akıl yürütme gerektirdiğinde (karmaşık yeniden düzenlemeler, resmi doğrulama) artırın. Rutin düzenlemeler için daha düşük bütçeler kullanın.

5) Enstrüman çıktıları ve taahhütleri

Testleri otomatik olarak çalıştıran ve çıktılarını oturuma ekleyen kancalara sahip olun (bash modu) ! (Bir kabuk komutunu çalıştırmak ve çıktıyı bağlam olarak eklemek için). Mesajlarla net atomik commit'ler oluşturmak için commit kancalarını kullanın.

Bağlam "düştüğünde" veya Claude talimatları unuttuğunda nasıl sorun gidermeliyim?

Yaygın belirtiler ve çözümler

• semptom: Claude, CLAUDE.md veya önceki talimatları dikkate almıyor.
• Düzeltmeler: Dosyanın oturumun geçerli çalışma dizininde olduğunu doğrulayın; onu geçersiz kılan daha spesifik bir alt dizin olan CLAUDE.md'yi kontrol edin; geçerli istemi görmek için ayrıntılı modu kullanın.
• semptom: Uzun oturumlar boyunca performans düşer (model ilk kısımları "unutur").
• Düzeltmeler: Oturumu sıkıştırın: CLAUDE.md dosyasına sabit verileri çıkarın veya konuşmanın bazı bölümlerinin anlık görüntüsünü dosyalara aktarın ve tekrarlamak yerine bunlara başvurun. Ayrıca kısa oturumları yeniden başlatmayı ve yalnızca özlü bağlam aktarmayı da düşünün.
• semptom: Uzun süreli düşünme çok uzun sürer veya zaman aşımına uğrar.
• Düzeltmeler: Düşük düşünme bütçesi kullanın, görevi daha küçük alt problemlere bölün veya çok büyük bütçelere ihtiyacınız varsa toplu çevrimdışı analiz çalıştırın. Anthropic, zaman aşımını önlemek için optimum düşünme bütçeleri ~32K jetonu aştığında toplu analiz yapılmasını önerir.

Sonuç

Claude Kodunda bağlamı yönetmek artık çok boyutlu bir sorundur: model seçimi, alt ajan tasarımı, CLAUDE.md Disiplin, düşünme bütçeleri ve araç mimarisi etkileşim halindedir. Net bir taslak oluşturmak için 1-2 saat ayırarak başlayın. CLAUDE.md, 2-3 odaklı alt acenteyi bir araya getirin ve belirteçler ve düşünme bütçeleri için kullanım araçları ekleyin; güvenilirlik, maliyet öngörülebilirliği ve ekip üretkenliğinde anında kazanımlar göreceksiniz.

CometAPI aracılığıyla Claude Kodunu kullanın

CometAPI, OpenAI'nin GPT serisi, Google'ın Gemini, Anthropic'in Claude, Midjourney, Suno ve daha fazlası gibi önde gelen sağlayıcılardan 500'den fazla AI modelini tek bir geliştirici dostu arayüzde toplayan birleşik bir API platformudur. Tutarlı kimlik doğrulama, istek biçimlendirme ve yanıt işleme sunarak CometAPI, AI yeteneklerinin uygulamalarınıza entegrasyonunu önemli ölçüde basitleştirir. İster sohbet robotları, görüntü oluşturucular, müzik bestecileri veya veri odaklı analiz hatları oluşturuyor olun, CometAPI daha hızlı yineleme yapmanızı, maliyetleri kontrol etmenizi ve satıcıdan bağımsız kalmanızı sağlar; tüm bunları yaparken AI ekosistemindeki en son atılımlardan yararlanırsınız.

CometAPI'nin artık güçlü Claude Code'u tam olarak desteklediğini duyurmaktan heyecan duyuyoruz. Claude Code üzerinde Comet API modelini kullanmak için yapmanız gereken tek şey Claude Code'u kurmak ve elde edilen Comet API anahtarı ve temel adres ile kimlik doğrulaması yapmaktır.

CometAPI üzerinden claude kodu neden kullanılmalıdır?

Yapay Zeka'nın en önemli özellikleri: Geliştiriciler için özel olarak oluşturulmuş modelleri kullanarak kodu kolayca oluşturun, hata ayıklayın ve optimize edin.

• Esnek Model Seçimi: Kapsamlı model yelpazemiz daha sorunsuz bir şekilde geliştirme yapmanıza olanak tanır.
• Kusursuz Entegrasyon: API'ler her zaman kullanılabilir. Claude Code'u dakikalar içinde mevcut iş akışınıza entegre edin.
• CometAPI aracılığıyla Claude Code'u kullanmak daha fazla maliyet tasarrufu sağlayacaktırCometAPI tarafından sağlanan API, resmi fiyattan %20 indirimlidir ve resmi olarak en son modelle güncellenmektedir. En son model: Claude Opus 4.1.

Claude Kodunu kullanmaya hazır mısınız? API kılavuzu detaylı talimatlar için.

Ayrıca bakınız Claude Code CometAPI ile Nasıl Kurulur ve Çalıştırılır?