تتيح لك خطافات Claude Code hooks تشغيل أوامر Shell حتمية عند كل حدث رئيسي في دورة حياة Claude Code: قبل استخدام أداة، بعد استخدام أداة، عند إرسال مطالبة (prompt)، عند توقف وكيل، أو عند إرسال إشعار. AgentsRoom هو مركز القيادة البصري الذي يتيح لك مشاهدة كل خطاف ينطلق في الوقت الفعلي، عبر عشرات وكلاء Claude Code، في عشرات المشاريع.
الخطافات هي الطريقة الرسمية من Anthropic لإضافة أتمتة حتمية وحواجز حماية ومسارات تدقيق وتأثيرات جانبية مخصصة إلى Claude Code. AgentsRoom لا يستبدل خطافاتك. بل يشغل أداة Claude Code CLI الحقيقية، لذا فإن كل خطاف تقوم بتكوينه في .claude/settings.json يستمر في العمل كما هو مقصود بالضبط. ما يضيفه AgentsRoom هو الرؤية: لوحة تحكم مباشرة حيث يمكنك رؤية كل إطلاق خطاف، لكل وكيل، ولكل مشروع، ولكل تشغيل.
خطافات Claude Code hooks هي أوامر Shell معرّفة من قبل المستخدم يقوم Claude Code بتنفيذها تلقائيًا عند نقاط محددة خلال جلسة الوكيل. يتم تكوينها في .claude/settings.json (مشتركة، مُودعة في git) أو .claude/settings.local.json (شخصية، مستثناة من git)، وتمنحك تحكمًا حتميًا في سلوك وكلاء Claude Code لديك. حيث تكون المطالبة (prompt) احتمالية، يكون الخطاف حتميًا بنسبة 100٪: يعمل في كل مرة يتم فيها إطلاق الحدث المطابق، بلا استثناءات.
الخطافات هي إجابة Anthropic على الحاجة إلى حواجز الحماية والأتمتة وقياس البيانات وتسجيل التدقيق والتكاملات المخصصة. يمكنك استخدام خطافات Claude Code hooks لتنسيق الكود تلقائيًا بعد كل تعديل، أو حظر الأوامر الخطرة قبل تشغيلها، أو تسجيل كل استدعاء أداة في ملف، أو إرسال إشعار سطح مكتب عندما ينتظر الوكيل الإدخال، أو تشغيل مهمة CI عند انتهاء الجلسة، أو دفق كل مطالبة (prompt) إلى خلفية قابلية الملاحظة. أي أمر Shell يمكنك كتابته، يمكنك ربطه بخطاف Claude Code hook.
نظرًا لأن الخطافات تعيش في المشروع نفسه (يتم إيداع .claude/settings.json في git)، فإنها تنتقل مع قاعدة الكود الخاصة بك. كل مطور في الفريق، وكل وكيل ذكاء اصطناعي يتم إنتاجه من هذا المشروع، يرث نفس شبكة الأمان. يحترم AgentsRoom هذا النموذج من البداية إلى النهاية: تطبيق سطح المكتب لا يعيد كتابة خطافاتك، بل يشغل أداة Claude Code CLI الحقيقية كعملية فرعية، والتي تلتقط تكوين الخطاف الخاص بك تلقائيًا، تمامًا كما لو كنت تشغل claude code من الطرفية.
كل جلسة وكيل Claude Code تُطلق أحداث خطافات عند نقاط محددة جيدًا. إليك ما يعنيه كل حدث وما يمكنك فعله به.
يُطلق خطاف PreToolUse قبل أن يشغل Claude Code أي أداة (Bash، Edit، Write، Read، Grep، إلخ). إنه المكان المثالي لحواجز الحماية: حظر الأوامر الخطرة، أو طلب تأكيد للعمليات المدمرة، أو فرض قواعد خاصة بالمشروع، أو إعادة كتابة وسائط الأداة قبل التنفيذ. أعد رمز خروج غير صفري من الخطاف لحظر استدعاء الأداة بالكامل. PreToolUse هو خطاف Claude Code hook رقم 1 للفرق التي تهتم بالسلامة.
يُطلق خطاف PostToolUse مباشرة بعد اكتمال أي أداة Claude Code. هذا هو المكان الذي تربط فيه المعالجة اللاحقة التلقائية: تشغيل منسق (Prettier، Black، rustfmt) بعد كل Edit، أو تشغيل أداة فحص بعد كل Write، أو تحديث سجل التغييرات عند تعديل ملف، أو دفع أحداث قياس البيانات. PostToolUse هو الخطاف الأساسي لتحويل Claude Code إلى عضو فريق منضبط يترك قاعدة الكود أنظف مما وجدها.
يُطلق خطاف UserPromptSubmit كلما تم إرسال مطالبة (prompt) جديدة إلى وكيل Claude Code. استخدمه لتسجيل كل مطالبة للتدقيق والامتثال، أو إعادة كتابة المطالبات أثناء التشغيل (إدخال السياق، إخفاء الأسرار)، أو توجيه الطلبات إلى نماذج مختلفة، أو فرض اصطلاحات التسمية. عند دمجه مع لوحة التحكم متعددة الوكلاء في AgentsRoom، يمنحك UserPromptSubmit مسار تدقيق كامل لكل تعليمة مرسلة إلى كل وكيل Claude Code.
يُطلق Stop hook عند انتهاء جلسة وكيل Claude Code، إما لأن العمل قد تم أو لأنه تم إلغاؤه. إنه المكان المناسب لتشغيل مهام التنظيف، أو دفع ملخص نهائي إلى نظام تتبع، أو إيداع القطع الأثرية، أو إخطار إنسان بأن الجلسة انتهت. يكمل AgentsRoom Stop hook بنظام الإشعارات الخاص به، لذلك يتم إخطارك من قبل خطافك المخصص ومن قبل إشعارات الدفع الخاصة بـ AgentsRoom على سطح المكتب والجوال.
يُطلق Notification hook عندما يرسل Claude Code إشعار نظام — عادةً عندما ينتظر الوكيل إدخال المستخدم أو أنهى مهمة طويلة الأمد. استخدمه لتوجيه الإشعارات إلى Slack أو Discord أو Telegram أو البريد الإلكتروني أو أي webhook تفضله. يعرض AgentsRoom بالفعل إشعارات Claude Code محليًا في لوحة التحكم متعددة الوكلاء وكإشعارات دفع على هاتفك، لذا فإن Notification hook هو المكان المثالي لإضافة تكاملات مخصصة فوقه.
يُطلق خطاف SubagentStop عندما ينهي وكيل فرعي لـ Claude Code عمله ويعيد التحكم إلى الأصل. إذا كنت تستخدم وكلاء فرعيين لـ Claude Code معرفين في .claude/agents/*.md لتفويض المهام المتخصصة، فإن SubagentStop يتيح لك تسجيل ما فعله كل وكيل فرعي، أو تجميع مخرجاتهم، أو تشغيل خطوة متابعة. داخل AgentsRoom، تظهر أحداث SubagentStop في الجدول الزمني المباشر للوكيل حتى تتمكن من رؤية الوكلاء الفرعيين الذين تم تشغيلهم بالضبط داخل كل جلسة Claude Code.
تحول الخطافات Claude Code من ذكاء اصطناعي مثير للإعجاب إلى وكيل ترميز بدرجة إنتاجية يمكن لفريقك بأكمله الاعتماد عليه.
المطالبات احتمالية ويمكن تجاوزها. خطافات Claude Code hooks هي أوامر Shell حتمية تعمل دائمًا. يمكن لخطاف PreToolUse حظر أي rm -rf، وأي push --force، وأي ترحيل مدمر — بغض النظر عن كيفية صياغة الوكيل لتفكيره. هذا هو المعيار الذهبي لعمليات نشر Claude Code الحرجة للسلامة.
اربط خطافات Claude Code hooks بأدوات التنسيق، وأدوات الفحص، ومشغلات الاختبار، ومدققات الأنواع، وبرامج البناء النصية الخاصة بك. كل تعديل يقوم به الوكيل يطلق نفس الفحوصات التي يشغلها خط أنابيب CI الخاص بك — محليًا، فوريًا، وتلقائيًا. يصبح وكلاء Claude Code الخاصون بك مساهمين منضبطين ذاتيًا لا ينسون أبدًا تشغيل المنسق.
يمكن تسجيل كل مطالبة، وكل استدعاء أداة، وكل بداية ونهاية جلسة بواسطة خطافات Claude Code hooks. ادمج ذلك مع الجدول الزمني البصري لـ AgentsRoom وستحصل على مسار تدقيق كامل لكل إجراء لوكيل ترميز ذكاء اصطناعي — ضروري للفرق الملتزمة بالامتثال، والشركات الواعية بالأمان، وأي شخص جاد بشأن تطوير الذكاء الاصطناعي القابل للملاحظة.
نظرًا لأن .claude/settings.json مُودع في git، فإن مجموعة واحدة من خطافات Claude Code hooks تفرض نفس الاصطلاحات لكل مطور في الفريق وكل وكيل ذكاء اصطناعي يتم إنتاجه من المشروع. يرث أعضاء الفريق الجدد حواجز الحماية في اللحظة التي يستنسخون فيها المستودع. قم بترقية سلوك فريق ترميز الذكاء الاصطناعي بالكامل باستخدام طلب سحب واحد.
تنتج خطافات Claude Code hooks أحداثًا. يحول AgentsRoom هذه الأحداث إلى تغذية مرئية: كل إطلاق خطاف، وكل استدعاء أداة، وكل تغيير حالة، مُدفقة مباشرة لكل وكيل ولكل مشروع. لن تضطر بعد الآن إلى متابعة السجلات — ستشاهد أسطول Claude Code الخاص بك يعمل في الوقت الفعلي.
بدون خطافات، يعني تشغيل Claude Code مراقبة كل استدعاء أداة. مع الخطافات، تقوم بتفويض المراقبة إلى كود حتمي وتشرف على مستوى الاستثناء. يضخم AgentsRoom هذا: ترى جميع وكلاء Claude Code المحميين بالخطافات دفعة واحدة، ولا تتدخل إلا عندما يتطلب شيء ما انتباهك.
AgentsRoom هو مركز القيادة البصري لـ Claude Code وغيره من أدوات CLI لترميز الذكاء الاصطناعي. إنه لا يفرع Claude Code، ولا يعيد تنفيذ الخطافات، ولا يعترض استدعاءات الأدوات. يقوم بتشغيل أداة Claude Code CLI الحقيقية كعملية فرعية داخل طرفية xterm.js كاملة، مما يعني أن كل خطاف قمت بتعريفه في .claude/settings.json أو .claude/settings.local.json يعمل تمامًا كما صممته Anthropic — بلا تنازلات، ولا مفاجآت، ولا وسيطة غير مرئية.
ما يضيفه AgentsRoom هو المقياس والرؤية. يمكنك تشغيل عشرات من وكلاء Claude Code بالتوازي، عبر عشرات المشاريع، كل منها بتكوين خطاف خاص به، ورؤية كل إطلاق خطاف على لوحة تحكم واحدة. مع إشعارات AgentsRoom لكل وكيل، وتطبيق الرفيق للجوال، وتتبع الحالة في الوقت الفعلي، تصبح خطافات Claude Code hooks طبقة قابلية ملاحظة من الدرجة الأولى لعملية ترميز الذكاء الاصطناعي بأكملها لديك.
يُنتج AgentsRoom عمليات claude CLI حقيقية داخل طرفيات xterm.js كاملة. أي خطاف تم تكوينه في .claude/settings.json أو .claude/settings.local.json أو الإعدادات على مستوى المستخدم يُطلق تلقائيًا، تمامًا كما لو كنت قد شغلت Claude Code من طرفيتك. بلا تصحيحات، بلا إعادة كتابة، بلا فقدان للدقة.
شغّل 10، 20، 50 وكيل Claude Code بالتوازي مع تمكين الخطافات. تعرض لوحة التحكم متعددة الوكلاء في AgentsRoom إشعارات وتغييرات الحالة الناتجة عن الخطافات لكل وكيل في وقت واحد. تعمل حواجز حماية PreToolUse، ومنسقات PostToolUse، ومعالجات Stop على نطاق الأسطول.
كل مشروع في AgentsRoom لديه .claude/settings.json الخاص به وبالتالي تكوين خطافات Claude Code hook الخاص به. يقوم الشريط الجانبي بتجميع الحالة المباشرة عبر المشاريع حتى تتمكن من اكتشاف أي خطافات تُطلق وأين، وأي وكلاء محجوبون في انتظار إدخال المستخدم، وأي Stop hooks أكمل للتو تشغيلًا.
يأتي AgentsRoom مع إشعارات macOS الأصلية وإشعارات دفع الجوال المشفرة من طرف إلى طرف. Notification hook الخاص بـ Claude Code، وStop hook، وSubagentStop hook كلها تنتج إشارات يعرضها AgentsRoom مباشرة على سطح المكتب والهاتف. يمكنك الابتعاد عن الكمبيوتر ولا تزال تعرف متى يخبرك خطاف بالعودة.
قم بتنزيل AgentsRoom، وافتح مشروعًا بخطافات .claude/settings.json، وأنتج وكيل Claude Code، وشاهد كل حدث خطاف يتدفق إلى لوحة التحكم في الوقت الفعلي.
التطبيق المرافق: تابع وكلاءك أينما كنت
يعمل مع Claude و Codex و OpenCode و Gemini CLI و Aider