Claude Code aracınız 45 dakika boyunca mükemmel çalıştı. Bağlam oluşturdu. Kod tabanını anladı. İlk 30 dakikada öğrendiği şeylere bağlı kararlar aldı. Ardından bağlam sınırına ulaşıldı. Oturum sıkıştırıldı. Aracın öğrendiği her şey — izlediği özel dosya, tanımladığı desen, işaretlediği üç kenar durumu — kayboldu. Yeni oturum tazelenmiş olarak başlar. Ajan CLAUDE.md'yi okur, görevi okur ve önceki oturumda yapılanları bilmeden yeniden başlar. Zaten işlediği dosyaları yeniden inceleyebilir. Önceki oturumdaki bağlam eksikliğinden dolayı farklı kararlar verebilir. Zaten yapılan işi yeniden yapabilir. Bu, oturum belleği başarısızlığıdır. Uzun süren ajan görevleri birden fazla bağlam penceresini aştığında her zaman meydana gelir.
Sorun: Bağlam Bellek Değildir Claude Code ajanlarının sıkça karıştırılan iki farklı bileşeni vardır: Bağlam — mevcut oturum penceresindeki içerik. Hızlı erişim. Büyük akıl yürütme yeteneği. Sıfır kalıcılık. Oturum sona erdiğinde veya sıkıştırıldığında gider. Bellek — diske yazılan içerik. Oturumlar arasında kalıcıdır. Gelecekteki herhangi bir ajana kullanılabilir. Korunmasının bilişsel maliyeti sıfır; yapılandırılması ve alınması için ise sıfır olmayan bir maliyet vardır.
60-90 dakikadan uzun süren üretim görevleri bağlam penceresini aşacaktır. Bağlam sıkıştırılması, yeni çalışmalar için yer açmak amacıyla oturumun daha önceki kısımlarını kaldırır. Sınırlara ulaşılmasa bile, her 10 dakikada bir cron ile çalıştırılan bir ajan her seferinde taze bir bağlama sahip olur. Bağlamda bilgi biriktirmek için tasarlanmış herhangi bir ajan, bağlam sıfırlandığında başarısız olacaktır.
Üç başarısızlık modu:
- Tekrarlanan keşif
Ajanın izlediği yetkilendirme hatasının auth/middleware.py dosyasında bulunduğunu keşfetti. Bu bilgi bağlamda mevcuttu. Yeni oturum başladığında ajan dosya listesini tekrar okur, aynı hatayı yeniden keşfeder. Her sıfırlamada 10 dakikalık gereksiz çalışma.
- Karar bağlamının kaybolması
Ajan, daha önceki bir analizde config.yaml dosyasının üç farklı servis tarafından kullanıldığını gösterdiği için dosyayı değiştirmeme kararı aldı. Bu analiz sıkıştırılmış bağlamda yer alıyordu. Yeni oturumda ajan bu kısıtı bilmeden config.yaml dosyasını düzenler ve geriye dönük bir hataya neden olur.
- İlerleme takibi başarısızlığı
Ajan dosyaları A'dan M'ye kadar işledi. Bağlam sıkıştırıldı; bu ilerleme kayboldu. Yeni oturum A'dan yeniden başlar. M'ye ulaştığında her şeyi iki kez işlemiş olur. Çıktılar klasöründe kopyalar oluşur; hangisinin nihai versiyon olduğu belli değildir.
Ne İşe Yaramaz CLAUDE.md'ye oturum durumunu yazmak CLAUDE.md, çalıştırma talimatları için vardır, çalışma zamanı durumları için değil. Oturum ilerlemesini CLAUDE.md'ye yazmak kararlı yapılandırma ile geçici durumu birbirine karıştırmak anlamına gelir. Her gelecek oturum için gürültü yaratır ve CLAUDE.md'nin yalnızca ~K¹ onayıyla değişmesi gerektiği ilkesini ihlal eder. outputs/ klasörüne yazmak ve yeniden okumak Çıktı dosyaları tasarım gereği yazıldıktan sonra değiştirilmez. Oturum başında durumu yeniden oluşturmak için bunları okumak kırılgandır — ajan kendi düzyazı çıktısını ayrıştırarak yapılandırılmış veriyi kurtarmak zorundadır. Bir sonraki oturumun "kendisinin halledeceğini" düşünmek Halletmeyecektir. Bir sonraki oturum yalnızca diskte olanları ve CLAUDE.md'deki içerikleri görür. Oturum özelindeki kararlar, ilerleme işaretleri ve keşfedilen bağlam açıkça yazılmadıkça var olmaz.
Desen: Oturum Bellek Dosyaları Her uzun soluklu görev, oturum belleği dosyası adı verilen yapılandırılmış, yalnızca ekleme yapılabilen bir günlük dosyası tutar. Ajan bu dosyayı oturum sırasında yazar ve bir sonraki oturumun başında okur.
SESSION_MEM="$INTUITEK/working/${TASK_ID}/session_memory.md"
Oturum bellek dosyası yapısı:
Session Memory — task_orders_audit_20260422
Kararlar
- 2026-04-22T07:12Z — config/auth.yaml DÜZENLENMEMELİ — 3 servis (auth, payments, admin) tarafından kullanılıyor; buradaki değişiklik hepsini bozar
- 2026-04-22T07:23Z — Sipariş güncellemeleri için iyimser kilitleme kullan; orders.py:241'deki mevcut kilitleme deseniyle doğrulandı
İlerleme İşaretleri
- TAMAMLANDI: orders/batch_1/ (dosyalar 001-047)
- TAMAMLANDI: orders/batch_2/ (dosyalar 048-091)
- DEVAM EDİYOR: orders/batch_3/ (dosyalar 092-??? — dur
Yapay zeka özeti
Discover how session memory files maintain agent continuity across context resets, preventing redundant work and costly mistakes in long-running tasks.
Etiketler
