Bagaimana jika asisten AI Anda mengingat setiap keputusan arsitektur, perbaikan bug, dan sesi refactoring selama berminggu-minggu pengembangan? Claude-mem menghilangkan masalah konteks yang hilang dengan secara otomatis menangkap observasi penggunaan alat, mengompresnya menjadi ringkasan semantik, dan menyuntikkan riwayat yang relevan ke setiap sesi Claude Code yang baru.
Masalah: Amnesia Konteks dalam Pengembangan Berbantuan AI
Setiap sesi Claude Code dimulai dari awal. Saat Anda menutup terminal atau memutuskan sambungan dari sesi, Claude melupakan segalanya; struktur proyek Anda, keputusan refactoring terbaru, penemuan debugging, dan pola arsitektur. Ini memaksa Anda untuk berulang kali menjelaskan basis kode Anda, menghabiskan token untuk konteks yang berlebihan dan mengganggu kelangsungan alur kerja.
Pengembang saat ini mengatasi masalah ini dengan secara manual memelihara file CLAUDE.md, mencatat di dokumen terpisah, atau menjelaskan kembali konteks proyek di awal setiap sesi. Pendekatan ini rapuh, memakan waktu, dan tidak pernah menangkap kekayaan penuh riwayat pengembangan Anda. Claude-mem menyelesaikannya dengan secara otomatis mengamati setiap pemanggilan alat, mengompres output menjadi memori semantik yang dapat dicari, dan secara cerdas mengambil konteks yang relevan saat Anda membutuhkannya.
Ingin platform All-in-One terintegrasi untuk Tim Pengembang Anda bekerja sama dengan produktivitas maksimal?
Apidog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!
Memahami Arsitektur Claude-mem
Claude-mem beroperasi sebagai sistem kompresi memori persisten yang terhubung ke siklus hidup Claude Code. Ini menangkap output alat—biasanya 1.000 hingga 10.000 token—dan mengompresnya menjadi observasi semantik sekitar 500 token menggunakan SDK Agen Claude. Observasi ini dikategorikan berdasarkan jenis (keputusan, perbaikan bug, fitur, refactor, penemuan, perubahan) dan ditandai dengan konsep dan referensi file yang relevan, kemudian disimpan dalam basis data SQLite lokal dengan kemampuan pencarian teks lengkap.
Sistem ini menggunakan lima hook siklus hidup untuk menangkap konteks:
- SessionStart: Menyuntikkan konteks dari sesi sebelumnya saat Anda memulai
- UserPromptSubmit: Menangkap kueri Anda untuk pengenalan pola
- PostToolUse: Mengamati setiap eksekusi alat dan outputnya
- Stop: Menghasilkan ringkasan sesi saat Claude selesai merespons
- SessionEnd: Menyelesaikan penyimpanan sesi dan pembersihan
Arsitektur ini memungkinkan pengungkapan progresif—sistem pengambilan memori berlapis yang menyeimbangkan cakupan dengan efisiensi token. Alih-alih membuang seluruh riwayat Anda ke dalam konteks, Claude-mem mengambil observasi secara berlapis, menghemat sekitar 2.250 token per sesi dibandingkan dengan manajemen konteks manual.
Instalasi dan Persyaratan Sistem
Claude-mem membutuhkan Node.js 18.0.0 atau lebih tinggi, Claude Code terbaru dengan dukungan plugin, dan Bun sebagai runtime JavaScript dan manajer proses (terinstal otomatis jika tidak ada). SQLite 3 dibundel untuk penyimpanan persisten. Plugin ini berfungsi lintas platform di Windows, macOS, dan Linux.
Instalasi Cepat
Instal Claude-mem langsung dari marketplace plugin dengan dua perintah:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
Mulai ulang Claude Code setelah instalasi. Plugin secara otomatis mengunduh biner pre-built, menginstal dependensi termasuk Bun dan SQLite, mengonfigurasi hook untuk manajemen siklus hidup sesi, dan secara otomatis memulai layanan worker pada sesi pertama Anda.
Instalasi Lanjutan dari Sumber
Untuk pengembangan atau pengujian, kloning dan bangun dari sumber di github:
git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem
npm install
npm run build
npm run worker:start
Pendekatan ini berguna jika Anda perlu memodifikasi plugin atau menjalankan fitur beta seperti Endless Mode.
Verifikasi Pasca-Instalasi
Setelah instalasi, verifikasi semuanya berfungsi:
- Periksa instalasi plugin:
cat plugin/hooks/hooks.json
- Verifikasi bahwa layanan worker berjalan:
curl http://localhost:37777/api/health
- Lihat log worker terbaru:
npm run worker:logs
Uji pengambilan konteks dengan memulai sesi Claude Code yang baru. Anda akan melihat konteks dari sesi sebelumnya secara otomatis dimuat dalam prompt awal.
Penyimpanan Data dan Konfigurasi
Claude-mem menyimpan semua data secara lokal di ~/.claude-mem/:
- Basis Data:
~/.claude-mem/claude-mem.db(SQLite dengan pencarian FTS5) - File PID:
~/.claude-mem/.worker.pid - File Port:
~/.claude-mem/.worker.port - Log:
~/.claude-mem/logs/worker-YYYY-MM-DD.log - Pengaturan:
~/.claude-mem/settings.json
Timpa direktori data default dengan variabel lingkungan:
export CLAUDE_MEM_DATA_DIR=/custom/path
Opsi Konfigurasi
Pengaturan dikelola di ~/.claude-mem/settings.json (dibuat secara otomatis saat pertama kali dijalankan). Konfigurasi utama meliputi:
CLAUDE_MEM_CONTEXT_OBSERVATIONS: Jumlah observasi yang disuntikkan saat sesi dimulai (default: 50)CLAUDE_MEM_FOLDER_INDEX_ENABLED: Mengaktifkan/menonaktifkan file CLAUDE.md yang dibuat otomatis di folder- Pemilihan model untuk kompresi bertenaga AI
- Pengaturan port dan host worker
- Konfigurasi level log
Bagaimana Claude-mem Menangkap dan Memproses Konteks
Saat Anda menggunakan Claude Code dengan claude-mem diaktifkan, sistem secara otomatis menangkap setiap pemanggilan alat. Baik Claude membaca file, menjalankan perintah bash, mencari dengan pola glob, atau mengedit kode, claude-mem mengamati input dan output.
Layanan worker memproses observasi ini dan mengekstrak:
- Judul: Deskripsi singkat tentang apa yang terjadi
- Subjudul: Konteks tambahan
- Narasi: Penjelasan rinci tentang aktivitas
- Fakta: Pembelajaran utama sebagai poin-poin
- Konsep: Tag dan kategori yang relevan untuk pencarian
- Jenis: Klasifikasi (keputusan, perbaikan bug, fitur, refactor, penemuan, perubahan)
- File: File mana yang dibaca atau dimodifikasi
Kompresi ini terjadi secara otomatis tanpa intervensi manual. Output alat mentah mungkin 5.000 token, tetapi observasi semantik yang disimpan dalam basis data kira-kira 500 token—mempertahankan makna sambil menghilangkan kebisingan.
Ringkasan Sesi
Saat Claude selesai merespons (memicu hook Stop), claude-mem secara otomatis menghasilkan ringkasan sesi yang berisi:
- Permintaan: Apa yang Anda minta
- Diselidiki: Apa yang Claude jelajahi untuk menjawab
- Dipahami: Penemuan dan wawasan utama
- Selesai: Apa yang telah dicapai
- Langkah Berikutnya: Tindakan tindak lanjut yang direkomendasikan
Ringkasan ini disuntikkan ke sesi mendatang bersama dengan observasi individual, memberikan detail yang terperinci dan konteks naratif tingkat tinggi.
Menggunakan Alat Pencarian MCP untuk Mengkueri Memori Anda
Claude-mem mengekspos empat alat MCP yang mengikuti pola alur kerja 3 lapis yang efisien token. Desain ini mengambil konteks secara progresif, meminimalkan penggunaan token sambil memaksimalkan relevansi.
Alur Kerja 3 Lapis
search: Dapatkan indeks ringkas dengan ID (~50-100 token per hasil)timeline: Dapatkan konteks kronologis seputar hasil yang menarikget_observations: Ambil detail lengkap HANYA untuk ID yang difilter (~500-1.000 token per hasil)
Pendekatan ini mencapai penghematan token sekitar 10x dengan memfilter sebelum mengambil detail lengkap.
Alat MCP yang Tersedia
search: Cari indeks memori dengan kueri teks lengkap. Filter berdasarkan jenis, tanggal, atau proyek.timeline: Dapatkan konteks kronologis di sekitar observasi atau kueri tertentu. Berguna untuk memahami apa yang menyebabkan keputusan atau perbaikan bug tertentu.get_observations: Ambil detail observasi lengkap berdasarkan ID. Selalu gabungkan beberapa ID dalam satu panggilan untuk meminimalkan overhead.__IMPORTANT: Dokumentasi alur kerja yang selalu terlihat oleh Claude, menjelaskan cara menggunakan sistem memori secara efektif.
Contoh Pola Penggunaan
Temukan perbaikan bug tertentu:
// Langkah 1: Cari bug
search(query="authentication bug", type="bugfix", limit=10)
// Langkah 2: Tinjau indeks, identifikasi ID yang relevan (misalnya, #123, #456)
// Langkah 3: Ambil detail lengkap untuk observasi yang relevan
get_observations(ids=[123, 456])
Jelajahi keputusan arsitektur terbaru:
search(query="database schema", type="decision", limit=5)
Temukan semua yang terkait dengan file tertentu:
search(query="worker-service.ts", limit=20)
Kueri Bahasa Alami
Anda dapat bertanya kepada Claude secara alami tentang riwayat proyek Anda:
- "Apa yang kita putuskan tentang penanganan error?"
- "Bagaimana kita mengimplementasikan otentikasi?"
- "Bug apa yang kita perbaiki di lapisan API?"
- "Tunjukkan perubahan pada skema basis data"
Claude secara otomatis memanggil alat MCP yang sesuai untuk mengambil konteks yang relevan, menyajikan temuan dengan kutipan URI claude-mem:// yang mereferensikan observasi tertentu.
File Konteks Folder dan Pembuatan Otomatis CLAUDE.md
Claude-mem secara otomatis menghasilkan file CLAUDE.md di folder proyek, membuat garis waktu aktivitas yang melengkapi basis data memori global.
Bagaimana Konteks Folder Bekerja
Saat Anda bekerja dengan file di dalam folder, claude-mem:
- Mengidentifikasi jalur folder unik dari file yang disentuh
- Mengkueri observasi terbaru yang relevan dengan setiap folder
- Menghasilkan garis waktu aktivitas yang diformat
- Menulisnya ke CLAUDE.md di folder tersebut (di dalam tag
<claude-mem-context>)
Setiap CLAUDE.md folder berisi bagian Aktivitas Terbaru yang menampilkan ID observasi, stempel waktu, indikator jenis (perbaikan bug, fitur, penemuan), judul singkat, dan perkiraan jumlah token.
Pelestarian Konten Pengguna
Konten yang dibuat secara otomatis dibungkus dalam tag <claude-mem-context>. Setiap konten yang Anda tulis di luar tag ini akan dipertahankan saat file dibuat ulang. Ini memungkinkan Anda untuk:
- Menambahkan dokumentasi Anda sendiri di atas atau di bawah bagian yang dihasilkan
- Menulis instruksi khusus folder untuk Claude
- Menyertakan catatan arsitektur atau konvensi
Contoh struktur CLAUDE.md:
# Modul Otentikasi
Folder ini berisi semua kode yang terkait dengan otentikasi.
Ikuti pola yang telah ditetapkan untuk penyedia otentikasi baru.
<claude-mem-context>
# Aktivitas Terbaru
| ID | Waktu | Tipe | Judul | Token |
|----|------|------|-------|--------|
| #1234 | 16:30 | 🔵 | Mengimplementasikan otentikasi pengguna | ~250 |
| #1235 | 16:45 | 🔴 | Memperbaiki bug pengalihan login | ~180 |
</claude-mem-context>
## Catatan Manual
- Penyedia OAuth berada di /providers/
- Penanganan sesi menggunakan Redis
Kontrol Privasi dan Keamanan
Claude-mem menyediakan kontrol privasi granular untuk mencegah data sensitif masuk ke sistem memori.
Tag Konten Pribadi
Bungkus konten sensitif dalam tag <private> untuk mengecualikannya dari penyimpanan:
<private>
API_KEY=sk-live-abc123xyz789
DATABASE_PASSWORD=supersecret456
</private>
Pemrosesan di tepi (edge processing) memastikan konten pribadi tidak pernah mencapai basis data. Ini sangat penting untuk kunci API, kredensial, dan logika proprietary.
Sistem Privasi Dua Tag
Claude-mem menggunakan pendekatan dua tag:
<private>: Privasi yang dikontrol pengguna untuk konten sensitif<claude-mem-context>: Tag tingkat sistem mencegah penyimpanan observasi rekursif
UI Penampil Web dan Pemantauan Real-Time
Claude-mem menjalankan penampil web di http://localhost:37777 untuk visualisasi aliran memori secara real-time. Antarmuka ini menampilkan:
- Aliran observasi langsung dengan indikator emoji untuk kepentingan
- Garis waktu sesi dengan penanda kronologis
- Antarmuka pencarian untuk mengkueri memori
- Panel pengaturan untuk penyesuaian konfigurasi
- Pergantian versi antara saluran stabil dan beta
UI ini bersifat opsional untuk penggunaan dasar tetapi sangat berharga untuk memahami apa yang ditangkap claude-mem dan bagaimana ia mengatur riwayat pengembangan Anda.
Fitur Beta: Mode Tanpa Batas (Endless Mode)
Saluran beta menawarkan Mode Tanpa Batas (Endless Mode), arsitektur memori biomimetik untuk sesi yang diperpanjang. Alih-alih mencapai batas konteks setelah 50 penggunaan alat, Endless Mode menjanjikan sekitar 1.000 penggunaan—peningkatan 20 kali lipat. Ini dicapai dengan mengompres output alat secara real-time, mengurangi token sekitar 95% dan mengubah penskalaan dari kuadrat O(N²) menjadi linear O(N).
Kompromi: Pembuatan observasi menambah 60-90 detik per pemanggilan alat. Untuk sesi pengkodean mendalam dan penuh pertimbangan yang berlangsung berhari-hari atau berminggu-minggu, latensi ini mungkin dapat diterima. Untuk penggunaan alat yang cepat, ini bisa menjadi penghalang.
Aktifkan fitur beta dari UI penampil web di http://localhost:37777 → Pengaturan → Saluran Versi.
Pemecahan Masalah Umum
Layanan Worker Tidak Dimulai
Jika worker gagal dimulai pada port 37777:
- Periksa apakah port sudah ditempati:
lsof -i :37777
- Konfigurasi port alternatif:
export CLAUDE_MEM_WORKER_PORT=8080
- Mulai worker secara manual:
bun plugin/scripts/worker-service.cjs
Memori Tidak Disimpan
Jika Claude tidak mengingat sesi sebelumnya:
- Verifikasi bahwa worker berjalan:
npm run worker:status
- Periksa apakah file basis data ada:
ls -la ~/.claude-mem/claude-mem.db
- Tinjau log worker untuk kesalahan:
npm run worker:logs
Masalah Injeksi Konteks
Jika terlalu banyak atau terlalu sedikit konteks muncul di awal sesi:
Sesuaikan batas observasi:
export CLAUDE_MEM_CONTEXT_OBSERVATIONS=10 # Kurangi
export CLAUDE_MEM_CONTEXT_OBSERVATIONS=100 # Tingkatkan
File CLAUDE.md Kosong
Jika claude-mem membuat file CLAUDE.md kosong di seluruh proyek Anda, ini adalah masalah yang diketahui di v9.0.5. Solusi sementara saat ini termasuk menghapus direktori yang dibuat secara manual, menambahkan pola ke .gitignore, atau menunggu perbaikan di rilis berikutnya.
Integrasi Desktop Claude
Claude-mem berfungsi dengan Claude Desktop melalui konfigurasi server MCP. Tambahkan server mcp-search ke konfigurasi Claude Desktop Anda, arahkan ke skrip server MCP di instalasi claude-mem, dan mulai ulang Claude Desktop.
Setelah dikonfigurasi, tanyakan secara alami tentang pekerjaan sebelumnya:
- "Apa yang kita lakukan di sesi terakhir?"
- "Apakah kita pernah memperbaiki bug ini sebelumnya?"
- "Bagaimana kita mengimplementasikan otentikasi?"
Gunakan penampil web di localhost:37777 untuk memverifikasi memori sedang ditangkap dan periksa log Claude Desktop jika koneksi gagal.
Perintah Manajemen Worker Manual
Dari direktori claude-mem, Anda dapat mengelola layanan worker:
npm run worker:start # Mulai layanan worker
npm run worker:stop # Hentikan layanan worker
npm run worker:restart # Mulai ulang layanan worker
npm run worker:logs # Lihat log worker
npm run worker:status # Periksa status worker
Kesimpulan
Claude-mem mengubah Claude Code dari asisten tanpa status menjadi mitra pengembangan persisten yang mengumpulkan pengetahuan tentang basis kode Anda seiring waktu. Dengan secara otomatis menangkap penggunaan alat, mengompres observasi menjadi memori yang dapat dicari, dan secara cerdas mengambil konteks yang relevan, ini menghilangkan pembangunan konteks berulang yang memperlambat pengembangan berbantuan AI.
Arsitektur pengungkapan progresif sistem—pengambilan berlapis dengan alat MCP, file CLAUDE.md berbasis folder, dan kontrol privasi—memberikan efisiensi token sekitar 10x dibandingkan dengan manajemen konteks manual sambil mempertahankan lokalitas data dan keamanan yang lengkap.
Saat membangun API atau bekerja dengan layanan eksternal dalam alur kerja yang ditingkatkan Claude-mem Anda, optimalkan pengujian Anda dengan Apidog. Ini menawarkan pengujian API visual, pembuatan dokumentasi otomatis, dan debugging kolaboratif yang melengkapi pengaturan memori persisten Anda.