Yapay zeka asistanınızın haftalar süren geliştirme boyunca her mimari kararı, hata düzeltmesini ve yeniden düzenleme oturumunu hatırladığını düşünün. Claude-mem, araç kullanım gözlemlerini otomatik olarak yakalayarak, bunları anlamsal özetlere sıkıştırarak ve ilgili geçmişi her yeni Claude Code oturumuna enjekte ederek kaybedilen bağlamın yarattığı sürtünmeyi ortadan kaldırır.
Sorun: Yapay Zeka Destekli Geliştirmede Bağlam Kaybı
Her Claude Code oturumu boş bir sayfa olarak başlar. Terminalinizi kapattığınızda veya bir oturumdan bağlantınızı kestiğinizde, Claude her şeyi unutur; proje yapınızı, son yeniden düzenleme kararlarınızı, hata ayıklama keşiflerinizi ve mimari desenlerinizi. Bu durum, kod tabanınızı tekrar tekrar açıklamanıza, gereksiz bağlam için token harcamanıza ve iş akışı sürekliliğini bozmanıza neden olur.
Geliştiriciler şu anda bu sorunu CLAUDE.md dosyalarını manuel olarak tutarak, ayrı belgelere notlar alarak veya her oturumun başında proje bağlamını yeniden açıklayarak aşmaya çalışıyorlar. Bu yaklaşımlar kırılgan, zaman alıcıdır ve geliştirme geçmişinizin tüm zenginliğini asla tam olarak yakalayamaz. Claude-mem, her araç çağrısını otomatik olarak gözlemleyerek, çıktıyı aranabilir anlamsal belleklere sıkıştırarak ve ihtiyacınız olduğunda ilgili bağlamı akıllıca alarak bu sorunu çözer.
Geliştirici Ekibinizin birlikte çalışması için entegre, Hepsi Bir Arada bir platform ister misiniz? maksimum üretkenlik?
Apidog tüm taleplerinizi karşılar ve Postman'ın yerini çok daha uygun bir fiyata alır!
düğme
Claude-mem'in Mimarisi Nasıl Çalışır?
Claude-mem, Claude Code'un yaşam döngüsüne bağlanan kalıcı bir bellek sıkıştırma sistemi olarak çalışır. Araç çıktılarını (genellikle 1.000 ila 10.000 token) yakalar ve Claude'un Agent SDK'sını kullanarak bunları yaklaşık 500 tokenlik anlamsal gözlemlere sıkıştırır. Bu gözlemler türe göre (karar, hata düzeltme, özellik, yeniden düzenleme, keşif, değişiklik) kategorize edilir ve ilgili kavramlar ve dosya referanslarıyla etiketlenir, ardından tam metin arama yeteneklerine sahip yerel bir SQLite veritabanında depolanır.
Sistem, bağlamı yakalamak için beş yaşam döngüsü kancası kullanır:
- SessionStart: Başladığınızda önceki oturumlardan bağlamı enjekte eder
- UserPromptSubmit: Desen tanıma için sorgularınızı yakalar
- PostToolUse: Her araç yürütmesini ve çıktısını gözlemler
- Stop: Claude yanıt vermeyi bitirdiğinde oturum özetleri oluşturur
- SessionEnd: Oturum depolamasını ve temizliği tamamlar
Bu mimari, ilerleyici ifşayı – kapsama alanı ile token verimliliğini dengeleyen katmanlı bir bellek alma sistemini – mümkün kılar. Claude-mem, tüm geçmişinizi bağlama yüklemek yerine, gözlemleri katmanlar halinde alır ve manuel bağlam yönetimine kıyasla oturum başına yaklaşık 2.250 token tasarrufu sağlar.
Kurulum ve Sistem Gereksinimleri
Claude-mem, Node.js 18.0.0 veya üzeri, eklenti desteğine sahip en son Claude Code ve JavaScript çalışma zamanı ve süreç yöneticisi olarak Bun (eksikse otomatik olarak yüklenir) gerektirir. Kalıcı depolama için SQLite 3 paketlenmiştir. Eklenti, Windows, macOS ve Linux'ta çapraz platform çalışır.
Hızlı Başlangıç Kurulumu
Claude-mem'i doğrudan eklenti pazarından iki komutla yükleyin:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
Kurulumdan sonra Claude Code'u yeniden başlatın. Eklenti, önceden oluşturulmuş ikili dosyaları otomatik olarak indirir, Bun ve SQLite dahil bağımlılıkları yükler, oturum yaşam döngüsü yönetimi için kancaları yapılandırır ve ilk oturumunuzda çalışan hizmeti otomatik olarak başlatır.
Kaynaktan Gelişmiş Kurulum
Geliştirme veya test için, github'daki kaynaktan klonlayın ve oluşturun:
git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem
npm install
npm run build
npm run worker:start
Bu yaklaşım, eklentiyi değiştirmeniz veya Sonsuz Mod gibi beta özelliklerini çalıştırmanız gerektiğinde faydalıdır.
Kurulum Sonrası Doğrulama
Kurulumdan sonra her şeyin çalıştığını doğrulayın:
- Eklenti kurulumunu kontrol edin:
cat plugin/hooks/hooks.json
- Çalışan hizmetin çalıştığını doğrulayın:
curl http://localhost:37777/api/health
- Son çalışan günlüklerini görüntüleyin:
npm run worker:logs
Yeni bir Claude Code oturumu başlatarak bağlam alımını test edin. Önceki oturumlardan gelen bağlamın başlangıç istemine otomatik olarak yüklendiğini görmelisiniz.
Veri Depolama ve Yapılandırma
Claude-mem tüm verileri yerel olarak ~/.claude-mem/ dizininde saklar:
- Veritabanı:
~/.claude-mem/claude-mem.db(FTS5 aramalı SQLite) - PID dosyası:
~/.claude-mem/.worker.pid - Port dosyası:
~/.claude-mem/.worker.port - Günlükler:
~/.claude-mem/logs/worker-YYYY-MM-DD.log - Ayarlar:
~/.claude-mem/settings.json
Varsayılan veri dizinini bir ortam değişkeniyle geçersiz kılın:
export CLAUDE_MEM_DATA_DIR=/ozel/yol
Yapılandırma Seçenekleri
Ayarlar ~/.claude-mem/settings.json dosyasında yönetilir (ilk çalıştırmada otomatik olarak oluşturulur). Temel yapılandırmalar şunları içerir:
CLAUDE_MEM_CONTEXT_OBSERVATIONS: Oturum başlangıcında enjekte edilen gözlem sayısı (varsayılan: 50)CLAUDE_MEM_FOLDER_INDEX_ENABLED: Klasörlerde otomatik olarak oluşturulan CLAUDE.md dosyalarını etkinleştir/devre dışı bırak- Yapay zeka destekli sıkıştırma için model seçimi
- Çalışan bağlantı noktası ve ana bilgisayar ayarları
- Günlük seviyesi yapılandırması
Claude-mem Bağlamı Nasıl Yakalar ve İşler?
Claude Code'u claude-mem etkinleştirilmiş olarak kullandığınızda, sistem her araç çağrısını otomatik olarak yakalar. Claude bir dosyayı okusun, bir bash komutunu yürütsün, glob desenleriyle arama yapsın veya kodu düzenlesin, claude-mem girdiyi ve çıktıyı gözlemler.
Çalışan hizmeti bu gözlemleri işler ve şunları çıkarır:
- Başlık: Ne olduğuna dair kısa açıklama
- Alt Başlık: Ek bağlam
- Anlatı: Etkinliğin ayrıntılı açıklaması
- Gerçekler: Madde işaretli temel öğrenmeler
- Kavramlar: Arama için ilgili etiketler ve kategoriler
- Tür: Sınıflandırma (karar, hata düzeltme, özellik, yeniden düzenleme, keşif, değişiklik)
- Dosyalar: Hangi dosyalar okundu veya değiştirildi
Bu sıkıştırma, manuel müdahale olmadan otomatik olarak gerçekleşir. Ham araç çıktısı 5.000 token olabilir, ancak veritabanında depolanan anlamsal gözlem yaklaşık 500 tokendir – anlamı korurken gürültüyü ortadan kaldırır.
Oturum Özetleri
Claude yanıt vermeyi bitirdiğinde (Durdur kancasını tetikleyerek), claude-mem otomatik olarak şunları içeren bir oturum özeti oluşturur:
- İstek: Ne istediğiniz
- İncelenen: Claude'un yanıtlamak için keşfettikleri
- Öğrenilen: Temel keşifler ve içgörüler
- Tamamlanan: Ne başarıldı
- Sonraki Adımlar: Önerilen takip eylemleri
Bu özetler, hem ayrıntılı bilgi hem de üst düzey anlatı bağlamı sağlayarak, gelecekteki oturumlara bireysel gözlemlerle birlikte enjekte edilir.
Belleğinizi Sorgulamak için MCP Arama Araçlarını Kullanma
Claude-mem, token açısından verimli 3 katmanlı bir iş akışı modelini izleyen dört MCP aracı sunar. Bu tasarım, tam ayrıntıları almadan önce filtreleme yaparak yaklaşık 10 kat token tasarrufu sağlayarak, ilgili bağlamı aşamalı olarak alır.
3 Katmanlı İş Akışı
search: Kimliklerle kompakt bir dizin alın (sonuç başına ~50-100 token)timeline: İlginç sonuçlar etrafında kronolojik bağlam alınget_observations: YALNIZCA filtrelenmiş kimlikler için tam ayrıntıları getirin (sonuç başına ~500-1.000 token)
Bu yaklaşım, tam ayrıntıları almadan önce filtreleme yaparak yaklaşık 10 kat token tasarrufu sağlar.
Mevcut MCP Araçları
search: Bellek dizinini tam metin sorgularıyla arayın. Türe, tarihe veya projeye göre filtreleyin.timeline: Belirli bir gözlem veya sorgu etrafında kronolojik bağlam alın. Belirli bir karara veya hata düzeltmesine neyin yol açtığını anlamak için kullanışlıdır.get_observations: Kimliklere göre tam gözlem ayrıntılarını getirin. Ek yükü en aza indirmek için her zaman birden fazla kimliği tek bir çağrıda toplu olarak işleyin.__IMPORTANT: Bellek sistemini etkili bir şekilde nasıl kullanacağınızı açıklayan, Claude için her zaman görünür olan İş Akışı belgeleri.
Örnek Kullanım Desenleri
Belirli bir hata düzeltmesini bulun:
// Adım 1: Hatayı arayın
search(query="kimlik doğrulama hatası", type="bugfix", limit=10)
// Adım 2: Dizini inceleyin, ilgili kimlikleri belirleyin (örn. #123, #456)
// Adım 3: İlgili gözlemler için tam ayrıntıları getirin
get_observations(ids=[123, 456])
Son mimari kararları keşfedin:
search(query="veritabanı şeması", type="decision", limit=5)
Belirli bir dosya ile ilgili her şeyi bulun:
search(query="worker-service.ts", limit=20)
Doğal Dil Sorguları
Claude'a proje geçmişiniz hakkında doğal bir şekilde soru sorabilirsiniz:
- "Hata yönetimi hakkında neye karar vermiştik?"
- "Kimlik doğrulamayı nasıl uyguladık?"
- "API katmanında hangi hataları düzelttik?"
- "Veritabanı şemasındaki değişiklikleri göster"
Claude, ilgili bağlamı almak için uygun MCP araçlarını otomatik olarak çağırır ve bulguları, belirli gözlemleri referans alan claude-mem:// URI atıflarıyla sunar.
Klasör Bağlam Dosyaları ve CLAUDE.md Otomatik Oluşturma
Claude-mem, proje klasörlerinde otomatik olarak CLAUDE.md dosyaları oluşturarak, küresel bellek veritabanını tamamlayan etkinlik zaman çizelgeleri yaratır.
Klasör Bağlamı Nasıl Çalışır?
Bir klasördeki dosyalarla çalıştığınızda, claude-mem:
- Dokunulan dosyalardan benzersiz klasör yollarını tanımlar
- Her klasörle ilgili son gözlemleri sorgular
- Biçimlendirilmiş bir etkinlik zaman çizelgesi oluşturur
- Bunu o klasördeki CLAUDE.md dosyasına yazar (
<claude-mem-context>etiketlerinin içine)
Her klasörün CLAUDE.md dosyası, gözlem kimliklerini, zaman damgalarını, tür göstergelerini (hata düzeltmeleri, özellikler, keşifler), kısa başlıkları ve tahmini token sayılarını gösteren bir Son Etkinlik bölümü içerir.
Kullanıcı İçeriğini Koruma
Otomatik olarak oluşturulan içerik <claude-mem-context> etiketleri içine alınır. Bu etiketlerin dışında yazdığınız herhangi bir içerik, dosya yeniden oluşturulduğunda korunur. Bu sayede:
- Oluşturulan bölümün üstüne veya altına kendi dokümantasyonunuzu ekleyebilirsiniz
- Claude için klasöre özgü talimatlar yazabilirsiniz
- Mimari notları veya kuralları dahil edebilirsiniz
Örnek CLAUDE.md yapısı:
# Kimlik Doğrulama Modülü
Bu klasör, kimlik doğrulama ile ilgili tüm kodları içerir.
Yeni kimlik doğrulama sağlayıcıları için belirlenmiş desenleri takip edin.
<claude-mem-context>
# Son Etkinlik
| Kimlik | Zaman | Tür | Başlık | Tokenler |
|----|------|------|-------|--------|
| #1234 | 16:30 | 🔵 | Kullanıcı kimlik doğrulaması uygulandı | ~250 |
| #1235 | 16:45 | 🔴 | Giriş yönlendirme hatası düzeltildi | ~180 |
</claude-mem-context>
## Manuel Notlar
- OAuth sağlayıcıları /providers/ dizinine gider
- Oturum yönetimi Redis kullanır
Gizlilik Kontrolleri ve Güvenlik
Claude-mem, hassas verilerin bellek sistemine girmesini önlemek için ayrıntılı gizlilik kontrolleri sağlar.
Özel İçerik Etiketleri
Hassas içeriği <private> etiketleri arasına alarak depolamadan hariç tutun:
<private>
API_KEY=sk-live-abc123xyz789
DATABASE_PASSWORD=süpergizli456
</private>
Kenar işleme, özel içeriğin asla veritabanına ulaşmamasını sağlar. Bu, API anahtarları, kimlik bilgileri ve tescilli mantık için kritik öneme sahiptir.
Çift Etiketli Gizlilik Sistemi
Claude-mem çift etiketli bir yaklaşım kullanır:
<private>: Hassas içerik için kullanıcı kontrollü gizlilik<claude-mem-context>: Sistem seviyesi etiketler, özyinelemeli gözlem depolamasını önler
Web Görüntüleyici Kullanıcı Arayüzü ve Gerçek Zamanlı İzleme
Claude-mem, gerçek zamanlı bellek akışı görselleştirmesi için http://localhost:37777 adresinde bir web görüntüleyici çalıştırır. Arayüz şunları gösterir:
- Önem derecesi için emoji göstergeleriyle canlı gözlem akışı
- Kronolojik işaretleyicilerle oturum zaman çizelgesi
- Bellekleri sorgulamak için arama arayüzü
- Yapılandırma ayarlamaları için ayarlar paneli
- Kararlı ve beta kanalları arasında sürüm değiştirme
Bu kullanıcı arayüzü, temel kullanım için isteğe bağlıdır, ancak claude-mem'in neyi yakaladığını ve geliştirme geçmişinizi nasıl düzenlediğini anlamak için paha biçilmezdir.
Beta Özellikleri: Sonsuz Mod
Beta kanalı, uzun süreli oturumlar için biyomimetik bir bellek mimarisi olan Sonsuz Mod'u sunar. 50 araç kullanımından sonra bağlam sınırlarına ulaşmak yerine, Sonsuz Mod yaklaşık 1.000 kullanım vaat eder – 20 kat artış. Bunu, araç çıktılarını gerçek zamanlı olarak sıkıştırarak, tokenleri yaklaşık %95 oranında azaltarak ve ölçeklendirmeyi O(N²) kareselden O(N) doğrusala değiştirerek başarır.
Değiş Tokuş: Gözlem oluşturma, araç çağrısı başına 60-90 saniye ekler. Günler veya haftalar süren derin, düşünceli kodlama oturumları için bu gecikme kabul edilebilir olabilir. Hızlı araç kullanımı için bu kısıtlayıcı olabilir.
http://localhost:37777 → Ayarlar → Sürüm Kanalı adresindeki web görüntüleyici kullanıcı arayüzünden beta özelliklerini etkinleştirin.
Sık Karşılaşılan Sorunları Giderme
Çalışan Hizmeti Başlamıyor
Çalışan hizmeti 37777 numaralı bağlantı noktasında başlamazsa:
- Bağlantı noktasının zaten dolu olup olmadığını kontrol edin:
lsof -i :37777
- Alternatif bir bağlantı noktası yapılandırın:
export CLAUDE_MEM_WORKER_PORT=8080
- Çalışanı manuel olarak başlatın:
bun plugin/scripts/worker-service.cjs
Bellek Kaydedilmiyor
Claude önceki oturumları hatırlamıyorsa:
- Çalışanın çalıştığını doğrulayın:
npm run worker:status
- Veritabanı dosyasının mevcut olduğunu kontrol edin:
ls -la ~/.claude-mem/claude-mem.db
- Hatalar için çalışan günlüklerini inceleyin:
npm run worker:logs
Bağlam Enjeksiyonu Sorunları
Oturum başlangıcında çok fazla veya çok az bağlam görünüyorsa:
Gözlem sınırını ayarlayın:
export CLAUDE_MEM_CONTEXT_OBSERVATIONS=10 # Azalt
export CLAUDE_MEM_CONTEXT_OBSERVATIONS=100 # Arttır
Boş CLAUDE.md Dosyaları
Eğer claude-mem projeniz genelinde boş CLAUDE.md dosyaları oluşturuyorsa, bu v9.0.5'te bilinen bir sorundur. Mevcut geçici çözümler arasında, oluşturulan dizinleri manuel olarak silmek, .gitignore dosyasına desenler eklemek veya sonraki bir sürümdeki düzeltmeyi beklemek yer alır.
Claude Masaüstü Entegrasyonu
Claude-mem, Claude Masaüstü ile MCP sunucu yapılandırması aracılığıyla çalışır. MCP arama sunucusunu Claude Masaüstü yapılandırmanıza ekleyin, claude-mem kurulumundaki MCP sunucu betiğini işaret edin ve Claude Masaüstü'nü yeniden başlatın.
Yapılandırıldıktan sonra, geçmiş çalışmalar hakkında doğal bir şekilde soru sorun:
- "Geçen oturumda ne yaptık?"
- "Bu hatayı daha önce düzelttik mi?"
- "Kimlik doğrulamayı nasıl uyguladık?"
Belleklerin yakalandığını doğrulamak için localhost:37777 adresindeki web görüntüleyiciyi kullanın ve bağlantı başarısız olursa Claude Masaüstü günlüklerini kontrol edin.
Manuel Çalışan Yönetim Komutları
claude-mem dizininden çalışan hizmetini yönetebilirsiniz:
npm run worker:start # Çalışan hizmetini başlat
npm run worker:stop # Çalışan hizmetini durdur
npm run worker:restart # Çalışan hizmetini yeniden başlat
npm run worker:logs # Çalışan günlüklerini görüntüle
npm run worker:status # Çalışan durumunu kontrol et
Sonuç
Claude-mem, Claude Code'u durumsuz bir asistandan, zamanla kod tabanınız hakkında bilgi biriktiren kalıcı bir geliştirme ortağına dönüştürür. Araç kullanımını otomatik olarak yakalayarak, gözlemleri aranabilir belleklere sıkıştırarak ve ilgili bağlamı akıllıca alarak, yapay zeka destekli geliştirmeyi yavaşlatan tekrarlayan bağlam oluşturma işlemini ortadan kaldırır.
Sistemin aşamalı ifşa mimarisi – MCP araçlarıyla katmanlı alma, klasör tabanlı CLAUDE.md dosyaları ve gizlilik kontrolleri – manuel bağlam yönetimine kıyasla yaklaşık 10 kat token verimliliği sağlarken, eksiksiz veri yerelliği ve güvenliğini sürdürür.
Claude-mem ile geliştirilmiş iş akışınızda API'ler oluştururken veya harici hizmetlerle çalışırken, Apidog ile testlerinizi kolaylaştırın. Kalıcı bellek kurulumunuzu tamamlayan görsel API testi, otomatik dokümantasyon oluşturma ve işbirliğine dayalı hata ayıklama sunar.
düğme