ذاكرة Claude Code: /init وCLAUDE.md واختصار # – بالصور
دون ذاكرة ينسى Claude Code كل جلسة. تشغّل هذه الجولة /init في مشروع Next.js حقيقي، وتقرأ CLAUDE.md المولّدة، وتضيف قاعدة من الدردشة باختصار #، وتتحقق من أن Claude يتبعها فعلًا – كل خطوة مثبتة بلقطة شاشة.
خلاصة سريعة – ذاكرة Claude Code في أربعة أسطر
- شغّل /init مرة واحدة لكل مشروع: يمسح Claude المستودع – بنية المجلدات والسكربتات وإدارة الحالة – ويكتب CLAUDE.md منظمة في الجذر.
- تُضاف هذه الملف تلقائيًا إلى سياق كل جلسة، فتشكّل ما تكتبه فيها كل توليد شيفرة لاحق.
- اكتب في الدردشة # متبوعة بقاعدة لحفظها فورًا، ثم اختر موضعها: ذاكرة المشروع (مرفوعة للمستودع)، أو الذاكرة المحلية للمشروع، أو ذاكرة المستخدم (~/.claude/CLAUDE.md).
- حدّث الملف كلما تغيرت بنيتك أو حزمة تقنياتك – الذاكرة المتقادمة تضلّل Claude – ويمكنك إعادة فتح أي ملف ذاكرة بـ /memory.
Claude Code Tutorial #2 - CLAUDE.md Files & /init
القناة:Net Ninja12:18
The CLAUDE.md file
القناة:Claude (official Anthropic channel)3:01
Claude Code's Memory System: The Full Guide
القناة:DIY Smart Code5:05
Manage Claude's memory — Claude Code documentation
الوثائق:code.claude.com
اللقطات من درس CLAUDE.md لقناة Net Ninja (تسجيل نظيف لـ VS Code)؛ ونص الجولة كُتب باستقلالية وقوبل بوثائق ذاكرة Anthropic وفيديو CLAUDE.md الرسمي.
تبقى لقطات الشاشة ملكًا لصناعها وتُستخدم بإسناد المصدر بوصفها توثيقًا مرئيًا. وكل خطوة تتضمن رابطًا مباشرًا إلى اللحظة نفسها في الفيديو الأصلي.
من ذاكرة فارغة إلى مشروع يعرفه Claude
1 · ولّد CLAUDE.md عبر /init
- 1
ابدأ بـ /init
عند إدخال Claude Code إلى مشروع لأول مرة، شغّل /init قبل طلب أي شيفرة. يقول التلميح حرفيًا ما تفعله: تهيئة ملف CLAUDE.md جديد مع توثيق قاعدة الشيفرة. يقرأ Claude مشروعك الآن كي لا تضطر الجلسات اللاحقة إلى ذلك.
/init – الأمر الوحيد الذي تشغله أولًا في أي مستودع جديد.شاهد عند 0:30 - 2
شاهد Claude يستكشف قبل أن يكتب
بدل التخمين، يبني /init قائمة مهامه بنفسه: استكشاف بنية المستودع، وتحليل package.json والشيفرة المصدرية، والتحقق من وجود توثيق، ثم إنشاء CLAUDE.md بالنتائج. وترى كل بند يُشطب فورًا – فالملف ملخص لما قُرئ فعلًا لا قالب جاهز.
قائمة Update Todos أثناء التهيئة – استكشف ثم حلّل ثم اكتب.شاهد عند 1:42 - 3
اقرأ ترويسة الإرشادات والأوامر التي كتبها
يفتح الملف المولّد بترويسة إرشادات لـ Claude Code، تليها Development Commands منقولة من package.json – dev وbuild وlint وstart. وهذا القسم بالذات يمنع Claude من اختراع سير عمل خاص به: فالسكربتات الحقيقية صارت في سياقه.
افتتاحية الملف: إرشادات لـ Claude Code مع سكربتات npm الحقيقية للمشروع.شاهد عند 2:56 - 4
افحص قسمي البنية والهيكلة
انزل أكثر وستجد الملف يوثق نظرة عامة على البنية (هذا المشروع: مدونة Next.js 15 بـ React 19 وTailwind)، وخريطة Project Structure تبيّن موضع الملفات الجديدة، وملاحظات Data Persistence لطبقة Hygraph CMS. وترث الجلسات الجديدة كل ذلك دون إعادة قراءة مستودعك.
Project Structure مع مسارات محددة، مع ملاحظة Hygraph عن استمرارية البيانات.شاهد عند 2:30
2 · أضف الذكريات وأثبت أنها تلازم
- 5
أثبت أن الذاكرة تغير السلوك
الاختبار: بعد إضافة «كل الـ hooks القابلة لإعادة الاستخدام توضع في مجلد hooks هذا» إلى الملف، طلبنا hookًا لتفضيل الثيم – مع التنبيه صراحة بعدم استخدامه في أي مكان بعد. تُظهر قائمة مهام Claude أنه أنشأ الـ hook في src/hooks/use-theme، وأنهى بعبارة «الـ hook جاهز للاستخدام لكنه لم يُدمج في أي مكان بعد، كما طلبت». ذاكرة تدخل، سلوك يخرج.
يهبط الـ hook في المجلد الذي ذكره ملف الذاكرة – ويحترم تعليمة «لا تربطه بعد».شاهد عند 6:40 - 6
احفظ قاعدة جديدة مباشرة من الدردشة بـ #
لست مضطرًا لتحرير الملف يدويًا. ابدأ رسالة بـ # – مثل «# عند إنشاء مكوّنات صفحات جديدة، أضف دائمًا رابطًا لتلك الصفحة في الهيدر» – فيتعرف Claude Code عليها بوصفها ذكرى للحفظ، ثم يسألك أين توضع: ذاكرة المشروع أم المحلية أم المستخدم.
اختصار # ومنتقي الوجهات الثلاث الذي يفتحه.شاهد عند 7:30 - 7
فرّق بين أنواع الذاكرة الأربعة
جدول توثيق Anthropic هو الخريطة: ذاكرة سياسة المؤسسة للمؤسسات، وذاكرة المشروع (./CLAUDE.md، مرفوعة ومشتركة مع الفريق)، وذاكرة المستخدم (~/.claude/CLAUDE.md، تفضيلاتك العالمية الشخصية)، والذاكرة المحلية للمشروع (./CLAUDE.local.md، شخصية وغير متتبعة) – وهي التي وثّقتها الوثائق بوصفها مهجورة لصالح استيراد ملفات غير متتبعة من ذاكرة المشروع، مع أن الخيار ما زال يظهر في المنتقي.
جدول أنواع الذاكرة الرسمي: الموضع والغرض ومن يشارك كل ملف.شاهد عند 10:50 - 8
تأكد أن القاعدة وصلت إلى الملف
عند اختيار ذاكرة المشروع تُضاف القاعدة إلى نهاية CLAUDE.md – وهى هناك أسفل الملف: «عند إنشاء مكوّنات صفحات جديدة، أضف دائمًا رابطًا لتلك الصفحة في الهيدر». ومن الجلسة التالية يمضي هذا السطر ضمن السياق تلقائيًا.
القاعدة الجديدة محفوظة أسفل CLAUDE.md المرفوع للمستودع.شاهد عند 11:48
3 · أدر ملفات الذاكرة يوميًا
- 9
تحقق من الذاكرة في مهمة جديدة
اطلب الآن صفحة About وراقب الخطة: «سأنشئ صفحة About وأضيف رابطًا لها في الهيدر وفق تعليمة الذاكرة الخاصة بك»، مع بند مستقل بعنوان «Add About page link to header navigation». فقاعدة # من خطوتين سابقة تقود مهمة لم تُذكر فيها مطلقًا. (وتنبيه أمين من الفيديو: قد يضيف Claude روابط لصفحات لم تذكرها أيضًا – تجاوز نطاق يمكنك ترويضه بسطر في الملف نفسه.)
«…وفق تعليمة الذاكرة الخاصة بك» – قائمة المهام تثبت أن القاعدة مفعّلة.شاهد عند 9:37 - 10
أعد فتح أي ملف ذاكرة بـ /memory
يسرد أمر /memory كل ملفات الذاكرة مع مواضعها: ذاكرة المشروع المرفوعة في ./.CLAUDE.md، والذاكرة المحلية المستثناة في ./.CLAUDE.local.md، وملفك العام للمستخدم في ~/.claude/CLAUDE.md. اختر أحدها فيفتح في محررك – وقد بلغت الذكريات في ملف هذا المشروع 11 ذكرى.
اختر الذاكرة للتحرير – ثلاثة نطاقات في منتقٍ واحد.شاهد عند 11:22 - 11
حررها كأي ملف آخر
يؤكد Claude Code برسالة «Opened project memory at ./.CLAUDE.md» ويفتحها في VS Code، مع نصيحة: اضبط متغير البيئة $EDITOR أو $VISUAL لاختيار محرر آخر. ومن /init إلى الصيانة اليومية، الذاكرة مجرد ملف markdown تحرص على صدقه.
«Opened project memory at ./.CLAUDE.md» – حررها وحافظ على تحديثها.شاهد عند 12:06
طبقات الذاكرة وموضع كل ملف
أربعة ملفات وأربعة نطاقات – اختر الصح، فلا تبقى ذاكرة Claude Code لغزًا:
- 1ذاكرة المشروع – ./CLAUDE.md في جذر المستودع. متتبعة في git ومشتركة مع كل مطور في المشروع. اجعلها عن المشروع فقط: البنية والعُرف والأوامر والأطر.
- 2الذاكرة المحلية للمشروع – ./CLAUDE.local.md. ملاحظاتك الشخصية لهذا المستودع (أدواتك واختصاراتك) تبقى غير متتبعة. اعتبرتها الوثائق مهجورة – والنمط الموصى به استيراد ملفات غير متتبعة من ذاكرة المشروع – مع أن الخيار بقي متاحًا في منتقي # وقت التسجيل.
- 3ذاكرة المستخدم – ~/.claude/CLAUDE.md في مجلدك المنزلي. تفضيلاتك العالمية عبر كل مشاريع الجهاز: أسلوب الشيفرة ولغة الردود وسير عملك الخاص.
- 4ما وراء CLAUDE.md – أضافت إصدارات Claude Code الأحدث نظام ذاكرة تلقائي (MEMORY.md وملفات موضوعات تحت ~/.claude/projects/) يديره Claude بنفسه، منفصلًا عن ملف التعليمات، إضافة إلى استيراد @ لسحب مستندات أخرى إلى السياق. أطفئه بـ CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 إذا أردت ملفات التعليمات فقط.
أيًّا كانت الطبقة التي تستخدمها، فالعادة من الفيديو واحدة: الذاكرة ليست «أنشئ وانسَ». حين تتغير بنيتك أو حزمك أو عُرفك حدّث الملف – فالذاكرة المتقادمة أسوأ من عدمها، لأن Claude سيتبعها بثقة تامة.