كيف تعطي Claude Code ذاكرة دائمة مع claude-mem

كل جلسة وكيل تبدأ من صفر. claude-mem يلتقط العمل ويضغطه، ثم يعيد للجلسة التالية فهرسًا بما يهم المشروع.

مجانيالوكلاءتشغيل محلي واستضافة ذاتيةمتوسطمحتوى عملي بقلم 8 دقائق للقراءة0 قراءة· حُدّث 15 نوفمبر 2026

دخول أو حساب مجاني لتُعجب وتحفظ وتعلّق.

كيف تعطي Claude Code ذاكرة دائمة مع claude-mem

الخلاصة أولًا: claude-mem إضافة مفتوحة المصدر بترخيص Apache-2.0 من Alex Newman (@thedotmack). تعالج مشكلة بسيطة ومزعجة: كل جلسة جديدة مع وكيلك البرمجي تبدأ من صفر. الإضافة تشغّل مراقبًا ثانيًا بجانب الوكيل، يلتقط ما يقرأه ويعدّله ويشغّله، ويضغطه إلى ملاحظات قصيرة، ثم يعيد فهرسًا موجزًا في الجلسة التالية. الذاكرة تُحفظ على جهازك في ~/.claude-mem.

هذا الدليل مأخوذ من المستودع والتوثيق الرسمي بتاريخ 15 نوفمبر 2026 (توقيت الرياض، Asia/Riyadh)، وليس تجربة عملية أجريناها نحن. آخر إصدار منشور وقت المراجعة: v15.18.4. في ذلك التاريخ أظهر GitHub API أكثر من 117 ألف نجمة للمستودع. الرقم يتغير، فراجعه على الصفحة إن احتجت رقمًا حديثًا.

لمن هذا؟

  • من يستخدم Claude Code يوميًا على المشروع نفسه، ويضيّع وقتًا في إعادة شرح القرارات والإصلاحات القديمة.
  • من يتنقل بين Claude Code ووكلاء آخرين مدعومين مثل Codex أو Cursor أو OpenCode، ويبغى ذاكرة للمشروع عبر الجلسات.
  • من يبي يسأل عن عمل سابق («وش سوينا في المصادقة الأسبوع اللي فات؟») من غير ما يفتح كل الجلسات يدويًا.

ليس لك إذا: تبي تفاصيل الجلسة تبقى بعيدة عن أي نموذج ضغط، أو ما تقدر تشغّل خدمة محلية صغيرة بجانب الوكيل. القاعدة محلية، لكن خطوة الضغط تحتاج مزوّدًا: خطة Anthropic، أو مفتاح OpenRouter أو Gemini، أو مراقب claude-mem التجاري بعد التجربة.

وإذا كنت تبني عادة التخطيط قبل الكود مع Claude Code، راجع أيضًا مقالتنا عن gstack. الأداتان تتكاملان في مسار وكلاء البرمجة: gstack ينظّم التفكير قبل البرمجة، وclaude-mem يحفظ ما حدث أثناء العمل وبعده.

المشكلة التي يعالجها

README يصف المشكلة بوضوح: في كل جلسة جديدة يبدأ الوكيل من صفر. يعيد قراءة الملفات نفسها، ويعيد طرح الأسئلة نفسها، وقد يعود إلى أخطاء سبق أن أصلحتها معه في جلسة سابقة.

claude-mem لا يلغي ملفات المشروع ولا يغني عن CLAUDE.md. يبني سجل عمل مضغوطًا عبر الجلسات، ثم يعيد للوكيل ما يهم هذا المشروع، ويترك التفاصيل الكاملة إلى أن يطلبها.

كيف يعمل؟

حسب التوثيق الرسمي، المسار بثلاث خطوات:

  1. وكيلك يشتغل. Hooks في الوكيل تمرّر كل استدعاء أداة (قراءة وتعديل وتشغيل) إلى خدمة محلية اسمها worker.
  2. المراقب يكتب ملاحظات. وكيل ثانٍ يحوّل هذا النشاط إلى ملاحظات قصيرة، ويكتب ملخصًا عند نهاية الجلسة.
  3. الجلسة التالية تبدأ منها. عند بدء جلسة في المشروع نفسه، يصل للوكيل فهرس مضغوط للملاحظات المهمة، ويجلب التفاصيل الكاملة عند الحاجة فقط.

الذاكرة تصل للوكيل من جلستك الثانية في المشروع. إذا أردت تمهيدًا أوسع للمستودع من البداية، يذكر README أمرًا اختياريًا: /learn-codebase، ويقدّر الوقت بنحو خمس دقائق على مستودع عادي. هذا تقدير المصدر، لا قياس أجريناه نحن.

الخدمة المحلية تديرها Bun، وتفتح واجهة ويب على جهازك. العنوان يُطبع عند التشغيل. المنفذ الافتراضي يحسب لكل مستخدم: 37700 + (uid % 100)، ويمكن تثبيته من الإعدادات عبر CLAUDE_MEM_WORKER_PORT. الخدمة ترتبط افتراضيًا بـ 127.0.0.1 فقط. واجهة My Work على المسار /، بينما الذاكرة والجلسات والإعدادات على /viewer.

التخزين في SQLite على المسار ~/.claude-mem/claude-mem.db، مع بحث نصي (FTS5)، وبحث دلالي اختياري عبر Chroma. الإعدادات في ~/.claude-mem/settings.json.

مع Claude Code، الأحداث تشمل SessionStart وUserPromptSubmit وPreToolUse وPostToolUse وStop وSessionEnd. بعد التثبيت يفترض أن يعمل هذا تلقائيًا، من غير ما تتذكر أمرًا في كل جلسة.

التثبيت

احتياجات النظام حسب دليل التثبيت الرسمي:

  • Node.js: الإصدار 20.19 أو أحدث ضمن سلسلة 20.x، أو 22.12 أو أحدث.
  • Bun (يُثبّت تلقائيًا إن كان ناقصًا). الدليل يذكر الإصدار 1.2.16 أو أحدث لترجمة أداة التشغيل.
  • uv لبحث المتجهات (يُثبّت تلقائيًا إن كان ناقصًا).
  • وكيل مدعوم: Claude Code بالإصدار 2.1.139 أو أحدث (أول إصدار يدعم صيغة الـ hooks المستخدمة هنا)، أو مضيف آخر مذكور في التوثيق.
  • SQLite 3 مضمّن مع الإضافة.

الطريقة الموصى بها

npx claude-mem install

المثبّت يكتشف الوكلاء على جهازك ويسألك أيهم تريد إعداده. بعد ذلك ابدأ العمل: الملاحظات تبدأ من أول طلب، والجلسة الثانية في المشروع تفتح بذاكرة من الأولى.

المثبّت قد يطلب تسجيل الدخول في المتصفح (رابط سحري بالبريد، من غير ما تحتاج بطاقة لمجرد الدخول). اختيار claude-mem observer يبدأ تجربة مجانية لمدة 30 يومًا على صفحة دفع تطلب وسيلة دفع. بعد انتهاء التجربة، يقول المصدر إن الذاكرة تعود تلقائيًا إلى خطة Anthropic ما لم تشترك. بعد الدخول تختار مزوّد الذاكرة: مراقب claude-mem، أو مفتاح OpenRouter أو Gemini لديك، أو خطة Anthropic.

إذا أردت تجاوز تسجيل الدخول، يمكنك تمرير --provider صراحة، أو ضبط CLAUDE_MEM_ONLINE_OPTIN=false، أو التشغيل في بيئة CI أو غير تفاعلية. للبقاء على خطة Anthropic من سطر الأوامر:

npx claude-mem install --provider claude

من داخل Claude Code

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

بعدها أعد تشغيل Claude Code. حسب README، سياق الجلسات السابقة يظهر تلقائيًا في الجلسات الجديدة.

تنبيه مهم من المشروع نفسه: الحزمة موجودة على npm، لكن npm install -g claude-mem يثبّت مكتبة أو SDK فقط، ولا يسجّل الـ Hooks ولا يشغّل خدمة worker. ثبّت دائمًا عبر npx claude-mem install أو أوامر /plugin أعلاه.

تثبيت السوق وحده قد يترك الجلسة الأولى من غير سياق ذاكرة بينما تُجهَّز أداة التشغيل. الجلسة التالية تحصل عليها. تشغيل npx claude-mem install مرة واحدة يتجنّب هذه الفجوة، حسب دليل التثبيت.

بعدها للتأكد:

npx claude-mem doctor

هذا الأمر يفحص Bun وuv وأداة الـ hook وخدمة worker، ويخبرك ما الذي يحتاج إصلاحًا.

كيف تبحث في الذاكرة؟

بعد الجلسة الثانية، يفترض أن يصل للوكيل فهرس موجز في بداية الجلسة. يمكنك أيضًا السؤال بشكل طبيعي عن عمل سابق، مثل إصلاحات المصادقة أو قرار تصميم قديم. مهارة mem-search تقود البحث عبر ثلاث أدوات MCP، بترتيب يسميه التوثيق الإفصاح التدريجي:

  1. search: فهرس مضغوط مع معرّفات. التوثيق يقدّر حجم الصف بنحو 50 إلى 100 رمز (token).
  2. timeline: السياق الزمني حول نتيجة مهمة.
  3. get_observations: التفاصيل الكاملة للمعرّفات التي اخترتها فقط. التوثيق يقدّر السجل الكامل بنحو 500 إلى 1,000 رمز.

المشروع ينبّه أن هذه نسبة حجم بين الفهرس والسجل الكامل، وليست قياسًا لنجاح الاسترجاع أو لتوفير محسوب عبر المسار كاملًا.

مثال على التسلسل كما في دليل البحث:

search(query="authentication bug", type="bugfix", limit=10)
timeline(anchor=312, depth_before=3, depth_after=3)
get_observations(ids=[312, 489])

يمكنك متابعة الملاحظات من المتصفح على عنوان worker، ومراجعة الإعدادات من /viewer.

إذا أردت أن تُكتب الملاحظات والملخصات بالعربية، الوضع المضمّن هو code--ar. عدّل ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--ar"
}

ثم أعد تشغيل Claude Code. هذا يغيّر لغة الملاحظات والملخصات، وليس بالضرورة واجهة العارض نفسها.

الخصوصية والحدود

  • الذاكرة محلية افتراضيًا. الملفات في ~/.claude-mem. المزامنة السحابية مع cmem.ai اختيارية. إن فعّلتها، يوضح التوثيق أن المزامنة ترفع نصوص الملاحظات والطلبات إلى حسابك، فلا تفعّلها إذا كان المحتوى لازم يبقى على الجهاز فقط.
  • ضغط الملاحظات يمر على نموذج. حتى مع قاعدة محلية، نشاط الأدوات يُرسل إلى المزوّد الذي اخترته: خطة Anthropic، أو OpenRouter، أو Gemini، أو بوابة cmem.ai إن اخترت المراقب التجاري. هذا لا يعني أن «كل شيء يبقى على الجهاز».
  • أخفِ الأسرار يدويًا. غلّف أي نص لا تريده في قاعدة الذاكرة بوسوم <private>...</private>. الوكيل يراه في الجلسة الحالية، لكن المحتوى لا يُحفظ في قاعدة البيانات ولا في فهارس البحث، حسب دليل الوسوم الخاصة. التوثيق ينصح مع ذلك ألا تعتمد على الوسم وحده لإدارة الأسرار.
  • التنقيح التلقائي للأسرار مطفأ افتراضيًا. يمكنك تفعيله بـ CLAUDE_MEM_REDACT_ENABLED إن أردت حماية إضافية للرموز التي تظهر في مخرجات الأدوات من غير أن تكتبها بنفسك.
  • لقطات الشاشة تُحفظ افتراضيًا تحت ~/.claude-mem/media-v1/. لا تُرفع إلى السحابة إلا مع تشغيل Cloud Sync، ولا تُرسل إلى نموذج المراقب إلا إن فعّلت استدلال الصور بشكل منفصل.
  • تحليلات الاستخدام مفعّلة افتراضيًا. حسب صفحة Telemetry، الأحداث مجهولة ولا تتضمن النصوص أو الشيفرة أو أسماء المشاريع أو استعلامات البحث. لإيقافها:
npx claude-mem telemetry disable

والإضافة تحترم أيضًا المتغير DO_NOT_TRACK.

  • لا تفتح الخدمة على الشبكة من غير حماية. الافتراضي هو loopback. ربطها على 0.0.0.0 من غير رمز يضع واجهة كاملة على الشبكة المحلية، بما في ذلك الإعدادات. التوثيق يحذّر من هذا صراحة.
  • ليس كل وكيل يُسجَّل. README يذكر أن Copilot CLI وGoose وRoo Code وWarp تستطيع البحث في الذاكرة، لكن جلساتها لا تُضاف إليها.
  • التحديث التلقائي مفعّل افتراضيًا. يمكن إيقافه بـ CLAUDE_MEM_AUTO_UPDATE=false.
  • التجربة التجارية للمراقب ليست إجبارية. هي موجودة في مسار المثبّت، وتطلب وسيلة دفع لبدء تجربة ثلاثين يومًا. سعر الاشتراك بعد التجربة لم نتحقق منه هنا. راجعه على الموقع إن كنت تفكر في هذا المسار.

مصادر

مقالة ذات صلة في مسار وكلاء البرمجة: gstack: المهارة اللي ما أبرمج مع Claude بدونها.

تابعنا على X وTikTok

النقاش

كن أول من يعلّق — شارك سؤالك أو تجربتك مع هذا المحتوى.

دخول أو حساب مجاني لتُعجب وتحفظ وتعلّق.

كل محتوى مسار الوكلاء ←