دليل Codex CLI: التثبيت وتسجيل الدخول وأول مهمة
كل ما تحتاجه لجلستك الأولى: التثبيت وتسجيل الدخول، جعل Codex يشرح مستودعًا غير مألوف، تنفيذ تعديل بوضع full-auto، وإعادة بناء لقطة شاشة إلى تطبيق عامل — محدَّث للإصدار 0.157.0 مع GPT-6 Sol وLuna.
Codex CLI في لمحة
- تثبيت واحد: npm install -g @openai/codex ثم تسجيل الدخول بخطة ChatGPT أو مفتاح API.
- أول طلب (prompt) يثمر دائمًا: "explain this codebase to me and how do I run it?"
- --full-auto يعدّل الملفات ويشغّل الأوامر داخل صندوق حماية — في عرض الإطلاق أنتج طلب واحد ثيمًا داكنًا كاملًا.
- أضاف الإصدار 0.157.0 نموذجَي GPT-6 Sol وLuna إلى الكتالوج ودعم Amazon Bedrock وزر f الذي يُنشئ تفريعًا للجلسة في تطبيق آخر.
OpenAI Codex CLI
الفيديو:OpenAI6:19
Codex CLI in 12 mins
الفيديو:lustoykov12:14
openai/codex releases
سجل التغييرات:GitHub changelog
كل لقطات الشاشة في هذه الصفحة مأخوذة من تسجيل الإطلاق الرسمي لـCodex CLI من OpenAI — لقطات طرفية ومتصفح فقط دون أي إطارات كاميرا. جرى التحقق من الأوامر والخيارات وتفاصيل سير العمل عبر الفيديو الثاني، أما حقائق الإصدار فمن سجل التغييرات الرسمي المشار إليه أعلاه.
الفيديوهات المصدر: OpenAI ("OpenAI Codex CLI") وlustoykov ("Codex CLI in 12 mins") على يوتيوب، مرتبطة بروابط عميقة بطوابع زمنية. نص الصفحة أصلي.
الجولة التفصيلية: 14 خطوة
تثبيت Codex CLI وتسجيل الدخول
- 1
ثبّت Codex CLI عالميًا
يُوزَّع Codex CLI عبر npm — شغّل الأمر npm install -g @openai/codex في أي طرفية. المتطلب الوحيد هو Node.js (حمّله من nodejs.org إن لم يكن لديك)، وعلى macOS يمكن أيضًا brew install --cask codex. الأداة مفتوحة المصدر على GitHub برخصة Apache-2.0.
- 2
شغّل Codex وسجّل الدخول
شغّل الأمر codex وسيرشدك التشغيل الأول إلى تسجيل الدخول: اختر Sign in with ChatGPT لاستخدام خطة Plus أو Pro أو Business أو Edu أو Enterprise القائمة (يتوفر أيضًا خيار رمز الجهاز)، أو قدّم مفتاح API الخاص بك للدفع بالاستهلاك. المتصفح يتولى تسجيل الدخول والطرفية تعرض تأكيد النجاح.
المهمة الأولى: اجعل Codex يشرح قاعدة الكود
- 3
شغّل Codex داخل مستودع واسأل السؤال الأهم
cd إلى أي مشروع ثم شغّل codex مرة أخرى — تبدأ هذه المرة جلسة عمل. قبل أن تكتب أي شيء، يعرض الترويسة دليل العمل والنموذج النشط ووضع الموافقات. في عرض الإطلاق من OpenAI كان الهدف مستودع openai-fm والسؤال هو السؤال الشامل: "explain this codebase to me and how do I run it?"
ترويسة الجلسة أولًا، ثم السؤال — ثم Enter.شاهد عند 1:27 - 4
اقرأ قسم High-level overview الذي يعيده Codex
يقرأ Codex الملفات ويجيب بشكل منظم: أي إطار وأي منظومة تنسيق يستخدمها المستودع، أين تُخزَّن الحالة، كيف يُولَّد الصوت وأي المسارات اختياري. أسرع طريقة للاطمئنان داخل قاعدة كود غير مألوفة.
النظرة العامة تسمي المنظومة: Next.js 15 وReact 19 وTailwind 4 وZustand.شاهد عند 1:45 - 5
ادرس Typical file map
يكمل الإجابة خريطة ملفات — layout.tsx للـHTML العام، وpage.tsx صفحة الدخول، وapi/ للمسارات الخادمية — لتستطيع في الطلبات التالية الإشارة إلى مسارات حقيقية بدل أوصاف غامضة.
كل مسار في الخريطة هو سياق يمكنك الاستشهاد به في الطلب التالي.شاهد عند 1:50 - 6
اتبع تعليمات التشغيل التي كتبها Codex لك
تنتهي الإجابة نفسها بدليل تشغيل جاهز للنسخ: Node 20+ ومفتاح API، ثم git clone وnpm install، وسطر OPENAI_API_KEY في .env.local، ثم npm run dev عبر next dev --turbopack وزيارة http://localhost:3000. داخل Codex يمكنك أيضًا تشغيل أوامر الصدفة بنفسك بإضافة البادئة !.
من clone إلى خادم التطوير دون فتح أي وثيقة.شاهد عند 1:55 - 7
شاهد الصفحة الهدف بالوضع الفاتح
أول تعديل في العرض هو تغيير ثيم الموقع الذي شغّلته للتو. يظهر OpenAI.fm بالوضع الفاتح مع بطاقات الأصوات وإعدادات vibe وزر Play البرتقالي — معرفتك الدقيقة بالحالة الراهنة هي ما يجعل الطلب التالي ناجحًا.
قبل التعديل: وضع فاتح، بطاقات أصوات، إعدادات vibe، وزر Play برتقالي.شاهد عند 1:15
أول تعديل: ثيم داكن بوضع full-auto
- 8
أعد التشغيل بوضع full-auto مع طلب دقيق
اخرج ثم شغّل codex --full-auto وصِف التغيير: "Implement dark mode based on system settings — make sure every surface adapts automatically, like buttons and toggles." يتيح full-auto لـCodex تعديل الملفات وتشغيل الأوامر دون سؤال في كل مرة؛ وصفه عرض OpenAI بأنه معطَّل الشبكة ومحاط بصندوق حماية في مجلد التشغيل. الإصدارات الحالية تكشف أدوات التحكم عبر --ask-for-approval (untrusted وon-request وnever) و--sandbox (read-only وworkspace-write وdanger-full-access).
- 9
تحقق من النتيجة: كل سطح يتكيف
بعد تحديث واحدة يصبح الموقع داكنًا بالكامل — الخلفية والبطاقات والنصوص تتبع إعداد النظام، بل غيّر طلب العرض نص زر Play إلى Introduce Codex. وبما أن full-auto يبقى داخل صندوق الحماية، فإن أي تعديل خاطئ يمس نسختك العاملة فقط.
الوضع الداكن بعد طلب واحد — مع تحديث نص الزر أيضًا.شاهد عند 3:05
من لقطة شاشة إلى تطبيق عامل
- 10
ابدأ من الصفر في مجلد فارغ
تحويل لقطة الشاشة إلى تطبيق هو فن Codex المفضل. أنشئ مجلدًا فارغًا ثم شغّل بالنموذج ووضع الموافقات والمرفق في سطر واحد: codex -m o4-mini -a full-auto -i <لقطة الشاشة>. -i ترفق صورة، و-a تحدد الموافقات، و-m تختار النموذج.
أمر واحد يحدد النموذج والموافقات والصورة المرفقة.شاهد عند 3:50 - 11
دع Codex يفحص لقطة الشاشة
تؤكد ترويسة الجلسة ما استلمه Codex — دليل العمل والنموذج وموافقة full-auto ومسار الصورة — ثم يكون الدور الأول كله Thinking وهو يدرس الصورة قبل كتابة سطر كود واحد.
ترويسة الجلسة تعرض لقطة الشاشة المرفقة قبل كتابة أي كود.شاهد عند 3:58 - 12
أجب عن أسئلة التوضيح
بدل التخمين، يرد Codex بقسم Clarifying user intent: هل تريد بناء شيء مشابه بلغة Python/OpenCV؟ أم تنفيذ تأثير بعينه مثل thermal-vision؟ أم تحتاج إرشادات للواجهة والتخطيط؟ بضعة أسطر من الإجابة العادية تحوّل اللقطة الغامضة إلى مواصفات.
بعد ثلاثة أسئلة، تتحول لقطة الشاشة إلى مواصفات.شاهد عند 4:00 - 13
شاهده يكتب التطبيق ذا الملف الواحد
بعد استقرار المواصفات، يبث Codex أمر apply_patch الذي ينشئ index.html من أوله لآخره: شبكة canvas بأبعاد مبنية على devicePixelRatio، وctx.drawImage لكل لوحة، وrequestAnimationFrame للفيديو الحي، ومستمع load — ثم يبلّغ عن Done.
تنتهي الرقعة بـDone — التطبيق كله في ملف HTML واحد.شاهد عند 4:42 - 14
افتح index.html وقارن
يختم Codex بالوصفة: تسع لوحات في شبكة 3×3، وفلاتر من Sepia وB&W إلى Comic Book وThermal وX-Ray، وتثبيت الوضع الأفقي عبر Screen Orientation API — وتعليمة بسيطة: افتح index.html عبر HTTPS أو localhost لكي تعمل الكاميرا.
رسالة الختام هي توثيق README للتطبيق المولَّد.شاهد عند 4:50
قواعد البيت: AGENTS.md وصندوق الحماية والأوامر الجديرة بالحفظ
شغّل /init وسينشئ Codex ملف AGENTS.md في المستودع — ملف يشبه موجه النظام يُقرأ قبل المهام، فتعيش قواعد التسمية والإطار والاختبارات داخل المشروع بدل إعادة كتابتها في كل جلسة.
الموافقات والعزل هما القراران الأساسيان. يبدّل /permissions الوصول الكامل داخل الجلسة؛ ويحدد --ask-for-approval (untrusted وon-request وnever) و--sandbox (read-only وworkspace-write وdanger-full-access) القيم الافتراضية، ويحفظها ~/.codex/config.toml بشكل دائم. تركيبة --yolo تعني never مع danger-full-access — مريحة وبخطورة تطابق وصفها تمامًا.
الأوامر اليومية: /model تبدّل النموذج ومستوى الاستدلال (medium خيار معقول — high يحرق التوكنات)، و/plan تحوّل الطلب إلى خطة قابلة للمراجعة، و/review تراجع التغييرات غير المرسلة أو فرعًا، و/compact تحرر السياق بعد الجلسات الطويلة، و/new تبدأ محادثة نظيفة. خارج الواجهة، ينفذ codex exec "…" مهام لمرة واحدة غير تفاعلية، ويعيد codex resume (أو codex resume-last) فتح جلسة سابقة. أشر إلى الملفات بـ@ وحمّل المهارات بـ$ — وهي مجلدات تحتوي ملف تعليمات وتُثبَّت في ~/.codex/skills.
جديد Codex CLI 0.157.0: نموذجا GPT-6 Sol وLuna وAmazon Bedrock ومفتاح التفريع
صدر الإصدار 0.157.0 في 25 سبتمبر 2026. خمسة تغييرات من سجل التغييرات الرسمي تستحق التحديث:
- 1أُضيف GPT-6 Sol وLuna إلى كتالوج النماذج — ويظهران في /model كأي إدخال آخر.
- 2حلّ دعم Amazon Bedrock، شاملًا كتالوجات Bedrock للنماذج الجديدة وتلميحات ترحيل تساعد على نقل أسماء النماذج الأقدم.
- 3أصبح النص الكامل للشاشة (transcript) مفعّلًا افتراضيًا، مع توسيع تحديد النص عبر Shift-click.
- 4زر f الجديد يُنشئ تفريعًا للمحادثة المفتوحة في تطبيق آخر مع الاحتفاظ بالمسودات والطلبات المنتظرة.
- 5أصبح /import متاحًا في الجلسات البعيدة وجلسات background-server المحلية التي تبدأ تلقائيًا للجلسات التفاعلية المؤهلة.
أي نموذج تختار؟ GPT-6 Sol هو ما يعرضه شريط الحالة افتراضيًا — أبقه للأعمال الوكيلية الثقيلة. Luna موسوم بالنموذج الوكيلي السريع والاقتصادي فهو أنسب للتعديلات الصغيرة والتشغيل المتكرر، وTerra يتوسطهما كخيار يومي متوازن. بدّل عبر /model، واضبط مستوى الاستدلال لكل نموذج، أو ثبّت الافتراضي في config.toml — وفي دليل منتقي نماذج Codex عندنا شرح كامل للتبديل.