إشعارات Codex: احصل على تنبيه عندما ينتهي أو ينتظر الموافقة

يمكن لـ Codex أن يخبرك متى ينتهي دور (turn) ومتى يحتاج إلى موافقتك. لكن هناك مشكلة: الآليتان الموجودتان في ملف التهيئة تغطيان أحداثًا مختلفة، وفي معظم الطرفيات يتحول «إشعار سطح المكتب» بصمت إلى جرس.

بقلم Aslan، فريق Pet Island · آخر تحديث 26 أكتوبر 2026 · مدة القراءة: 3 دقيقة

الإجابة المختصرة

استخدم القسم [tui]: ‏notifications = ["agent-turn-complete", "approval-requested"]، وnotification_condition = "always" إذا أردت التنبيهات حتى أثناء تركيزك على الطرفية. لا يرسل Codex إشعار سطح المكتب (OSC 9) إلا في Ghostty وiTerm2 وKitty وWarp وWezTerm. وفي كل مكان آخر، بما في ذلك Windows Terminal، يقرع الجرس. أما الإعداد notify في المستوى الأعلى فيشغّل برنامجك الخاص، لكن فقط عند agent-turn-complete، وليس عند الموافقات أبدًا.

إعدادان مختلفان

	[tui] notifications	notify
ماذا يفعل	تنبيه في الطرفية من Codex CLI	يشغّل برنامجًا تختاره
اكتمال الدور	نعم (`agent-turn-complete`)	نعم (`agent-turn-complete`)
طلب موافقة	نعم (`approval-requested`)	لا
طلبات الخطة / الأسئلة	نعم (`plan-mode-prompt` و`async-question`)	لا
الافتراضي	مفعّل	معطّل

إذا أردت أن تعرف متى ينتظرك Codex، فإن notify وحده لن يفعل ذلك أبدًا. استخدم إشعارات TUI لهذا الغرض.

إشعارات TUI

هذا هو الجزء المعني من مثال التهيئة لدى OpenAI:

~/.codex/config.tomlنسخ

[tui]

# Desktop notifications from the TUI: boolean or filtered list. Default: true

notifications = ["agent-turn-complete", "approval-requested"]

# Notification mechanism for terminal alerts: auto | osc9 | bel. Default: "auto"

notification_method = "auto"

# When notifications fire: unfocused (default) | always

notification_condition = "unfocused"

notifications: ‏true أو false أو قائمة أحداث. يغطي approval-requested طلبات الموافقة على الأوامر وتعديلات الملفات وMCP.
notification_condition: افتراضيًا لا تُطلَق التنبيهات إلا عندما لا تكون الطرفية في وضع التركيز. اضبط always إذا كنت تُبقي الطرفية ظاهرة على شاشة أخرى.
notification_method: auto أو osc9 أو bel.

تبدو الرسائل مثل «Approval requested: <command>» و«Codex wants to edit <file>» و«Agent turn complete».

لماذا لا تسمع سوى صفير (Windows Terminal وغيرها)

في وضع auto لا يرسل Codex إشعار سطح المكتب (تسلسل الهروب OSC 9) إلا عندما يتعرف على Ghostty أو iTerm2 أو Kitty أو Warp أو WezTerm. كل طرفية أخرى (Windows Terminal، وطرفية VS Code، وApple Terminal) تحصل على جرس الطرفية. هذا مأخوذ من الشيفرة المصدرية لـ Codex ‏(tui/src/notifications/mod.rs)؛ أما الوثائق فتقول فقط إن auto «prefers OSC 9» (يفضّل OSC 9).

في Windows Terminal يمكنك جعل الجرس أوضح: اضبط bellStyle على all في إعدادات ملف التعريف ليشغّل صوتًا ويجعل أيقونة شريط المهام تومض (القيمة الافتراضية audible).

ملف settings.json في Windows Terminal (ملف التعريف)نسخ

{

"bellStyle": "all"

}

يمكنك أيضًا فرض notification_method = "osc9"؛ أما تحويله إلى إشعار نظام فيعتمد على الطرفية.

شغّل برنامجك الخاص باستخدام notify

يشغّل notify برنامجًا خارجيًا عند اكتمال الدور ويمرّر إليه وسيطة JSON واحدة تحتوي على type وthread-id وturn-id وcwd وinput-messages وlast-assistant-message. وهذا يجعله مناسبًا لإشعار على الهاتف، أو webhook، أو سجل: أي شيء خارج الطرفية. إنه مفتاح في المستوى الأعلى، لذا ضعه فوق أي [section]:

~/.codex/config.tomlنسخ

notify = ["python3", "/Users/you/.codex/notify.py"]

سكربت بسيط، على غرار السكربت الموجود في وثائق OpenAI:

~/.codex/notify.pyنسخ

import json, subprocess, sys

notification = json.loads(sys.argv[1])

if notification.get("type") == "agent-turn-complete":

message = (notification.get("last-assistant-message") or "Turn complete")[:120]

# macOS: a system notification. On Linux use ["notify-send", "Codex", message].

subprocess.run(["osascript", "-e", f'display notification {json.dumps(message)} with title "Codex"'])

لا يمكن لملف .codex/config.toml الخاص بالمشروع ضبط notify. يجب أن يكون في تهيئة المستخدم.
تصنّف الشيفرة المصدرية لـ Codex الإعداد notify على أنه قديم وتخطط لاستبداله بالخطافات. إنه يعمل اليوم؛ تابع سجل التغييرات.

ماذا عن الخطافات؟

لدى Codex خطافات أيضًا. وهي مفعّلة افتراضيًا وتتضمن الحدثين PermissionRequest وStop، وتُهيّأ في ~/.codex/hooks.json أو في جدول [hooks]، ويجب مراجعة كل خطاف غير مُدار والوثوق به عبر /hooks قبل أن يعمل. لا يوجد حدث Notification، ولا تعرض وثائق OpenAI خطاف إشعارات. للتنبيهات، إعداد TUI أعلاه هو المسار الموثّق.

تطبيق Codex وإضافة بيئة التطوير

لتطبيق Codex لسطح المكتب عناصر تحكم خاصة به: يمكن ضبط تنبيهات اكتمال الدور على «أبدًا»، أو «فقط عندما يكون التطبيق في الخلفية»، أو «دائمًا»، وهناك مفاتيح منفصلة لتشغيل إشعارات الأذونات والأسئلة أو إيقافها. لا تحتوي إضافة بيئة التطوير على إعدادات إشعارات خاصة بها. وتحيلك وثائق OpenAI إلى notify بدلًا من ذلك.

إذا كنت توافق من هاتفك عبر تطبيق ChatGPT، فإن المشكلة #39346 تُبلغ عن حالة يعرض فيها الهاتف «approval waiting» (موافقة بانتظارك) دون بطاقة للرد عليها.

أن تراه، وأن ترد عليه

الجرس يخبرك بأن شيئًا ما حدث في طرفية ما. يعرض Pet Island حالة Codex في جزيرة صغيرة أعلى الشاشة (يعمل، أو ينتظر، أو انتهى)، وعندما يطلب Codex تشغيل أمر أو تعديل ملف، يظهر الطلب هناك مع الأمر أو الفروقات (diff). اسمح به أو ارفضه دون التبديل بين النوافذ؛ وبالنسبة للأسئلة، تنقلك نقرة واحدة إلى الطرفية الصحيحة. يعمل مع Codex CLI وتطبيق Codex، إلى جانب Claude Code وCursor وبقية وكلائك.

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

كيف أحصل على إشعار عندما ينتهي Codex؟

إشعارات TUI في Codex مفعّلة افتراضيًا لحدث agent-turn-complete، لكنها افتراضيًا لا تُطلَق إلا عندما لا تكون الطرفية في وضع التركيز. اضبط notification_condition = "always" في [tui] إذا أردتها أثناء التركيز.

كيف أحصل على إشعار عندما يحتاج Codex إلى موافقة؟

أضف "approval-requested" إلى notifications في القسم [tui] من ~/.codex/config.toml. الإعداد notify لا يُطلَق عند الموافقات.

لماذا يكتفي Codex بالصفير بدلًا من عرض إشعار؟

في وضع auto لا يرسل Codex إشعار سطح المكتب إلا في Ghostty وiTerm2 وKitty وWarp وWezTerm. أما الطرفيات الأخرى، ومنها Windows Terminal، فتحصل على الجرس.

هل يمكنني وضع notify في ملف .codex/config.toml الخاص بمشروعي؟

لا. لا يمكن لتهيئة المشروع ضبط notify؛ ضعه في ~/.codex/config.toml.

هل لدى Codex خطاف Notification؟

لا. تتضمن خطافات Codex الحدثين PermissionRequest وStop، لكن لا يوجد حدث Notification ولا خطاف إشعارات موثّق.

المصادر

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

تابع القراءة

Codex