Claude-Mem: إضافة ذاكرة دائمة لـ Claude Code
Claude-Mem إضافة من طرف ثالث تراقب ما يفعله وكيلك، وتكلّف وكيلًا ثانيًا بضغط ذلك في ملاحظات قصيرة، ثم تحقن فهرسًا مختصرًا منها في الجلسة التالية. إليك ما تفعله فعلًا، وكيف تُثبَّت وتُضبط، وأين تنتهي هي ويبدأ CLAUDE.md.
Claude-Mem في لمحة
- إنها طبقة ذاكرة، لا ملف قواعد: تمرّر الـ hooks كل استدعاء أداة إلى عامل محلي، ويحوّل وكيل ثانٍ هذا النشاط إلى ملاحظات قصيرة، وتبدأ الجلسة التالية بفهرس مختصر منها.
- طريقتان مدعومتان للتثبيت: npx claude-mem install (يهيّئ بيئة التشغيل ويفتح إعدادًا في المتصفح)، أو الزوج /plugin marketplace add thedotmack/claude-mem ثم /plugin install claude-mem.
- Apache-2.0، بلغة TypeScript، يصونه Alex Newman (thedotmack). تُخزَّن الذاكرة محليًا في SQLite على المسار ~/.claude-mem/claude-mem.db؛ والمزامنة السحابية اختيارية.
- لا تحلّ محل CLAUDE.md ولا محل الذاكرة التلقائية في Claude Code — الثلاثة تُحمَّل عند بداية الجلسة وتجيب عن أسئلة مختلفة. جدول المقارنة أدناه هو النسخة المختصرة.
thedotmack/claude-mem — README
المصدرgithub.comchecked 2026-11-13
.claude-plugin/marketplace.json — claude-mem 15.18.3
المصدرraw.githubusercontent.comchecked 2026-11-13
Installation Guide
المصدرdocs.claude-mem.aichecked 2026-11-13
Configuration
المصدرdocs.claude-mem.aichecked 2026-11-13
Telemetry — what is collected and how to opt out
المصدرdocs.claude-mem.aichecked 2026-11-13
How Claude remembers your project — CLAUDE.md vs auto memory
المصدرcode.claude.comchecked 2026-11-13
dsh-claude-mem — DeepSeek Harness port (unofficial)
المصدرdeepseekharnessplugins.comchecked 2026-11-13
الأوامر والإعدادات والقيم الافتراضية والمسارات في هذه الصفحة مأخوذة من المستودع الأصلي والوثائق الرسمية في 2026-11-13. تُركت الأوامر وأسماء الإعدادات بلا ترجمة عن قصد، لأن الأمر المترجم أمر معطّل.
بيانات المستودع من GitHub API في 2026-11-13: 116,640 نجمة، 10,120 تفرّعًا، أُنشئ في 2025-08-31، آخر إصدار v15.18.3 نُشر في 2026-11-12. أعداد النجوم تتغيّر يوميًا — تعامل معها كلقطة، لا كتقييم.
ما هي Claude-Mem فعلًا
Claude-Mem إضافة مفتوحة المصدر لـ Claude Code (ولعشرات من وكلاء البرمجة الآخرين) تمنح الوكيل ذاكرة عن عمله هو. يصف المشروع المشكلة بصراحة: كل جلسة جديدة تبدأ من الصفر، وتعيد قراءة الملفات نفسها، وتعيد طرح الأسئلة نفسها، وتعود إلى أخطاء أصلحتموها معًا من قبل.
جوابها وكيل ثانٍ يعمل إلى جانب وكيلك. تمرّر الـ hooks المثبّتة في الوكيل المضيف كل استدعاء أداة — ما قُرئ وما عُدّل وما شُغّل — إلى عامل محلي صغير. يشغّل هذا العامل نموذج مراقبة على النشاط، ويكتب ملاحظات قصيرة منظّمة وملخّصًا في نهاية الجلسة، ويخزّنها في قاعدة بيانات SQLite محلية. وعند بدء جلسة جديدة، يتلقى الوكيل المضيف فهرسًا مختصرًا بالملاحظات المهمة لهذا المشروع، ولا يجلب التفاصيل الكاملة إلا عند طلبها.
إذن وحدة الذاكرة هنا ملاحظة عن عمل حدث فعلًا، لا تعليمة كتبتها أنت. هذا هو الفرق كله عن CLAUDE.md، ولهذا يتعايش الاثنان بدل أن يتنافسا.
- الترخيص
- Apache-2.0
- آخر إصدار
- v15.18.3 · 2026-11-12
- تقع الذاكرة في
~/.claude-mem/claude-mem.db- النجوم (2026-11-13)
- 116,640
كيف تعمل، في ثلاث خطوات
يصف README الحلقة في ثلاث جمل، وكل ميزة أخرى تتفرّع عنها:
- 1
وكيلك يعمل
تمرّر خطّافات دورة الحياة في الوكيل المضيف كل استدعاء أداة إلى عامل محلي صغير. في Claude Code تغطّي الخطّافات SessionStart وUserPromptSubmit وPreToolUse وPostToolUse وPostToolUseFailure وStop وSubagentStop وSessionEnd، إضافة إلى مدخل Setup من أجل claude --init و--maintenance. كل خطّاف أمر واحد بلا صدفة، claude-mem hook claude-code <event>.
- 2
المراقب يدوّن الملاحظات
يحوّل وكيل ثانٍ هذا النشاط إلى ملاحظات قصيرة ويكتب ملخّصًا عند انتهاء الجلسة. نموذج الضغط افتراضيًا هو Haiku (CLAUDE_MEM_MODEL=haiku) ويعمل على خطة Anthropic الخاصة بك؛ ويمكنك توجيهه إلى مفتاح OpenRouter أو Gemini بدلًا من ذلك، أو إلى مراقب الاستضافة لدى المزوّد.
- 3
الجلسة التالية تبدأ بها
عند SessionStart يتلقى الوكيل فهرسًا مختصرًا بملاحظات هذا المشروع — 50 افتراضيًا، يُضبط عبر CLAUDE_MEM_CONTEXT_OBSERVATIONS — ويجلب التفاصيل الكاملة عند الحاجة فقط. يبدأ الحقن من جلستك الثانية في المشروع، لأن الأولى لا شيء لديها لتحقنه بعد.
يعتمد البحث الفكرة الطبقية نفسها. ثلاث أدوات MCP — search وtimeline وget_observations — تعيد فهرسًا أولًا، ثم سياقًا زمنيًا، ثم السجلات الكاملة في النهاية، فيدفع الوكيل ثمن التفاصيل فقط في الصفوف التي اختارها. تقود مهارة mem-search هذه الأدوات نيابةً عنك، وأرقام README نفسه تقدّر صف الفهرس بنحو 50–100 رمز مقابل 500–1,000 للسجل الكامل — وهي نسبة لكل صف يقول README صراحةً إنها ليست توفيرًا مقيسًا من طرف إلى طرف.
ما يقدّمه العامل أيضًا
يوفّر العامل المحلي عارضًا على العنوان المطبوع عند بدء التشغيل — الذاكرة والجلسات والإعدادات على /viewer، وMy Work في الجذر — ويكشف أدوات تتجاوز البحث: smart_search وsmart_outline وsmart_unfold لتنقّل الشيفرة، وsave_memory لكتابة ملاحظة عن قصد، وتتبّع حالة العمل. ولكل ملاحظة معرّف يمكن الاستشهاد به عبر واجهة API الخاصة بالعامل.
التثبيت والتحقق
الطريقتان أدناه منقولتان من وثائق المشروع. طريقة المثبّت هي التي يوصي بها المشروع، لأنها تهيّئ بيئة التشغيل وتُصرّف مشغّل الخطّافات؛ أما طريقة الإضافة فهي طلبان داخل Claude Code.
الطريقة 1 — المثبّت
نفّذ هذا في الطرفية. يتحقق المثبّت من Bun وuv، وينسخ ملفات الإضافة، ويثبّت التبعيات، ويضع مشغّل claude-mem في PATH، ويفتح إعدادًا في المتصفح تختار فيه الوكلاء والتكاملات والمهارات ومزوّد الذاكرة. أبقِ الطرفية قيد التشغيل أثناء استخدامك تلك الصفحة.
npx claude-mem installلا تثبّتها عبر npm install -g claude-mem. يوضّح README أن التثبيت العام عبر npm يضع الـ SDK/المكتبة على جهازك فقط — فهو لا يسجّل أي خطّافات للإضافة ولا يشغّل أي عامل، وقد يحجب المشغّل الحقيقي في PATH.
الطريقة 2 — سوق الإضافات
أرسل هذين الأمرين كطلبين منفصلين داخل Claude Code، ثم أعد تشغيله. كلتا الطريقتين تضبطان الخطّافات وتشغّلان العامل؛ وبعدها يظهر السياق من الجلسات السابقة تلقائيًا في الجلسات الجديدة.
/plugin marketplace add thedotmack/claude-mem/plugin install claude-memالتثبيت عبر السوق وحده لا يتضمن خطوة مثبّت، لذا تضع الإضافة مشغّلها عند بداية الجلسة الأولى أثناء التصريف — قد تعمل تلك الجلسة الأولى بلا سياق من الذاكرة، ثم تحصل الجلسة التالية عليه. وتشغيل npx claude-mem install مرة واحدة يسدّ هذه الفجوة.
تحقّق من أنه يعمل فعلًا
نفّذ npx claude-mem doctor: يفحص Bun وuv ومشغّل الخطّافات والعامل، ويخبرك بما يجب إصلاحه. يطبع claude-mem --version رقم بروتوكول المشغّل، وعنوان العامل المطبوع عند بدء التشغيل يقدّم العارض. وإذا أبلغت الخطّافات عن «Executable not found in $PATH»، يُظهر doctor أيّ claude-mem يُحلّ في PATH وما إذا كان هو المشغّل.
npx claude-mem doctorclaude-mem --versionالمتطلبات قبل البدء
- 1Node.js 20.19 أو أحدث ضمن سلسلة 20.x، أو 22.12 أو أحدث.
- 2Bun 1.2.16 أو أحدث — به يُصرّف مشغّل الخطّافات؛ ويثبّت المثبّت Bun إن كان مفقودًا.
- 3uv، يُثبَّت تلقائيًا عند غيابه: يوفّر الجانب البايثوني من خدمة التضمين في Chroma للبحث الدلالي.
- 4Claude Code 2.1.139 أو أحدث — أول إصدار ينفّذ وسائط الخطّافات بصيغة exec. الإصدارات الأقدم تتجاهل الوسائط وتشغّل claude-mem مجرّدًا، فلا يُلتقط شيء. يأتي SQLite مضمّنًا عبر bun:sqlite.
الإعدادات التي تغيّر السلوك فعلًا
كل شيء في ~/.claude-mem/settings.json، يُنشأ تلقائيًا بالقيم الافتراضية عند أول تشغيل، ومتغيّر بيئة بالاسم نفسه يتجاوز الملف. هذه هي الصفوف الجديرة بالمعرفة؛ وتوثّق صفحة الإعدادات الباقي.
| الإعداد | الافتراضي | ما يفعله |
|---|---|---|
CLAUDE_MEM_MODEL | haiku | النموذج المستخدم لضغط الملاحظات عندما يكون المزوّد هو Claude. haiku يتبع أحدث Haiku؛ والمعرّف الكامل يثبّت إصدارًا واحدًا. |
CLAUDE_MEM_PROVIDER | claude | أي مزوّد يشغّل المراقب: claude أو codex أو gemini أو openrouter أو openai-compatible. |
CLAUDE_MEM_CONTEXT_OBSERVATIONS | 50 | عدد الملاحظات المحقونة عند بداية الجلسة. خفّضه إذا شعرت أن كتلة البداية ثقيلة. |
CLAUDE_MEM_MODE | code | ملف سير العمل ولغة الملاحظات المولّدة، مثل code، أو code--chill لملاحظات أقل، أو code--zh للصينية. |
CLAUDE_MEM_DATA_DIR | ~/.claude-mem | جذر البيانات. كل مسار آخر — قاعدة البيانات وفهرس Chroma والسجلات والإعدادات وملفات pid والمنفذ الخاصة بالعامل — يُشتقّ منه. |
CLAUDE_MEM_WORKER_PORT | 37700 + (uid % 100) | منفذ العامل. الافتراضي خاص بكل مستخدم، حتى لا يتصادم مستخدمان على جهاز واحد؛ اضبط منفذًا ثابتًا إن كنت تكتب سكربتات ضد واجهة HTTP API. |
CLAUDE_MEM_CONTEXT_PROJECTS | current | أي المشاريع يقرأ SessionStart ذاكرتها: current تعني هذا الـ checkout، وall تعني كل المشاريع باستثناء ما تستبعده بنمط glob. |
CLAUDE_MEM_SKIP_TOOLS | ListMcpResourcesTool, SlashCommand, Skill, TodoWrite, AskUserQuestion | الأدوات المستبعدة من الملاحظات. مفيد للأدوات التي يكون ناتجها ضجيجًا لا معرفة. |
CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES | false | هل يتضمن سياق SessionStart ملاحظات من كل الأطر، لا من الإطار الذي أنت فيه فقط. الافتراضي false. |
CLAUDE_MEM_SKILLS_DISABLED | (none) | يخفي المهارات المضمّنة من قائمة Claude Code وأوامر الشرطة المائلة، باسم المجلد المجرّد. |
وهناك إعدادان آخران يستحقان المعرفة: CLAUDE_MEM_SKIP_BASH_PATTERNS يأخذ تعبيرًا نمطيًا يُقارن بكل أمر shell حتى لا تتحول الأوامر الصاخبة إلى ملاحظات، وCLAUDE_MEM_REDACT_ENABLED (معطّل افتراضيًا) يفعّل الحجب التلقائي لأنماط الأسرار المعروفة قبل تخزينها.
Claude-Mem مقابل الذاكرة المدمجة في Claude Code
ينقل Claude Code المعرفة بين الجلسات بطريقتين بالفعل، وتعتبرهما وثائق Anthropic متكاملتين: ملفات CLAUDE.md التي تكتبها أنت، والذاكرة التلقائية التي يكتبها Claude بنفسه. وClaude-Mem طبقة ثالثة مستقلة فوقهما.
| البُعد | مدمج في Claude Code | إضافة Claude-Mem |
|---|---|---|
| من يكتبه | أنت تكتب CLAUDE.md؛ وClaude يكتب الذاكرة التلقائية من تصحيحاتك. | وكيل مراقب ثانٍ، من نشاط الأدوات الذي أنتجته جلستك. |
| أين يقيم | CLAUDE.md في جذر المشروع أو ~/.claude/CLAUDE.md؛ والذاكرة التلقائية في ~/.claude/projects/<project>/memory/ مع فهرس MEMORY.md. | SQLite على المسار ~/.claude-mem/claude-mem.db، مع الإعدادات والسجلات في المجلد نفسه. وفهرس Chroma اختياري للبحث الدلالي. |
| ما يدخل فيه | التعليمات والقواعد؛ والذاكرة التلقائية تحمل الدروس والأنماط، ولا يُحمَّل منها إلا أول 200 سطر أو 25 كيلوبايت. | ملاحظات عن عمل حدث فعلًا — قرارات وإصلاحات أخطاء وما قُرئ وعُدّل — مضغوطة بواسطة نموذج. |
| متى يُحمَّل | في كل جلسة، تلقائيًا، كسياق بعد موجه النظام. | عند SessionStart عبر خطّاف، من جلستك الثانية في المشروع فصاعدًا. |
| كيف يُقرأ | الملف كله أو فهرس الذاكرة التلقائية حاضر ببساطة في السياق؛ و/memory يسرد الملفات ويفتحها. | يُحقن فهرس مختصر؛ وتعود التفاصيل عبر ثلاث أدوات MCP — search وtimeline وget_observations. |
| التبعيات والتكلفة | لا شيء إضافي — فهو يأتي مع Claude Code. | Node وBun وuv، وعملية عامل محلية، ونموذج يضغط: خطة Anthropic الخاصة بك افتراضيًا، أو مفتاحك الخاص، أو المراقب المستضاف المدفوع. |
التوزيع العملي: القواعد والاتفاقيات في CLAUDE.md، والتفضيلات يجمعها الـ auto memory، وClaude-Mem يحمل سجلّ ما فعلته فعلًا. إذا كانت تفصيلة جلسة تهم مرة واحدة فلا يحتاجها أيٌّ من الثلاثة؛ وإذا كان لا بد من اتباع قاعدة في كل مرة فمكانها الوحيد CLAUDE.md. بل إنهما لا يتعارضان حتى في التخزين — فميزة memory ingest في claude-mem تستورد ملفات موضوعات الـ auto memory الخاصة بـ Claude Code إلى قاعدة بياناتها كملاحظات، دون استهلاك tokens النموذج.
برنامج تعليمي عن ذاكرة Claude Codeالخصوصية والحدود والتحفّظات الصادقة
تسجّل هذه الإضافة جلسات عملك، لذا يستحق الافتراضيات قراءة قبل أن تستقر في مستودع عمل.
- 1محلي افتراضيًا. تُكتب الجلسات والملاحظات والملخصات في SQLite على المسار ~/.claude-mem/claude-mem.db؛ والإعدادات والسجلات في المجلد نفسه. المزامنة السحابية اختيارية وليست تلقائية.
- 2ضع أي شيء داخل وسوم <private> فلن يُخزَّن أبدًا — بهذا تنصّ عبارة README. أما الحجب التلقائي لأنماط الأسرار المعروفة فهو مفتاح اختياري منفصل هو CLAUDE_MEM_REDACT_ENABLED، وهو معطّل افتراضيًا.
- 3القياس المجهول مفعّل افتراضيًا (PostHog، مرتبط فقط بمعرّف UUID عشوائي للتثبيت). أوقفه عبر npx claude-mem telemetry disable؛ وDO_NOT_TRACK يُحترم ويتجاوز كل شيء.
- 4الضغط استدعاء نموذج، لذا يغادر نشاط الأدوات الجهاز نحو المزوّد الذي اخترته — خطة Anthropic الخاصة بك، أو مفتاح OpenRouter أو Gemini، أو مراقب المزوّد المستضاف. اختر بوعي.
- 5إنها برمجية طرف ثالث، لا منتج من Anthropic، وهي تثبّت خطّافات قابلة للتنفيذ. اقرأ plugin/hooks/hooks.json والإعدادات قبل نشرها على فريق؛ وتعامل مع الإضافة كشيفرة تشغّلها، لأنها كذلك فعلًا.
- 6تكلّف سياقًا بقدر ما تكلّف رموزًا: فهرس محقون، وعملية عامل، وBun وuv على الجهاز. وإذا كانت جلساتك قصيرة ومكتفية بذاتها أصلًا، فالمكسب صغير — قِس على مستودعك أنت بدل الثقة برقم في عنوان.
لا شيء من ذلك يجعله تثبيتًا سيئًا. إنه فقط أداة يُستحسن تجربتها على مشروع حقيقي واحد أولًا — مع استبعاد المستودعات التي لا تريد تسجيلها أبدًا بنمط glob، وإيقاف القياسات إن أردت — قبل أن تجعله الافتراضي في كل ما تفتحه.
إيقاف القياسات يتم بأمر واحد:
npx claude-mem telemetry disable