مجلد .claude/: مركز تحكم Claude Code، شرح كامل لـ CLAUDE.md والأوامر والمهارات والصلاحيات

معظم مستخدمي Claude Code يعرفون

/.claude/

وجود المجلد، لكنهم لم يفتحوه فعليًا من قبل. قام مهندس الذكاء الاصطناعي أكشاي مؤخرًا بإعداد دليل كامل يوضح وظيفة كل ملف داخل هذا المجلد، وكيفية الإعداد لجعل Claude يعمل تمامًا وفقًا لطريقتك.

مجلدان، وليس واحدًا

أولاً، يجب توضيح سوء الفهم الشائع:

/.claude/

هناك مجلدان، وليس مجلدًا واحدًا.

على مستوى المشروع (مشروعك/.claude/): يُخزن الإعدادات المشتركة للفريق، ويُرسل إلى Git، ليحصل الجميع على قواعد وأوامر موحدة.

على المستوى العام (~/.claude/): تفضيلات شخصية وإعدادات عبر المشاريع، تؤثر فقط على جهازك الخاص.

CLAUDE.md: أهم ملف

عند بدء جلسة عمل Claude Code، يكون أول شيء يفعله Claude هو قراءة

CLAUDE.md

، وتحميله في نظام التلميحات (system prompt)، والالتزام بالتعليمات الموجودة فيه طوال الحوار.

المحتوى الذي يجب كتابته:

أوامر البناء، الاختبار، lint (مثل npm run test)

القرارات الهيكلية المهمة

ملاحظات غير واضحة (مثل “تفعيل وضع strict في TypeScript، المتغيرات غير المستخدمة ستُبلغ عن خطأ”)

معايير التسمية، أسلوب معالجة الأخطاء

ما لا ينبغي كتابته: قواعد إعداد linter، ملفات كاملة، شرح نظري مطول.

يقترح أكشاي أن يكون حجم CLAUDE.md محدودًا بـ 200 سطر — فزيادة الطول عن ذلك قد يؤدي فعليًا إلى انخفاض التزام Claude بالتعليمات، بسبب استهلاك السياق بشكل مفرط.

مجلد rules/: أوامر مهيكلة، مناسب لتوسعة الفريق

عندما يصبح CLAUDE.md ممتلئًا جدًا، فإن

/.claude/rules/

هو الحل. كل ملف Markdown يمثل نقطة اهتمام، مثل code-style.md، testing.md، api-conventions.md، وسيقوم Claude بقراءة جميع الملفات تلقائيًا.

الأكثر قوة هو “قواعد نطاق المسار”: بإضافة بيانات YAML مسبقة في ملف القاعدة، يمكنك جعل القواعد تُحمّل فقط عند معالجة ملفات في مسارات معينة، مما يمنع قواعد غير ذات صلة من استهلاك السياق.

مجلد commands/: أوامر مخصصة باستخدام الشرطة المائلة

كل ملف Markdown داخل

/.claude/commands/

سيصبح أمرًا مخصصًا باستخدام الشرطة المائلة. مثلا، review.md يتوافق مع /project:review، و fix-issue.md يتوافق مع /project:fix-issue.

أكثر وظيفة عملية هي استخدام

!

داخل ملف الأمر لتنفيذ أوامر shell ودمج المخرجات — على سبيل المثال، سحب تغييرات git diff تلقائيًا وحقنها في التلميحات، مما يسمح لـ Claude “برؤية” تغييرات الكود الخاصة بك. الأوامر الشخصية الموجودة في ~/.claude/commands/ يمكن استخدامها عبر جميع المشاريع.

skills/ و agents/: تفعيل تلقائي مقابل تعيين وكلاء فرعيين

الفرق الأساسي بين Skills و agents هو طريقة التفعيل:

Skills: يقرر Claude تلقائيًا استنادًا إلى محتوى الحوار ما إذا كان سيناديها، بدون الحاجة لإدخال أمر يدوي. كل skill له مجلد خاص وملف SKILL.md، ويمكن أن يحتوي على ملفات داعمة.

Agents: يحدد شخصيات وكلاء متخصصة، تمتلك تلميحات نظام مستقلة، وصلاحيات أدوات، وإعدادات نموذج. عند تنفيذ مهمة معقدة، ي spawn Claude نافذة سياق معزولة ليقوم الوكيل بتنفيذها، لتجنب امتلاء الجلسة الرئيسية بعدد كبير من الرموز.

خاصية tools في الوكيل تسمح بتقييد نطاق سلوك الوكيل — مثلا، وكيل التدقيق الأمني يحتاج فقط إلى صلاحية القراءة، ولا يجب أن يكون لديه القدرة على الكتابة. حقل model يتيح اختيار نموذج أخف لمهام مركزة، لتوفير التكاليف.

settings.json: قوائم السماح والرفض

/.claude/settings.json

يُتحكم من خلاله في العمليات المسموح أو الممنوعة لـ Claude:

allow: قائمة السماح — تنفذ مباشرة بدون تأكيد (مثل npm run *، git *)

deny: قائمة الرفض — يمنع تمامًا (مثل rm -rf *، قراءة .env)

العمليات غير المدرجة في القائمتين: سيطلب Claude تأكيدًا قبل المتابعة.

الإعدادات الشخصية يمكن وضعها في

/.claude/settings.local.json

، وهي تُضاف إلى gitignore تلقائيًا، ولا تُرسل إلى المستودع.

من أين تبدأ؟

يوصي أكشاي بترتيب بداية عملي: أولاً، تشغيل

/init

لإنشاء CLAUDE.md مبدئي، ثم إعداد ملف settings.json لتحديد الصلاحيات الأساسية، ثم إنشاء واحد أو اثنين من أوامر التخصيص الأكثر استخدامًا — والباقي يُضاف تدريجيًا مع نمط الاستخدام.

الاستنتاج الرئيسي هو:

/.claude/

هو البروتوكول الذي تخبر فيه Claude “من أنت، ما هو المشروع، وما هي القواعد التي يجب الالتزام بها”. كلما كانت الإعدادات أوضح، قل الوقت الذي ستقضيه في تصحيح أخطاء Claude.

هذه المقالة توضح فهم مجلد .claude/: مركز تحكم Claude Code، وتحليل كامل لـ CLAUDE.md، والأوامر، Skills، والصلاحيات، نُشرت لأول مرة على ABMedia.