|

Cara Memasang claude-mem dengan 100 Ribu Bintang? Hubungkan Memori dalam 3 Langkah dan Hindari Jebakan Uji Coba

Cara Memasang claude-mem dengan 100 Ribu Bintang? Hubungkan Memori dalam 3 Langkah dan Hindari Jebakan Uji Coba

Claude Code lupa apa yang diubah pada sesi sebelumnya setiap kali ditutup dan dibuka lagi. Karena itu, banyak orang memasang claude-mem, yang punya 100 ribu bintang di GitHub. Boleh dipasang, tapi jangan asal tekan Enter di setiap langkah instalasi. Installer v15 per Oktober 2026 secara default memilih observer terkelola CMEM Pro, yang dikenai biaya $30/bulan setelah uji coba 30 hari berakhir. Kalau tidak mau membayar biaya bulanan, tambahkan --provider claude saat instalasi, atau ganti observer agar menggunakan kunci API sendiri setelahnya.

Ini bukan artikel promosi yang menjanjikan “pasang sekali, ingat selamanya”. Pembahasan di bawah dibagi berdasarkan sumbernya: “klaim resmi / kasus tunggal dari pihak ketiga / pengujian saya / belum diketahui”. Semua data diperiksa pada 2026-10-30.

claude-mem-cross-session-memory-install-guide-id-image-0


Poin penting claude-mem

Lihat tabel ini dulu untuk memutuskan apakah kamu perlu membaca lebih lanjut.

Poin Penjelasan Dampaknya untuk kamu
Popularitas GitHub thedotmack/claude-mem, 105.017 stars, Apache-2.0 (data GitHub API per 2026-10-30) Jumlah stars hanya menunjukkan popularitas. Soal cocok atau tidak, kamu tetap perlu menilainya sendiri
Versi Versi terbaru di npm dan GitHub release sama-sama 15.6.0 (2026-10-29); badge README tertulis 15.7.0, jadi tidak cocok Jadikan versi npm sebagai acuan, jangan terkecoh oleh badge
Berbayar secara default Installer secara default memilih CMEM Pro, dengan biaya $30/bulan setelah uji coba 30 hari Jika tidak ingin berlangganan, pilih opsi lain
Opsi tanpa biaya bulanan Gunakan --provider claude dengan paket Claude milikmu, atau ubah pengaturan setelah instalasi untuk memakai key sendiri Biaya akan diambil dari kuota paket atau saldo API
Tidak sepenuhnya lokal Model observer akan membaca isi pemanggilan tool kamu Pertimbangkan dulu jika menangani repositori sensitif

📷 Tempat tangkapan layar, tambahkan saat pengeditan: halaman utama repositori GitHub (thedotmack/claude-mem, menampilkan jumlah stars dan release terbaru)

Apa sebenarnya yang diingat claude-mem

Singkatnya, claude-mem adalah lapisan memori yang berjalan di komputer lokal, bukan model chat baru atau catatan cloud. Ia menangkap hal-hal yang terjadi selama sesi, memampatkannya untuk disimpan, lalu memasukkannya kembali ke Claude saat sesi berikutnya dimulai.

Seluruh alurnya terdiri dari 5 tahap:

  1. hooks (kait siklus hidup): Claude Code memicu event saat sesi dimulai, prompt dikirim, sebelum dan sesudah pemanggilan tool, serta saat sesi dihentikan dan berakhir. claude-mem memasang hook pada titik-titik tersebut.
  2. worker: layanan HTTP yang berjalan di komputer lokal menggunakan Bun dan bertugas menerima event dari hook. Port default-nya adalah 37700 + (uid % 100), jadi tidak selalu 37700.
  3. observer (model pengamat): worker menyerahkan data mentah pemanggilan tool ke sebuah model untuk dipampatkan menjadi observation terstruktur.
  4. observation (catatan pengamatan): setiap catatan berisi jenis, judul, narasi, dan file terkait, lalu disimpan di ~/.claude-mem/claude-mem.db (SQLite). Indeks vektor disimpan di ~/.claude-mem/chroma/ (Chroma adalah database vektor untuk pencarian semantik).
  5. Injeksi pada SessionStart berikutnya: saat sesi baru dimulai, observation terbaru yang relevan dengan proyek saat ini otomatis disuntikkan, secara default maksimal 50 catatan. Claude juga dapat menggunakan tool MCP (tiga lapisan search → timeline → get_observations) untuk mencari memori yang lebih lama sesuai kebutuhan.

Perlu diingat, claude-mem hanya mencatat konten yang ditangkap oleh hooks. Hal yang kamu pikirkan di luar sesi atau diskusi yang tidak melalui pemanggilan tool tidak akan otomatis masuk ke database. Selain itu, memory bawaan Claude Code (MEMORY.md) dan claude-mem adalah dua sistem berbeda yang secara default berjalan bersamaan.

claude-mem-cross-session-memory-install-guide-id-image-1


3 syarat wajib sebelum memasang claude-mem

Kalau salah satu syarat berikut belum terpenuhi, jangan buru-buru memasang:

  1. Claude Code ≥ 2.1.139: Pada versi yang lebih lama, args pada hook akan diabaikan. Akibatnya, tidak ada catatan yang dibuat dan tidak ada peringatan, sehingga sulit dilacak. Jalankan claude --version terlebih dahulu. Jika versinya belum memenuhi syarat, jalankan claude update.
  2. Node 20+: Paket npm menetapkan versi ^20.19.0 || >=22.12.0. Pastikan dengan node -v. Bun (≥1.1.31) dan uv akan dipasang otomatis oleh installer. Dalam satu pengujian pihak ketiga di Ubuntu 26.04, Bun, uv, dan Chroma bersama-sama memakai sekitar 1,2 GB ruang disk.
  3. Siap jika observer melihat isi pemanggilan alat: Apa pun jalur yang dipilih, pemanggilan alat, prompt, dan bahan ringkasan akan dikirim ke penyedia observer yang dipilih. Jika repositori berisi kunci, data pelanggan, atau kode yang belum dipublikasikan, jangan aktifkan dulu.

Pengguna Windows tidak memerlukan Git Bash untuk hook, tetapi perlu memulai ulang terminal atau IDE setelah pemasangan agar PATH baru berlaku.


Cara memilih dari 3 jalur pemasangan claude-mem

claude-mem-cross-session-memory-install-guide-id-image-2

Jalur Perlu akun cmem? Sumber biaya Konten dikirim ke Cocok untuk
A: CMEM Pro default Ya, dan uji coba perlu menghubungkan kartu Mulai $30/bulan, uji coba 30 hari Observer yang dikelola cmem.ai Yang tidak ingin mengatur key, butuh sinkronisasi cloud atau penggunaan di beberapa perangkat
B: --provider claude Tidak Menggunakan kuota paket Claude Anthropic Yang sudah berlangganan Claude
C: Pasang lewat B, lalu ganti dengan key sendiri Tidak Ditagih sesuai pemakaian penyedia Endpoint yang kamu konfigurasi, misalnya APIYI apiyi.com Yang ingin mengendalikan biaya atau sudah punya saldo API

Marketplace plugin adalah pintu masuk lain yang dijelaskan terpisah di bawah sebagai jalur C’. Jalur ketiga harus dimulai lewat B: openai-compatible bukan pilihan --provider pada installer, jadi pengaturannya hanya bisa diubah secara manual setelah pemasangan.

Jalur A: CMEM Pro bawaan (opsi default penginstal claude-mem)

  1. Jalankan npx claude-mem install.
  2. Yang akan terlihat: Pada langkah pertama, Agent yang terdeteksi sudah dipilih dan runtime akan diinstal. Langkah kedua menampilkan kode perangkat XXXX-XXXX, lalu membuka browser untuk otorisasi OAuth (jangan sampai terhenti di langkah login ini). Pada langkah ketiga, CMEM Pro sudah dipilih sebagai provider memori. Jika pilihan ini digunakan, halaman pembayaran atau uji coba akan terbuka.
  3. Ketentuan yang perlu diperhatikan (halaman harga resmi, diperiksa pada 2026-10-30):
  4. Uji coba memerlukan kartu kredit atau debit; kartu prabayar tidak bisa digunakan.
  5. Penagihan dimulai saat uji coba berakhir atau kuota yang disertakan habis, mana pun yang terjadi lebih dulu.
  6. Pengaturan upgrade otomatis dapat menaikkan langganan dari Pro ke Heavy ($70/bulan) atau Max ($100/bulan). Banyak tutorial hanya menyebutkan “no card required” dan melewatkan hal ini.
  7. Tanda berhasil: Setelah instalasi selesai, penginstal akan menampilkan Version, Plugin dir, IDEs, Account, Cloud sync, dan Worker URL. Setelah itu, jalankan 5 pemeriksaan berikutnya.

Jalur B: --provider claude, instal claude-mem tanpa biaya bulanan

  1. Jalankan npx claude-mem install --provider claude.
  2. Jika hanya ingin mempertahankan satu sistem memori, gunakan npx claude-mem install --provider claude --disable-auto-memory. Parameter ini akan menulis CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 dan menonaktifkan auto-memory bawaan Claude Code.
  3. Yang akan terlihat: Skipping claude-mem login: --provider claude runs memory on your own Anthropic plan., Cloud sync: OFF (local), Auto-memory: left enabled (jika tidak menambahkan parameter disable). Penginstal juga akan meminta Anda memilih model observer. Pilih Haiku, jangan Opus.
  4. Tanda berhasil: Tidak ada halaman login cmem atau pembayaran selama proses instalasi, dan semua pemeriksaan npx claude-mem doctor mendapat tanda centang.

Di kode sumber, hanya provider claude dan host yang tidak memerlukan login. Dalam pengujian pihak ketiga, --provider openrouter berhenti di Waiting for OAuth login in the browser…. Jadi, jika ingin menggunakan kunci dari pihak ketiga, selesaikan instalasi dengan Jalur B terlebih dahulu, lalu ubah konfigurasinya.

Rute C’: Marketplace plugin Claude Code

  1. Di Claude Code, masukkan /plugin marketplace add thedotmack/claude-mem.
  2. Lalu masukkan /plugin install claude-mem dan mulai ulang Claude Code.
  3. Apa yang akan terlihat: Pada sesi pertama, launcher masih dalam proses kompilasi, sehingga mungkin belum ada memori. Untuk menghindari jeda ini, jalankan npx claude-mem install --provider claude sekali lagi.
  4. Jangan gunakan npm install -g claude-mem: perintah ini hanya memasang pustaka SDK, tidak mendaftarkan hook atau menjalankan worker, dan malah menutupi launcher yang sebenarnya.

Cara memverifikasi instalasi claude-mem: 5 pemeriksaan

Ingat: sesi pertama adalah sesi pengumpulan. Belum ada riwayat yang bisa disuntikkan, jadi memori baru akan terlihat pada sesi kedua. Jika berharap “ia sudah mengingat saya” pada sesi pertama, Anda bisa keliru mengira instalasinya gagal.

# Pemeriksaan Perintah / tindakan Kriteria lolos
1 doctor npx claude-mem doctor Bun, uv, Plugin, Hook launcher, Worker, Claude Code version (2.1.139+), dan Chroma semuanya ✓
2 status npx claude-mem status Worker dalam kondisi sehat dan nomor port ditampilkan
3 viewer Buka http://127.0.0.1:<PORT>/ di browser; memori ada di /viewer Halaman bisa dibuka; entri terlihat setelah satu sesi dijalankan
4 sqlite count sqlite3 ~/.claude-mem/claude-mem.db "select count(*) from observations;" Nilai yang dikembalikan lebih dari 0 setelah sesi pertama berakhir
5 context inject curl "http://127.0.0.1:<PORT>/api/context/inject?project=<nama-proyek>" Konten yang dikembalikan adalah memori yang akan disuntikkan ke sesi berikutnya

Nomor port bisa dilihat di CLAUDE_MEM_WORKER_PORT dalam ~/.claude-mem/settings.json. Anda juga bisa memastikannya dengan curl http://127.0.0.1:<PORT>/api/health. Baris Hook launcher adalah bagian yang paling sering bermasalah dalam output doctor. Jika muncul not on PATH atau is not the claude-mem hook launcher, tangani dulu sebelum memeriksa bagian lain.

📷 Tempat tangkapan layar, tambahkan saat penyuntingan: halaman viewer worker (/viewer, menampilkan daftar observation)


Biaya claude-mem: Klaim resmi “hemat 96%” dan temuan pihak ketiga “+4.226 token”

Kedua angka ini benar, tetapi mengukur hal yang berbeda dan tidak bisa dibandingkan secara langsung.

  • Klaim resmi: 4 observation menggunakan sekitar 1.093 token, sementara pekerjaan aslinya menggunakan 26.447 token, sehingga “hemat sekitar 96%”. Pencarian MCP tiga lapis disebut “sekitar 10 kali lebih hemat daripada memasukkan semua data”. Angka-angka ini merupakan estimasi tim proyek, bukan hasil audit pihak ketiga.
  • Satu pengujian pihak ketiga (ComputingForGeeks, 2026-10-24, claude-mem 15.0.2, Sonnet via OpenRouter): untuk permintaan yang sama, “Reply with the single word ready”, input tanpa claude-mem berjumlah 28.489 token. Setelah diaktifkan, meski memori masih kosong, input mencapai 32.715 token, bertambah +4.226 token (sekitar +14,8%) dengan biaya tambahan $0.010. Ini hanya pengujian satu kali pada satu mesin dan satu proyek, jadi tidak mencerminkan tagihan Anda.

Kesimpulannya: “hemat” berarti memori lebih ringkas daripada catatan aslinya, sedangkan “bertambah” berarti setiap sesi harus menanggung overhead tetap tambahan. Semakin sibuk proyek dan semakin banyak entri yang dimasukkan, semakin besar overhead-nya. Pada paruh pertama 2026, pengguna di Issue #618 dan #2469 melaporkan bahwa token cepat habis. Itu adalah pengalaman pada versi lama, bukan gambaran kondisi 15.6.0 saat ini, tetapi menunjukkan bahwa memori tidak pernah gratis.

claude-mem-cross-session-memory-install-guide-id-image-3

5 pengaturan claude-mem untuk mengontrol biaya

  1. CLAUDE_MEM_CONTEXT_OBSERVATIONS: nilai default-nya 50. Turunkan ke 10–20 untuk langsung mengurangi jumlah observasi yang disisipkan.
  2. CLAUDE_MEM_SEMANTIC_INJECT: biarkan pada nilai default false. Jika diaktifkan, memori yang relevan akan ditambahkan ke setiap petunjuk.
  3. CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES: biarkan pada nilai default false. Jika tidak, memori dari semua host akan disisipkan.
  4. CLAUDE_MEM_DISABLE_TOOL_HOOKS=1: nonaktifkan observasi pada tingkat pemanggilan tool dan hanya simpan ringkasan sesi. Ini menghemat token sekaligus mengurangi beban proses.
  5. CLAUDE_MEM_OPENAI_COMPAT_OBSERVATION_BATCH_SIZE: nilai default-nya 1. Naikkan secara bertahap saat terjadi penumpukan peristiwa; jangan langsung mengaturnya ke 32.

Perbandingan biaya tiga opsi

Opsi Metode penagihan Harga (USD) Cocok untuk
CMEM Pro Langganan $30/bulan, uji coba 30 hari (Heavy $70, Max $100) Pengguna intensif yang membutuhkan sinkronisasi cloud
Paket Claude Menggunakan kuota langganan Tidak dikenakan biaya terpisah, tetapi berbagi kuota dengan aktivitas penulisan kode Pengguna yang sudah berlangganan Claude
APIYI claude-haiku-5-5 Sesuai pemakaian Input $0.1 / output $0.5 / pembacaan cache $0.01 per juta token (satu permintaan ≤100.000 token; di atas 100.000 token, input $0.5/1M dengan tarif bertingkat) Pengguna dengan frekuensi rendah hingga sedang

Data harga diambil dari daftar harga lengkap APIYI di apiyi.com (halaman diperbarui pada 2026-10-27 14:50 UTC+8). Rujuk daftar model di platform untuk model dan harganya, serta konsol untuk biaya aktual. Sebagai perbandingan, pada platform yang sama, claude-haiku-4-5-20251001 dikenakan tarif input $1 / output $5 / pembacaan cache $0.1, claude-sonnet-5-5 $2 / $10 / $0.1, dan claude-opus-5-5 $4 / $20 / $0.2. Observer menangani tugas kecil yang terstruktur dan sering dijalankan, sehingga model setingkat Haiku sudah memadai. Penagihan sesuai pemakaian cocok untuk penggunaan berfrekuensi rendah hingga sedang; pengguna intensif sebaiknya menghitung pemakaian aktual selama seminggu, lalu membandingkannya dengan biaya $30/bulan.


Mengganti observer claude-mem dengan APIYI

Ini adalah langkah lengkap untuk rute C, cocok bagi developer yang sudah punya saldo API dan tidak ingin berlangganan khusus untuk fitur memori. APIYI mendukung pengisian saldo dalam renminbi, dengan kurs tetap 1:7 sesuai halaman harga resminya.

  1. Instal terlebih dahulu mengikuti rute B: npx claude-mem install --provider claude.
  2. Buka ~/.claude-mem/settings.json, lalu masukkan empat kunci:
  3. "CLAUDE_MEM_PROVIDER": "openai-compatible"
  4. "CLAUDE_MEM_OPENAI_COMPAT_BASE_URL": "https://api.apiyi.com/v1"
  5. "CLAUDE_MEM_OPENAI_COMPAT_MODEL": "claude-haiku-5-5"
  6. "CLAUDE_MEM_OPENAI_COMPAT_API_KEY": "sk-key-APIYI-Anda"
  7. Jika tidak ingin menulis key sebagai teks biasa di settings, Anda bisa menaruhnya di ~/.claude-mem/.env: OPENAI_COMPAT_API_KEY=sk-key-APIYI-Anda (izin direktori 0700, izin file 0600).
  8. Jalankan npx claude-mem restart. Kredensial hanya dibaca saat worker dimulai, jadi perubahan tidak akan berlaku tanpa restart.
  9. Cara memastikan berhasil: npx claude-mem doctor menampilkan provider sebagai openai-compatible. Observation berikutnya yang dihasilkan sesi baru muncul di viewer.

Ada dua hal yang perlu diwaspadai. Pertama, base URL harus menyertakan /v1 dan tidak boleh diakhiri garis miring. Jika tidak, URL yang terbentuk akan memiliki garis miring ganda dan menyebabkan 404. Untuk perbedaan tiga jenis base URL, lihat: help.apiyi.com/apiyi-base-url-v1-claude-gemini-endpoint-config-guide.html. Kedua, jika satu saja dari empat kunci tidak ada, claude-mem akan diam-diam kembali ke rute Claude. Dari luar semuanya terlihat normal, tetapi biaya justru dipotong dari paket langganan.

Hasil pengujian API (saya menguji dengan key APIYI pada 2026-10-30):

  • GET /v1/models mengembalikan 200 dengan total 259 model, termasuk claude-haiku-5-5.
  • POST /v1/chat/completions menggunakan claude-haiku-5-5 dengan response_format: {type: "json_object"} mengembalikan 200 dalam sekitar 2,0 detik. Responsnya berupa JSON valid, dengan penggunaan 59 token.
  • Saat ditambahkan field reasoning: {enabled: false} yang akan dikirim oleh claude-mem, responsnya juga 200 tanpa error 400.
  • Endpoint native Anthropic /v1/messages juga mengembalikan 200.

Batasan kesimpulan: Pengujian di atas hanya memastikan bahwa endpoint APIYI dapat menerima format permintaan yang dibutuhkan claude-mem. Saya belum menjalankan alur observation claude-mem secara lengkap di komputer lokal, jadi API yang lolos pengujian tidak berarti seluruh alur plugin sudah terverifikasi.

🚀 Saran untuk mulai cepat: Buat key terpisah di konsol APIYI apiyi.com, khusus untuk claude-mem. Dengan begitu, setelah seminggu Anda bisa memeriksa pemakaian key tersebut secara terpisah dan menilai apakah biaya berdasarkan penggunaan lebih hemat daripada berlangganan. Jika Anda juga ingin menghubungkan Claude Code, lihat: help.apiyi.com/claude-code-apiyi-integration-tutorial.html.


Privasi claude-mem: apa yang disimpan secara lokal dan apa yang dikirim keluar

Penyimpanan lokal (semuanya berada di ~/.claude-mem/, lokasinya bisa diubah dengan CLAUDE_MEM_DATA_DIR): claude-mem.db (sesi, observasi, ringkasan, petunjuk), indeks vektor chroma/, logs/, settings.json, serta direktori tangkapan layar media-v1/ yang dinonaktifkan secara default.

Konten yang dikirim keluar dari perangkat:

  • Pemanggilan observer: isi pemanggilan alat, petunjuk, dan materi untuk ringkasan dikirim ke penyedia yang kamu pilih. Jika memilih Anthropic, data dikirim ke Anthropic; jika memilih CMEM, ke cmem.ai; jika memilih APIYI, ke APIYI.
  • Telemetri aktif secara default: data dikirim ke PostHog menggunakan UUID instalasi acak, dan informasi kesalahan disamarkan. Untuk menonaktifkannya, jalankan npx claude-mem telemetry disable atau atur DO_NOT_TRACK=1. Penginstal juga akan menanyakan pilihan ini di tahap akhir.
  • Sinkronisasi cloud harus diaktifkan secara manual: fitur ini nonaktif secara default. Setelah diaktifkan, observasi, ringkasan sesi, dan teks petunjuk lengkap akan diunggah ke cmem.ai.

Kontrol yang bisa kamu gunakan:

  • Konten yang dibungkus dengan <private>...</private> akan dihapus pada lapisan hook dan tidak masuk ke basis data.
  • Penyamaran otomatis nonaktif secara default. Atur CLAUDE_MEM_REDACT_ENABLED=true untuk mengaktifkan 16 pola kunci bawaan (AWS, GitHub PAT, kunci OpenAI/Anthropic, JWT, PEM, dan lainnya). Tambahkan CLAUDE_MEM_REDACT_GENERIC_ENABLED=true untuk mengaktifkan 3 pola umum tambahan. Jangan berasumsi bahwa data sensitif akan disamarkan secara otomatis.

Tabel pemecahan masalah umum claude-mem

Gejala Penyebab Solusi
Setiap hook melaporkan Executable not found in $PATH: "claude-mem" Launcher tidak ada di PATH Jalankan npx claude-mem install untuk memasang ulang, lalu mulai ulang terminal, IDE, dan Claude Code
Sesi menampilkan memory hooks are not active Launcher belum aktif Lakukan langkah di atas, lalu jalankan npx claude-mem doctor dan periksa baris Hook launcher
Tidak ada yang tercatat dan tidak ada pesan kesalahan Versi Claude Code di bawah 2.1.139 Jalankan claude update
Perintah claude-mem tertimpa program lain Sebelumnya pernah menjalankan npm install -g claude-mem Cari dengan which -a claude-mem, lalu jalankan npm uninstall -g claude-mem
Viewer tidak bisa dibuka Port bukan 37700, atau worker belum berjalan Periksa port di settings, lalu jalankan curl http://127.0.0.1:<PORT>/health
Port sedang digunakan Ada konflik dengan proses lain Tetapkan export CLAUDE_MEM_WORKER_PORT=38000, lalu mulai ulang worker
Endpoint kustom mengembalikan 404 Base URL salah Untuk endpoint kompatibel OpenAI, gunakan /v1; untuk endpoint native Anthropic, gunakan domain utama. Pastikan ID model muncul di /v1/models
Sudah mengatur kunci pihak ketiga, tetapi masih menggunakan Claude Keempat pengaturan belum lengkap, sehingga diam-diam beralih ke Claude Lengkapi settings, lalu jalankan npx claude-mem restart
Observation kosong atau terpotong Model kecil tidak mengikuti struktur JSON, atau mencapai batas output Naikkan CLAUDE_MEM_OBSERVER_MAX_OUTPUT_TOKENS (default 4096), atau gunakan model yang lebih stabil
Berulang kali mengalami timeout Permintaan streaming dihentikan jika tidak ada token selama 90 detik Naikkan CLAUDE_MEM_LLM_STREAM_IDLE_TIMEOUT_MS, atau gunakan model yang lebih kecil
Hook terus menghentikan worker Versi plugin dan worker tidak cocok (#3857, #3940, sudah diperbaiki) Jalankan npx claude-mem update; jika perlu, jalankan npx claude-mem@latest install
Dua sistem memori saling bertentangan Auto-memory bawaan dan claude-mem berjalan bersamaan Tambahkan --disable-auto-memory saat memasang ulang

Risiko claude-mem dan tanggung jawab jika akun diblokir

Baca bagian ini sampai selesai sebelum menginstal.

  1. Proyek komunitas, tanpa dukungan resmi: claude-mem adalah proyek sumber terbuka komunitas, bukan produk resmi APIYI. APIYI tidak memberikan dukungan resmi atau SLA untuk proyek ini.
  2. Konten dikirim ke luar: Konten pemanggilan alat akan dikirim ke observer yang kamu pilih. Jangan aktifkan dulu di repositori yang berisi kunci, data pelanggan, atau kode yang belum dipublikasikan.
  3. Pemakaian kuota: Alat ini bisa menghabiskan banyak token atau kuota paket. Sebaiknya coba dulu pada satu proyek kecil selama seminggu, lalu periksa tagihannya sebelum memutuskan.
  4. Kontrol risiko dan pembatasan laju: Hooks yang sering terpicu, akun bersama, dan kunci layanan proksi API semuanya bisa memicu kontrol risiko atau pembatasan laju dari platform. Sebaiknya gunakan kunci terpisah, akun sekunder, dan satu proyek untuk uji coba. Konsekuensinya menjadi tanggung jawab pembaca. Artikel ini hanya memastikan bahwa antarmuka APIYI telah lolos uji pemakaian, bukan menjamin tidak akan ada pembatasan laju.
  5. Ada sisa setelah penghapusan: Setelah menjalankan npx claude-mem uninstall, direktori ~/.claude-mem masih tersimpan, termasuk database dan kunci yang mungkin tersimpan di dalamnya. Kamu perlu menjalankan rm -rf ~/.claude-mem secara manual. Selain itu, berdasarkan pengujian pihak ketiga, ~/.bun dan ~/.cache/uv menghabiskan sekitar 1,1 GB. Jika tidak digunakan oleh proyek lain, keduanya juga bisa dihapus.

Pertanyaan umum tentang claude-mem

Q1: Apakah 100 ribu bintang berarti claude-mem pasti bagus?

Tidak. Jumlah bintang hanya menunjukkan popularitas. Kamu tetap perlu menilai sendiri biaya token, batas privasi, dan ritme pembaruan versinya. Belum ada audit independen yang memastikan apakah pertumbuhan jumlah bintangnya organik.

Q2: Apakah claude-mem sama dengan memory bawaan Claude Code?

Tidak. Memory bawaan menggunakan MEMORY.md, sedangkan claude-mem memakai hooks dan database tersendiri. Secara default, keduanya berjalan bersamaan. Jika hanya ingin menggunakan satu sistem, tambahkan `–disable-auto-memory` saat instalasi.

Q3: Apakah memory langsung tersedia setelah sesi pertama?

Belum. Sesi pertama digunakan untuk mengumpulkan dan merangkum informasi, lalu memory baru disisipkan pada sesi kedua. Gunakan pemeriksaan nomor 4 (sqlite count) dan nomor 5 (context inject) untuk memastikannya.

Q4: Bisakah claude-mem digunakan tanpa menautkan kartu atau berlangganan?

Bisa. Instal dengan `–provider claude` untuk menggunakan kuota paket Claude. Atau, setelah instalasi, ganti observer agar memakai kunci APIYI apiyi.com dengan pembayaran sesuai pemakaian. Biaya dihitung berdasarkan token yang digunakan, dan pengguna baru juga mendapat kuota gratis untuk mencoba.

Q5: Model apa yang cocok untuk observer?

Gunakan model sekelas Haiku, seperti `claude-haiku-5-5`. Observation adalah tugas kecil yang terstruktur dan sering dijalankan. Model unggulan seperti Opus lebih mahal dan bisa menghabiskan anggaran output untuk proses berpikir.

Q6: Bisakah hanya menggunakan model lokal?

Bisa. Arahkan `openai-compatible` ke Ollama, LM Studio, atau vLLM. Namun, model kecil harus mampu menghasilkan struktur JSON observation secara konsisten. Jika tidak, catatan yang dihasilkan bisa kosong.

Q7: Bagaimana cara mengaktifkan observation dalam bahasa Mandarin?

Atur `”CLAUDE_MEM_MODE”: “code–zh”` di settings. Ini adalah mode bawaan, jadi tidak perlu instalasi tambahan. Setelah itu, mulai ulang Claude Code.


Poin Penting claude-mem

  • Cara kerja: hooks menangkap pemanggilan tool, lalu observer meringkasnya dan menyimpannya di SQLite untuk disisipkan ke sesi berikutnya.
  • Jebakan default: installer v15 memilih CMEM Pro secara otomatis. Uji cobanya mengharuskan kartu pembayaran, lalu biayanya $30/bulan.
  • Tanpa biaya bulanan: instal dengan --provider claude, lalu ubah settings sesuai kebutuhan untuk memakai kunci sendiri.
  • Biaya: klaim resmi menyebut “hemat 96%”, sementara satu pengujian pihak ketiga mencatat “+4.226 token”. Keduanya menggunakan dasar pengukuran berbeda.
  • Privasi: observer mengirim konten ke luar; telemetri aktif secara default; penyamaran data dan sinkronisasi cloud harus diaktifkan secara manual.
  • Cara mulai: buat kunci API terpisah di APIYI apiyi.com, gunakan claude-haiku-5-5 dengan tarif berdasarkan pemakaian selama seminggu, lalu hitung biayanya.

Kesimpulan: Siapa yang Perlu Memasang Memori Antarsesi claude-mem?

3 tipe orang yang cocok memasangnya:

  1. Orang yang memelihara proyek yang sama dalam jangka panjang dan sering menutup lalu membuka kembali sesi Claude Code.
  2. Orang yang sering perlu menjawab pertanyaan seperti “kenapa dulu diubah begini?” atau “bug itu akhirnya diperbaiki bagaimana?”.
  3. Orang yang bersedia meluangkan 10 menit untuk konfigurasi dan tidak keberatan observer membaca konten pemanggilan tool.

3 tipe orang yang sebaiknya tidak memasangnya:

  1. Orang yang hanya menjalankan skrip sekali pakai dan tidak punya proyek berkelanjutan. Menggunakan CLAUDE.md dan catatan sendiri lebih murah.
  2. Orang yang kode atau datanya tidak boleh keluar dari perangkat lokal atau wilayah kepatuhan yang ditentukan.
  3. Pengguna dengan ruang disk atau CPU yang sangat terbatas, serta orang yang berharap “langsung lebih pintar setelah instalasi”.

Jika ingin memasangnya, ikuti urutan “jalur B → 5 pemeriksaan → kurangi jumlah entri yang disisipkan → ganti observer jika perlu” agar lebih mudah menghindari masalah. Untuk menguji biaya observer berdasarkan pemakaian, gunakan kuota gratis di APIYI apiyi.com untuk menjalankan proyek kecil terlebih dahulu.


📚 Referensi

  1. Repositori GitHub claude-mem: kode sumber, release, dan issues
  2. Tautan: github.com/thedotmack/claude-mem
  3. Keterangan: jumlah bintang, versi, serta catatan masalah #618, #2469, #3857, #3940, dan lainnya

  4. Dokumentasi resmi claude-mem: instalasi, konfigurasi, dan pemecahan masalah

  5. Tautan: docs.claude-mem.ai/installation
  6. Keterangan: persyaratan sistem, nilai default settings, dan konfigurasi provider openai-compatible

  7. Halaman harga CMEM: ketentuan CMEM Pro / Heavy / Max

  8. Tautan: cmem.ai/pricing
  9. Keterangan: uji coba 30 hari, persyaratan penambahan kartu, dan awal penagihan (diperiksa pada 2026-10-30)

  10. Pengujian pihak ketiga oleh ComputingForGeeks: instalasi versi 15.0.2 dan penggunaan token

  11. Tautan: computingforgeeks.com/claude-mem-claude-code
  12. Keterangan: sumber data +4.226 token dari satu contoh pengujian (2026-10-24)

  13. Dokumentasi model APIYI: daftar model dan harga

  14. Tautan: docs.apiyi.com/models
  15. Keterangan: lihat daftar model di platform untuk informasi model dan harga terkini

Penulis: Tim Teknis APIYI
Diskusi teknis: Jika mengalami masalah dengan endpoint atau model saat konfigurasi, hubungi kami melalui halaman utama situs resmi APIYI. Panduan integrasi lainnya tersedia di pusat dokumentasi docs.apiyi.com.

Artikel terkait

Similar Posts