OpenAI Codex: ما هو، وكيفية تثبيته، وشروط الوصول الإقليمي في 2026

تعني كلمة «Codex» في نتائج البحث ثلاثة أشياء مختلفة، وعادةً لا يفهم من يبحث عنها للمرة الأولى ما الذي عثر عليه. كان هناك نموذج Codex، لكن أُوقف في 2023؛ واليوم أصبح الاسم لبرنامج وكيل، وهناك نحو اثني عشر منتجًا آخر بالاسم نفسه.

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

تجد مواد إضافية حول إعداد الأدوات في وثائق Ailoot.

ما هو OpenAI Codex؟#

قارنه بالمحادثة العادية. في المحادثة، تنسخ جزءًا من الشفرة وتلصقه وتحصل على إجابة ثم تنسخها مرة أخرى. يعمل الوكيل بطريقة مختلفة: تصف مهمة بلغة طبيعية، فيفتح الملفات ذات الصلة داخل مجلد مشروعك، ويجري التغييرات، وينفذ الفحوصات، ثم يعرض لك النتيجة.

تصفه OpenAI في سطر واحد في مستودعها:

يعني «محليًا» أن البرنامج يُنزّل إلى جهازك، حيث يمكنه رؤية ملفاتك وتشغيل الأوامر في مجلدك. أما طلب النموذج وحده فيُرسل إلى السحابة.

الشفرة مفتوحة المصدر على GitHub بموجب ترخيص Apache-2.0. وحتى 1 أغسطس 2026، بلغ عدد النجوم في المستودع 103,000، وصدر أحدث إصدار، 0.146.0، في 29 يوليو. تصدر التحديثات شبه يوميًا، لذا من المرجح أن يكون إصدارك قد اختلف بالفعل.

كيف يختلف Codex في 2026 عن Codex القديم الذي أُوقف؟#

كثيرًا ما يخلط الناس بينهما لأن المنتجين رسميان ومن OpenAI. والتواريخ هي ما يميّز أحدهما من الآخر.

كان الأول مجموعة من النماذج: code-davinci-001 وcode-davinci-002 وcode-cushman-001 وcode-cushman-002. كانت تؤدي مهمة واحدة، هي إكمال الشفرة لك، وشغّلت الإصدار الأول من GitHub Copilot. في قائمة OpenAI للنماذج المتوقفة، تظهر النماذج الأربعة كلها في سطر واحد: أُعلن عنها في 20 مارس 2023، وأُوقفت في 23 مارس، وكان gpt-4o البديل الموصى به.

أما الثاني فهو برنامج تثبته على جهاز الكمبيوتر. ظهر حزم @openai/codex في سجل npm في 16 أبريل 2025. ويُستبدل النموذج الموجود بداخله بآخر أحدث مع مرور الوقت، بينما يظل البرنامج نفسه.

أي إرشادات حول Codex تسبق أبريل 2025 تصف منتجًا متوقفًا. إذا عثرت على مادة تصف Codex بأنه نموذج وتقترح استدعاءه عبر code-davinci-002، فأغلقها.

أين يعمل Codex: في الطرفية أم المحرر أم المتصفح أم التطبيق؟#

لست مضطرًا إلى الاختيار بينها. طريقة تسجيل الدخول واحدة، وكذلك الحساب. والاختلاف الوحيد هو المكان الأنسب لك للعمل.

يعمل الامتداد بطريقة مختلفة مع Xcode وJetBrains مقارنةً بالمحررات الأخرى:

تختلف السحابة عن الأماكن الأربعة الأخرى. تُرسل المهمة إلى حاوية OpenAI، حيث تُستخرج نسخة من المستودع من GitHub. يعمل الوكيل من دون استخدام جهازك، ثم تراجع النتيجة لاحقًا وتقرر ما إذا كنت ستجلب التغييرات إلى نسختك. يتطلب الإعداد ثلاث خطوات: ربط GitHub، وإنشاء بيئة بالتبعيات المطلوبة، وإسناد مهمة.

إذا سجلت الدخول باستخدام مفتاح API، فستعمل الطرفية والمحرر والتطبيق. لا تتوفر السحابة باستخدام المفتاح، ولا الميزات المرتبطة بها مثل مراجعة الشفرة التلقائية وإطلاق المهام من Slack. تحتاج إلى تسجيل الدخول بحساب ChatGPT لاستخدامها.

ما النموذج الذي يعمل داخل Codex؟#

تلخص OpenAI ذلك في سطر واحد:

هناك عنصر تحكم ثانٍ بجوار النموذج: مستوى الاستدلال. وله أربعة إعدادات: Low (تُسمى Light في التطبيق والمحرر) وMedium وHigh وExtra High. توصي OpenAI باستخدام أدنى مستوى يحقق النتيجة المطلوبة ورفعه حين تتطلب المهمة تخطيطًا.

وفوق ذلك وضعان إضافيان. يمنح Max النموذج وقتًا أطول للمهمة. أما Ultra فيقسّم العمل إلى أجزاء ويسندها إلى وكلاء فرعيين بالتوازي. وتذكر الوثائق صراحةً أن معظم المهام لا تحتاج إلى أي منهما.

وهناك أيضًا خيار منفصل هو gpt-5.3-codex-spark، وهو إصدار بحثي للتكرارات السريعة، متاح في خطة Pro فقط.

إن اختيار النموذج ومستوى الاستدلال هو بحد ذاته هندسة السياق: فأنت تقرر مقدار تفكير الوكيل وما يستحضره للمهمة. ولهذا المزيج ثلاثة أركان: نسخة الذكاء الاصطناعي (منهجيتك داخل الوكيل)، والدماغ الثاني (بنية المعرفة المتعلقة بالمشروع)، وهندسة السياق. من دون هذا المزيج يبدأ وكيل الذكاء الاصطناعي باختلاق الأمور.

كم تبلغ تكلفة Codex، وما الذي تتضمنه الخطط؟#

تحققت من الأسعار في صفحة الأسعار الرسمية في 1 أغسطس 2026.

تبلغ تكلفة Business مقدار $25 لكل مقعد مع الفوترة الشهرية بدلًا من $20.

والآن، إلى الحدود. لا تقدم OpenAI رقمًا ثابتًا واحدًا:

بدلًا من رقم واحد، تنشر OpenAI نطاقًا: عدد الرسائل المتاحة خلال خمس ساعات عند العمل على جهازك. والأرقام نفسها لخُطتي Plus وBusiness:

في خطة Pro البالغة 100 دولار، تُضرب جميع الأرقام في خمسة؛ وفي خطة Pro البالغة 200 دولار، تُضرب في عشرين. وتذكر OpenAI أيضًا حدودًا أسبوعية إلى جانب نافذة الساعات الخمس، لكنها لا تنشر أرقامًا محددة لها.

للنطاق الذي يبلغ عشرة أضعاف في النموذج الواحد تفسير بسيط. قد تستخدم الرسالة الواحدة 1% أو 10% من حصتك اليومية؛ فالمهم هو مقدار العمل المنجز، بينما لا يؤثر عدد الطلبات كثيرًا. شرحت بالتفصيل كيفية استهلاك الرموز عمليًا باستخدام Claude مثالًا في حدود Claude Pro وMax—والآلية مطابقة تمامًا.

عندما تنفد حصتك، أمامك ثلاثة خيارات: شراء أرصدة إضافية من دون تغيير خطتك، أو الانتقال إلى نموذج أخف، أو بدء جلسة باستخدام مفتاح API والدفع مقابل الرموز المستخدمة.

ما القيود الإقليمية المفروضة على Codex؟#

تنشر OpenAI علنًا قائمتها الرسمية بالبلدان والأقاليم المدعومة. بيلاروسيا غير مدرجة. أما كازاخستان وأرمينيا وجورجيا وتركيا وصربيا وأوكرانيا فهي مدرجة.

وجاءت الصياغة في الصفحة نفسها كما يلي:

تثبيت البرنامج وتشغيله شيء، والوصول إلى النموذج شيء آخر. يبدأ التحقق من البلد عند تسجيل الدخول: سواء سجلت عبر ChatGPT أو باستخدام مفتاح API، فأنت تتعامل مع حساب OpenAI.

توضح تقارير GitHub شكل الرفض المرتبط بالبلد. في يناير 2026، كتب مطور من فنزويلا أنه يستخدم Codex 0.88.0 في PowerShell ويحصل على النتيجة نفسها في كل محاولة:

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

يشير الرمز unsupported_country_region_territory وحالة 403 إلى رفض مرتبط بالبلد. إذا رأيت ذلك، فهذا يعني أنك لم ترتكب خطأ أثناء التثبيت، وأن Node لا علاقة له بالأمر.

هناك عائق ثانٍ لا تذكره الوثائق إطلاقًا، لكنه يظهر كثيرًا في الواقع: التحقق من رقم الهاتف. يحتوي التقرير «التحقق من رقم الهاتف لا يعمل» على 206 تعليقات؛ وهناك تقرير ثانٍ عن رقم قديم لم يعد متاحًا ولا يمكن استبداله، وهو مفتوح منذ يونيو 2026 ويحتوي على 71 تعليقًا. وتتكرر القصة نفسها: يعمل ChatGPT في المتصفح على الحساب نفسه، لكن Codex يطلب التحقق من الهاتف ولا توجد طريقة لتجاوزه. ولا تنشر OpenAI قائمة بالبلدان التي تقبل أرقام هواتفها، لذا لا توجد وسيلة للتحقق مسبقًا من قبول رقمك.

لن أتناول طرق الالتفاف على ذلك؛ فهذا المقال يشرح كيفية عمل الأداة.

تنشر Anthropic أيضًا قائمة بالبلدان المدعومة، ويعمل الأمر بالطريقة نفسها. إن المواد التي تصف أداة بأنها «مسموح بها» والأخرى بأنها «محظورة» تضلل القراء، فهما رسميًا في الوضع نفسه. تتغير القائمتان، لذا تحقّق من أحدث إصدار.

كيفية تثبيت Codex: خطوة بخطوة#

نبدأ هنا بالجزء التقني لمن لديهم حساب OpenAI نشط بالفعل.

1. تثبيت البرنامج

   اختر الطريقة المناسبة لنظامك. استخدم الطريقة نفسها لاحقًا لتحديث البرنامج إلى أحدث إصدار.

2. فتح مجلد المشروع

   يعمل الوكيل في المجلد الذي شغّلته منه. انتقل إليه قبل تنفيذ الأمر الأول.

3. تسجيل الدخول إلى حسابك

   عند تشغيل codex للمرة الأولى، سيعرض عليك تسجيل الدخول. سيفتح المتصفح، وبعد تسجيل الدخول ستعود إلى الطرفية.

4. إسناد أول مهمة إليه

   صِف ما تحتاج إليه بلغة طبيعية. ابدأ بمهمة بسيطة، مثل أن تطلب منه وصف المشروع.

أمر التثبيت على macOS وLinux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

على Windows، استخدم المثبّت نفسه عبر PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

إذا كان Node مثبتًا لديك بالفعل، فيمكنك التثبيت عبر npm:

npm install -g @openai/codex

يعمل Homebrew على macOS. احرص على استخدام --cask؛ فبدونه ستثبّت البرنامج الخطأ:

brew install --cask codex

في Linux وWSL2، تعتمد البيئة المعزولة على bubblewrap، وعليك تثبيته مسبقًا:

sudo apt install bubblewrap

على Fedora والأنظمة المشابهة، استخدم sudo dnf install bubblewrap. كذلك، كان WSL الإصدار 1 مدعومًا حتى الإصدار 0.114؛ وبدءًا من 0.115، انتقلت البيئة المعزولة إلى bubblewrap ولم يعد WSL1 يعمل. أما على Windows، فيعمل كل شيء من دون WSL باستخدام البيئة المعزولة المضمنة فيه.

ما الذي ينبغي فعله عند التشغيل الأول؟#

للبدء، انتقل إلى مجلد المشروع واكتب codex؛ ستُفتح جلسة. ثم صِف المهمة بلغة طبيعية، من دون أي صياغة خاصة.

خمسة أوامر للدقائق الأولى:

1. /status - يعرض النموذج وسياسة الموافقة والمجلدات التي يعتبرها الوكيل مساحة عمله.
2. /permissions - يعرض وضع الوصول الحالي وكيفية التبديل بين الأوضاع.
3. /model - يغيّر النموذج ومستوى الاستدلال.
4. /init - ينشئ ملف AGENTS.md يصف المشروع؛ سنتناول ذلك في القسم التالي.
5. /review - يراجع تغييراتك بصورة منفصلة من دون تعديل الملفات.

إلى جانب الأمر البسيط codex، هناك ثلاثة أوامر مفيدة في الطرفية:

codex resume                    # العودة إلى المحادثة السابقة في هذا المجلد
codex exec "fix the tests"      # تشغيل لمرة واحدة من دون حوار، للاستخدام في البرامج النصية
codex --image screenshot.png    # إرفاق صورة بالمهمة

تكرر OpenAI النصيحة نفسها في وثائق الطرفية وامتداد المحرر: أنشئ إيداعًا قبل المهمة وبعدها. فالوكيل يعدّل الملفات من تلقاء نفسه، وستحتاج إلى إمكانية التراجع عنها بأمر واحد منذ اليوم الأول.

كيف تشرح مشروعك لـ Codex باستخدام AGENTS.md؟#

ترتيب القراءة صارم، وتذكره الوثائق في السطر الأول تمامًا من القسم:

أولًا، يقرأ Codex الملف العام ~/.codex/AGENTS.md، حيث تضع عادات العمل التي تنطبق على جميع مشاريعك. ثم يقرأ الملفات داخل المشروع: ملفًا لكل مجلد، من جذر المستودع حتى مجلدك الحالي. وتُجمع من الأعلى إلى الأسفل، بحيث يتقدم الملف الأقرب على الملف الأبعد. وهذا يعني أن قاعدة في services/payments تتقدم على قاعدة عامة في الجذر.

وهذا مثال على ملف بسيط:

# AGENTS.md

## كيفية العمل على هذا المشروع

- شغّل الاختبارات باستخدام `npm test`؛ لا تشغّلها ملفًا واحدًا في كل مرة.
- ثبّت الحزم باستخدام pnpm.
- اسألني قبل إضافة تبعية إنتاج جديدة.
- لا تلمس مجلد `legacy/` إطلاقًا.

الحد الأقصى للملفات مجتمعة هو 32 كيلوبايت. وبعد تجاوز ذلك، يتوقف إدراج الملفات دون تنبيه. كما أن ملف AGENTS.md الأكبر من اللازم يستهلك الحد في كل تشغيل لأن الملف بأكمله يُضاف إلى السياق.

إذا كنت تعرف CLAUDE.md، فستبدو لك الآلية مألوفة: إنها التقنية نفسها باسم مختلف. يشكل ملف قواعد المشروع أساس الدماغ الثاني: إذ يتعلم الوكيل معلومات عن عملك قبل أن تتاح لك فرصة شرح أي شيء. تناولت كيفية استخدام الملفين في مشروع واحد في استخدام AGENTS.md وCLAUDE.md معًا.

ماذا يفعل Codex تلقائيًا، وما الذي يتطلب موافقة؟#

غالبًا ما يختلط هذان الإعدادان، لذلك توضح OpenAI الفرق بينهما في سطر واحد:

يُبقي جعل المراجعة تلقائية حدود مجلد العمل كما هي. فالأتمتة تزيل النقرات فقط ولا تغيّر أذونات الوكيل.

للتطبيق والمحرر ثلاثة أوضاع للوصول. وضع Ask for approval متاح دائمًا، وهو نقطة البداية الموصى بها. أما Approve for me وFull access فيجب تفعيلهما أولًا من الإعدادات.

للطرفية منطقها الخاص: يفحص البرنامج المجلد ويقترح مجموعة أذونات مناسبة.

يكون الوصول إلى الشبكة معطلًا افتراضيًا في الوضع المحلي. ينفذ الوكيل الأوامر التي يقترحها بنفسه، ولن يرغب أحد في السماح له بالوصول إلى الإنترنت افتراضيًا.

حتى داخل مجلد العمل، لا يستطيع الوكيل في أي وضع قراءة سوى مواقع محددة: .git و.agents و.codex. استخدم /status لمعرفة المجلدات التي يعتبرها الوكيل حاليًا مساحة عمله.

هناك أيضًا وضع الوصول الكامل، باستخدام العلم --dangerously-bypass-approvals-and-sandbox. تصفه الوثائق بأنه أعلى خطورة وتضع عليه علامة «غير موصى به». ويشرح اسم العلم كل شيء؛ ليس لدي ما أضيفه.

Codex أم Claude Code: أيهما تختار؟#

الفرق بين الأداتين أصغر مما قد تستنتجه من النقاشات عبر الإنترنت. كلتاهما تقرأ مشروعك وتعدّل الملفات من تلقاء نفسها، وتطلب الإذن قبل تجاوز حدود المجلد.

في البداية، من الأسهل النظر إلى ما تدفع ثمنه بالفعل. إذا كان لديك اشتراك ChatGPT، فإن Codex مشمول به ولا تحتاج إلى دفع رسوم منفصلة. أعددت مقارنة مفصلة مدعومة بالقياسات في مقال مستقل عن Codex مقابل Claude Code، وإذا أردت نقل إعدادات العمل من إحداهما إلى الأخرى، فاطلع على دليل الترحيل.

ما أكثر المشكلات شيوعًا عند التشغيل الأول؟#

تستند هذه القائمة إلى تقارير في مستودع المشروع. لا مجال للتخمين هنا؛ فكل بند ورد على لسان شخص واجه المشكلة.

1. ثُبّتت الحزمة الخاطئة. يثبّت الأمر npm install -g codex من دون بادئة مولّد مواقع ثابتة يعود إلى 2011. الحزمة الصحيحة هي @openai/codex.
2. لم يُثبّت bubblewrap. من دونه على Linux وWSL2، لا تبدأ البيئة المعزولة. ينتقل Codex إلى البديل المضمن فيه ويعرض تنبيهًا عند بدء التشغيل. ثبّته بأمر واحد.
3. رُفض الوصول بسبب البلد. يظهر الرمز unsupported_country_region_territory وحالة 403 عند تسجيل الدخول. ولا علاقة للتثبيت بذلك.
4. مطلوب التحقق من الهاتف. لا يحدث هذا للجميع ولا توضحه الوثائق. لا توجد طريقة رسمية لاستبدال رقم يتعذر الوصول إليه؛ والتقرير المتعلق به مفتوح منذ يونيو 2026.
5. تنفد حدود الاستخدام أسرع من المتوقع. التقرير «الرموز تنفد بسرعة كبيرة» هو الأكثر مناقشة في المستودع كله، مع 627 تعليقًا. وقد يساعد الانتقال إلى نموذج أخف وخفض مستوى الاستدلال.

لا تؤثر لغة الواجهة في عمل الوكيل؛ فلغة المهمة ليست ملزمة بمطابقة لغة الواجهة.

ما الخطوة التالية؟#

تُخصّص الساعة الأولى مع الوكيل دائمًا للشيء نفسه: معرفة حدود ما يستطيع فعله من تلقاء نفسه. لا يمكنك معرفة ذلك إلا باستخدام مشروعك؛ فمثال في الوثائق لن يخبرك.

إليك الترتيب الذي أوصي به للبدء:

1. ثبّت البرنامج وسجّل الدخول إلى حساب OpenAI نشط.
2. افتح مجلد مشروع حقيقيًا وشغّل codex.
3. افحص /status و/permissions، واختر القراءة فقط صراحة لمهمة الفحص وحده، وتحقق من الوضع النشط قبل السؤال عن تنظيم المشروع.
4. أنشئ إيداعًا وأسند إليه أول مهمة تعديل.
5. اكتب ملف AGENTS.md من ثلاثة أسطر وقارن استجابات الوكيل قبل ذلك وبعده.

نسخة الذكاء الاصطناعي + الدماغ الثاني + هندسة السياق — تجد مواد إضافية حول العمل مع الأدوات في وثائق Ailoot.