Claude Code Best Practices: 6 عادات لنتائج أفضل

هل طلبت من Claude Code شيئًا، فجاءت النتيجة قريبة لكنها ليست ما أردت؟ هذا يحدث لكل المبتدئين، وليس عيبًا فيك. الفرق بين نتيجة عادية ونتيجة ممتازة غالبًا عادات صغيرة في طريقة العمل. في هذا الدرس ستتعلّم ست عادات يستخدمها المبرمجون المحترفون مع Claude Code.

🎯 ماذا ستتعلم؟

بنهاية هذا الدرس ستكون قادرًا على:

• شرح معنى الـ context window، ولماذا هي أهم ما تحافظ عليه.
• إعطاء Claude Code طريقة يتحقّق بها من عمله بنفسه.
• استخدام الـ plan mode قبل المهام الكبيرة.
• كتابة طلبات محدّدة، وإنشاء ملف CLAUDE.md قصير ومفيد.
• إدارة الجلسة بالأوامر /clear و/rewind والمفتاح Esc.

🧰 ماذا تحتاج قبل أن تبدأ؟

Claude Code مثبّت على جهازك، وتعرف ما هي Skills. إن لم تقرأ الدرسين السابقين، فابدأ بـ ما هو Claude Code؟ ثم Claude Code Skills. وتذكّر أن حساب Claude يملكه شخص بالغ يتعلّم معك.

الفكرة ببساطة

تخيّل سبّورة في الفصل. كل ما يقوله المعلّم والطلاب يُكتب عليها. في البداية تكون نظيفة وواضحة. لكن مع الوقت تمتلئ بالكتابة، حتى يصعب أن تجد الملاحظة المهمة.

هذه السبّورة هي الـ context window. فيها كل رسائلك، وكل ملف يقرؤه Claude Code، وكل ناتج لأمر شغّله. وعندما تمتلئ، قد ينسى Claude Code تعليمات قديمة، أو يخطئ أكثر.

لذلك أغلب العادات في هذا الدرس هدفها واحد: أبقِ السبّورة نظيفة ومفيدة.

العادة 1: أعطه طريقة يتحقّق بها

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

قارن بين هذين الطلبين:

❌ اكتب دالة تحسب معدّل درجاتي

✅ اكتب دالة average في ملف grades.py تحسب معدّل قائمة درجات. مثال: [80, 90, 100] معدّلها 90، والقائمة الفارغة تعطي 0. اكتب اختبارات لهذه الأمثلة وشغّلها.

الطلب الثاني فيه أمثلة واضحة، واختبارات يشغّلها Claude Code بنفسه. واطلب منه دائمًا أن يريك الدليل: ناتج الاختبار، أو الأمر الذي شغّله.

العادة 2: استكشف، ثم خطّط، ثم اكتب الكود

لو قفز Claude Code إلى الكتابة مباشرة، فقد يحلّ مشكلة غير مشكلتك. لهذا يوجد الـ plan mode. في هذا الوضع يقرأ الملفات ويجيب عن أسئلتك، دون أن يغيّر شيئًا.

للدخول إليه، اضغط Shift+Tab حتى يظهر في الأسفل ⏸ plan mode on. أو ابدأ الجلسة هكذا:

claude --permission-mode plan

ثم اتبع أربع مراحل:

1. استكشف: «اقرأ ملفات لعبة الأسئلة، وافهم كيف تُحسب النقاط».
2. خطّط: «أريد إضافة مؤقّت لكل سؤال. ما الملفات التي ستتغيّر؟ اكتب خطة».
3. نفّذ: وافق على الخطة، أو اضغط Shift+Tab للخروج من الـ plan mode، ثم اطلب التنفيذ مع الاختبارات.
4. احفظ: اطلب منه حفظ التغييرات (commit) برسالة واضحة.

لكن لا تخطّط لكل شيء! إن استطعت وصف التغيير في جملة واحدة، مثل تصحيح خطأ إملائي، فاطلبه مباشرة.

العادة 3: كن محدّدًا، وأشِر إلى الملفات

Claude Code ذكي، لكنه لا يقرأ أفكارك. فأخبره بالملف، والموقف، وشكل النجاح. وبدل أن تصف مكان الكود، اكتب @ ثم اسم الملف، فيقرؤه قبل أن يجيب:

في @quiz.py يتوقف البرنامج عندما يكتب اللاعب حرفًا بدل رقم. اكتب اختبارًا يُظهر المشكلة، ثم أصلحها.

وتستطيع أيضًا أن تلصق صورة شاشة، أو تعطيه رابط صفحة توثيق.

العادة 4: ملف CLAUDE.md قصير ومفيد

تذكّر من الدرس السابق: ملف CLAUDE.md يقرؤه Claude Code في بداية كل جلسة. لإنشاء نسخة أولى منه تلقائيًا، اكتب داخل الجلسة:

/init

سيقرأ مشروعك ويكتب ملفًا مبدئيًا، وأنت تحسّنه مع الوقت. هذا مثال لملف جيد:

# طريقة العمل
- شغّل الاختبارات بالأمر: python -m pytest
- أسماء المتغيّرات بالإنجليزية، والرسائل للمستخدم بالعربية
- لا تعدّل ملفات مجلد data

القاعدة الذهبية: لكل سطر اسأل نفسك: «لو حذفته، هل سيخطئ Claude Code؟». إن كان الجواب لا، فاحذفه. فالملف الطويل يجعل القواعد المهمة تضيع بين السطور.

وما تحتاجه أحيانًا فقط ضعه في Skill، لا في CLAUDE.md.

العادة 5: صحّح المسار مبكرًا

لا تنتظر حتى ينتهي Claude Code إن رأيته يسير في الطريق الخطأ:

• Esc: يوقفه في منتصف العمل، مع بقاء المحادثة، فتوجّهه من جديد.
• Esc مرتين أو /rewind: يفتح قائمة الرجوع، فتعيد المحادثة أو الكود أو كليهما إلى نقطة سابقة.
• «تراجع عن ذلك»: اطلب منه بكلماتك أن يلغي تغييراته.

تنبيه مهم: الرجوع يشمل التعديلات التي صنعها Claude Code بأدوات تعديل الملفات فقط. لذلك لا يغني عن حفظ عملك بأداة git.

العادة 6: نظّف السبّورة بين المهام

عندما تنتهي من مهمة وتبدأ مهمة لا علاقة لها بها، اكتب:

/clear

هذا يمسح السبّورة كلها، فيبدأ Claude Code بذهن صافٍ. وإن أردت أن تكمل في اليوم التالي من حيث توقفت، فابدأ الجلسة بالأمر:

claude --continue

🚀 للمتقدمين: بدل المسح الكامل، تستطيع تلخيص المحادثة بالأمر /compact مع تعليمات، مثل /compact ركّز على تغييرات ملف quiz.py. وإن أردت أن يبحث Claude Code في ملفات كثيرة دون أن يملأ سبّورتك، فاطلب: «استخدم subagent لتبحث في…». الـ subagent يعمل في سياق منفصل، ثم يعيد إليك ملخّصًا فقط.

⚠️ أخطاء شائعة

1. جلسة «كل شيء في مكان واحد».

❌ أصلح لعبة الأسئلة ← ثم سؤال عن واجب الرياضيات ← ثم عودة إلى اللعبة

✅ الحل: اكتب /clear بين المهام التي لا علاقة بينها.

2. التصحيح مرة بعد مرة.

❌ لا، ليس هكذا… ما زال خطأ… قلت لك ليس هكذا…

✅ الحل: بعد تصحيحين لم ينجحا، اكتب /clear. ثم اكتب طلبًا جديدًا أوضح، فيه ما تعلّمته من المحاولات السابقة.

3. البحث بلا حدود.

❌ ابحث في المشروع كله عن أي شيء غريب

✅ الحل: حدّد مكان البحث، مثل «ابحث في مجلد game فقط عن طريقة حساب النقاط». أو اطلب أن يبحث subagent.

🧪 جرّب بنفسك

التحدي 1 (سهل): أعد كتابة هذا الطلب ليكون محدّدًا ويمكن التحقق منه: «اعمل برنامج يحوّل الدرجات».

اكتب دالة grade_letter في ملف grades.py تحوّل الدرجة إلى حرف: 90 فأكثر A، ومن 80 إلى 89 B، وأقل من 80 C. اكتب اختبارات للدرجات 95 و85 و70 وشغّلها.

التحدي 2 (متوسط): هذا ملف CLAUDE.md طويل. أي سطرين تحذف، ولماذا؟

- شغّل الاختبارات بالأمر: python -m pytest
- اكتب كودًا نظيفًا ومرتّبًا
- بايثون لغة برمجة شهيرة أنشأها جيدو فان روسوم
- لا تعدّل ملفات مجلد data

التحدي 3 (للمتقدمين): تريد إضافة لوحة أفضل اللاعبين إلى لعبتك، وستتغيّر عدة ملفات. اكتب الطلبين اللذين ستستخدمهما في الـ plan mode.

اقرأ ملفات اللعبة وافهم كيف تُحفظ نقاط كل لاعب.

أريد لوحة تعرض أفضل 5 لاعبين بعد كل جولة. ما الملفات التي ستتغيّر؟ اكتب خطة مفصّلة مع طريقة اختبارها.

✅ اختبر نفسك

1. ما الذي يحدث عندما تمتلئ الـ context window؟ (أ) يصبح Claude Code أسرع (ب) قد ينسى تعليمات قديمة ويخطئ أكثر (ج) لا يحدث شيء
2. صح أم خطأ: يجب استخدام الـ plan mode حتى لتصحيح خطأ إملائي واحد.
3. ما الأمر الذي تكتبه بين مهمتين لا علاقة بينهما؟

📝 الخلاصة

• الـ context window مثل سبّورة تمتلئ، فحافظ عليها نظيفة.
• أعطِ Claude Code اختبارًا أو مثالًا يتحقّق به، واطلب منه الدليل.
• للمهام الكبيرة: استكشف ثم خطّط ثم نفّذ، بمساعدة الـ plan mode.
• اكتب طلبات محدّدة، وأشِر إلى الملفات بـ @، واجعل CLAUDE.md قصيرًا.
• صحّح مبكرًا بـ Esc و/rewind، ونظّف بين المهام بـ /clear.

⏭️ الخطوة التالية

الآن تعرف كيف تعمل مع Claude Code بذكاء. في الدرس التالي ستكتشف سرًّا يجعله أسرع وأوفر: Claude Code Prompt Caching. وتستطيع متابعة كل الدروس في مسار Claude.