Codex Security هو وكيل أمان يبحث عن ثغرات محتملة في الكود، ويتحقق من الأدلة، ويساعد على الوصول إلى الإصلاحات. أولًا، ميّز بين الإضافة التي تستخدمها مع Codex محليًا، وCodex Security Cloud الذي يعمل في السحابة ومتصل بـGitHub. فرغم تشابه الاسم، يختلفان في الإعداد ومكان التشغيل ومكان التحقق من التسعير. وهناك أيضًا نسخة مستقلة لسطر الأوامر لإدراجها في CI وما شابهه (@openai/codex-security، ويُشار إليها لاحقًا بـ«واجهة الأوامر المستقلة»).
Codex Security
يعمل في تطبيق سطح المكتب أو في دردشة Codex CLI. اختر نطاق الفحص: المستودع كاملًا، أو مجلدًا محددًا، أو فرق التغييرات.
Codex Security Cloud
إضافة منفصلة. تفحص مستودع GitHub المتصل في السحابة، وتُجري فحصًا لمرة واحدة، أو تراقب الـ commits الجديدة.
تتناول هذه المقالة اختيار الطريقة المناسبة، والأسعار والرصيد المجاني، والفحص الأول، وعبء الفحص العميق، وقراءة النتائج، والتحقق بعد الإصلاح.
المصدر: OpenAI، نظرة عامة على Codex Security وبدء استخدام الإضافة المحلية.
كيفية الاختيار بين النسخة المحلية ونسخة Cloud والمراجعة العادية
لتغيير صغير، يمكنك ببساطة تمرير الفرق (diff) ومعايير المراجعة إلى Codex العادي. لا يعني ذلك أن مخرجات أداة فحص متخصصة أو سجل نطاق الفحص تُضاف تلقائيًا. يجب التعامل مع طلب مراجعة الكود وتشغيل فحص Codex Security كأمرين منفصلين. ولمعرفة كيفية الاختيار بين منتجات Codex نفسها، راجع مقالة مقارنة Claude Code وCodex.
@openai/codex-security) وSDK. وهما منفصلان عن الإضافة داخل Codex CLI، لذا تحقق من طريقة المصادقة وصلاحيات التشغيل والميزانية بشكل منفصل.إن Cloud في مرحلة المعاينة البحثية، ويتطلب استخدامه وصولًا إلى مساحة العمل المستهدفة. وبالنسبة لواجهة الأوامر المستقلة أيضًا، فإن نشر الحزمة وامتلاك حسابك صلاحية الفحص أمران منفصلان. وبحسب حسابك ومستودعاتك، قد يلزم أيضًا «Trusted Access for Cyber» لإجراء فحص كامل. لا يمكنك الاستنتاج أن كل المسارات متاحة لمجرد اسم خطة مثل Pro. وإذا لم يظهر شيء على الشاشة، فتحقق من تفعيل الإضافة، وصلاحيات الاستخدام، وإعدادات الإدارة في مؤسستك.
المصدر: OpenAI، نظرة عامة وشروط الوصول ومراجعة أمنية لتغييرات الكود.
الأسعار والرصيد المجاني: يلزم التحقق بشكل منفصل حتى مع Pro
فحوصات Cloud لا تُحتسب ضمن حصة الخطة العادية
تشرح الأسئلة الشائعة لـCloud من OpenAI أن فحوصات المستودعات والفحوصات المستمرة التي تُعدّ في 1 أكتوبر 2026 الساعة 12:53 (التوقيت الرسمي لمنطقة المحيط الهادئ في الولايات المتحدة) أو بعده تُحتسب بالأرصدة أو بالدولار الأمريكي استنادًا إلى أسعار الرموز (tokens) في الخطة. ولا تُدرج ضمن حصة الاستخدام العادية للخطة. وبالنسبة للحسابات المؤهلة، تُستهلك أرصدة الفحص المجانية قبل الاستخدام المدفوع.
المراقبة الحالية المؤهلة مجانية حتى 21 أكتوبر
الفحوصات التي تُضاف لاحقًا لا تشملها. بعد انتهاء الفترة المجانية، تستمر المراقبة إذا فعّلت الاستخدام المدفوع، وتتوقف مؤقتًا إذا لم تفعّله.
رصيد مجاني بما يعادل 500 دولار أمريكي للحسابات المؤهلة
للحسابات المؤهلة. يُستخدم الرصيد نفسه للفحوصات لمرة واحدة والمستمرة، ويُشارك عبر مساحة العمل. وبحسب الأسئلة الشائعة، لا تنتهي صلاحية رصيد الفحص المجاني هذا.
500 دولار أمريكي هو رصيد فحص للحسابات المؤهلة. وبعد استنفاده، تنطبق بنية الفوترة لذلك الحساب أو مساحة العمل. قبل البدء، تحقق على الشاشة مما إذا كنت مؤهلًا، وكم يتبقى من الرصيد المجاني، وشروط الاستخدام المدفوع.
«التكلفة» على الشاشة ليست دائمًا ما ستُحاسَب عليه
في Cloud، يمكنك فتح الفحص المعني من «Scans» والاطلاع على عدد الرموز والتكلفة. ويعرض التمرير فوق عدد الرموز تفصيل المدخلات والمدخلات المخزنة مؤقتًا والمخرجات. والتكلفة المعروضة هي المبلغ قبل تطبيق الرصيد المجاني أو الإعفاءات من الفوترة، لذا اقرأ ما يُغطى بالرصيد المجاني منفصلًا عن المبلغ الفعلي للفوترة. أما الفحوصات التي تعرض «Exempt from billing. No charges apply.» فلا تُحتسب عليها رسوم.
المصدر لبيانات الأسعار والرصيد المجاني والعرض: الأسئلة الشائعة حول Codex Security Cloud، قسم «Billing» من OpenAI. المرجع الزمني هو التوقيت الرسمي لمنطقة المحيط الهادئ في الولايات المتحدة كما هو منشور رسميًا.
لا يُطبَّق رصيد Cloud المجاني على النسخة المحلية
تعمل الإضافة المحلية كمهمة في Codex. وبموجب شروط الاستخدام العامة لـCodex، تؤثر الخطة والنموذج وحجم المعالجة وطريقة المصادقة في الاستهلاك، وتُحتسب الأعمال المحلية الإضافية التي تستخدم مفتاح API وفق أسعار API. ومن ناحية أخرى، لا تحدد خطوات البدء المحلية التي تحققت منها، ووثائق الفحص القياسي والعميق، وأسئلة CLI الشائعة، سعرًا ثابتًا لكل فحص، ولا جدول أسعار خاصًا بالإضافة. لا تفترض أن «المحلي يعني صفر استهلاك»، ولا أن «رصيد Cloud البالغ 500 دولار يمكن استخدامه».
قد تستخدم واجهة الأوامر المستقلة مفتاح API حتى عند تسجيل الدخول. إذا كان OPENAI_API_KEY أو CODEX_API_KEY موجودًا في البيئة، فسيُختار ذلك المفتاح تلقائيًا للفحوصات غير التفاعلية ولمخرجات JSON/JSONL. وإذا وُجد مفتاح API للبيئة وتسجيل دخول ChatGPT محفوظ معًا، فإن الأوضاع التفاعلية والنصية تسألك عن طريقة الاختيار. وتوفر الوثائق الرسمية خيارين صريحين هما --auth chatgpt و--auth api-key، لذا حدد الجهة التي ستُحاسَب قبل البدء.
يمكنك التحقق من رصيد Codex في شاشة الاستخدام، وداخل Codex CLI عبر /status. كما يلزم التحقق من تكاليف فحوصات Cloud من جانب Cloud أيضًا. ولمقارنة الخطط، راجع مقالة أسعار Pro وحصص الاستخدام.
المصدر: OpenAI، أسعار Codex وWork والاستخدام واختيار مصادقة CLI.
خطوات الفحص الأول ونص الطلب
فيما يلي شرح للخطوات الرسمية. اقصر أهداف الفحص على الكود الذي تملكه أو لديك إذن باختباره. وفي الفحص الأول، تحقق من الفرع المستهدف والمراجعة (revision) ومكان الإخراج والمصادقة المستخدمة. والبدء بـStandard هو التسلسل الأسهل.
الإضافة المحلية في تطبيق سطح المكتب
- ابحث عن «Codex Security» في قائمة الإضافات، ثم ثبّتها وفعّلها. أما Cloud فهي إضافة منفصلة.
- افتح من الشريط الجانبي Security → Scans → + Scan.
- اختر المستودع. للفحص الكامل اختر «Codebase»، وفي التشغيل الأول أوقف «Deep scan».
- تحقق من المجلد المراد فحصه، والفرع الحالي والمراجعة، والنموذج ومقدار الاستدلال (reasoning effort).
- عند الحاجة فقط، أضف في «Additional context» نقاط الدخول العامة وشروط التفويض والعمليات المهمة.
- ابدأ بـ«Start scan»، وتابع التقدم لكل مرحلة. وبعد الاكتمال، اقرأ نطاق الفحص والأدلة.
عند الاستخدام داخل Codex CLI، ثبّت الإضافة بـ/plugins، ثم أنشئ دردشة جديدة للمستودع المستهدف بـ/new. بدلًا من أن تكتب «افحص الأمان» فقط، اذكر استخدام الفحص المتخصص وهدفه، ليبقى في السجل ما طلبته.
شغّل فحصًا قياسيًا باستخدام Codex Security مع التركيز على services/billing.
ركّز أولًا على مدخلات المستخدمين، وفحص ملكية معلومات الفوترة، والعمليات الخاصة بالمسؤول.
هذه المرة للفحص والتقرير فقط. لا تعدّل الكود المصدري، ولا تنفذ commit أو push أو نشرًا، ولا تغيّر إعدادات الفوترة.
أبلغ عن المراجعة المستهدفة، والنطاق الذي تم فحصه، والنطاق المستثنى أو غير المكتمل، والأدلة على كل إعادة إنتاج.
إذا كان يلزم تغيير في الإعدادات، فأوقف العمل واعرض التغيير وسببه.
الممنوعات المكتوبة في نص الطلب لا تفرض الصلاحيات كما تفعل بيئة العزل (sandbox)، لذا تحقق من صلاحيات التنفيذ بشكل منفصل.
نسخة Cloud التي تستخدم GitHub
- ثبّت «Codex Security Cloud» وتحقق من اتصال GitHub بالمستودع المستهدف.
- اختر المستودع والبيئة من «Scan». يُنشئ «Auto» بيئة عند البدء، لذا إذا أردت استخدام بيئة جاهزة فتحقق منها عبر «Customize».
- لفحص واحد فقط اختر «One-Time Scan». ولمراقبة الـ commits المستقبلية اختر «Continuous Scanning».
- تحقق من السعر والرصيد المتبقي والنطاق، ثم ابدأ بـ«Create».
تستهدف الفحوصات المستمرة الفرع الافتراضي للمستودع. وكلما طالت فترة السجل التي تفحصها، طال الفحص الأولي. ولإيقاف المراقبة، أوقفها مؤقتًا من «Repositories»، ثم اختر الهدف، ثم «Monitoring settings»، واحفظ. ولا تخلط بين إغلاق الشاشة وإيقاف المراقبة.
المصدر: OpenAI، خطوات بدء الإضافة وإعداد Cloud والمراقبة.
Standard وDeep: ضبط النطاق والعبء
Standard
فحص عادي للمستودع أو المجلد. حدّد ما سيُفحص وما نوع الأدلة التي ستظهر أولًا، واستخدمه كأساس تقارن به الفحوصات التالية.
Deep
طريقة تستكشف على نطاق أوسع، لذا تضع عبئًا كبيرًا على الوقت والموارد. تستخدم عمال فحص مستقلين والوكلاء الفرعيين التابعين لهم، وتجمع النتائج وفق الشروط.
في إعدادات Deep الرسمية، عدد العمال المتزامنين الافتراضي هو 4، وعدد الوكلاء الفرعيين لكل عامل هو 3، والحد الأقصى لوقت التشغيل 96 ساعة. الـ96 ساعة حد أقصى مُعَدّ في الإعدادات، وليست مدة التشغيل المعتادة. وضبط حد زمني يتطلب الإضافة 0.1.19 أو أحدث. وعند بلوغ الحد الزمني، يُوقف العمال غير المكتملين، وتُجمع النتائج المكتملة. وإذا بقي جزء غير مفحوص، يبقى ذلك النطاق كما هو.
ابدأ بتضييق الهدف إلى وحدات خدمة ذات معنى، واقرأ نتائج Standard، ثم قرر الحاجة إلى Deep. ويمكنك أيضًا فحص المجالات الحرجة فقط بعمق، مثل المدفوعات والمصادقة. فتقليل عدد العمال والحدود الزمنية يخفف العبء، لكنه قد يزيد المشكلات التي لا تُكتشف، لذا من المهم تسجيل «نطاق الهدف للنتيجة الأرخص والأسرع».
لفحص الفروق، استخدم «Changes». يمكنك اختيار التغييرات غير الملتزَم بها، أو commit واحد، أو مراجعتي الأساس والهدف، لكن لا يتوفر Deep مع Changes. فهو يفحص الكود المرتبط مباشرة بالفرق، ولا يتوسع تلقائيًا إلى تدقيق شامل.
حد التكلفة في واجهة الأوامر المستقلة تقديري. يحدد الخيار الرسمي --max-cost متى يتوقف الفحص استنادًا إلى تكلفة مقدَّرة بالدولار الأمريكي. وقد يكتمل طلب قيد التنفيذ بالفعل متجاوزًا الحد، لذا فهو ليس سقفًا دقيقًا للدفع. اجمعه مع الحدود الزمنية والتوازي والنطاق، ولا تعامل فحصًا توقف في منتصفه كنتيجة كاملة.
المصدر: OpenAI، Standard وDeep والقيم الافتراضية، ونطاق Changes، وحدود التكلفة المقدّرة.
قراءة النطاق والأدلة قبل عدد النتائج
عدد المشكلات التي وُجدت وحده لا يكفي للحكم على جودة الفحص. فالفحص الذي استهدف الكود الخطأ، أو توقف في منتصفه، أو تجاهل شروط التفويض، قد يُظهر صفر نتائج دون أن يكون الكود آمنًا. كما توجّه خطوات الفحص القياسي الرسمية إلى قراءة المراجعة والمجالات التي تم فحصها والمؤجلة والأدلة الفردية أولًا.
- هل الهدف صحيح؟ تحقق من المستودع والمراجعة والنطاق. لا تستخدم نتائج الكود القديم كضمان للنسخة الحالية.
- ما الذي لم يُفحص؟ تحقق من المجالات المستثناة والمعلّقة والمنقطعة. لا تفترض أنك فحصت كل شيء لمجرد ظهور حالة الاكتمال.
- هل يصمد الدليل؟ تحقق من المسار من المدخل إلى المعالجة الخطرة، والدفاعات الموجودة، وطريقة إعادة الإنتاج ونتيجتها.
- هل يلزم إصلاحه؟ ضع في الاعتبار شروط الوصول الفعلية للمشكلة وتأثيرها، ثم أصلح كل ملاحظة مقبولة على حدة.
أسهل نقطة دخول هي report.md. يتيح coverage.json المنظم التحقق من المجالات المفحوصة والمعلّقة، ويُستخدم findings.json للتحقق من موقع كل ملاحظة وخطورتها وأدلتها واتجاه إصلاحها. وقد يحتوي المجلد findings/ على تقارير تفصيلية وملفات إعادة إنتاج. وعند المشاركة، احتفظ بالملفات المرتبطة معًا، لا بالتقرير وحده.
جملة مثل «لا يوجد تفويض» وحدها لا تكفي للحكم. تحقق من نقطة النهاية المستهدفة، وشروط تسجيل الدخول، وما يحدث عند تغيير معرّف معلومات الفوترة، وأين يقع فحص الملكية، وأي فحوصات تعمل في طبقة أخرى.
مثال يصمد: عادت بيانات لمعرّف مستخدم آخر، وتمت إعادة إنتاج ذلك في بيئة اختبار مصرّح بها.
مثال يحتاج إلى متابعة: قد يوجد فحص ملكية قبل خطوة المعالجة، ولم يتم التحقق من مسار الاستدعاء الفعلي والإعدادات.
في واجهة الأوامر المستقلة، استخدم coverage.json للتأكد من النطاقات التي لم تُفحص (المسارات المستثناة والمواقع المؤجلة). حتى مع وجود نطاقات غير مفحوصة، لا يتغير رمز الخروج، لذا لا يعني رمز الخروج 0 أن كل الملفات قد فُحصت. وإذا اختفت ملاحظة في فحص لاحق، فلا يمكن اعتبارها «مُصلحة» ما لم تكن قد فحصت المسار الأصلي. كما أن التحقق التلقائي في Cloud ميزة تحاول إعادة إنتاج المشكلات، ونتيجة «غير متحقق منه» لا تعني «ثبت أنه آمن».
المصدر: OpenAI، خطوات تقييم الفحص القياسي، ونطاق فحص CLI والمقارنة، والتحقق التلقائي في Cloud.
الإصلاح وإعادة التحقق والتعامل مع المعلومات الحساسة
إخبار الفحص بمن يحق له فعل ماذا يجعل التقارير أسهل في الحكم
أدرج في سياق الفحص «من يجب أن يكون قادرًا على فعل ماذا». على سبيل المثال: «معلومات الفوترة متاحة لصاحب الحساب والمسؤولين فقط»، أو «نشر الملفات يقتصر على المالك». وفي الإضافات المحلية، يمكنك استخدام SECURITY.md كسياسة أمان مستمرة، وAGENTS.md لتعليمات مثل خطوات البناء والتحقق. وفي Cloud، راجع نموذج التهديد المُولَّد، وأكمل النقص في نقاط الدخول العامة والعمليات الحرجة وحدود الثقة.
نموذج التهديد وصف قصير لبنية التطبيق والشروط التي يجب أن يحميها. وبما أن التعديلات في Cloud تُطبَّق على الفحوصات المستقبلية، فإن تصحيح الافتراضات لا يغيّر ما فُحص في التقارير القديمة.
أصلح ملاحظة واحدة في كل مرة، وتحقق من إعادة الإنتاج والسلوك الطبيعي معًا
- اقبل الملاحظة: تحقق من الدليل والتأثير الفعلي، واختر مشكلة واحدة للإصلاح.
- أنشئ اقتراح إصلاح صغيرًا: في الواجهة المحلية، اختر «Patch» ثم «Generate patch». إنشاء الاقتراح خطوة منفصلة عن تطبيقه على نسخة الهدف (checkout).
- اقرأ الفرق: تحقق من عدم وجود تنظيف غير مرتبط أو تغييرات تُضعف دفاعًا آخر، ثم طبّقه بـ«Apply patch».
- أعد التحقق: استخدم «Verify fix» للتحقق من خطوات إعادة الإنتاج الأصلية والسلوك الطبيعي. وإن أمكن، احتفظ أيضًا باختبار انحدار يفشل قبل الإصلاح وينجح بعده.
- أغلق الملاحظة: التحقق وحده لا يغلقها تلقائيًا. اقرأ نقص الأدلة المتبقي، ثم أغلقها مع ذكر السبب، أو تابع التحقيق.
عندما يقدّم Cloud اقتراح إصلاح، راجع المحتوى قبل إنشاء PR مسودة. وسجّل بشكل منفصل: هل يوجد اقتراح إصلاح، وهل طُبّق، وهل أُعيد التحقق منه، وهل نُشر في الإنتاج. واستخدم أيضًا فحوص ما قبل النشر للتطبيقات المنشأة بالذكاء الاصطناعي، حتى لا تترك كل القرارات لأداة فحص واحدة.
«المحلي» لا يعني عدم إرسال أي شيء خارجيًا
حتى المسارات التي تعمل على جهازك، تحقق بشكل منفصل من طلبات الاستدلال المرسلة إلى النموذج، والمعلومات المستخدمة في التحقق. وتحذر خطوات واجهة الأوامر المستقلة الرسمية من أن الفحوصات تستخدم صلاحيات نظام التشغيل المحلي، ولا تتوقف عند الموافقة على كل إجراء، وقد ترث متغيرات البيئة. لا تفترض أنها تملك نفس صلاحيات دردشة Codex العادية، وجهّز بيئة فحص لا تحمل بيانات اعتماد غير ضرورية.
السجلات المحفوظة لا تُزال منها القيم السرية تلقائيًا دائمًا، وقد تحتوي على الكود المصدري أو بيانات الاعتماد. كما تتضمن المخرجات خطوات إعادة الإنتاج وتفاصيل الثغرات، لذا تحقق من المحتوى ونطاق المشاركة قبل نشر رابط عام أو مشاركته مع أطراف ثالثة. أما إعدادات استخدام البيانات في تحسين النموذج، فتشرحها مقالة استخدام ChatGPT وCodex للتدريب والخصوصية بشكل منفصل.
المصدر: OpenAI، SECURITY.md وAGENTS.md، ونموذج تهديد Cloud، والإصلاح والتحقق، وصلاحيات واجهة الأوامر المستقلة ومخرجاتها وسجلاتها.
قائمة التحقق قبل البدء
- المسار: حدد أيًّا من الإضافة المحلية أو Cloud أو واجهة الأوامر المستقلة.
- الصلاحيات: تأكد من إذن فحص الكود وصلاحية الفحص في حسابك.
- الأسعار: لا تخلط بين حصة الاستخدام العادية والرصيد المجاني لـCloud وفوترة API.
- الهدف: ثبّت المراجعة والنطاق، وفكّر في البدء بـStandard.
- الحكم: اقرأ نطاق الفحص وأدلة إعادة الإنتاج والشكوك المتبقية، لا العدد فقط.
- الإصلاح: تحقق من كل فرق وإعادة تحقق واحدة في كل مرة قبل القبول.
إذا كانت هذه أول مرة، فابدأ بفحص Standard للنطاق المطلوب لترى هل تستطيع الحكم على النتائج بنفسك. وإذا احتجت مراقبة مستمرة، فكّر في Cloud؛ وإذا أردت إدماج الفحص في عمليات آلية، فكّر في واجهة الأوامر المستقلة. استخدمها كأداة تكمل اكتشاف المشكلات والتحقق منها، لا كإثبات للأمان يحل محل تحليل الكود الساكن (SAST) الحالي أو المراجعة البشرية.
فرضيات هذه المقالة: كُتبت في 7 أكتوبر 2026 استنادًا إلى الوثائق الرسمية من OpenAI. وتم التحقق مرة أخرى من الفترة المجانية ورموز الخروج في CLI مقابل الأسئلة الشائعة الرسمية في 19 أكتوبر. ولم نشغّل فحوصات المنتج، لذلك تحقق بنفسك من دقة الكشف وزمن التشغيل والاستهلاك، بتجربته على جزء من مستودعك.
الأسئلة الشائعة
س. إذا كان لديّ ChatGPT Pro، هل Codex Security Cloud مشمول دون رسوم إضافية؟
لا يُوصف بأنه مشمول ضمن حصة الاستخدام العادية للخطة. تُحتسب فحوصات Cloud المؤهلة بأسعار الرموز، وتوجد بشكل منفصل أرصدة فحص مجانية مؤهلة، وفترات مجانية للمراقبة المستمرة الحالية. لا تعتمد على اسم الخطة وحده، بل تحقق من رصيدك وشروط الاستخدام المدفوع.
س. ألا يكفي أن أطلب من Codex العادي مراجعة الكود؟
يعتمد ذلك على هدفك. يمكن للمراجعة العادية فحص التنفيذ والاختبارات. فكّر في Codex Security عندما تريد نطاق فحص متخصصًا، ونتائج، وأدلة إعادة إنتاج، ومراقبة مستمرة.
س. إذا كان الفحص لا يُظهر أي مشكلة، فهل يمكنني اعتبار الكود آمنًا؟
لا. تحقق أولًا من المراجعة ونطاق الهدف، وما إذا انتهى الفحص مبكرًا، وما المجالات التي استُثنيت. فإذا كان نطاق الفحص غير مكتمل، أو لم تستطع تحديد شروط التفويض في العمل، فقد تفوتك مشكلات. استخدمه مع تحليل الكود الساكن الحالي والمراجعة البشرية.
س. إذا اخترت فحص Deep، فهل يمكنني الفحص بموثوقية بحصة استخدام صغيرة؟
لا يوجد ضمان لذلك. يستكشف Deep على نطاق أوسع، لذا يستخدم وقتًا وموارد أكثر من Standard. عدّل الهدف والتوازي والحدود الزمنية، وإذا توقف الفحص فاقرأ النطاق الذي غطّاه. كما أن حد التكلفة المقدّر في واجهة الأوامر المستقلة ليس سقفًا صارمًا للدفع.