الأسبوع ١٤الوكلاء والأتمتة

Hooks في Claude Code: اجعل الأداة تنفّذ قواعدك تلقائياً — بلا برمجة

اجعل Claude Code يطبّق قواعدك تلقائياً — ينسّق ملفاتك، يمنع الأوامر الخطيرة، ويذكّره دوماً بالمعلومات التي تريدها — بلا كتابة أي كود: تصف ما تريد بالعربية، وClaude يبني الأداة (Hook) ويركّبها، وأنت تتحقق فقط أنها تعمل.

ما هو الـ Hook في Claude Code؟

الـ Hook أمر يشغّله Claude Code تلقائياً عند حدث محدد، مثل لحظة ما قبل تنفيذ أي أداة (PreToolUse) أو بداية الجلسة (SessionStart). وبخلاف القواعد المكتوبة في CLAUDE.md التي قد يتجاهلها النموذج، يُنفَّذ الـ Hook في كل مرة، لأن الأداة نفسها هي التي تشغّله لا النموذج.

أين أضع إعداد الـ Hook؟

في ملف settings.json: داخل مجلد .claude في مشروعك ليعمل في هذا المشروع وحده، أو في ~/.claude/settings.json ليعمل في كل مشاريعك. الإعداد كائن hooks فيه اسم الحدث، ومطابِق الأداة (matcher)، والأمر الذي يُشغَّل.

كيف يمنع الـ Hook أمراً خطيراً؟

الأمر الذي يشغّله الـ Hook يقرأ تفاصيل الأداة قبل تنفيذها: إن خرج بالرمز 2 مُنع التنفيذ ووصل سبب المنع إلى Claude، وإن خرج بالرمز 0 مرّ الأمر. هذا مثال يوقف أوامر الطرفية الخطيرة قبل أن تُنفَّذ:

settings.json — منع الأوامر الخطيرة
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "INPUT=$(cat); echo \"$INPUT\" | jq -r '.tool_input.command' | grep -qE 'rm -rf|DROP TABLE|git push --force' && { echo 'أمر خطير محظور' >&2; exit 2; } || exit 0"
          }
        ]
      }
    ]
  }
}

ما ستخرج به

Claude Code يفرض قواعدك وحده: ينسّق، يمنع الخطير، يحقن السياق — بضمان لا رجاء

قبل أن تبدأ

المستوى
مبتدئ
الوقت حتى المخرج
١ ساعة تقريباً
الخطوة الأولى
اطلب من Claude بناء أول Hook وجرّبه في جلسة جديدة — ٢٠ دقيقة

ابدأ به إذا كان هدفك

  • الوكلاء والأتمتة

والعائق الذي يوقفك

  • الحاجة لربط الأدوات في نظام واحد
  • ضيق الوقت

وما الذي تتجاهله الآن

ما دام هذا دليلك الحالي، أجّل ما يلي — لا لأنه بلا قيمة، بل لأن خطوتين معاً تعنيان صفر خطوة منجزة.

  • الأحداث الثلاثين المتقدّمة
  • معالجات http/mcp/agent قبل إتقان command

الدليل كاملاً لأعضاء مُشَيِّد

العضوية تفتح هذا الدليل وكل الأدلة السابقة والقادمة، ومعها الأنظمة والموارد الجاهزة لتنفيذها — بضمان استرجاع ١٤ يوماً.

اطّلع على العضويةعضو بالفعل؟ افتح الدليل

تريد القصة والتجربة قبل الدليل؟ اقرأ المقال: خل Claude Code يلتزم بقواعدك بدل ما يتجاهلها

وبعد هذا الدليل

تصفّح أرشيف الأدلة كاملاً