كيف تثبّت claude-mem الحاصل على 100 ألف نجمة؟ أضف الذاكرة في 3 خطوات وتجنب فخاخ الفترة التجريبية

في كل مرة تغلق فيها Claude Code وتفتحه مجددًا، ينسى ما عدّلته في الجلسة السابقة. لذلك يلجأ كثيرون إلى تثبيت claude-mem، الذي حصد أكثر من 100 ألف نجمة. يمكنك تثبيته، لكن لا تضغط Enter في كل خطوة دون مراجعة الخيارات. ففي إصدار v15 من أداة التثبيت، المتاح في أكتوبر 2026، يُختار مراقب CMEM Pro المستضاف افتراضيًا، وتبدأ المحاسبة بـ 30 دولارًا شهريًا بعد انتهاء الفترة التجريبية البالغة 30 يومًا. إذا أردت تجنب الرسوم الشهرية، يمكنك إضافة --provider claude عند التثبيت، أو تغيير إعدادات المراقب بعده لاستخدام مفتاحك الخاص.

هذا ليس مقالًا ترويجيًا يعدك بذاكرة دائمة بمجرد التثبيت. سنميّز فيما يلي بين «ما يذكره المشروع رسميًا / حالة فردية من طرف ثالث / ما اختبرته بنفسي / ما لا نعرفه». وقد تم التحقق من جميع البيانات في 2026-10-30.

أهم ما تحتاج معرفته عن claude-mem

ابدأ بهذا الجدول لتقرر إن كنت تريد متابعة القراءة.

النقطة	التفاصيل	ماذا يعني ذلك لك؟
الشعبية	مستودع GitHub باسم `thedotmack/claude-mem`، حاصل على 105,017 نجمة، ومرخّص بموجب Apache-2.0 (وفق GitHub API في 2026-10-30)	عدد النجوم مؤشر على الشعبية فقط؛ عليك أن تقرر بنفسك إن كانت الأداة مناسبة لك
الإصدار	أحدث إصدار على npm وفي إصدارات GitHub هو 15.6.0 (2026-10-29)، بينما تعرض شارة README الرقم 15.7.0؛ وهناك تعارض بينهما	اعتمد إصدار npm، ولا تدع الشارة تضللك
الاشتراك الافتراضي	تختار أداة التثبيت CMEM Pro افتراضيًا، بتكلفة 30 دولارًا شهريًا بعد تجربة مدتها 30 يومًا	إذا لم ترد الاشتراك، فاختر مسارًا آخر
مسار بلا رسوم شهرية	استخدم `--provider claude` مع باقة Claude الخاصة بك، أو عدّل الإعدادات بعد التثبيت لاستخدام مفتاحك الخاص	ستُحتسب التكلفة من حصة باقتك أو رصيد API
ليس محليًا بالكامل	يطّلع نموذج المراقب على محتوى استدعاءات الأدوات	فكّر جيدًا قبل استخدامه مع مستودعات حساسة

📷 موضع لقطة شاشة تُضاف أثناء التحرير: الصفحة الرئيسية لمستودع GitHub ‏(thedotmack/claude-mem)، مع ظهور عدد النجوم وأحدث إصدار.

ما الذي يتذكره claude-mem بالضبط؟

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

تمر العملية بخمس مراحل:

hooks (خطافات دورة الحياة): يطلق Claude Code أحداثًا عند بدء الجلسة، وإرسال الموجه، وقبل استدعاء الأدوات وبعده، وعند التوقف وانتهاء الجلسة. ويربط claude-mem خطافاته بهذه الأحداث.
worker (العامل): خدمة HTTP تعمل محليًا باستخدام Bun وتتلقى أحداث الخطافات. المنفذ الافتراضي هو 37700 + (uid % 100)، لذا ليس بالضرورة أن يكون 37700.
observer (نموذج المراقبة): يرسل العامل استدعاءات الأدوات الخام إلى نموذج يضغطها في سجلات مراقبة منظّمة.
observation (سجل المراقبة): يتضمن كل سجل نوعًا وعنوانًا ووصفًا والملفات المعنية. تُكتب السجلات في ~/.claude-mem/claude-mem.db باستخدام SQLite، بينما يُحفظ فهرس المتجهات في ~/.claude-mem/chroma/؛ وChroma قاعدة بيانات متجهات تُستخدم للبحث الدلالي.
الحقن عند SessionStart التالية: عند بدء جلسة جديدة، تُحقن تلقائيًا أحدث سجلات المراقبة ذات الصلة بالمشروع الحالي، بحد أقصى 50 سجلًا افتراضيًا. ويمكن لـ Claude أيضًا استرجاع ذكريات أقدم عند الحاجة باستخدام أدوات MCP، عبر ثلاث مراحل: search → timeline → get_observations.

انتبه إلى أنه لا يسجل إلا المحتوى الذي تلتقطه الخطافات. فالأفكار التي تخطر لك خارج الجلسة، والنقاشات التي لا تمر عبر استدعاء الأدوات، لا تُضاف تلقائيًا إلى قاعدة البيانات. كذلك، فإن الذاكرة المدمجة في Claude Code، وهي MEMORY.md، وclaude-mem نظامان منفصلان يعملان بالتوازي افتراضيًا، وليسا الشيء نفسه.

ثلاثة شروط أساسية قبل تثبيت claude-mem

إذا لم يتحقق أي شرط من الشروط التالية، فلا تتعجل في التثبيت:

Claude Code ≥ 2.1.139: في الإصدارات الأقدم، يتم تجاهل args الخاصة بـ hook، ما يؤدي إلى عدم تسجيل أي شيء بصمت، وهي مشكلة يصعب تشخيصها. شغّل claude --version أولًا، وإذا كان الإصدار أقدم، فشغّل claude update.
Node 20+: تحدد حزمة npm الإصدارات المدعومة بالتعبير ^20.19.0 || >=22.12.0؛ تحقق من إصدارك باستخدام node -v. يتولى برنامج التثبيت تثبيت Bun (≥1.1.31) وuv تلقائيًا. وفي اختبار مستقل على Ubuntu 26.04، شغل Bun وuv وChroma معًا نحو 1.2 GB من مساحة القرص.
قبول اطّلاع المراقب (observer) على محتوى استدعاءات الأدوات: أيًا كان المسار الذي تختاره، ستُرسل استدعاءات الأدوات والموجهات والمواد المستخدمة في إعداد الملخصات إلى مزود خدمة المراقبة الذي تختاره. إذا كان المستودع يحتوي على مفاتيح سرية أو بيانات عملاء أو شيفرة غير منشورة، فلا تفعّله قبل مراجعة ذلك.

لا يحتاج مستخدمو Windows إلى Git Bash لتشغيل hooks، لكن عليهم إعادة تشغيل الطرفية أو بيئة التطوير المتكاملة (IDE) بعد التثبيت حتى يسري تعديل PATH.

كيف تختار بين مسارات تثبيت claude-mem الثلاثة؟

المسار	هل يتطلب حساب cmem؟	مصدر التكلفة	إلى من تُرسل المحتويات؟	لمن يناسب؟
A: ‏CMEM Pro الافتراضي	نعم، وتتطلب النسخة التجريبية ربط بطاقة	يبدأ من 30 دولارًا/شهر، مع تجربة لمدة 30 يومًا	خدمة المراقبة المستضافة على cmem.ai	من لا يريد إعداد مفتاح، أو يحتاج إلى المزامنة السحابية أو العمل على أجهزة متعددة
B: ‏`--provider claude`	لا	يُستهلك من حصة اشتراك Claude	Anthropic	من لديه اشتراك Claude بالفعل
C: تثبيت B ثم استخدام مفتاحك الخاص	لا	الدفع حسب استخدام مزود الخدمة	نقطة النهاية التي تضبطها، مثل APIYI على apiyi.com	من يريد التحكم في التكلفة أو لديه رصيد API

يمثل سوق الإضافات طريقة أخرى للتثبيت، وسنشرحها أدناه بشكل منفصل باعتبارها المسار C’. أما المسار الثالث فيتطلب البدء بالمسار B: فقيمة openai-compatible ليست من الخيارات المتاحة للمعامل --provider في أداة التثبيت، ولا يمكن استخدامها إلا بتعديل الإعدادات يدويًا بعد التثبيت.

المسار A: ‏CMEM Pro الافتراضي (الخيار الافتراضي في أداة تثبيت claude-mem)

شغّل npx claude-mem install.
ما ستراه: في الخطوة الأولى، تُحدَّد أدوات Agent المكتشفة مسبقًا ويُثبَّت بيئة التشغيل. في الخطوة الثانية، يظهر رمز جهاز بصيغة XXXX-XXXX، ثم يُفتح المتصفح لإكمال تفويض OAuth (لا تتوقف عند خطوة تسجيل الدخول). في الخطوة الثالثة، يُحدَّد CMEM Pro افتراضيًا بوصفه مزوّد الذاكرة، وعند اختياره تُفتح صفحة الدفع أو التجربة.
شروط يجدر الانتباه إليها (وفق صفحة الأسعار الرسمية، بعد التحقق في 2026-10-30):
تتطلب التجربة بطاقة ائتمان أو بطاقة خصم، ولا تُقبل البطاقات مسبقة الدفع.
تبدأ الفوترة عند انتهاء التجربة أو استهلاك الحصة المضمنة، أيهما يحدث أولًا.
قد تنقل إعدادات الترقية التلقائية الاشتراك من Pro إلى Heavy ‏($70 شهريًا) أو Max ‏($100 شهريًا). تذكر كثير من الشروحات فقط عبارة «لا حاجة إلى بطاقة»، وتغفل هذه الخطوة.
كيف تتأكد من نجاح التثبيت: عند انتهاء التثبيت، ستظهر بيانات Version وPlugin dir وIDEs وAccount وCloud sync وWorker URL. بعد ذلك، نفّذ اختبارات التحقق الخمسة الواردة لاحقًا.

المسار B: تثبيت claude-mem دون رسوم شهرية باستخدام `--provider claude`

شغّل الأمر npx claude-mem install --provider claude.
إذا كنت تريد الاحتفاظ بنظام ذاكرة واحد فقط، فاستخدم npx claude-mem install --provider claude --disable-auto-memory. يضبط هذا الخيار المتغير CLAUDE_CODE_DISABLE_AUTO_MEMORY=1، ما يعطّل الذاكرة التلقائية المدمجة في Claude Code.
ما الذي ستراه؟: Skipping claude-mem login: --provider claude runs memory on your own Anthropic plan. وCloud sync: OFF (local) وAuto-memory: left enabled (عند عدم إضافة خيار التعطيل). سيطلب منك المثبّت أيضًا اختيار نموذج المراقبة؛ اختر Haiku، وليس Opus.
كيف تتأكد من النجاح؟: لم تظهر صفحة تسجيل الدخول إلى cmem أو الدفع في أي مرحلة، ويعرض npx claude-mem doctor علامة نجاح لجميع الفحوصات.

في الشيفرة المصدرية، لا يتطلب تسجيل الدخول سوى المزوّدين claude وhost. وأظهر اختبار مستقل أن استخدام --provider openrouter يتوقف عند الرسالة Waiting for OAuth login in the browser…. لذلك، إذا أردت استخدام مفتاح من طرف ثالث، فالترتيب الصحيح هو إكمال التثبيت عبر المسار B أولًا، ثم تعديل الإعدادات.

المسار C’: سوق إضافات Claude Code

أدخل /plugin marketplace add thedotmack/claude-mem في Claude Code.
أدخل /plugin install claude-mem، ثم أعد تشغيل Claude Code.
ما الذي ستراه؟: قد لا تتوفر أي ذكريات في الجلسة الأولى، لأن المشغّل لا يزال قيد البناء. لتجاوز هذه الفجوة، شغّل npx claude-mem install --provider claude مرة واحدة.
لا تستخدم أبدًا npm install -g claude-mem: فهو يثبّت مكتبة SDK فقط، ولا يسجّل الخطافات أو يشغّل العامل، كما قد يحجب المشغّل الفعلي.

كيف تتحقق من نجاح تثبيت claude-mem؟ 5 فحوصات

تذكّر أولًا أن الجلسة الأولى مخصّصة لجمع المعلومات؛ فلا يوجد فيها سجل سابق يمكن إدراجه. ستظهر الذاكرة في الجلسة الثانية. إذا توقعت أن «يتذكرك» من الجلسة الأولى، فقد تظن خطأً أن التثبيت فشل.

#	الفحص	الأمر / الإجراء	معيار النجاح
1	doctor	`npx claude-mem doctor`	ظهور ✓ أمام كل من Bun وuv وPlugin وHook launcher وWorker وClaude Code version‏ (2.1.139+) وChroma
2	status	`npx claude-mem status`	يعمل الـ worker بصورة سليمة ويظهر رقم المنفذ
3	viewer	افتح `http://127.0.0.1:<PORT>/` في المتصفح؛ وتوجد الذاكرة في `/viewer`	تُفتح الصفحة، وتظهر سجلات بعد إتمام جلسة
4	sqlite count	`sqlite3 ~/.claude-mem/claude-mem.db "select count(*) from observations;"`	تكون القيمة المُعادة أكبر من 0 بعد انتهاء الجلسة الأولى
5	context inject	`curl "http://127.0.0.1:<PORT>/api/context/inject?project=<项目名>"`	المحتوى المُعاد هو الذاكرة التي ستُدرج في الجلسة التالية

يمكنك العثور على رقم المنفذ في قيمة CLAUDE_MEM_WORKER_PORT داخل الملف ~/.claude-mem/settings.json، ويمكنك أيضًا التأكد باستخدام curl http://127.0.0.1:<PORT>/api/health. أكثر سطر عرضة للمشكلات في مخرجات doctor هو Hook launcher. إذا ظهرت not on PATH أو is not the claude-mem hook launcher، فعالج المشكلة أولًا قبل فحص البنود الأخرى.

📷 مكان لقطة شاشة، تُضاف أثناء التحرير: صفحة worker viewer‏ (/viewer، وتعرض قائمة الملاحظات)

تكلفة claude-mem: «توفير 96%» رسميًا مقابل «+4,226 رمزًا» في اختبار مستقل

الرقمان صحيحان، لكنهما يقيسان شيئين مختلفين، لذا لا يمكن المقارنة بينهما مباشرة.

تقديرات المشروع الرسمية: تستهلك 4 ملاحظات نحو 1,093 رمزًا، مقابل 26,447 رمزًا للسجل الأصلي، أي «توفير نحو 96%». كما أن البحث ثلاثي المراحل عبر MCP «يوفر نحو 10 أضعاف مقارنة بحقن المحتوى كاملًا». هذه تقديرات فريق المشروع، وليست تدقيقًا مستقلًا.
اختبار مستقل واحد (ComputingForGeeks، 2026-10-24، الإصدار 15.0.2 من claude-mem، ونموذج Sonnet عبر OpenRouter): عند إرسال العبارة نفسها «Reply with the single word ready»، بلغ الإدخال 28,489 رمزًا دون تفعيل claude-mem. وبعد تفعيله، وصل الإدخال إلى 32,715 رمزًا حتى مع ذاكرة فارغة، بزيادة 4,226 رمزًا، أي نحو 14.8%، وتكلفة إضافية قدرها $0.010. هذا اختبار واحد على جهاز واحد ومشروع واحد، ولا يعني أن فاتورتك ستكون مماثلة.

الخلاصة: «التوفير» يعني أن الذاكرة أكثر اختصارًا من السجلات الأصلية، أما «الزيادة» فهي تكلفة إضافية ثابتة تتحملها كل جلسة. كلما زاد نشاط المشروع وعدد العناصر المحقونة، ارتفعت هذه التكلفة. وفي النصف الأول من عام 2026، أبلغ مستخدمون في Issue #618 و#2469 عن استهلاك الرموز بسرعة. تعكس تلك البلاغات تجربة إصدارات أقدم، ولا تمثل بالضرورة الوضع في الإصدار 15.6.0، لكنها تذكّرنا بأن الذاكرة ليست مجانية.

5 إعدادات للتحكم في تكلفة claude-mem

CLAUDE_MEM_CONTEXT_OBSERVATIONS：القيمة الافتراضية 50؛ تخفيضها إلى 10–20 يقلل مباشرةً كمية المعلومات المحقونة.
CLAUDE_MEM_SEMANTIC_INJECT：أبقِ القيمة الافتراضية false. عند تفعيلها، تُضاف الذكريات ذات الصلة إلى كل موجه.
CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES：أبقِ القيمة الافتراضية false، وإلا ستُحقن ذكريات جميع الأجهزة المضيفة.
CLAUDE_MEM_DISABLE_TOOL_HOOKS=1：يعطّل تسجيل الملاحظات على مستوى استدعاءات الأدوات، ويكتفي بملخصات الجلسات، مما يوفر الرموز ويقلل عبء العمليات.
CLAUDE_MEM_OPENAI_COMPAT_OBSERVATION_BATCH_SIZE：القيمة الافتراضية 1؛ زدها تدريجيًا عند تراكم الأحداث، ولا تضبطها على 32 منذ البداية.

مقارنة تكاليف الخيارات الثلاثة

الخيار	طريقة الفوترة	السعر بالدولار	مناسب لـ
CMEM Pro	اشتراك	$30 شهريًا، مع فترة تجريبية لمدة 30 يومًا (Heavy بسعر $70 وMax بسعر $100)	المستخدمين المكثفين ومن يحتاجون إلى المزامنة السحابية
باقة Claude	استهلاك حصة الاشتراك	دون رسوم منفصلة، لكنه يستهلك من الحصة المتاحة لكتابة الشفرة	من لديهم اشتراك في Claude
APIYI `claude-haiku-5-5`	حسب الاستهلاك	الإدخال $0.1 / الإخراج $0.5 / قراءة ذاكرة التخزين المؤقت $0.01 لكل مليون رمز (للطلب الواحد ≤100,000 رمز؛ وعند تجاوز 100,000 رمز يصبح سعر الإدخال $0.5 لكل مليون رمز، وفق تسعير متدرج)	المستخدمين قليلي ومتوسطي الاستخدام

بيانات الأسعار مأخوذة من قائمة الأسعار الشاملة لدى APIYI على apiyi.com، والتي حُدّثت في 2026-10-27 الساعة 14:50 بتوقيت UTC+8. يُرجى الرجوع إلى قائمة نماذج المنصة للتحقق من النماذج والأسعار، وإلى لوحة التحكم لمعرفة المبلغ الفعلي المخصوم. وللمقارنة، يبلغ سعر claude-haiku-4-5-20251001 على المنصة نفسها $1 للإدخال و$5 للإخراج و$0.1 لقراءة ذاكرة التخزين المؤقت، بينما تبلغ الأسعار لـ claude-sonnet-5-5 ‏$2 / $10 / $0.1، ولـ claude-opus-5-5 ‏$4 / $20 / $0.2. يؤدي المكوّن observer مهام صغيرة ومهيكلة ومتكررة، لذا يكفيه نموذج من فئة Haiku. تناسب الفوترة حسب الاستهلاك الاستخدام القليل والمتوسط؛ أما المستخدمون المكثفون، فمن الأفضل أن يحسبوا تكلفة استهلاكهم الفعلي خلال أسبوع ثم يقارنوها باشتراك $30 شهريًا.

استبدال مراقب claude-mem بـ APIYI

هذه هي خطوات المسار C كاملة، وهي مناسبة للمطورين في الصين الذين لديهم رصيد API بالفعل ولا يرغبون في دفع اشتراك منفصل للذاكرة. يدعم APIYI شحن الرصيد بالرنمينبي، ويحتسب التكلفة بسعر صرف ثابت قدره 1:7، وفقًا لصفحة الأسعار الرسمية.

ثبّت claude-mem أولًا وفق المسار B: npx claude-mem install --provider claude.
افتح ~/.claude-mem/settings.json وأضف المفاتيح الأربعة التالية:
"CLAUDE_MEM_PROVIDER": "openai-compatible"
"CLAUDE_MEM_OPENAI_COMPAT_BASE_URL": "https://api.apiyi.com/v1"
"CLAUDE_MEM_OPENAI_COMPAT_MODEL": "claude-haiku-5-5"
"CLAUDE_MEM_OPENAI_COMPAT_API_KEY": "sk-你的APIYIkey"
إذا كنت لا تريد كتابة المفتاح كنص واضح في الإعدادات، يمكنك وضعه بدلًا من ذلك في ~/.claude-mem/.env: ‏OPENAI_COMPAT_API_KEY=sk-你的APIYIkey (صلاحيات المجلد 0700، وصلاحيات الملف 0600).
شغّل npx claude-mem restart. تُقرأ بيانات الاعتماد عند بدء تشغيل العامل فقط، لذا لن تسري التغييرات دون إعادة تشغيله.
كيف تتأكد من نجاح الإعداد؟ يُظهر الأمر npx claude-mem doctor أن مزوّد الخدمة هو openai-compatible، وتظهر الملاحظة التالية الناتجة عن جلسة جديدة في العارض.

هناك مشكلتان يجدر تجنبهما مسبقًا. أولًا، يجب أن يتضمن عنوان URL الأساسي اللاحقة /v1، وألا ينتهي بشرطة مائلة، وإلا سينتج عنوان بشرطتين مائلتين ويؤدي إلى خطأ 404. لمعرفة الفرق بين الأنواع الثلاثة لعناوين URL الأساسية، راجع: help.apiyi.com/apiyi-base-url-v1-claude-gemini-endpoint-config-guide.html. ثانيًا، إذا غاب أي مفتاح من المفاتيح الأربعة، فسيعود claude-mem بصمت إلى مسار Claude. سيبدو كل شيء طبيعيًا، لكن التكلفة ستُخصم من الباقة.

اختبار واجهة API فعليًا (اختبرته بمفتاح API من APIYI في 2026-10-30):

أعاد GET /v1/models حالة 200 وقائمة تضم 259 نموذجًا، من بينها claude-haiku-5-5.
أعاد POST /v1/chat/completions باستخدام claude-haiku-5-5 ومعه response_format: {type: "json_object"} حالة 200 خلال نحو 2.0 ثانية، وأنتج JSON صالحًا باستهلاك 59 رمزًا.
عند إضافة الحقل reasoning: {enabled: false} الذي يرسله claude-mem، عاد الطلب أيضًا بحالة 200 دون خطأ 400.
أعادت نقطة نهاية Anthropic الأصلية /v1/messages حالة 200 أيضًا.

حدود النتيجة: التحقق أعلاه يثبت فقط أن «نقطة نهاية APIYI تقبل صيغة الطلبات التي يحتاجها claude-mem». لم أختبر مسار الملاحظات في claude-mem كاملًا على جهازي، ونجاح اختبارات الواجهة لا يعني التحقق من مسار الإضافة بأكمله.

🚀 نصيحة للبدء سريعًا: أنشئ أولًا مفتاحًا منفصلًا في لوحة تحكم APIYI على apiyi.com، وخصصه لـ claude-mem. بهذه الطريقة يمكنك بعد أسبوع مراجعة استهلاك هذا المفتاح وحده، وتحديد ما إذا كانت المحاسبة حسب الاستخدام أوفر من الاشتراك. وإذا كنت تخطط أيضًا لربط Claude Code نفسه، يمكنك مراجعة: help.apiyi.com/claude-code-apiyi-integration-tutorial.html.

خصوصية claude-mem: ما الذي يبقى محليًا وما الذي يُرسل إلى الخارج

التخزين المحلي (كل الملفات في ~/.claude-mem/، ويمكن تغيير الموقع باستخدام CLAUDE_MEM_DATA_DIR): قاعدة البيانات claude-mem.db التي تضم الجلسات والملاحظات والملخصات والموجهات، وفهرس المتجهات chroma/، وlogs/، وsettings.json، بالإضافة إلى مجلد لقطات الشاشة media-v1/ الذي يكون معطّلًا افتراضيًا.

المحتوى الذي يغادر جهازك:

استدعاءات المراقب (observer): تُرسل محتويات استدعاءات الأدوات والموجهات والمواد المستخدمة لإنشاء الملخصات إلى المزوّد الذي تختاره. إذا اخترت Anthropic، تُرسل إليه؛ وإذا اخترت CMEM، تُرسل إلى cmem.ai؛ وإذا اخترت APIYI، تُرسل إليه.
بيانات القياس عن بُعد مفعّلة افتراضيًا: تُرسل البيانات إلى PostHog باستخدام معرّف تثبيت UUID عشوائي، وتُحجب المعلومات الحساسة في رسائل الأخطاء. لتعطيلها، شغّل npx claude-mem telemetry disable أو اضبط DO_NOT_TRACK=1. وسيطرح برنامج التثبيت السؤال أيضًا في النهاية.
المزامنة السحابية تتطلب التفعيل يدويًا: وهي معطّلة افتراضيًا. عند تفعيلها، تُرفع الملاحظات وملخصات الجلسات والنصوص الكاملة للموجهات إلى cmem.ai.

وسائل التحكم المتاحة لك:

يُزال المحتوى المحاط بـ <private>...</private> في طبقة الخطاف (hook)، ولا يدخل قاعدة البيانات.
حجب البيانات الحساسة تلقائيًا معطّل افتراضيًا. يجب ضبط CLAUDE_MEM_REDACT_ENABLED=true لتفعيل 16 نمطًا مدمجًا للكشف عن المفاتيح، مثل AWS وGitHub PAT ومفاتيح OpenAI/Anthropic وJWT وPEM. ويمكن إضافة 3 أنماط عامة بضبط CLAUDE_MEM_REDACT_GENERIC_ENABLED=true. لا تفترض أنه سيحجب البيانات الحساسة تلقائيًا.

جدول استكشاف أعطال claude-mem الشائعة وإصلاحها

المشكلة	السبب	الحل
كل hook يعرض الخطأ `Executable not found in $PATH: "claude-mem"`	برنامج التشغيل غير موجود في PATH	شغّل `npx claude-mem install` لإعادة التثبيت، ثم أعد تشغيل الطرفية وبيئة التطوير وClaude Code
تعرض الجلسة `memory hooks are not active`	برنامج التشغيل لم يُفعّل	اتبع الخطوات السابقة، ثم شغّل `npx claude-mem doctor` وتحقق من سطر Hook launcher
لا تُسجّل أي بيانات ولا تظهر أخطاء	إصدار Claude Code أقدم من 2.1.139	شغّل `claude update`
أمر `claude-mem` محجوب ببرنامج آخر	سبق تشغيل `npm install -g claude-mem`	استخدم `which -a claude-mem` للعثور عليه، ثم شغّل `npm uninstall -g claude-mem`
لا تفتح واجهة العرض	المنفذ ليس 37700، أو أن الـ worker لم يبدأ	تحقق من المنفذ في الإعدادات، ثم شغّل `curl http://127.0.0.1:<PORT>/health`
المنفذ مشغول	تعارض مع عملية أخرى	اضبط `export CLAUDE_MEM_WORKER_PORT=38000`، ثم أعد تشغيل الـ worker
نقطة النهاية المخصصة تعرض خطأ 404	عنوان URL الأساسي غير صحيح	استخدم `/v1` مع الواجهات المتوافقة مع OpenAI، والنطاق الجذري مع واجهة Anthropic الأصلية؛ وتأكد من ظهور معرّف النموذج في `/v1/models`
أُعدّ مفتاح لطرف ثالث، لكن الطلبات ما زالت تمر عبر Claude	لم تُضبط المفاتيح الأربعة كلها، فينتقل النظام إلى الخيار البديل دون تنبيه	أكمل الإعدادات وشغّل `npx claude-mem restart`
الملاحظة فارغة أو مقتطعة	النموذج الصغير لا يلتزم ببنية JSON، أو بلغ الحد الأقصى للمخرجات	زد قيمة `CLAUDE_MEM_OBSERVER_MAX_OUTPUT_TOKENS` (الافتراضية 4096)، أو استخدم نموذجًا أكثر استقرارًا
انتهاء المهلة بشكل متكرر	يُلغى طلب البث إذا لم يتلقَّ أي رمز لمدة 90 ثانية	زد قيمة `CLAUDE_MEM_LLM_STREAM_IDLE_TIMEOUT_MS`، أو استخدم نموذجًا أصغر
يستمر الـ hook في إيقاف الـ worker	عدم تطابق إصدار الإضافة مع إصدار الـ worker (المشكلتان #3857 و#3940، وقد أُصلحتا)	شغّل `npx claude-mem update`، وعند الحاجة شغّل `npx claude-mem@latest install`
نظاما الذاكرة يتعارضان	تعمل الذاكرة التلقائية المدمجة وclaude-mem بالتوازي	أضف `--disable-auto-memory` عند إعادة التثبيت

مخاطر claude-mem واحتمال حظر الحساب على مسؤوليتك

يرجى قراءة هذا القسم قبل التثبيت.

مشروع مجتمعي بلا ضمانات: ‏claude-mem مشروع مفتوح المصدر من المجتمع، وليس منتجًا رسميًا من APIYI. ولا تقدم APIYI ضمانات له أو اتفاقية مستوى خدمة (SLA).
إرسال المحتوى إلى جهة خارجية: يُرسل محتوى استدعاءات الأدوات إلى المراقب (observer) الذي تختاره. لا تفعّله في مستودعات تحتوي على مفاتيح سرية أو بيانات عملاء أو شيفرة غير منشورة.
استهلاك الحصة: قد يستهلك أعدادًا كبيرة من الرموز (tokens) أو حصة باقتك. يُنصح بتجربته أولًا على مشروع صغير لمدة أسبوع، ومراقبة الفاتورة قبل اتخاذ القرار.
قيود الأمان وحدود المعدل: قد تؤدي المشغّلات (hooks) المتكررة، والحسابات المشتركة، ومفاتيح خدمة وكيل API إلى تفعيل إجراءات الأمان أو حدود المعدل لدى المنصة. يُنصح بالتجربة باستخدام مفتاح منفصل وحساب ثانوي ومشروع واحد. تتحمل أنت مسؤولية العواقب. تؤكد هذه المقالة نجاح اختبار واجهة API الخاصة بـ APIYI فقط، ولا تضمن عدم فرض حدود على المعدل.
بقاء ملفات بعد إلغاء التثبيت: بعد تنفيذ npx claude-mem uninstall، يبقى المجلد ~/.claude-mem بما فيه من قاعدة بيانات ومفاتيح ربما تكون محفوظة. لحذفه، يجب تنفيذ rm -rf ~/.claude-mem يدويًا. كذلك، تبيّن من اختبار أجرته جهة خارجية أن المجلدين ~/.bun و~/.cache/uv يشغلان نحو 1.1 غيغابايت؛ ويمكن حذفهما أيضًا إذا لم تكن مشروعات أخرى تستخدمهما.

الأسئلة الشائعة حول claude-mem

س1: هل يعني حصول claude-mem على 100 ألف نجمة أنه جيد بالضرورة؟

لا. عدد النجوم يعكس الشعبية فقط. عليك تقييم استهلاك الرموز وحدود الخصوصية وتيرة تحديث الإصدارات بنفسك. كما لم يُجرَ تدقيق مستقل للتحقق مما إذا كان نمو النجوم طبيعيًا بالكامل.

س2: هل claude-mem هو نفسه نظام الذاكرة المدمج في Claude Code؟

لا. الذاكرة الأصلية تعتمد على ملف MEMORY.md، بينما يستخدم claude-mem خطافات وقاعدة بيانات مستقلتين، ويعمل النظامان بالتوازي افتراضيًا. إذا أردت الاحتفاظ بنظام واحد فقط، أضف `–disable-auto-memory` عند التثبيت.

س3: هل تتوفر الذاكرة بعد الجلسة الأولى مباشرة؟

لا. تُستخدم الجلسة الأولى لجمع المعلومات وضغطها، ولا تُحقن الذاكرة إلا في الجلسة الثانية. للتأكد، استخدم البند الرابع من اختبار القبول (sqlite count) والبند الخامس (context inject).

س4: هل يمكن استخدام claude-mem دون ربط بطاقة أو دفع اشتراك؟

نعم. ثبّته باستخدام `–provider claude`، وسيستهلك من حصة باقة Claude. أو بدّل observer بعد التثبيت إلى مفتاح بنظام الدفع حسب الاستخدام من APIYI على apiyi.com، لتُحاسب على الرموز المستهلكة فعليًا. ويحصل المستخدمون الجدد أيضًا على رصيد تجريبي مجاني.

س5: ما النموذج المناسب لـ observer؟

استخدم نموذجًا من فئة Haiku، مثل `claude-haiku-5-5`. فمهام observation صغيرة ومنظمة ومتكررة؛ واستخدام نموذج متقدم مثل Opus مكلف، وقد يستهلك ميزانية الإخراج في التفكير.

س6: هل يمكن استخدام نموذج محلي فقط؟

نعم. وجّه `openai-compatible` إلى Ollama أو LM Studio أو vLLM. لكن يجب أن يكون النموذج الصغير قادرًا على إخراج بنية JSON الخاصة بـ observation باستمرار، وإلا فسينتج سجلات فارغة.

س7: كيف أفعّل observation باللغة الصينية؟

اضبط `”CLAUDE_MEM_MODE”: “code–zh”` في settings. هذا وضع مدمج لا يحتاج إلى تثبيت إضافي. بعد ذلك، أعد تشغيل Claude Code.

أبرز النقاط حول claude-mem

آلية العمل: تلتقط hooks استدعاءات الأدوات، ثم يضغطها observer ويخزنها في SQLite لإدراجها في الجلسة التالية.
انتبه للإعداد الافتراضي: يحدد مُثبّت الإصدار 15 خيار CMEM Pro مسبقًا. تتطلب الفترة التجريبية ربط بطاقة دفع، ثم تبلغ التكلفة 30 دولارًا شهريًا.
بدون رسوم شهرية ثابتة: ثبّت باستخدام --provider claude، ثم عدّل الإعدادات عند الحاجة لاستخدام مفتاحك الخاص.
التكلفة: يعلن المشروع عن «توفير 96%»، بينما سجل اختبار مستقل واحد زيادة قدرها «4,226 رمزًا». ويختلف أساس المقارنة بين الرقمين.
الخصوصية: يرسل observer المحتوى إلى جهة خارجية، وتُفعّل بيانات القياس عن بُعد افتراضيًا، بينما يلزم تفعيل إخفاء البيانات الحساسة والمزامنة السحابية يدويًا.
طريقة البدء: أنشئ مفتاحًا منفصلًا في APIYI على apiyi.com، واستخدمه مع claude-haiku-5-5 بنظام الدفع حسب الاستخدام لمدة أسبوع، ثم احسب التكلفة.

الخلاصة: لمن تناسب ذاكرة claude-mem بين الجلسات، ولمن لا تناسب؟

ثلاث فئات يُنصح لها بالتثبيت:

من يعملون على المشروع نفسه لفترة طويلة ويغلقون جلسات Claude Code ويعيدون فتحها كثيرًا.
من يحتاجون باستمرار إلى إجابات عن أسئلة مثل «لماذا أجرينا هذا التغيير آخر مرة؟» أو «كيف أصلحنا ذلك الخلل في النهاية؟».
من يستطيعون تخصيص 10 دقائق للإعداد، ولا يمانعون أن يقرأ observer محتوى استدعاءات الأدوات.

ثلاث فئات لا يُنصح لها بالتثبيت:

من يشغّلون سكربتات لمرة واحدة ولا يعملون على مشروع مستمر. استخدام CLAUDE.md مع ملاحظاتهم الخاصة أقل تكلفة.
من لا يُسمح لهم بإخراج الشفرة أو البيانات من أجهزتهم أو من منطقة امتثال محددة.
مستخدمو الأجهزة ذات المساحة أو قدرة المعالجة المحدودة، ومن يتوقعون أن يصبح النظام «أذكى فور تثبيته».

إذا قررت التثبيت، فاتبع هذا الترتيب لتجنب المشكلات قدر الإمكان: «المسار B ← التحقق من العناصر الخمسة ← تقليل عدد العناصر المُدرجة ← تغيير observer عند الحاجة». وإذا أردت تجربة تكلفة observer بنظام الدفع حسب الاستخدام، يمكنك أولًا تشغيل مشروع صغير باستخدام الرصيد المجاني في APIYI على apiyi.com.

📚 المراجع

مستودع claude-mem على GitHub: الشفرة المصدرية والإصدارات والمشكلات
الرابط: github.com/thedotmack/claude-mem
التفاصيل: عدد النجوم والإصدارات وسجلات المشكلات #618 و#2469 و#3857 و#3940 وغيرها
الوثائق الرسمية لـ claude-mem: التثبيت والإعداد واستكشاف الأخطاء وإصلاحها
الرابط: docs.claude-mem.ai/installation
التفاصيل: متطلبات النظام والقيم الافتراضية للإعدادات وإعداد موفّر متوافق مع OpenAI
صفحة أسعار CMEM: شروط CMEM Pro وHeavy وMax
الرابط: cmem.ai/pricing
التفاصيل: الفترة التجريبية لمدة 30 يومًا، واشتراط ربط بطاقة دفع، وتاريخ بدء الفوترة (تم التحقق في 2026-10-30)
اختبار مستقل من ComputingForGeeks: تثبيت الإصدار 15.0.2 واستهلاك الرموز
الرابط: computingforgeeks.com/claude-mem-claude-code
التفاصيل: مصدر بيانات الزيادة البالغة 4,226 رمزًا في حالة واحدة (2026-10-24)
وثائق نماذج APIYI: قائمة النماذج والأسعار
الرابط: docs.apiyi.com/models
التفاصيل: يُرجى الرجوع إلى قائمة النماذج على المنصة لمعرفة النماذج والأسعار المعتمدة

الكاتب: الفريق التقني في APIYI
للتواصل التقني: إذا واجهت مشكلة في نقاط النهاية أو النماذج أثناء الإعداد، يمكنك التواصل معنا عبر الصفحة الرئيسية لموقع APIYI الرسمي. ولمزيد من إرشادات التكامل، تفضل بزيارة مركز الوثائق على docs.apiyi.com

كيف تثبّت claude-mem الحاصل على 100 ألف نجمة؟ أضف الذاكرة في 3 خطوات وتجنب فخاخ الفترة التجريبية