تحكّم فـ Claude Code باستعمال قواعد المشروع، الوكلاء، الـ Hooks، MCP وCI

شنو كيوفّر كورس Claude Code PRO

Claude Code PRO هو كورس عملي وحزمة إعدادات بالروسية لـ Claude Code. كيبدا من التثبيت وكتابة البرومبتات، وكيطلع حتى لإعدادات الفريق كامل، والأتمتة القابلة لإعادة الاستعمال، والربط مع الخدمات الخارجية، وعمليات CI.

المستودع فيه 12 وحدة تعليمية، و8 مختبرات تطبيقية، ومكتبة ديال البرومبتات، ومثال ديال إضافة، وعمليات GitHub Actions، وورقة مرجعية مختصرة، والأسئلة الشائعة، وحزمة بداية واجدة للتثبيت. حزمة البداية فيها 8 مهارات، و5 وكلاء فرعيين، و4 خطافات، وقواعد، وسطر للحالة، ونمط للإخراج.

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

فهم كيفاش كيخدم Claude Code

Claude Code وكيل، وماشي أداة عادية ديال الإكمال التلقائي. ملي كتعطيه هدف، يقدر يفحص الملفات، ويقلب فالمستودع، ويعدّل الكود، ويشغّل الأوامر، ويتأكد من النتيجة. هادي هي الدورة المعتادة ديالو:

1. كيجمع السياق من تعليمات المشروع، والملفات، وعمليات البحث، ومخرجات الأوامر.
2. كيخطط للتغييرات المطلوبة.
3. كيعدّل الملفات ولا كيشغّل الأدوات.
4. كيشغّل الاختبارات، وأدوات فحص الكود، وعمليات البناء، ولا فحوصات أخرى.
5. كيعاود حتى يدوزو الفحوصات ولا يحتاج لمعلومات إضافية.

أهم المسؤوليات ديالك هي تعطي هدف واضح، وتوجّه Claude للسياق المناسب، وتحدّد القيود، وتوضح كيفاش خاص التحقق من النجاح.

صيغة مفيدة للبرومبت هي: الهدف + فين يقلب + القيود + طريقة التحقق.

ثبّت Claude Code وحزمة البداية

الخطوة 1: تثبيت Claude Code

فـ macOS أو Linux أو Windows Subsystem for Linux، استعمل سكريبت التثبيت الرسمي:

curl -fsSL https://claude.ai/install.sh | bash

الـ README كيوفّر حتى خيار التثبيت باستعمال npm:

npm install -g @anthropic-ai/claude-code

الخطوة 2: نسخ مستودع الكورس

git clone https://github.com/justxor/claude-code-pro-course.git

الخطوة 3: تثبيت حزمة البداية فالمشروع ديالك

شغّل أداة التثبيت المرفقة، وعطيها المسار ديال المشروع المستهدف:

bash claude-code-pro-course/install.sh ~/path/to/my-project

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

الخطوة 4: شغّل Claude Code

cd ~/path/to/my-project
claude

داخل الجلسة، راجع السياق الحالي وشغّل مهارة التعريف بالمشروع ديال حزمة البداية:

/context
/onboard

/context كيبين شنو اللي كيستهلك نافذة السياق. و/onboard كيعطي نظرة عامة على المشروع باستعمال المهارة المثبّتة.

نظّم إعدادات Claude Code

الكورس كيفرّق بين نطاقات إعدادات المستخدم، والمشروع، والإعدادات المحلية.

• إعدادات المستخدم: الملفات اللي كاينة تحت ~/.claude/، ومن بينها التعليمات الشخصية، والإعدادات، والمهارات، والوكلاء، وأنماط الإخراج.
• إعدادات المشروع: الملفات المشتركة بحال CLAUDE.md، و.claude/rules/، و.claude/settings.json، ومهارات المشروع، ووكلاء المشروع، و.mcp.json.
• الإعدادات المحلية: الملفات الخاصة بالجهاز بحال CLAUDE.local.md و.claude/settings.local.json، واللي ما خاصهاش تتشارك كإعدادات ديال الفريق.
• الإضافات: مجموعات معبّأة فيها مهارات، ووكلاء، وخطافات، وإعدادات MCP، ويمكن توزيعها على عدة مستودعات.

اختار آلية الإعداد المناسبة

• استعمل CLAUDE.md ولا .claude/rules/ لمعلومات المشروع وقواعد كتابة الكود.
• استعمل إعدادات الصلاحيات للسماح بالأوامر الآمنة، وطلب التأكيد على العمليات الحساسة، ومنع الولوج الخطير.
• استعمل مهارة لإجراء أو برومبت قابل لإعادة الاستعمال.
• استعمل وكيلاً فرعياً ملي كتحتاج المهمة لتخصص معيّن ولا لنافذة سياق معزولة.
• استعمل خطافاً ملي خاص شي إجراء يوقع باستمرار.
• استعمل MCP باش تربط نظاماً خارجياً بحال GitHub أو متصفح أو قاعدة بيانات.
• استعمل إضافة باش توزّع إعدادات كاملة على مستودعات أخرى ولا على أعضاء الفريق.
• استعمل claude -p أو GitHub Actions أو Agent SDK للتنفيذ بلا مراقبة مباشرة.

صايب ملف CLAUDE.md مفيد

CLAUDE.md كيخدم بحال ذاكرة المشروع. Claude Code يقدر يصايب نسخة أولية باستعمال /init، وتقدر تعدّل الذاكرة باستعمال /memory. خلّي هاد الملف قصير وواضح: ضمّن فيه الأوامر، وحدود المعمارية، ومعايير كتابة الكود، والقيود الصريحة.

هادي نسخة معدّلة من مثال الكورس:

# المشروع: متجر Next.js وPostgreSQL

## الأوامر
- npm run dev — تشغيل التطوير
- npm test — تشغيل اختبارات Vitest
- npm run lint — تشغيل أداة فحص الكود
- npm run db:migrate — كيتطلب التأكيد

## المعمارية
- src/app — المسارات
- src/lib — منطق العمل
- src/db — الولوج لقاعدة البيانات
- عمليات قاعدة البيانات خاصها تدوز عبر src/db

## القواعد
- استعمل TypeScript الصارم وتجنّب any
- زِد اختبارات للكود الجديد
- عاود إنتاج الخطأ باختبار فاشل قبل ما تصلحو
- ما تعدّليش src/legacy إلا كان الطلب واضح
- قبل ما تسالي، شغّل npm test وnpm run lint

تجنّب تحوّل CLAUDE.md لدليل طويل. حطّ التوجيهات المفصّلة ولا المشروطة فـ .claude/rules/ ولا فـ المهارات القابلة لإعادة الاستعمال، باش ما تندفنش التعليمات الأساسية.

استعمل سير العمل الأساسي ديال التطوير

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

1. ضغط على Shift+Tab حتى يتفعّل وضع التخطيط.
2. طلب من Claude يفتّش فالكود المعني بلا ما يدير تغييرات.
3. راجع الملفات اللي اقترح، وخطوات التنفيذ، والمخاطر، والاختبارات.
4. صحّح الخطة إلا كان ضروري.
5. خلي التنفيذ يبدا غير من بعد ما تولّي الخطة مقبولة.
6. فرض الاختبارات، أو linting، أو التحقق من الأنواع، أو لقطات الشاشة.
7. فتّش فالـ diff قبل ما تطلب commit ولا pull request.

مثال على prompt مزيان للاستكشاف:

وضع التخطيط. درس المستودع وشرح البنية ديالو،
ونقط الدخول، وتدفّق البيانات ديال /api/orders، وفين كاينين الاختبارات،
وكيفاش نشغّلوهم. ما تبدّل والو. سالِي بخمسة
أماكن اللي غالباً يقدر يوقع فيها مساهم جديد فالغلط.

كتب Prompts قابلة للتحقّق

عوض تقول «صلّح المشكل»، وصف الفشل والتحقق المتوقع:

ملي كيكون الإيميل خاوي، signup() كيطّيح بـ TypeError.
عاود إنتاج المشكل باختبار فاشل، وصلحو بأصغر تغيير
معقول، وشغّل npm test.

بالنسبة لتطوير الميزات بالاعتماد على الاختبارات:

الميزة: طبّق تخفيض 10% على الطلبات اللي قيمتها 5000 ولا أكثر.
أولاً كتب اختبارات لـ 4999 و5000 و0 والقيم السالبة.
تأكّد بلي الاختبارات الجديدة كتفشل، ومن بعد طبّق الميزة
بلا ما تبدّل هاد الاختبارات.

بالنسبة لإعادة هيكلة آمنة:

قسّم @src/services/user.ts لموديلات حسب المسؤولية.
ما تبدّل لا السلوك لا الـ API العمومي. شغّل الاختبارات وtsc من بعد
كل خطوة. إلا كانت التغطية ناقصة، زِد اختبارات توصيف السلوك أولاً.

دبّر السياق بوعي

نافذة السياق فيها تعليمات النظام، وقواعد المشروع، وأوصاف المهارات والوكلاء، وتاريخ المحادثة، والملفات، ومخرجات الأوامر. ملي كيتراكم المحتوى اللي ما عندوش علاقة، الردود تقدر تولّي أقل دقّة.

• استعمل /context باش تشوف استعمال السياق.
• استعمل /clear قبل ما تبدا مهمة ما عندهاش علاقة.
• استعمل /compact باش تلخّص جلسة طويلة مع الحفاظ على القرارات المهمة.
• زيد ملف مباشرة بصيغة بحال @src/api/client.ts.
• شغّل أمر وحطّ المخرجات ديالو فالسياق بصيغة بحال !git status.
• فالخدمة اللي كتطوّل، طلب من Claude يحافظ على PLAN.md ولا NOTES.md.
• فوّض التحقيقات الكبيرة لوكيل فرعي باش غير الملخص ديالو يرجع للجلسة الرئيسية.

وتقدر حتى تدوز السجلات لـ Claude Code فاستدعاء مؤقت:

cat error.log | claude

ضبط الصلاحيات الآمنة

قواعد الصلاحيات كتتقيّم بالترتيب المنع → السؤال → السماح. المنع عندو الأولوية على السماح. الدورة كتنصح بإضافة الأوامر الآمنة للائحة السماح عوض تعطيل التحقق من الصلاحيات.

إعدادات الفريق تقدر تحط القواعد فـ .claude/settings.json:

{
  "permissions": {
    "allow": [
      "Bash(npm run test:*)",
      "Bash(npm run lint)",
      "Bash(git status)",
      "Bash(git diff:*)"
    ],
    "ask": [
      "Bash(git push:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(curl:*)"
    ]
  }
}

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

• ما تحطّش الأسرار فـ CLAUDE.md.
• طلب التأكيد قبل عمليات الدفع، والنشر، وعمليات الترحيل.
• شغّل المهام المستقلة فحاوية ولا sandbox بلا ولوج للإنتاج.
• اعتبر المحتوى اللي كترجعو المواقع وأنظمة MCP بيانات، ماشي تعليمات موثوقة.
• راجع git diff قبل ما تدير commit للتغييرات.

حوّل الخدمة المتكررة لمهارات

إلا عاودتي نفس الإجراء كذا مرة، حوّلو لمهارة. المهارة مناسبة لسيرورات بحال تحضير ملاحظات الإصدار، ومراجعة pull request، ولا التعريف بمشروع.

الدورة كتحط مهارات المشروع تحت .claude/skills/. المهارة تقدر تكون فيها تسمية، ووصف كيساعد Claude يقرر فوقاش يستعملها، وتسلسل ديال التعليمات. خلّي الإجراء محدود وعرّف المخرجات المتوقعة ديالو.

مثلاً، مهارة ديال ملاحظات الإصدار تقدر تعطي Claude التعليمات باش يلقى آخر Git tag، ويجمع الـ commits من بعد داك الـ tag، ويصنّف التغييرات حسب الفئات. الحزمة الابتدائية فيها أصلاً مهارات قابلة لإعادة الاستعمال تقدر تستكشفها من بعد التثبيت.

استعمل وكلاء فرعيين للخدمة المعزولة ولا المتخصصة

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

مثال المراجع ديال المستودع مخزّن فـ .claude/agents/reviewer.md وكيعطي للوكيل أدوات القراءة والبحث والـ shell. الدور ديالو هو يفتّش فـ git diff على الأخطاء، والحالات الحدّية، وتسريبات الأسرار، ومخالفة أسلوب المشروع.

نمط عملي ديال الكاتب والمراجع هو:

1. استعمل جلسة Claude وحدة لتنفيذ التغيير.
2. حلّ جلسة جديدة ونقية ولا وكيل فرعي باش يراجع الـ diff.
3. رجّع الملاحظات لجلسة التنفيذ.
4. صلّح المشاكل وعاود التحقق.

السياق النقي كيساعد المراجع يلاحظ مشاكل ممكن ما تبانش من بعد جلسة تنفيذ طويلة.

فرض الضمانات باستعمال Hooks

تعليمات المشروع كتعطي التوجيه، بينما الـhooks يقدرو يشغلو العمليات أو يمنعوها أوتوماتيكياً. من أحداث الـhooks المفيدة اللي كيوصفها الكورس:

• SessionStart لتحميل معلومات الفرع أو المهمة.
• UserPromptSubmit لإضافة السياق للـprompts.
• PreToolUse لمنع الأوامر الخطيرة أو التعديلات على الملفات المحمية.
• PostToolUse للتنسيق، أو linting، أو الاختبارات الموجهة.
• Notification للتنبيهات على سطح المكتب ملي كيحتاج Claude إدخال.
• Stop لخطوة تحقق نهائية.
• PreCompact لحفظ المعلومات المهمة قبل ضغط السياق.

هاد المثال كيشغل Prettier من بعد تعديل أو كتابة الملفات:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

بالنسبة للحمايات الحرجة، جمع permissions.deny مع hook ديال PreToolUse، وما تعتمدش غير على التعليمات المكتوبة.

ربط الأنظمة الخارجية باستعمال MCP

استعمل MCP ملي كيحتاج Claude لأدوات أو بيانات خارج المستودع المحلي. الكورس كيغطي تكاملات مع GitHub، والمتصفحات، وقواعد البيانات، وخوادم MCP مخصصة.

Browser MCP مفيد بزاف فالأعمال البصرية: يقدر Claude ينفذ واجهة، ياخذ screenshot، يقارنها مع مرجع، ويعاود يحسن الاختلافات. المحتوى الخارجي يقدر يحتوي على نص غير موثوق، لذلك راجع صلاحيات MCP بعناية وبقا منتبه لمحاولات حقن التعليمات.

أتمتة المهام بالوضع غير التفاعلي

الخيار -p كيشغل prompt بلا جلسة تفاعلية، وهاد الشي كيخليه مناسب للسكريبتات وCI. مثلاً، صيفط سجل build فاشل وطلب مخرجات منظمة:

claude -p "Find the cause of the build failure" \
  --output-format json < build.log

راجع التغييرات الحالية قبل ما تدفعها:

git diff main | claude -p \
  "Review this diff for bugs, edge cases, and security issues"

حدد الأدوات وعدد الدورات لمهمة أتمتة محدودة:

claude -p "Update CHANGELOG from recent commits" \
  --allowedTools "Read,Edit,Bash(git log:*)" \
  --max-turns 10

المستودع فيه حتى أمثلة ديال GitHub Actions لاستدعاء @claude فالقضايا وطلبات الدمج، وللمراجعة الآلية.

تشغيل مهام متعددة باستعمال Git Worktrees

للخدمة بالتوازي، أنشئ worktree وفرع مستقل لكل مهمة. كل جلسة ديال Claude كتخدم فمجلد مختلف، وهاد الشي كيمنع الوكلاء المتزامنين من تعديل نفس شجرة العمل.

git worktree add ../app-auth -b feature/auth
cd ../app-auth && claude

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

أدوات مفيدة للتحكم فالجلسة

• Esc كيوقف Claude بلا ما يحيد سياق الجلسة.
• Esc Esc أو /rewind كيرجع لحالة سابقة ديال الكود والمحادثة.
• Shift+Tab كيدوز بين الوضع العادي، وقبول التعديلات أوتوماتيكياً، ووضع Plan.
• /model كيبدل الموديل النشط.
• /permissions و/hooks و/agents و/mcp كيفتحو مسارات إعدادات مرتبطة بهاد المكونات.
• claude --continue كيعاود آخر جلسة.
• claude --resume كيخليك تختار جلسة سابقة.

نصائح متقدمة وأخطاء شائعة

• بدا بخطة: استعمل وضع Plan فالتغييرات اللي كتمس ملفات متعددة أو فيها مخاطر مهمة.
• ديماً وفر feedback: الاختبارات، وفحص الأنواع، وأدوات linting، وعمليات build، وscreenshots، أو المخرجات المتوقعة بدقة، كيعطيو للوكيل فرصة يصلح راسو.
• خلي الجلسات مركزة على المهمة: صفي السياق بين المهام اللي ما عندهاش علاقة، عوض ما تخلي جلسة وحدة خدامة طول النهار.
• رجع للمحاولات الفاشلة: من بعد تصحيحات فاشلة متكررة، استعمل /rewind وعاود صيغ المهمة عوض ما تراكم سياق خايب.
• ما تقبلش diffs بشكل أعمى: فتش التغييرات بنفسك أو طلب من subagent مستقل يراجعها.
• تجنب الصلاحيات غير المحدودة: استعمل allowlists وsandboxing عوض تجاوز فحوصات السلامة.
• أتمت الإجراءات المتكررة: حول التكرار لـskill، والسلوك الإلزامي لـhook.
• حافظ على التقدم خارجياً: خدم بخطة أو ملف ملاحظات خلال المهام الطويلة باش تقدر تكمل من بعد /clear.

تبع مسار التعلم كامل

وحدات المستودع كتمشي من التثبيت، وكتابة prompts، وذاكرة المشروع، والإعدادات، وسير العمل المهني، والـskills، والـsubagents، والـhooks، وMCP، والـplugins، وheadless CI، حتى للتقنيات المتقدمة. المختبرات الثمانية كتشمل البدء، والصلاحيات، وTDD، وإنشاء skill، والـsubagents، والـhooks، وMCP، والأتمتة.

بدا بالتثبيت السريع وأوامر السياق الأساسية. من بعد، أنشئ CLAUDE.md مختصر وسياسة آمنة للصلاحيات. ثم دوز عبر التخطيط، وTDD، والـskills، والـsubagents، والـhooks قبل ما تنتقل لـMCP، والـplugins، وتنفيذ CI بلا مراقبة.

الخلاصة

كيولي Claude Code فعال لأقصى درجة ملي كتعامل معاه كوكيل تطوير قابل للإعداد، ماشي غير كواجهة محادثة. عطيو سياق مركز، وتافقو على خطة، وفر ليه فحوصات موضوعية، وفرض الحدود المهمة باستعمال الصلاحيات والـhooks. مستودع Claude Code PRO كيوفر كورس منظم، ومختبرات عملية، وقوالب قابلة لإعادة الاستعمال لتطبيق هاد السير من التطوير الفردي حتى لأتمتة العمل الجماعي.