claude-mem ذاكرة دائمة للوكلاء: يقدّم المستودع thedotmack/claude-mem نفسه بوصفه «نظام ضغط للذاكرة الدائمة» مصممًا لـ Claude Code. فهو يراقب ما يفعله الوكيل أثناء الجلسة، ويلخّصه، ثم يعيد حقن الجوهر عند بدء الجلسة التالية. وفي نهاية أكتوبر 2026 كان المستودع يعرض نحو 103000 نجمة و9100 fork، برخصة Apache 2.0، وبالإصدار 15.2.1 المذكور في ملف README.
بالنسبة إلى فريق التشغيل، هو خدمة صغيرة تعمل بجانب الوكيل. تستمع إلى كل استدعاء لأداة، وتستدعي نموذجًا لغويًا لتلخيصه، وتخزّن النتيجة، وتغيّر سياق كل جلسة جديدة. لذلك يصبح زمن الاستجابة وكلفة الرموز (tokens) وجودة ما يُستعاد والخصوصية مسائل تشغيل. يتبع هذا المقال ملف README ووثائق المستودع، وقد قُرئت في 26 أكتوبر 2026.
تنبيه صراحة: لم تثبّت span.observer أداة claude-mem. الأوامر مأخوذة من README، والإعدادات من الوثائق الرسمية، ولقطة الواجهة من مستودع المشروع نفسه. وللاطلاع على مقاربة أخرى لذاكرة الوكلاء، راجع Hindsight، ذاكرة وكلاء الذكاء الاصطناعي؛ فالزاوية مختلفة كما سيأتي لاحقًا.
claude-mem ذاكرة دائمة للوكلاء: ما يقوله المستودع
- المؤلف والرخصة: يذكر README أن المؤلف هو Alex Newman (
@thedotmack). ملف LICENSE هو النص القياسي لرخصة Apache License 2.0، ويؤكد README ذلك. ويصف الملفانdocs/license.mdوdocs/ip-boundary.mdبنية «open-core»: محرك الذاكرة والخادم وواجهة سطر الأوامر والمحوّلات وأدوات MCP تحت Apache 2.0، بينما تبقى سحابة مستضافة ومزامنة الفرق والإدارة وSSO محجوزة خارج المستودع العام. - التقنية: TypeScript وNode.js بالإصدار 20 أو أحدث، وBun مديرًا للعمليات، وSQLite مع البحث النصي الكامل FTS5، واختياريًا قاعدة المتجهات Chroma (تُثبَّت عبر
uv). - المبدأ: تمرّر خطاطيف دورة حياة Claude Code (SessionStart وUserPromptSubmit وPreToolUse وPostToolUse وStop وSessionEnd) الأحداث إلى عامل (worker) محلي. ويطلب العامل من نموذج ضغطها إلى «ملاحظات» منظمة.
- أرقام قُرئت في 26 أكتوبر 2026: نحو 103000 نجمة و9100 fork بحسب صفحة المستودع؛ والإصدار 15.2.1 بحسب شارة README وحزمة npm. قرأت النجوم أداة تلخيص صفحات، فأعد التحقق منها قبل نقلها إلى مكان آخر.
ويسرد README أيضًا مثبّتات لبيئات أخرى غير Claude Code (OpenCode وT3 Code وAntigravity وOMP وPi وOpenClaw). يقتصر هذا المقال على Claude Code، وهو الحالة الأصلية.
جولة في الواجهة: عارض الويب
يقدّم العامل واجهة ويب، هي «العارض» (viewer)، تعرض الملاحظات المخزّنة مباشرة. اللقطة التالية إطار من الصورة المتحركة cm-preview.gif المنشورة في مستودع المشروع: جلسة Claude Code على اليسار والعارض على اليمين.

تحمل كل بطاقة نوعًا (مثل change أو feature) وعنوانًا وسردًا قصيرًا ومعرّفًا. وبحسب الوثائق يتحدث العارض عبر Server-Sent Events ويُرشَّح حسب المشروع. ومن هناك أيضًا تُعدَّل إعدادات السياق مع معاينة مباشرة.
كيف تُضغط الذاكرة ثم يُعاد حقنها
يتلخص التدفق الموصوف في وثائق البنية في سطر واحد: يكتب خطّاف في قاعدة البيانات، ويقرأ العامل المدخلات ويعالجها بواسطة SDK الوكيل، ثم يقرأ خطّاف الجلسة التالية الملخصات. عمليًا:
- الالتقاط: بعد كل استدعاء لأداة (PostToolUse) يرسل الخطّاف الحدث إلى العامل. وتتحدث الوثائق عن «أكثر من 100 مرة» في الجلسة الواحدة.
- الضغط: يسلّم العامل كل حدث إلى نموذج. القيمة الافتراضية لـ
CLAUDE_MEM_MODELهيclaude-haiku-4-5-20251001مع المزوّدclaude؛ وتُذكر مزوّدات أخرى:codexوgeminiوopenrouterوopenai-compatible. - الملخص: عند توقف الوكيل (Stop) يسجّل ملخص نهائي الطلب وما أُنجز وما جرى تعلّمه.
- إعادة الحقن: عند البدء التالي يضيف خطّاف السياق آخر الملاحظات. والقيمة الافتراضية 50 (
CLAUDE_MEM_CONTEXT_OBSERVATIONS).

تعرض اللقطة مثال الإعداد اليدوي في الوثائق: مئة ملاحظة وعشرون جلسة وترشيح حسب النوع (bugfix وdecision وdiscovery) وعرض كلفة رموز القراءة. وهذه ليست القيم الافتراضية.
بحث على ثلاث طبقات
يدافع المشروع عن «الإفصاح التدريجي»: عرض فهرس رخيص أولًا، ثم جلب التفاصيل عند الحاجة فقط. ويصف README ثلاث أدوات MCP: search (فهرس مضغوط) وtimeline (سياق زمني) وget_observations (تفاصيل المعرّفات المرشّحة). ويزعم المشروع توفيرًا يقارب عشرة أضعاف في الرموز؛ وهذا ادعاء وارد في README وليس قياسًا أعيد إنتاجه هنا.

التثبيت خطوة بخطوة
المتطلبات
يطلب README الإصدار 20 أو أحدث من Node.js، وإصدارًا حديثًا من Claude Code يدعم الإضافات، وBun وuv (يُثبَّتان تلقائيًا عند غيابهما)، وSQLite 3 (مضمّن).
الخطوة 1 — تشغيل المثبّت
npx claude-mem install
يوضح README أن الأمر npm install -g claude-mem يثبّت SDK فقط، دون تسجيل الخطاطيف أو العامل. وبعد التثبيت تقترح الأداة تسجيل الدخول بالبريد الإلكتروني إلى حساب claude-mem مع تجربة مجانية لمدة 30 يومًا لـ«المراقِب» المستضاف. ولتجنب ذلك يقترح README تمرير الخيار --provider صراحةً، أو ضبط CLAUDE_MEM_ONLINE_OPTIN=false، أو العمل في صدفة غير تفاعلية.
الخطوة 2 — أو استخدام سوق الإضافات
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
أعد تشغيل Claude Code: بحسب README يظهر سياق الجلسات السابقة بعد ذلك تلقائيًا في الجلسات الجديدة.
الخطوة 3 — ويندوز
لا تحتاج الخطاطيف إلى Git Bash. يضع المثبّت مُشغِّلًا باسم claude-mem.exe في %LOCALAPPDATA%\claude-mem\bin ويضيفه إلى Path المستخدم؛ أعد تشغيل الطرفية بعد ذلك. وعند ظهور الخطأ Executable not found in $PATH: “claude-mem” يحيل README إلى الأمر npx claude-mem doctor.
كيف تتحقق من أن كل شيء يعمل
- شغّل
npx claude-mem doctor: تذكر الوثائق أنه يعرض سطرًا عن مُشغِّل الخطاطيف. - ابدأ جلسة Claude Code، وأجرِ بعض الإجراءات، ثم افتح العارض على العنوان الذي يطبعه العامل عند البدء. يجب أن تظهر بطاقات الملاحظات.
- استعلم من العامل:
curl -s http://127.0.0.1:$CLAUDE_MEM_WORKER_PORT/api/health، وهو الأمر الذي تقدمه وثائق الإعداد لقراءة المنفذ النشط.
مراقبة claude-mem في التشغيل
لا تصف الوثائق تصدير OpenTelemetry ولا مقاييس Prometheus. أما ما تتيح متابعته فهو:
- صحة العامل: خدمة HTTP محلية، والمنفذ الافتراضي
37700 + (uid % 100)ويمكن تغييره بـCLAUDE_MEM_WORKER_PORT. تذكر صفحة «Worker Service» المسارGET /healthوتذكر صفحة الإعدادGET /api/health: تحقق من أيهما يستجيب في إصدارك. - الطابور: يعرض
GET /api/pending-queueالرسائل المنتظرة وقيد المعالجة والمعالَجة والفاشلة (ثلاث محاولات افتراضيًا) وعدد الرسائل «العالقة» (أكثر من خمس دقائق قيد المعالجة). ويعيدPOST /api/pending-queue/processتشغيل المعالجة. وهو المؤشر المناسب بعد انهيار. - السجلات: المجلد
logs/داخل مجلد البيانات (~/.claude-memافتراضيًا، وعبرCLAUDE_MEM_DATA_DIR)، ويُضبط المستوى بـCLAUDE_MEM_LOG_LEVEL(DEBUG وINFO وWARN وERROR وSILENT). وتسمّي صفحات الوثائق الملفات بطرق مختلفة (worker-out.logفي صفحة وworker-YYYY-MM-DD.logفي أخرى). - الحجم المخزَّن: يتيح
GET /api/stats(أعداد لكل مشروع) وملفclaude-mem.dbمتابعة النمو. - الكلفة: تمر كل ملاحظة عبر نموذج. وتتم متابعة الرموز لدى المزوّد؛ وتنطبق طريقة كلفة وكيل الذكاء الاصطناعي بالرموز مع OpenTelemetry، وكذلك مراقبة وكلاء MCP باستخدام OpenTelemetry لاستدعاءات أدوات البحث.
يستمع العامل افتراضيًا على 127.0.0.1 (CLAUDE_MEM_WORKER_HOST). وتوصي الوثائق بإبقائه كذلك لمن لا يستخدم الوصول عن بُعد. وللإطار العام لمراقبة وكيل برمجة انظر مراقبة وكيل البرمجة في المؤسسة.
ما الذي يميّز claude-mem عن Hindsight
يصف مقال Hindsight خادم ذاكرة يُنشر مع PostgreSQL ويستدعيه أي وكيل عبر واجهة API وعمليات retain وrecall وreflect. أما claude-mem فينطلق من مكان آخر: يتصل بخطاطيف Claude Code، ولا يتطلب شيفرة في جانب الوكيل، ويخزّن كل شيء محليًا في SQLite، ويعيد حقن فهرس عند بدء كل جلسة. الأول لبنة ذاكرة لبناء وكيل، والثاني إضافة لوكيل برمجة موجود.
الحدود والنقاط المفتوحة
- البيانات الحساسة: قد يُلتقط أي استدعاء لأداة، ومنه المسارات والأوامر ومقتطفات الملفات. ويصف README وسوم
<private>لاستبعاد المحتوى، وتشرح الوثائق مرشّحات (CLAUDE_MEM_SKIP_TOOLSوCLAUDE_MEM_SKIP_BASH_PATTERNSوالمشاريع المستبعدة). وهي لا تحمي إلا ما فكرت في استبعاده. - عرض تجاري في الواجهة: يبرز README تسجيل الدخول إلى حساب وتجربة مجانية لمدة 30 يومًا وذاكرة مستضافة افتراضيًا في أحد المثبّتات. ويزعم المشروع استخدامًا إضافيًا يصل إلى 100% من خطتك: هذه حجة تجارية لم نتحقق منها هنا. ويبقى التثبيت المحلي ممكنًا.
- رمز مجتمعي: تتحدث نهاية README عن CMEM، وهو رمز أنشأه طرف ثالث لكن المؤلف «احتضنه رسميًا». لا توصي span.observer به ولا تعلّق عليه؛ وهو إشارة حذر لمن يقيّم المشروع.
- إطار open-core: بعض الوظائف المعلنة (الفريق وSSO والسحابة) محجوزة خارج مستودع Apache 2.0 بحسب
docs/ip-boundary.md. - وثائق متفاوتة: المعلومة نفسها (صحة العامل وأسماء السجلات) تختلف من صفحة إلى أخرى، ويصف README التثبيت لـ Grok Bot أولًا ثم لـ Claude Code. ورقم «10 أضعاف أقل من الرموز» و«فعالية 100%» لمهارة البحث ادعاءات من المشروع.
- مشروع نشط جدًا: الإصدار 15.2.1 وأكثر من 3600 commit بحسب صفحة المستودع؛ والخيارات تتغير بسرعة.
أفضل الممارسات
- جرّبه أولًا على مشروع بلا أسرار، مع قيمة منخفضة لـ
CLAUDE_MEM_CONTEXT_OBSERVATIONS. - أضف أنماطك الحساسة إلى
CLAUDE_MEM_SKIP_BASH_PATTERNSقبل الاستخدام الفعلي، وأبقِ العامل على127.0.0.1. - اختر مزوّد الضغط صراحةً، بأرخص نموذج يفي بالغرض، وتابع الاستهلاك لديه.
- انسخ مجلد البيانات احتياطيًا قبل أي تحديث، وراقب الطابور بعد إعادة التشغيل.
- راجع ما يُحفظ: فالملاحظة الخاطئة يُعاد حقنها في كل جلسة.
الأسئلة الشائعة
هل claude-mem مجاني ومفتوح المصدر؟
شيفرة المستودع تحت Apache 2.0 بحسب ملف LICENSE. ويعرض README أيضًا خدمة مستضافة مع تجربة مجانية لمدة 30 يومًا؛ وهي اختيارية بحسب ما يذكره.
هل تغادر بياناتي جهازي؟
تُخزَّن الملاحظات في قاعدة SQLite محلية. لكن الملخص يمر عبر نموذج: Claude افتراضيًا، أو Gemini أو OpenRouter أو مزوّد آخر بحسب CLAUDE_MEM_PROVIDER. لذلك يُرسل محتوى استدعاءات الأدوات إلى ذلك المزوّد. والمزامنة السحابية خدمة منفصلة يصفها المشروع.
ما الفرق بينه وبين ملف CLAUDE.md؟
ملف التعليمات يُكتب يدويًا ويُقرأ كاملًا في كل جلسة. أما claude-mem فيولّد المدخلات تلقائيًا ويحقن فهرسًا محدودًا فقط، تُفصَّل تفاصيله لاحقًا عند الطلب. والاثنان يكمّلان بعضهما.
الخلاصة
يؤتمت claude-mem مهمة تؤديها الفرق يدويًا: إخبار الوكيل بما حدث بالأمس. يُثبَّت بأمر واحد ويُضبط بملف JSON. ويجب التعامل معه كخدمة: مراقبة طابورها، وحساب رموزها، وتحديد ما تحفظه. المصادر: مستودع thedotmack/claude-mem والوثائق الرسمية.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات المذكورة ملك لأصحابها. الأدوات تتطور بسرعة: تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.