إتقان ملف CLAUDE.md: اضبط المهارات والـ Hooks وذاكرة مشروعكCLAUDE.md Mastery: Configuring Skills, Hooks and Project Memory for Your Codebase

المصطلحات

CLAUDE.md

ملف Markdown يقرأه كلود كود في بداية كل جلسة. فيه سياق مشروعك وأوامره وقواعده وحدوده.

skill (مهارة)

مجلد فيه ملف SKILL.md يعلّم كلود مهمة متكررة. كلود يستخدمه عندما يطابق الموقف وصفه.

hook (هوك)

أمر يشغّله كلود كود تلقائياً في لحظة محددة، مثل قبل تشغيل أداة. يُضبط في settings.json ويعمل مهما قرر كلود.

settings.json

ملف إعدادات كلود كود. النسخة الموجودة في .claude/ داخل المستودع يشاركها الفريق عبر git.

رمز الخروج 2

عندما يخرج hook من نوع PreToolUse بالرمز 2، يمنع كلود كود تنفيذ الأداة ويعرض السبب على كلود.

الخطوات

1. 1

   الخطوة 1

   ضع ملفات CLAUDE.md في المستويات الصحيحة

   كلود كود يقرأ CLAUDE.md من أكثر من مكان. الملف العام في ~/.claude/CLAUDE.md يطبق على كل مشاريعك، فمكانه أسلوبك الشخصي وتفضيلاتك العامة. الملف في جذر المستودع فيه قواعد هذا المشروع وهيكله وسياقه.

   تستطيع أيضاً وضع CLAUDE.md داخل مجلد. كلود يقرأه عندما يعمل في هذا المجلد، فيكون لمجلد api/ قواعده ولمجلد frontend/ قواعده.

   المستويات تتراكم: العام، ثم المشروع، ثم المجلد. استخدم هذا عن قصد حتى لا تتكرر القواعد أو تتعارض.

   شغّل الأوامر التالية. داخل الجلسة، الأمر /memory يعرض الملفات التي حمّلها كلود. والأمر /init يكتب لك مسودة أولى لملف المشروع.

   برومبتالترمينال: إنشاء الملفات

   نسخ

   # Global file: applies to every project
   mkdir -p ~/.claude && touch ~/.claude/CLAUDE.md
   
   # Project file at the repo root
   touch ./CLAUDE.md
   
   # Folder level files for parts with their own rules
   mkdir -p ./src/api ./src/frontend
   touch ./src/api/CLAUDE.md ./src/frontend/CLAUDE.md
   
   # List every CLAUDE.md in the project
   find . -name 'CLAUDE.md' -not -path '*/node_modules/*' -not -path '*/.git/*'
   
   # Inside a Claude Code session, see and edit the memory files it loaded
   /memory