AI Open Guide
→ Claude · للمطوّرين

1في جملة واحدة

ملف نصي صغير اسمه CLAUDE.md في مجلد مشروعك يخبر Claude Code كيف تحب أن تُنجز الأمور، وهو يقرأه في بداية كل جلسة.

2كلمات جديدة

  • CLAUDE.md — ملف نصي عادي (الامتداد .md يعني Markdown، أي نص منسّق بسيط) يحوي قواعد مشروعك وأعرافه والأوامر المفيدة فيه. اعتبره تعليمات Project (الفصل 1.5) ولكن لـ Claude Code.
  • العُرف (Convention) — عادة يتبعها مشروعك: كيف تُسمّى الملفات، وأي لغة، وكيف تُشغَّل الاختبارات.
  • النطاق (Scope) — أين تنطبق القاعدة. يمكن أن يكون هناك CLAUDE.md لجهازك كله (عاداتك الشخصية)، وواحد لكل مشروع (قواعد المشروع)، وواحد للشركة.

3لماذا تحتاجه

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

4جرّبه الآن

(الخطط المدفوعة)

  1. في مجلد مشروعك، اطلب من Claude Code: أنشئ ملف CLAUDE.md لهذا المشروع يتضمن: ما هو المشروع في سطرين، كيف يُشغَّل، كيف يُختبر، قواعد التسمية التي نستخدمها، وثلاثة أشياء يجب ألا تغيّرها أبدًا من دون أن تسأل.
  2. اقرأ الملف الذي يكتبه؛ وصحّح أي خطأ.
  3. ابدأ جلسة جديدة واطلب تغييرًا صغيرًا. لاحظ أنه يشغّل الاختبارات ويتبع قاعدة التسمية من دون أن يُطلب منه ذلك.

5ماذا سترى

[الصورة قيد الإعداد: ملف CLAUDE.md مفتوح في المحرر وجلسة تتبعه.] ملف قصير، عادةً أقل من صفحة، يذكره Claude عندما يبدأ ("أتبع CLAUDE.md: تشغيل الاختبارات بعد التغييرات"). يعمل جنبًا إلى جنب مع قواعدك العامة؛ وملف المشروع يُضاف إليها.

6انتبه

  • أبقه قصيرًا ومحدّثًا. ملف CLAUDE.md طويل وقديم أسوأ من عدم وجوده؛ فسيتبع Claude القواعد البالية بأمانة.
  • لا تضع الأسرار (كلمات المرور، المفاتيح) قريبًا منه أبدًا. إنه ملف نصي يتم تشاركه.

7خطوة أبعد

أضف سطرًا مثل عندما لا تكون متأكدًا، اسأل قبل تغيير أكثر من ثلاثة ملفات. الفصل 6.3 يحوّل المهام المتكررة إلى مهارات، وهي قواعد مع خطوات.