إشعارات Claude Code لا تعمل؟ إليك قائمة تحقق

011. تأكد من أن Claude Code حمّل الـ hook

اكتب /hooks في prompt الخاص بـ Claude Code. ستظهر لك قائمة للقراءة فقط بكل الـ hooks التي حمّلها Claude Code، مع مصدر كل منها: إعدادات المستخدم، أو إعدادات المشروع، أو الإعدادات المحلية، أو إضافة (plugin)، أو الجلسة الحالية. اختر أي hook لترى الأمر الدقيق والملف المعرَّف فيه.

إن لم يظهر الـ hook في القائمة:

• ملف JSON غير صالح. ملفات الإعدادات تتبع صيغة JSON الصارمة؛ فاصلة زائدة في النهاية أو تعليق // كفيلان بإفساد الملف، وسيعرض Claude Code خطأ Settings Error عند التشغيل التالي. نفّذ claude doctor لترى الإدخالات التي رفضها Claude Code.
• الملف في مكان خاطئ. توضع الـ hooks الشخصية في ~/.claude/settings.json (وعلى Windows في %USERPROFILE%\.claude\settings.json)، أما hooks المشروع ففي .claude/settings.json داخل المشروع. نفّذ /status واقرأ سطر Setting sources لترى الملفات التي حُمِّلت.
• اسم الحدث خاطئ. أسماء الأحداث حساسة لحالة الأحرف: Notification وStop وPermissionRequest. أي اسم حدث غير معروف يظهر كتحذير Settings Warning ويُتجاهَل.
• الـ hooks معطَّلة. وجود "disableAllHooks": true في أي ملف إعدادات يعطّل كل الـ hooks. وإن ظهرت في /hooks الرسالة Only hooks from managed settings run here، فهذا يعني أن مؤسستك فعّلت allowManagedHooksOnly ولن تعمل الـ hooks الخاصة بك.
• لم يُلتقَط التعديل. يعيد Claude Code عادةً تحميل الإعدادات تلقائيًا. إن لم يظهر الـ hook بعد بضع ثوانٍ، فأعد تشغيل الجلسة.

022. وافق على الثقة بمساحة العمل

في الجلسة التفاعلية، يحجب Claude Code الـ hooks من جميع ملفات الإعدادات، بما فيها ملفك ~/.claude/settings.json، إلى أن توافق على نافذة الثقة بمساحة العمل لذلك المجلد. فإن أغلقت تلك النافذة دون موافقة، أو كنت في مجلد لم تفتح فيه Claude Code من قبل، فلن تعمل الـ hooks هناك. شغّل claude في ذلك المجلد ووافق على النافذة.

033. تأكد من أن الحدث يقع في الوقت الذي تظنه

كثير من الإشعارات "المعطّلة" مسألة توقيت في الحقيقة. وفقًا لمرجع الـ hooks من Anthropic:

لذا إن اختبرت hook من نوع Notification وأنت تكتب في الـ terminal، فقد لا يُطلق أبدًا. انتقل إلى نافذة أخرى وانتظر. وإن أردت تنبيهًا فور انتهاء الدور، فاستخدم Stop؛ ويشرحه دليل Stop hook.

تحقق أيضًا من وضع الأذونات. تبدأ الإصدارات الحديثة من Claude Code الجلسات التفاعلية في الوضع التلقائي، حيث يوافق مصنِّف على معظم الإجراءات دون سؤالك. وغياب طلب الإذن يعني غياب إشعار permission_prompt وعدم تنفيذ hook PermissionRequest. لاختبار تنبيهات الأذونات، اضغط Shift+Tab حتى يعرض شريط الحالة الوضع اليدوي، ثم اطلب من Claude تنفيذ شيء يحتاج إلى موافقة. تجد التفاصيل في شرح أوضاع الأذونات.

الـ matchers حساسة لحالة الأحرف كذلك؛ فالـ matcher bash في PermissionRequest لن يطابق الأداة Bash.

044. نفّذ أمر الـ hook بنفسك

انسخ الأمر من /hooks ونفّذه في terminal مع مدخلات تجريبية:

echo '{"hook_event_name":"Stop","cwd":"/tmp","last_assistant_message":"done"}' | ./my-hook.sh
echo $?

أخطاء شائعة:

• command not found: استخدم مسارًا مطلقًا للسكربت، أو ${CLAUDE_PROJECT_DIR} للسكربتات الموجودة في المشروع.
• السكربت لا يفعل شيئًا إطلاقًا: اجعله قابلًا للتنفيذ باستخدام chmod +x ./my-hook.sh.
• jq: command not found: ثبّت jq، أو حلّل JSON باستخدام Python أو Node.js.

055. اقرأ سجل التصحيح

شغّل Claude Code باستخدام claude --debug. لن يظهر شيء إضافي في الـ terminal؛ إذ يُكتب السجل في ~/.claude/debug/<session-id>.txt. ولتحديد المسار بنفسك، استخدم claude --debug-file /tmp/claude.log ونفّذ tail -f /tmp/claude.log في terminal آخر. وإن كانت الجلسة قيد التشغيل بالفعل، فإن /debug يفعّل التسجيل ويخبرك بمكان السجل.

ابحث عن الأسطر التي تبدأ بـ Hooks:. يذكر كل منها الحدث والأمر وكيف انتهى (finished with status 0 أو timed out أو failed to start) والمدة التي استغرقها. ولمزيد من التفاصيل حول المطابقة، اضبط CLAUDE_CODE_DEBUG_LOG_LEVEL=verbose.

هناك مشكلتان لا تظهران إلا هنا:

• ملف تعريف الـ shell يطبع شيئًا. إن كان ~/.bashrc أو ~/.zshrc ينفّذ echo ويحمّله الـ shell، فسيظهر ذلك النص قبل مخرجات JSON الخاصة بالـ hook، فيعاملها Claude Code كنص عادي. ابحث في السجل عن Hook output does not start with {. وغلِّف مخرجات ملف التعريف بـ if [[ $- == *i* ]]; then ... fi كي لا تُنفَّذ إلا في الـ shells التفاعلية.
• لا يوجد terminal للكتابة إليه. على Mac وLinux، تعمل hooks الأوامر دون terminal متحكِّم، لذا يفشل بصمت أي hook يحاول قرع الجرس أو كتابة رموز escape إلى /dev/tty. استخدم بدلًا من ذلك أمر إشعارات سطح المكتب، أو الإعداد preferredNotifChannel المدمج في Claude Code، والمشروح في دليل جرس الـ terminal.

066. تحقق من نظام التشغيل

إذا أظهر سجل التصحيح أن الـ hook انتهى بالحالة 0 ولم يظهر لك شيء، فهذا يعني أن نظام التشغيل أخفى الإشعار. تأكد من أن التطبيق الذي يرسل التنبيه مسموح له بعرض الإشعارات، وأن وضع التركيز Focus (على Mac) أو عدم الإزعاج (Windows) أو مفتاح عدم الإزعاج في سطح مكتب Linux متوقف. وعلى Linux، يجب أن تكون خدمة إشعارات (notification daemon) قيد التشغيل.

تجد الأوامر الخاصة بكل منصة في أدلة macOS وWindows وLinux.

07إذا كنت تستخدم Claude Code Notifier

Claude Code Notifier أداة مستقلة (ليست من إنتاج Anthropic) تثبّت برنامجًا صغيرًا هو ccn على هيئة hooks في Claude Code. كل ما سبق ينطبق عليها أيضًا، لأن ccn مجرد hook كغيره. ابدأ بفحوصاته الخاصة:

1. ccn doctor يفحص الـ hooks وبيانات الاعتماد والاتصال بالخادم واكتشاف وجودك. أصلح أي مشكلة يبلّغ عنها أولًا.
2. ccn test يرسل إشعارًا تجريبيًا. إذا وصل، فالمشكلة في الحدث أو في أحد الإعدادات، لا في مسار الإرسال.
3. ccn devices يعرض الهواتف المقترنة بهذا الكمبيوتر. إذا لم يظهر أي هاتف، فأعد الاقتران باستخدام ccn pair؛ ويشرح دليل الاقتران الخطوات.
4. ccn config show يعرض الإعدادات الفعلية. تأكد من تفعيل notify_on_done وnotify_on_permission وnotify_on_question، ومن أن quiet_hours لا تشمل الوقت الحالي. وتصل الإعدادات التي تغيّرها على الهاتف إلى الكمبيوتر عبر ccn sync.

بعض السلوكيات تبدو أعطالًا لكنها مقصودة:

• أنت أمام لوحة المفاتيح. إذا كتبت شيئًا خلال آخر 30 ثانية، فلا يُنتظر رد من الهاتف ويسألك الـ terminal كالمعتاد. ومع تفعيل quiet_when_present (الوضع الافتراضي)، لا يتلقى الهاتف شيئًا ما دمت في الـ terminal الذي يعمل فيه Claude، ويتلقى بطاقة معلومات إذا كنت نشطًا في تطبيق آخر.
• تنبيهات مكررة أو مفقودة على Mac. لا تشغّل تطبيق شريط القوائم القديم لـ Mac مع ccn على الجهاز نفسه.
• انقطاع طويل. إذا لم يُستخدم هاتف أو كمبيوتر لمدة 60 يومًا، يحذف الخادم اقترانه، فتحتاج إلى الاقتران من جديد.

على الهاتف نفسه، تأكد من السماح بإشعارات التطبيق، ومن أن وضع التركيز Focus (iPhone) أو عدم الإزعاج (Android) لا يكتمها. على Android، قد يؤخر تحسين البطارية إشعارات بعض التطبيقات؛ فإذا وصلت التنبيهات متأخرة، اسمح للتطبيق بالعمل دون قيود من إعدادات البطارية. وإذا عدّلت settings.json يدويًا، فسيخبرك ccn doctor هل لا تزال الـ hooks الخاصة به موجودة. ويحدّث ccn upgrade الأداة إلى أحدث إصدار.

08الأسئلة الشائعة