إنّ Codex CLI من OpenAI هو وكيل برمجة مجاني ومفتوح المصدر يعمل داخل الطرفية لديك، وهذا الدليل يأخذك من تثبيته إلى استخدامه بأمان في عمل حقيقي في 2026. تسجّل الدخول عبر خطة ChatGPT أو مفتاح API، وتوجّهه نحو مستودع، فيقرأ شفرتك ويحرّرها ويشغّلها داخل صندوق رملي تتحكّم فيه أنت. مكتوب بلغة Rust ويُحدَّث أسبوعيًا تقريبًا (صدر الإصدار 0.144.6 في 18 يوليو 2026)، وتُعدّ Codex CLI ردّ OpenAI المباشر على Claude Code من Anthropic، والخطوات أدناه تنقلك من الصفر إلى وكيل يعمل في نحو عشر دقائق.
ما هي Codex CLI؟
Codex CLI وكيل برمجة يعمل عبر الطرفية: تكتب طلبًا بلغة بسيطة، فيخطّط ويحرّر الملفات ويشغّل الأوامر ويكرّر حتى تكتمل المهمة، كل ذلك دون مغادرة الـ shell. وهي مفتوحة المصدر على GitHub ومكتوبة في معظمها بلغة Rust، لذا تُثبَّت كملف تنفيذي واحد سريع بدلًا من عملية Node ثقيلة. لا يوجد اشتراك منفصل: فهي مضمّنة في خطط ChatGPT المدفوعة (Plus وPro وBusiness وEdu وEnterprise) أو تُحتسب لكل رمز عبر مفتاح API من OpenAI. وهي تناسب المطوّرين الذين يعيشون أصلًا في الطرفية ويريدون وكيلًا يحترم git والعزل الرملي وCI بدلًا من نافذة محادثة. والمقايضة مقابل أداة ذات واجهة رسومية هي أنّك تدير الأذونات بنفسك، وهو بالضبط ما يتناوله بقية هذا الدليل. وإلى جانب الـ CLI، تقدّم OpenAI أيضًا Codex Web وتطبيق سطح مكتب وإضافات لبيئات التطوير VS Code وCursor وWindsurf، لكنّ الـ CLI هي الأكثر قابلية للبرمجة النصية من بين الأربعة.
كيفية تثبيت Codex CLI
اختر طريقة تثبيت واحدة. حزمة npm هي الأكثر شيوعًا:
npm install -g @openai/codex
على نظام macOS يمكنك استخدام Homebrew بدلًا من ذلك (brew install --cask codex)، أو تشغيل سكربت التثبيت الرسمي على Mac وLinux:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
ثم ادخل إلى مشروع عبر cd وشغّل codex. عند أول تشغيل يطلب منك المصادقة: اختر Sign in with ChatGPT لاستخدام حصة خطتك الحالية، أو عيّن متغيّر البيئة OPENAI_API_KEY للدفع لكل رمز عبر API. وتسجيل الدخول عبر ChatGPT هو المسار الأرخص لمعظم الناس لأنه يعيد استخدام خطة تملكها بالفعل بدلًا من احتساب كل رمز؛ وتشرح كلٌّ من صفحة حزمة npm والوثائق الرسمية هذا الاختيار. وبمجرد المصادقة، يضعك Codex في جلسة تفاعلية بنموذج افتراضي هو GPT-5.6، وهو عائلة OpenAI الحالية المضبوطة للبرمجة.
وضعا الموافقة والصندوق الرملي: الجزء الأهم
إنّ أهمّ ما ينبغي ضبطه على الإطلاق هو مقدار الحرية الممنوحة للوكيل. يفصل Codex هذا إلى إعدادين مستقلّين: صندوق رملي يحدّ من الوصول إلى الملفات والشبكة، وسياسة موافقة تقرّر متى يتوقّف ليسألك. اضبطهما جيدًا يكن الوكيل نافعًا وآمنًا معًا؛ واضبطهما خطأً فإمّا أن يزعجك في كل خطوة أو يعدّل جهازك بأكمله دون استئذان. تضبطهما تفاعليًا بأمر /permissions أو تحفظهما بشكل دائم في التهيئة.
| الإعداد | القيمة | ما يفعله |
|---|---|---|
sandbox_mode | read-only | يمكن للوكيل قراءة الملفات دون تغيير أي شيء |
sandbox_mode | workspace-write | قراءة/كتابة داخل المشروع و/tmp (الإعداد الافتراضي المعقول) |
sandbox_mode | danger-full-access | لا قيود على الملفات أو الشبكة — استخدمه فقط في جهاز افتراضي قابل للإتلاف |
approval_policy | untrusted | يشغّل عمليات القراءة الآمنة تلقائيًا، ويسأل عن كل ما عداها |
approval_policy | on-request | يعمل داخل الصندوق الرملي، ولا يسأل إلا عند تجاوز الحدود |
approval_policy | never | لا يسأل أبدًا (اقرنه بصندوق رملي صارم لـ CI) |
للبرمجة اليومية، يمثّل workspace-write مع on-request التوازن الذي يريده معظم المطوّرين: يستطيع Codex تحرير مشروعك واختباره بحرّية، لكن عليه أن يسأل قبل أن يمسّ أي شيء خارجه. وقد استبدل سجلّ تغييرات OpenAI في أبريل 2026 الرايةَ الشاملة القديمة --full-auto بهذه الملفات التعريفية الصريحة للأذونات، وأضاف وكيلًا فرعيًا خفيفًا بمثابة «حارس» يراجع الإجراءات المعلّقة بدلًا من الموافقة عليها آليًا، وهو ردّ مباشر على خطر تشغيل الوكيل أوامر مدمّرة دون إشراف.
تهيئة Codex عبر config.toml وAGENTS.md
كل ما تضبطه في الجلسة يمكن جعله دائمًا في ~/.codex/config.toml (أو $CODEX_HOME/config.toml)، مع تجاوزات خاصة بكل مشروع في .codex/config.toml عند جذر المستودع. تبدو التهيئة الدنيا هكذا:
model = "gpt-5.6"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
model_reasoning_effort = "medium"
[profiles.careful]
approval_policy = "untrusted"
تتيح لك الملفات التعريفية تبديل مجموعات أذونات كاملة بالاسم (codex --profile careful) بدلًا من تذكّر الرايات. أمّا النصف الثاني من التهيئة فسلوكي: شغّل /init في مستودع لتوليد ملف AGENTS.md، وهو تعليمات Markdown صِرفة يقرؤها Codex قبل كل مهمة (أوامر الاختبار، وقواعد الأسلوب، و«لا تمسّ مجلد الهجرات أبدًا»). وAGENTS.md هو المعيار المفتوح نفسه الذي بات Cursor ووكلاء آخرون يقرؤونه، فيخدم ملف واحد عدّة أدوات. وإن لم تكن قد كتبت واحدًا، فدليلنا حول كتابة ملف AGENTS.md يتناول ما يُحدث فرقًا فعليًا. ويتّصل Codex أيضًا بأدوات خارجية عبر Model Context Protocol من خلال codex mcp، وفي 2026 يستخدم البحث عن الأدوات افتراضيًا بحيث لم تعد خوادم MCP الكبيرة تُغرق نافذة السياق.
Codex CLI مقابل Claude Code: أيّهما تختار؟
تهيمن هاتان الأداتان على اهتمام مستخدمي وكلاء الطرفية، وهما أكثر تشابهًا مما قد يبدو. كلتاهما تعمل في الـ shell، وكلتاهما تقرأ ملف تعليمات Markdown، وكلتاهما تعزل إجراءاتها في صندوق رملي، وكلتاهما تتّصل بخوادم MCP. والفروق الحقيقية هي النموذج والمنظومة.
| Codex CLI | Claude Code | |
|---|---|---|
| النموذج الافتراضي | GPT-5.6 (Sol/Terra/Luna) | Claude Opus / Sonnet |
| اللغة | Rust (ملف تنفيذي واحد) | Node.js |
| ملف التعليمات | AGENTS.md | CLAUDE.md (يقرأ أيضًا AGENTS.md) |
| مضمّنة مع | خطط ChatGPT المدفوعة | خطط Claude المدفوعة |
| الوضع غير التفاعلي | codex exec | الوضع headless |
إذا كان فريقك يدفع أصلًا مقابل ChatGPT ويفضّل مخرجات البرمجة من GPT-5.6، فإنّ Codex هو الخيار الطبيعي؛ وإن كنت على منظومة Anthropic، فالخيار هو Claude Code. ويُبقي معظم المستخدمين المكثّفين كلتيهما مثبّتتين ويوزّعون المهام حسب أيّ نموذج يؤدّي مهمة بعينها على نحو أفضل، ولهذا يستحقّ تفصيلنا لأسعار كل خطة من خطط Codex مقابل Copilot وCursor وClaude Code القراءة قبل أن تلتزم بميزانية. وللاطّلاع على صورة أوسع، راجع مقارنتنا بين Cursor وCopilot وWindsurf وClaude Code.
تشغيل Codex في السكربتات وCI عبر codex exec
الـ CLI ليست تفاعلية فحسب. ينفّذ codex exec طلبًا واحدًا دون واجهة الطرفية ويطبع النتيجة، ما يجعله صالحًا للاستخدام في سكربتات الـ shell وخطوط CI:
codex exec "fix the failing unit tests and update the changelog"
وباقترانه مع approval_policy = "never" وصندوق رملي read-only أو workspace-write، هكذا تربط الفِرق Codex بالفحوص الآلية أو روبوتات الفرز أو عمليات إعادة الهيكلة الليلية دون وجود إنسان أمام لوحة المفاتيح. وهذه أيضًا وسيلة إبقاء الوكيل منضبطًا: فوجود صندوق رملي محكم في CI يعني أنّ حتى الإجابة الخاطئة لا يمكنها مغادرة مساحة العمل.
هل تستحق Codex CLI الاستخدام في 2026؟
ليس الجميع مقتنعين. يرى نقاش حظي بتصويتات كثيرة على r/ChatGPTCoding أنّ الضجيج يفوق التجربة اليومية، وهذا تدقيق منصف تجاه التسويق. والقراءة الصادقة: بالنسبة إلى المهام المحدّدة بدقّة (أصلِح هذا الاختبار، أعِد هيكلة هذه الوحدة، اكتب هذا السكربت) فإنّ Codex سريع فعلًا ونموذج الصندوق الرملي مصمَّم جيدًا. وحيث يصبح طموحًا هو وضع Goal، الذي غادر الحالة التجريبية في 21 مايو 2026 ويتيح لك أن تُسلّمه هدفًا بعيد المدى ليعمل عليه ساعات دون إشراف إلى حدّ كبير. وهذه القدرة مبهرة وفي الوقت نفسه الأكثر احتمالًا لخيبة الأمل، لأنّ الوكلاء غير الخاضعين للإشراف ينحرفون. والإعداد العملي هو التعامل مع Codex بوصفه شريك برمجة سريعًا مع صندوق رملي صارم، ومراجعة فروقه (diffs) كأيّ pull request، وحصر الاستقلالية الكاملة في البيئات القابلة للإتلاف. وباستخدامه على هذا النحو، يستحقّ مكانه ضمن مجموعة الأدوات.
الأسئلة الشائعة
هل Codex CLI مجانية؟
برمجيات الـ CLI مجانية ومفتوحة المصدر، لكنّ تشغيلها يكلّف إمّا خطة ChatGPT مدفوعة (Plus أو Pro أو Business أو Edu أو Enterprise) تسحب من حصّتها، وإمّا رموز API بنظام الدفع حسب الاستخدام إن صادقت باستخدام OPENAI_API_KEY. لا يوجد اشتراك منفصل لـ Codex.
ما النموذج الذي تستخدمه Codex CLI؟
تستخدم افتراضيًا عائلة البرمجة GPT-5.6 من OpenAI، ويمكنك تبديل النماذج وجهد الاستدلال في منتصف الجلسة عبر أمر /model. وتمتدّ العائلة من GPT-5.6 Sol لأقصى قدرة، إلى Terra لموازنة التكلفة، إلى Luna للتشغيلات كبيرة الحجم والأرخص.
كيف أمنع Codex من تشغيل أوامر خطيرة؟
عيّن sandbox_mode بقيمة read-only أو workspace-write، وapproval_policy بقيمة untrusted أو on-request، سواء عبر أمر /permissions أو في ~/.codex/config.toml. وحده danger-full-access يزيل الضمانات، وينبغي حصره في الأجهزة الافتراضية القابلة للإتلاف.
هل يمكن تشغيل Codex CLI دون واجهة طرفية؟
نعم. ينفّذ codex exec "your prompt" مهمة واحدة بشكل غير تفاعلي ويطبع النتيجة، وهو مصمَّم لخطوط CI والأتمتة عبر السكربتات. اقرنه بصندوق رملي صارم وapproval_policy = "never" للتشغيلات دون إشراف.
ما الفرق بين Codex CLI وCodex Web؟
تعمل الـ CLI محليًا في طرفيتك على نسختك المسحوبة وهي قابلة للبرمجة النصية بالكامل؛ بينما يشغّل Codex Web المهام في سحابة OpenAI من متصفّح. وهما يتشاركان الوكيل الأساسي نفسه، لذا تصمّم فِرق كثيرة النماذج الأولية في الـ CLI وتُحيل المهام الطويلة إلى النسخة الويب.
المصادر
- OpenAI — وثائق Codex CLI: التثبيت والمصادقة وأوامر الشرطة المائلة والنموذج الافتراضي.
- GitHub — openai/codex: المستودع المفتوح المصدر، وقاعدة شفرة Rust، وطرق التثبيت، والإصدار 0.144.6 (18 يوليو 2026).
- npm — @openai/codex: تثبيت الحزمة وخيارات المصادقة.
- OpenAI — Introducing upgrades to Codex: التوفّر العام لوضع Goal (21 مايو 2026) وترقيات ميزات 2026.
- OpenAI — سجل تغييرات Codex: الملفات التعريفية للأذونات التي تحلّ محلّ --full-auto، والوكيل الفرعي الحارس، والبحث عن أدوات MCP.
- r/ChatGPTCoding — الحجّة ضد الضجيج حول Codex CLI: وجهة نظر مجتمعية متشكّكة لتحقيق التوازن.
وقاص احمد وسیر
وقاص احمد وسیر مطوّر ومهندس أتمتة بخبرة تزيد على 8 سنوات في بناء أنظمة إنتاجية يستخدمها أكثر من 100 ألف شخص. يبني تطبيقات SaaS متعددة المستأجرين، وأتمتة بالذكاء الاصطناعي (n8n، تدفقات LLM، بوتات واتساب)، وبنية استضافة (WHM/cPanel، CloudLinux) — وهو صانع WaSphere وFlowMaticX وعلامة الاستضافة WaseerHost. أنجز أكثر من 100 مشروع لشركات صغيرة ومتوسطة ووكالات وشركات ناشئة ممولة.
