دورة تعليمية احترافية

الشريحة 1 · الغلاف

Claude Code 101 : أداة الكود الذكية القائمة على الوكلاء

الشريحة 2

ما هو Claude Code؟

أداة كود عميلة (Agentic) تعمل داخل بيئة التطوير:

تفهم قاعدة الكود الخاصة بك.

تُعدّل الملفات وتُنفّذ الأوامر الطرفية.

تتكامل مع أدواتك الحالية لتسريع إنجاز المهام.

متاحة في: الطرفية (Terminal)، VS Code، تطبيق Claude Desktop، الويب، و JetBrains.

ما الذي يُميّزه عن Claude.ai؟

يملك وصولاً مباشراً إلى ملفاتك والطرفية وكامل المشروع، بدلاً من نسخ ولصق الأكواد.

يعمل كوكيل ذكاء اصطناعي يتخذ إجراءات بنفسه.

الشريحة 3

ما هو الوكيل (Agent)؟ وماذا يستطيع Claude Code فعله؟

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

قدرات Claude Code العملية:

قراءة وفهم الكود: شرح ميزة أو تتبع خطأ عبر المشروع.

تعديل الملفات: إعادة هيكلة دالة وتحديث كل الملفات التي تشير إليها.

تشغيل أوامر الطرفية: بناء، اختبار، تثبيت حزم، واتخاذ قرارات بناءً على المُخرجات.

البحث في الويب: جلب توثيق أو أحدث مراجع API عند الحاجة.

الشريحة 4

استخدام Claude Code بفعالية

ثلاثة مفاهيم أساسية:

نافذة السياق (Context Window)

ذاكرة العمل. لا تتسع لكل شيء دفعة واحدة، لذا يعمل الوكيل بشكل استراتيجي للعثور على الإجابات دون تحميل كل المشروع.

طلب الإذن

يطلب الإذن افتراضياً قبل تنفيذ الأوامر أو التعديلات. أنت المسيطر.

قد يخطئ

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

الشريحة 5

كيف يعمل Claude Code - الحلقة العميلة

الحلقة العميلة (Agentic Loop):

إدخال موجه (Prompt).
جمع السياق: يتفاعل مع النموذج الذي يعيد نصاً أو استدعاء أداة.
اتخاذ إجراء: تعديل ملف، تشغيل أمر، إلخ.
التحقق: هل حقق الهدف؟
إذا لم يتحقق: يعود ويكرر المحاولة مع التصحيح حتى يتحقق الهدف أو يكتمل.

أثناء الحلقة يمكنك: إضافة سياق، مقاطعة، أو توجيه النموذج.

السياق: يُضغط تلقائياً عند الاقتراب من الحد الأقصى (Compaction) لتلخيص وإزالة غير الضروري.

الأدوات (Tools): أساس عمل الوكيل. تُمكنه من قراءة الملفات، البحث في الويب، وغيرها. يحدد متى يستخدمها عبر الفهم الدلالي.

الصلاحيات (Permissions):

  • الوضع الافتراضي: إذن صريح قبل التعديل أو تشغيل أمر.
  • قبول تلقائي: تعديل الملفات تلقائياً، لكن الأوامر تحتاج موافقة.
  • وضع التخطيط (Plan Mode): أدوات للقراءة فقط لوضع خطة.
حلقة العمل العميلة

الشريحة 6

تثبيت Claude Code

خيارات التثبيت:

الطرفية (موصى بها للميزات الأحدث):

macOS/Linux/WSL: أمر curl أو brew install.

Windows: PowerShell عبر Invoke-RestMethod، أو CMD بـ curl، أو winget.

بعد التثبيت، انتقل لمجلد المشروع وشغّل claude، ثم سجّل الدخول.

VS Code

تثبيت إضافة "Claude Code" من Anthropic، ثم فتح من لوحة الأوامر.

JetBrains

تثبيت الملحق من السوق، يظهر شعار Claude في الشريط الجانبي.

تطبيق Desktop

يتيح وضع "Code" للعمل داخل مجلد مع إمكانية العمل السحابي.

الويب

عبر claude.ai/code، مخصص لمستودعات GitHub.

الشريحة 7

الموجّه الأول (Your First Prompt)

أوضاع التحكم:

وضع الموافقة

يطلب إذنك قبل أي تعديل أو أمر.

القبول التلقائي

يوافق تلقائياً على تعديل الملفات، لكن الأوامر تتطلب إذنك.

وضع التخطيط (Plan Mode)

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

مثال: إضافة مفتاح الوضع الليلي

افتح المشروع، شغّل claude، فعّل وضع التخطيط واكتب: "أحتاج تطبيق وضع ليلي في التطبيق بالكامل مع مفتاح تبديل في الرأس."

راجع الخطة ثم وافق، وسيبدأ Claude بالتنفيذ خطوة بخطوة مع طلب موافقتك.

الشريحة 8

سير العمل اليومي: استكشف ← خطط ← كوّد ← أودع

أهم درس في الدورة: لا تقفز مباشرة إلى الكود!

استكشف (Explore) و خطط (Plan):

استخدم وضع التخطيط لقراءة الملفات وفهم النهج دون كتابة أي كود.

مثال: "أحتاج إضافة تحويل WebP في خط رفع الصور. اكتشف أين نضعه، التبعيات المطلوبة، وكيف نُطبقه."

هذا أفضل وقت لتصحيح المسار قبل بدء البرمجة.

كوّد (Code):

وافق على الخطة ودع Claude ينفذها. حدد معايير نجاح واضحة.

أضف أدوات مساعدة مثل إضافة متصفح للاختبار، أو مجموعة اختبارات (test suite) ليتحقق منها باستمرار.

إذا تكررت الأخطاء، اطلب منه حفظ الحل في CLAUDE.md.

أودع (Commit):

استخدم وكيلاً فرعياً لمراجعة الكود (نظرة جديدة بدون تحيز الجلسة السابقة).

اجعل Claude يُنشئ رسالة Commit بأسلوبك، ثم ادفع الكود (Push).

الشريحة 9

إدارة السياق (Context Management)

نافذة السياق: ذاكرة محدودة تتسع لكل شيء (رسائل، ملفات، نتائج أدوات).

عند الامتلاء: يتم الضغط التلقائي (Compaction) بتلخيص التفاصيل وإزالة استدعاءات الأدوات غير الضرورية، لكن قد تفقد بعض التفاصيل.

أوامر التحكم:

/compact : ضغط يدوي للجلسة حتى هذه النقطة. مثالي عند اقتراب الحد مع الحاجة لمتابعة نفس الميزة.

/clear : مسح كامل للسياق وبدء جديد. مثالي للانتقال لميزة جديدة بدون تحيز المحادثة السابقة.

/context : عرض حالة السياق واستهلاكه.

نصائح لتوفير مساحة السياق:

  • كن دقيقاً في توجيهاتك؛ التوجيه الغامض يُجبر Claude على استكشاف أوسع يستهلك سياقاً أكبر.
  • عطّل خوادم MCP غير المستخدمة.
  • استخدم الوكلاء الفرعيين (Subagents) للمهام التي تحتاج إجابتها فقط دون تفاصيل الرحلة.

الشريحة 10

مراجعة الكود (Code Review)

مراجعة عبر وكيل فرعي:

قبل دفع طلب الدمج (Pull Request)، اطلب من Claude استخدام وكيل فرعي (بنافذة سياق مستقلة) لمراجعة التغييرات. قيّده بأدوات قراءة فقط ليكتشف المشكلات دون تعديل.

مهارة /commit-push-pr:

تُتم دورة commit و push وإنشاء Pull Request دفعة واحدة. إذا ربطت قناة Slack، تُرسل الرابط تلقائياً.

العودة لجلسة Pull Request سابقة:

استخدم الأمر claude --from-pr <رقم_الـPull Request> لاستئناف العمل على تعليقات المراجعة أو إصلاحات البناء.

الشريحة 11

تخصيص Claude Code عبر ملف CLAUDE.md

ملف ذاكرة دائمة للمشروع: يُقرأ تلقائياً في كل جلسة، ويُزوّد Claude بسياق أساسي يتجنب إعادة الاستكشاف.

ماذا يحل؟ بدون الملف، يبدأ Claude من الصفر ويعيد اكتشاف التبعيات والأسلوب. مع CLAUDE.md، أنت تُقدّم "سيناريو تهيئة".

مثال للمحتوى:

  • نوع المشروع: Next.js 15، App Router، Tailwind، Drizzle ORM.
  • أوامر: pnpm dev، pnpm test، pnpm lint.
  • أسلوب الكود: مسافة بادئة 2، التصدير المُسمى، مسارات API.

للفرق: أودع الملف في مستودع Git. هناك مستويان:

  • مشروع: CLAUDE.md في جذر المشروع للفريق.
  • مستخدم: ملف شخصي في مجلد الإعدادات ينطبق على كل مشاريعك.

نصائح: احفظ التصحيحات المتكررة في الذاكرة. استخدم @README.md لربط التوثيق. ابدأ مشروعاً بدونه لتكتشف أين تحتاج التوجيه، ثم استخدم /init لتوليد الملف.

الشريحة 12

الوكلاء الفرعيون (Subagents)

تفويض المهام لوكلاء بسياق منعزل: يُحسن إدارة السياق بشكل كبير.

كيف تعمل:

1

يُفرخ Claude وكيلاً فرعياً لتنفيذ مهمة (مثل "استكشف قاعدة الكود").

2

يعمل الوكيل الفرعي بنافذة سياق مستقلة، ثم يُعيد ملخصاً للنتائج فقط للوكيل الرئيسي.

3

النتيجة: تحصل على الإجابة بدون أن تستهلك رحلة البحث كامل سياقك الرئيسي.

إنشاء وكيل فرعي:

شغّل /agents واختر "Create new agent". حدد النطاق، الهدف، الأدوات المسموحة، واللون.

يُمكن تخصيصها بذاكرة دائمة (للاحتفاظ بالسياق عبر الجلسات) وتحميل مهارات مُسبقاً.

الشريحة 13

بروتوكول MCP (Model Context Protocol)

معيار مفتوح يربط Claude Code بالأدوات ومصادر البيانات الخارجية.
يُحوّل السياق الموجود خارج الكود (قواعد بيانات، تطبيقات إنتاجية، مستودعات عامة) إلى أدوات قابلة للاستدعاء.

القدرات:

  • جلب تفاصيل مهام من Linear، أو توثيق محدث من Context7.
  • إضافة خادم MCP عبر claude mcp add (نوعان: HTTP للخدمات البعيدة، و Stdio للعمليات المحلية).

نطاقات الخوادم:

  • محلي: للمشروع الحالي فقط.
  • مستخدم: لكل المشاريع.
  • مشروع: عبر ملف .mcp.json يُشارك مع الفريق تلقائياً.

تكلفة السياق:

الخوادم تضيف تعريفات أدوات حتى لو لم تُستخدم. عطّل غير النشط منها. إذا تجاوزت 10% من السياق يُفعّل وضع البحث عن الأدوات تلقائياً. بديل أخف: استخدام مهارة (Skill) بدلاً من خادم.

الشريحة 14

الخطّافات (Hooks)

أوامر حتمية تُشغّل في نقاط محددة من دورة حياة Claude Code.
تضمن تنفيذ إجراءات بشكل مضمون 100% على عكس التعليمات النصية التي قد تُتجاهل أحياناً.

أمثلة على الاستخدام:

  • تنسيق تلقائي بعد كل تعديل (بدلاً من الطلب من Claude أن يفعلها).
  • تسجيل جميع الأوامر المُنفّذة للامتثال.
  • منع عمليات خطيرة (كتعديل ملفات الإنتاج، أو rm -rf).

آلية العمل:

تُضبط في settings.json أو عبر /hooks. تختار حدثاً (PreToolUse، PostToolUse...)، مُطابقاً (matcher) للأداة، والأمر.

خطّاف PreToolUse للمنع: كود الخروج 2 يمنع العملية ويُبلغ Claude بسبب المنع ليُعدّل سلوكه.

مشاركتها مع الفريق:

أودع الإعدادات في .claude/settings.json ليحصل الجميع على نفس الخطّافات الحتمية.

الشريحة 15 · ملخص وتذكرة نهائية

ملخص وتذكرة نهائية

Claude Code هو وكيل ترميز يعمل داخل بيئتك، يقرأ الكود، يُحرر الملفات، ويُنفذ الأوامر.

أهم الممارسات:

  • • اتّبع سير العمل: Explore → Plan → Code → Commit.
  • • استثمر في ملف CLAUDE.md لحفظ سياق دائم.
  • • حافظ على نظافة نافذة السياق عبر /compact، التوجيه الدقيق، والوكلاء الفرعيين.
  • • اربط أدواتك الخارجية عبر MCP، واستخدم الخطّافات لضمان التنفيذ الحتمي.

تذكر: الوكيل أداة قوية لكنها ليست معصومة؛ وجودك في حلقة المراجعة والتحكم هو ضمان الجودة.