دليل استخدام سطر الأوامر CLI
📚 تنقل السلسلة: المقال السابق 07 · تفاصيل تطبيق سطح المكتب رافقك لتستكشف تفاصيل تطبيق سطح المكتب وتعمل على ميزات مراجعة diff، تشغيل المهام المتوازية، والاعتماد البصري. هذا المقال يعود للطرفية لتفصيل تشغيل أمر
codexالبرمجي: هيكلة الأوامر، واجهة TUI التفاعلية، الخيارات السريعة والأوامر المائلة المتاحة. المقال التالي 09 · إضافات IDE (VS Code وغيرها) سيوضح دمج الوكيل داخل المحررات.
يقال دائمًا أن «الواجهة الرسومية هي الأسهل للمبتدئين، وتجنب استخدام سطر الأوامر قدر الإمكان» — ولكن بكل صراحة، تنخفض قيمة هذه المقولة للنصف عند الحديث عن Codex.
استخدمت المسارين لقرابة نصف عام، والخلاصة واضحة بالكامل: تطبيق سطح المكتب للمراجعة البصرية («للمشاهدة»)، و CLI للتنفيذ البرمجي («للعمل»). فإذا رغبت في متابعة التعديلات بصريًا، وتشغيل خمس مهام متوازية معًا، فتطبيق سطح المكتب يمنحك ذلك بامتياز. ولكن عند رغبتك في إدراج Codex في مسار عملك المعتاد — ككتابة سكربت يقوم بمراجعة الأكواد يوميًا، أو تشغيله على خوادم سحابية دون واجهة رسومية، أو إدراج الوكيل في مسارات CI/CD — فهذه الأمور يعجز تطبيق سطح المكتب عن إنجازها، ويظل CLI هو الحل النموذجي.
والميزة الأكثر تميزًا: أن نافذة CLI السوداء ليست مخيفة أو صعبة كما تظن. فتشغيل Codex CLI لا يتركك تحدق في سطر أوامر جاف، بل ينقلك لواجهة تفاعلية كاملة تُعرف بـ TUI (Terminal User Interface، واجهة مستخدم الطرفية) — وتضم صندوق محادثة، صندوق إدخال، وشريط حالة، لتتشابه في كفاءتها مع تطبيق سطح المكتب ولكن باعتماد كامل على لوحة المفاتيح. شعرت بالدهشة عند تشغيله للمرة الأولى: فلم يكن مجرد سطر الأوامر، بل كان تطبيقًا متكاملاً يعمل داخل الطرفية.
لذا لن يبالغ هذا المقال في التعقيد أو التبسيط. بل سيركز على شرح أمر codex البرمجي بالكامل، لينقلك من التردد إلى استخدامه بثقة وسهولة.
بعد قراءة هذا المقال，你会拿到：
- مخطط لهيكل أمر
codex— لتفكيك السطور الطويلة لقطع مفهومة وتحديد مواضع الأوامر والخيارات. - تفاصيل الأقسام الثلاثة لواجهة TUI التفاعلية (صندوق المحادثة، صندوق الإدخال، وشريط الحالة) وكيفية التعامل معها.
- جدول مرجعي لأهم الخيارات السريعة المعتادة (مثل
--modelو--sandboxو--cdو--searchو-i...) تم فحصها وتأكيدها بالكامل وفقًا لمرجع CLI الرسمي. - الأوامر المائلة واختصارات لوحة المفاتيح الهامة للاستخدام اليومي، ومسار عمل مبسط لتطبيقه بنفسك للتأكيد.
- الفروق الدقيقة بين مسار التشغيل التفاعلي (التوجيه المستمر) والتشغيل الصامت
exec(التنفيذ الفوري)، لمساعدتك في اختيار الأنسب للمهمة.
01 أولاً: تفكيك وتحليل أمر codex
يخشى الكثير من المبتدئين سطر الأوامر، ليس لصعوبة الكتابة، بل لخوفهم من تداخل الاختصارات والخيارات الطويلة في السطر البرمجي — مثل: codex exec --sandbox workspace-write --model xxx "مهمة ما".
وفي الواقع، يتبع هيكل السطر ترتيبًا برمجياً واضحًا وبسيطًا. والخلاصة: يتكون أمر codex من أربعة أجزاء رئيسية كحد أقصى — الأمر الرئيسي، الأمر الفرعي، الخيارات السريعة، والتوجيه (prompt). وفهم هذه الأجزاء يسهل قراءة وتفكيك أي أمر برمجي طويل بلمحة.
تشبيه: طلب كوب قهوة مخصص. يمثل codex طلبك الأساسي «أريد كوب قهوة» (الأمر الرئيسي)؛ وتحديد نوعها كـ «قهوة مثلجة» أو «لاتيه» يمثل الأمر الفرعي (مثل exec أو resume أو cloud لتعديل مسار التشغيل)؛ والخيارات الإضافية مثل «ثلج قليل، جرعة إضافية من الإسبريسو، وحليب اللوز» تمثل الخيارات السريعة (التي تبدأ بـ --)؛ والتوجيه الذي ترغب في معالجته — «ساعدني في فحص هذا الكود» — يمثل التوجيه (prompt). ويتكون السطر من هذه الأجزاء الأربعة، ويمكن حذف بعضها مع الحفاظ على الترتيب الثابت.
تفكيك الأجزاء كالتالي:
codex [الأمر الفرعي] [الخيارات السريعة...] ["التوجيه"]
│ │ │ │
الأمر تغيير مسار تعديل المعاملات المهمة المطلوبة
الرئيسي التشغيلونوضح الأجزاء بالتفصيل:
- الأمر الرئيسي
codex: بعد التثبيت بنجاح، يتفعل هذا الأمر في الطرفية. وتشغيله جافًا دون إضافات ينقلك لواجهة TUI التفاعلية. - الأمر الفرعي: لتعديل مسار التشغيل. على سبيل المثال، يوجه الأمر
codex execللتشغيل الصامت (ينفذ المهمة وينتهي فورًا دون فتح واجهة المحادثة)، والأمرcodex resumeلمواصلة الجلسة السابقة، والأمرcodex loginلتسجيل الدخول. وغياب الأمر الفرعي يعني الدخول الافتراضي لواجهة TUI التفاعلية. - الخيارات السريعة (Flags): خيارات تبدأ بـ
--أو-لتعديل المعاملات. مثل--modelلتعديل النموذج المستخدم، و--sandboxلتخصيص صلاحيات البيئة المعزولة، و--cdلتحديد دليل العمل. وتتوفر أغلب الخيارات بصيغة طويلة وصيغة مختصرة (مثل تطابق الخيارين--modelو-m). - التوجيه (Prompt): النص المكتوب بين علامتي اقتباس ويحدد المهمة المطلوبة. ويمكنك حذفه للدخول للواجهة وبدء المحادثة، أو كتابته ليوجه الوكيل للبدء في معالجته فور التشغيل.
إليك بعض الأمثلة للتوضيح:
# تشغيل جاف، ينقلك لواجهة TUI التفاعلية
codex# تشغيل مع إدخال توجيه، ليبدأ الوكيل في معالجته فور فتح الواجهة
codex "اشرح دور الأكواد وهيكل هذا المشروع"# تشغيل مع تعديل النموذج وتحديد دليل العمل المستهدف
codex --model gpt-5.5 --cd ~/my-project "أكمل ملف README"⚠️ ملاحظة: اسم النموذج
gpt-5.5هو مثال للتوضيح فقط. وتتغير قائمة أسماء النماذج المتاحة وتوصياتها باستمرار مع التحديثات، ويمكنك كتابة الأمر المائل/modelداخل الواجهة لمراجعة النماذج النشطة في جهازك، وتجنب حفظ أسماء قديمة طالها التعديل.
💡 الخلاصة في جملة واحدة: يتكون أمر
codexمن أربعة أجزاء رئيسية — الأمر الرئيسي + الأمر الفرعي + الخيارات السريعة + التوجيه؛ وفهم هذا الهيكل يبسط قراءة وكتابة الأوامر الطويلة.
02 ثانياً: واجهة TUI التفاعلية وأقسامها الثلاثة
تشغيل أمر codex بمفرده ينقلك لواجهة الطرفية الرسومية TUI. ويشعر المبتدئون بالحيرة للوهلة الأولى لمعرفة موضع كتابة التعليمات ومتابعة تقدم عمل الوكيل.
لا تقلق، فالأمر يتشابه مع تطبيق سطح المكتب تمامًا، ويكفي استيعاب الأقسام الثلاثة الرئيسية: صندوق المحادثة، صندوق الإدخال، وشريط الحالة. والأسطر المتسارعة الأخرى تمثل مخرجات تشغيل الوكيل وتكفي مراجعتها السريعة.
تشبيه: مشاهدة البث المباشر. المساحة الواسعة في المنتصف تمثل شاشة العرض الرئيسية للبث (وهي صندوق المحادثة لـ Codex لعرض الخطط والأكواد والفروق diff)؛ والشريط السفلي يمثل صندوق كتابة التعليقات والتفاعل (وهو صندوق الإدخال لتوجيه التعليمات للوكيل)؛ وفي الزاوية تظهر إحصاءات البث الحالية مثل عدد المشاهدين (وهو شريط الحالة الذي يوضح اسم النموذج، وحجم استهلاك الرموز، والمسار الحالي). ومتابعة البث لا تتطلب قراءة كل تفصيل، ويكفي التركيز على هذه العناصر الثلاثة لتواكب العمل.
ونوضح الأقسام بالتفصيل:
- صندوق المحادثة (المساحة الكبرى في المنتصف): بيئة العمل الرئيسية لـ Codex. وتعرض خطط العمل المقترحة، كتل الأكواد المضافة، ومقارنة الفروق Git diff، مع توفير ميزة تمييز الأكواد بالألوان (syntax highlighting) التي صممتها OpenAI لراحة العين وتسهيل الفحص البصري.
- صندوق الإدخال (الشريط السفلي): المدخل الوحيد لتوجيه التعليمات لـ Codex. وتكتب فيه النصوص، الأكواد، وترفق فيه مسارات الملفات والأوامر المائلة.
- شريط الحالة (الأسطر الصغيرة أسفل صندوق الإدخال): يوضح إحصاءات الجلسة الحالية — مثل اسم النموذج المستخدم، وحجم استهلاك الرموز المتبقية، والمسار الحالي النشط، وفرع Git الحالي. ويوفر التطبيق خيار
/statuslineلتخصيص وترتيب البيانات المعروضة في شريط الحالة حسب تفضيلاتك.
وننبه هنا لمشكلة شائعة يواجهها المبتدئون: حدوث تداخل أو تشوه بصري لواجهة الطرفية، أو ظهور مساحات فارغة مفاجئة. لا تقلق وتظن أن البرنامج قد تعطل. يحدث هذا غالبًا عند تشغيل Codex داخل بيئات مثل tmux والتنقل بين النوافذ مما يسبب تشوهًا للأحرف — ويكفي الضغط على الاختصار Ctrl + L ليقوم التطبيق بإعادة رسم وتحديث الواجهة فورًا دون فقد بيانات الجلسة.
واجهت هذا التشوه سابقًا عند الاتصال بخادم بعيد عبر SSH، حيث تسبب انقطاع لحظي للشبكة في تشوه الأحرف بالكامل، وكدت أضغط على Ctrl + C لإغلاق الجلسة وإعادة تشغيلها، فتذكرت الاختصار وضغطت Ctrl + L لتستقر الواجهة فورًا. وإعادة تشغيل الجلسة كانت ستؤدي لخسارة سياق المحادثة الطويل وإضاعة الوقت.
ويجب التمييز بين الاختصار Ctrl + L والأمر المائل /clear لتفادي الأخطاء: الاختصار Ctrl + L يقوم بمسح الشاشة وإعادة رسم الواجهة مع الاحتفاظ بسياق المحادثة كاملاً؛ بينما يقوم الأمر المائل /clear بمسح الشاشة وحذف كامل السياق لبدء محادثة جديدة كليًا. الأول يماثل «تنظيف السبورة»، والثاني يماثل «استبدال السبورة بأخرى جديدة»، فتجنب الخلط بينهما.
💡 الخلاصة في جملة واحدة: تتكون واجهة TUI من ثلاثة أقسام — صندوق المحادثة للفحص، صندوق الإدخال للتوجيه، وشريط الحالة للإحصاءات؛ وعند تشوه الواجهة اضغط
Ctrl + Lلتحديثها دون فقد البيانات، وتجنب خلطه بالأمر المائل/clearلحذف السياق.
03 خيارات التشغيل الهامة: ثمانية خيارات للاستخدام اليومي
تمثل خيارات التشغيل (Flags) أساس قوة CLI، وتضم مستندات المرجع الرسمية عشرات الخيارات التي لا داعي لحفظها بالكامل. واكتفينا هنا بفرز ثمانية خيارات أساسية للاستخدام اليومي، لتلجأ للبقية عند الحاجة المتقدمة.
تشبيه: أزرار التحكم في الكاميرا الاحترافية. تضم الكاميرا العديد من الأزرار والخيارات، ولكنك تكتفي في 90% من الوقت بتعديل ثلاثة عناصر رئيسية — فتحة العدسة، سرعة الغالق، وحساسية الضوء (ISO). وتماثل خيارات التشغيل هذه الأزرار الأساسية: أتقن تشغيل الخيارات عالية الاستخدام أولاً، واعتبر البقية ميزات متقدمة تراجع مستنداتها عند الحاجة.
ونلخص الخيارات المعتمدة في هذا الجدول:
| الخيار (الصيغة الطويلة / المختصرة) | الوظيفة والإجراء | مثال برمجية |
|---|---|---|
--model / -m | لتحديد إصدار النموذج المستخدم للجلسة الحالية | codex -m gpt-5.5 "أعد هيكلة الدالة" |
--sandbox / -s | لتخصيص صلاحيات البيئة المعزولة (read-only / workspace-write / danger-full-access) | codex -s read-only "راجع الأكواد فقط ولا تعدل الملفات" |
--ask-for-approval / -a | لتحديد سياسة طلب الموافقة (untrusted / on-request / never) | codex -a on-request "أصلح هذه المشكلة البرمجية" |
--cd / -C | لتحديد دليل العمل مباشرة دون الحاجة لأمر cd | codex --cd ~/proj "اشرح دور الأكواد" |
--add-dir | لترخيص مجلدات إضافية كقابلة للكتابة (يمكن تكراره) | codex --cd app --add-dir ../shared |
--image / -i | لإرفاق صورة (لقطة شاشة أو تصميم) مع التوجيه | codex -i error.png "ما سبب هذا الخطأ" |
--search | لتفعيل البحث المباشر في الويب أثناء الجلسة | codex --search "استخدم أحدث واجهات التطبيق" |
--oss | للتشغيل بالاعتماد على نموذج محلي (يتطلب تشغيل Ollama محليًا) | codex --oss "اكتب سكربت أتمتة دون الاتصال بالإنترنت" |
ونوضح بعض التفاصيل الهامة للخيارات:
- يعد الخيار
--cdالأكثر فائدة لتسريع التشغيل. فسابقًا كنت أضطر لتشغيل أمرcdللدخول للمجلد أولاً ثم تشغيلcodex؛ أما الآن فيمكنني تشغيلcodex --cd ~/project "..."للبدء مباشرة، وسيعرض شريط الحالة العلوي المسار النشط لتفادي الأخطاء. - يمثل الثنائي
--sandboxو--ask-for-approvalصمام الأمان للتحكم في «صلاحيات التعديل وسياسات طلب الموافقة». ولقد شرحنا تفاصيلهما في المقال 02 (البيئة المعزولة للحدود، والموافقة للمقاطعة)، ويكفي معرفة إمكانية تحديدهما مؤقتًا عند بدء التشغيل في CLI. والتوليفة الآمنة المعتادة هي استخدام--sandbox workspace-writeمع--ask-for-approval on-requestلحصر العمليات في مساحة العمل وطلب الإذن عند تجاوز الحدود. وسنتوسع في تفصيل الصلاحيات والإعدادات الدائمة في المقال 15. - يعتمد خيار البحث في الويب افتراضيًا على ذاكرة التخزين المؤقت (cache): حيث يفحص Codex الفهارس المدارة والمحدثة بواسطة OpenAI لتفادي الهجمات والبرمجيات الخبيثة؛ وتحديد الخيار
--searchيوجهه للبحث المباشر الفوري في الويب لجلب أحدث البيانات. وتذكر دائمًا معاملة محتويات الويب كمصادر غير موثوقة لحماية مشروعك.
وننبه للخيار الأكثر خطورة وتجنب تفعيله عشوائيًا:
⚠️ الخيار
--dangerously-bypass-approvals-and-sandbox(أو--yoloباختصار) يتجاوز كامل حدود البيئة المعزولة وسياسات الموافقة، ويسمح للوكيل بتشغيل كافة العمليات والتعديلات دون إذن أو قيد. وتنص الوثائق على قصر استخدامه في «بيئات التطوير المعزولة بالكامل خارج نظامك الرئيسي». وتجنب استخدامه كمبتدئ لحماية ملفات جهازك من التلف.
💡 الخلاصة في جملة واحدة: أتقن تشغيل الخيارات الثمانية الأساسية —
-mللنموذج،-sو-aللصلاحيات،--cdو--add-dirللمسارات،-iلإرفاق الصور، و--searchللبحث؛ وتجنب تفعيل الخيارات الخطرة مثل--yoloلحماية نظامك.
04 الأوامر المائلة: أزرار التحكم داخل الجلسة
تُكتب خيارات التشغيل قبل بدء العمل في سطر الأوامر؛ وعند الدخول للواجهة والرغبة في تعديل الإعدادات أثناء الجلسة، نعتمد على الأوامر المائلة (slash commands) — وتظهر قائمتها بكتابة / داخل صندوق الإدخال.
تشبيه: أزرار التحكم في جهاز التحكم عن بعد (الريموت). عند مشاهدة التلفاز ورغبتك في رفع الصوت أو تبديل القنوات، لن تضطر لإيقاف تشغيل التلفاز وإعادة تشغيله — بل تضغط على الزر المقابل في جهاز التحكم مباشرة. وتماثل الأوامر المائلة أزرار جهاز التحكم لـ Codex: تتيح لك تعديل الإعدادات والخيارات فورًا داخل الجلسة دون الحاجة للإغلاق وإعادة التشغيل. فتبديل النموذج، تعديل الصلاحيات، مسح السياق، ومراجعة الفروق diff تنفذ بضغطة زر.
تضم الواجهة العديد من الأوامر المائلة، وننصح بحفظ الأوامر الأساسية التالية للمبتدئين:
| الأمر المائل | الوظيفة والإجراء | متى يُستخدم |
|---|---|---|
/model | تبديل النموذج المستخدم ومستويات التفكير أثناء الجلسة | عند الرغبة في استخدام نموذج أسرع أو أعمق تفكيرًا |
/permissions | تعديل صلاحيات الموافقة (Auto / Read Only / Full Access) | لتشديد أو فتح صلاحيات التعديل والتشغيل |
/status | عرض تفاصيل الجلسة الحالية (النموذج، الصلاحيات، المسار، واستهلاك السياق) | لمراجعة الإعدادات الحالية للجلسة وتأكيدها |
/diff | مراجعة الفروق البرمجية Git diff للملفات المعدلة والجديدة | لفحص ومراجعة الأكواد قبل تسجيل الحفظ |
/compact | ضغط أسطر المحادثة الطويلة لتقرير ملخص لتوفير حجم السياق | عند امتلاء سياق المحادثة للجلسات الطويلة |
/review | استدعاء وكيل مراجعة مستقل لفحص التعديلات برمجياً | للاستفادة من «مراجعة برمجية ثانية» للتعديلات |
/init | توليد ملف القواعد المبدئي AGENTS.md في دليل المشروع | لتحديد قواعد التطوير للوكيل وتثبيتها |
/clear | مسح الشاشة وحذف السياق لبدء محادثة جديدة كليًا | عند الرغبة في تغيير موضوع المحادثة بالكامل والبدء من الصفر |
ويوفر Codex ميزة مريحة ومفيدة تنص عليها الوثائق: أثناء تشغيل الوكيل للمهمة الحالية، يمكنك كتابة التوجيه القادم أو الأمر المائل المقابل والضغط على زر Tab لجدولته في قائمة الانتظار، وسيقوم الوكيل بمعالجته تلقائيًا فور انتهاء المهمة الحالية دون حاجتك للانتظار. وعادتي الشخصية هي كتابة أمر المراجعة /review وجدولته بـ Tab أثناء تشغيل الوكيل للاختبارات، لتبدأ مراجعة الأكواد فور صدور نتائج الاختبار لتوفير الوقت.
ملاحظة: يضم نظام الأوامر المائلة خيارات واسعة وميزات متقدمة تشمل تخصيص الأوامر البرمجية، وتوفر القائمة الكاملة والخطوات التفصيلية في المقال 12. ويكفي استيعاب دور
/كأداة تحكم وحفظ الأوامر الأساسية الموضحة أعلاه للبدء بثقة.
💡 الخلاصة في جملة واحدة: تعمل الأوامر المائلة كأداة تحكم للجلسة، وأهمها الاستخدام اليومي لـ
/modelو/permissionsو/statusو/diffلمتابعة وتعديل الإعدادات؛ ويمكن جدولة الأوامر اللاحقة بـTabأثناء العمل.
05 اختصارات لوحة المفاتيح الهامة للاستخدام اليومي
إلى جانب الأوامر المائلة، تتوفر مجموعة من الاختصارات السريعة للوحة المفاتيح لتسريع استخدام واجهة TUI، ونلخص أهمها في هذا الجدول:
| الاختصار | الوظيفة والإجراء |
|---|---|
Ctrl + C | لإيقاف التشغيل الحالي للوكيل؛ ويمكن الخروج من الجلسة بكتابة /exit |
Ctrl + L | تحديث وإعادة رسم الواجهة لتفادي التشوه البصري (مع الاحتفاظ بالبيانات) |
↑ / ↓ (الأسهم) | للتنقل واستدعاء التوجيهات المكتوبة سابقًا في صندوق الإدخال |
Ctrl + R | للبحث السريع في تاريخ التوجيهات؛ واضغط Enter للاختيار أو Esc للإلغاء |
Ctrl + O | نسخ المخرجات البرمجية الأخيرة لـ Codex (تطابق أمر /copy) |
Tab | لجدولة التوجيهات أو الأوامر المائلة اللاحقة أثناء عمل الوكيل الحالي |
الضغط مرتين على Esc | للعودة وتعديل الرسالة الأخيرة الموجهة للوكيل وإعادة توجيهها |
Ctrl + G | لفتح محرر خارجي لكتابة التوجيهات الطويلة وتصديرها لصندوق الإدخال |
ونوضح ميزتين هاماتين بالتفصيل:
- بادئة
!— لتشغيل الأوامر مباشرة في بيئة الطرفية: بكتابة رمز!في أول صندوق الإدخال متبوعًا بالأمر (مثل!lsأو!git status)، يتم تشغيل الأمر مباشرة في طرفية جهازك. وتنص الوثائق على أن Codex يقرأ مخرجات هذا التشغيل ويدرجها في سياق المحادثة مع خضوعها لسياسات الصلاحيات المعتمدة. وتكمن فائدتها في إتاحة مراجعة حالة مستودعك بـ!git statusبسرعة وتوفير الرموز (tokens) بدلاً من استدعاء الوكيل للتحقق وتوفير الوقت.
!git status- الاختصار
Ctrl + Gلكتابة التوجيهات الطويلة: عند الرغبة في كتابة توجيهات مفصلة ومعقدة، اضغط علىCtrl + Gليقوم التطبيق بفتح المحرر الخارجي المعرف في متغير البيئةVISUAL(أوEDITOR)، لتكتب التوجيهات بمرونة وتنسيق كاملين، ثم تحفظ الملف ليتم استيرادها تلقائيًا داخل صندوق الإدخال. - ونشير أيضًا للبادئة
@: كتابة رمز@في صندوق الإدخال تفتح قائمة للبحث السريع والذكي عن ملفات مساحة العمل، وتدرج مسار الملف المختار بـTabأو Enter في الرسالة، لتفادي الخطأ وتوفير وقت كتابة المسارات الطويلة.
تنبيه حول الفروق بين الأنظمة: قد تختلف سلوكيات الاختصارات المذكورة بناءً على نوع الطرفية أو نظام التشغيل المستخدم، وتتيح كتابة /keymap مراجعة وتخصيص الاختصارات حسب رغبتك. وننصح بالالتزام بالاختصارات الافتراضية في البداية وتفادي تعقيد التهيئة.
💡 الخلاصة في جملة واحدة: استخدم البادئة
!لتشغيل الأوامر، و@لإدراج مسارات الملفات، وCtrl + Gلفتح المحرر لكتابة النصوص الطويلة، وTabلجدولة العمليات؛ واستخدم أمر/keymapلتعديل الاختصارات لاحقًا عند الحاجة.
06 تمرين عملي: تشغيل واختبار مسار CLI في 5 دقائق
سنطبق الآن مسار عمل مبسط لتأكيد فهم الميزات في الطرفية دون الحاجة لمشاريع معقدة. افتح الطرفية واتبع الخطوات التالية:
وإذا لم تقم بتثبيت Codex CLI بعد، فيرجى مراجعة وتطبق خطوات التثبيت في المقال 03 أولاً. وتأكد من سلامة التثبيت بتشغيل أمر
codex --version.
الخطوة الأولى: إنشاء مجلد تجريبي والدخول إليه وتفعيل البرنامج
على نظام Mac / Linux (ولنظام Windows PowerShell استبدل mkdir -p بـ mkdir):
mkdir -p ~/codex-cli-demo && cd ~/codex-cli-demo
codexالمتوقع: الدخول لواجهة TUI التفاعلية، وتظهر مساحة صندوق المحادثة في المنتصف، وصندوق الإدخال في الأسفل مع شريط الحالة.
الخطوة الثانية: مراجعة الإعدادات بـ /status
اكتب في صندوق الإدخال:
/statusالمتوقع: يعرض Codex ملخصًا لإعدادات الجلسة الحالية — يوضح اسم النموذج، سياسة الصلاحيات، المجلدات المرخصة للتعديل، وحجم استهلاك السياق الحالي.
وتوفر الأدوات المجتمعية (مثل أداة token-tracker الموضحة أعلاه) مخرجات ممتازة لمتابعة تفاصيل استهلاك الرموز، والحدود الزمنية، وحجم السياق المتبقي للجلسة الحالية.
الخطوة الثالثة: تشغيل أمر محلي بالبادئة !
اكتب في صندوق الإدخال:
!echo hello-codex-cliاضغط Enter. المتوقع: تقوم الطرفية بطباعة العبارة hello-codex-cli مباشرة، ويتم تسجيل محتوى الأمر ومخرجاته في سياق المحادثة للجلسة، دون قيام Codex بشرحه أو معالجته.
الخطوة الرابعة: استدعاء التوجيه السابق بالسهم العلوي ↑
أفرغ صندوق الإدخال واضغط على السهم العلوي ↑.
المتوقع: استدعاء واسترجاع السطر السابق !echo ... لصندوق الإدخال مباشرة لتسهيل إعادة الاستخدام دون الحصول على كتابته مجددًا. قم بمسحه للمتابعة.
الخطوة الخامسة: توجيهه للتعديل ومراجعة الفروق بـ /diff
وجه له أمر تعديل بسيط أولاً:
أنشئ ملفًا باسم hi.txt، واكتب بداخله عبارة "hello from codex cli"قد يتوقف لطلب الموافقة للتعديل (حسب إعدادات الصلاحيات)، وافق عليه لإتمام المهمة. ثم اكتب:
/diffالمتوقع: يعرض Codex مقارنة الفروق من منظور Git، ويوضح الملف الجديد hi.txt غير المسجل في فروع Git بعد. ويمثل هذا الإجراء القياسي لفحص التعديلات.
الخطوة السادسة: إغلاق الجلسة
/exitالمتوقع: الخروج من الواجهة التفاعلية بنجاح والعودة للطرفية المعتادة لجهازك. (كما يمكنك الخروج بالضغط على الاختصار Ctrl + C).
⚠️ ملاحظة: إذا تم إنشاء الملف في الخطوة الخامسة مباشرة دون طلب الإذن، فذلك يرجع لتساهل سياسات الموافقة النشطة في جهازك (حيث يسمح الوضع الافتراضي بالكتابة في مساحة العمل دون مقاطعة) — وهذا سلوك طبيعي للنظام لتسهيل التطوير. ولمشاهدة مقاطعة طلب الإذن، عدل الصلاحيات بـ
/permissionsللوضعRead Onlyوأعد تجربة إنشاء الملف لتلاحظ توقفه للموافقة.
💡 الخلاصة في جملة واحدة: تطبيق خطوات التمرين العملي الست يرسخ التعامل مع الواجهة التفاعلية، وإحصاءات
/status، وتشغيل الأوامر بـ!، واستدعاء التاريخ، ومراجعة الفروق بـ/diffفي ذهنك بتميز.
07 التشغيل التفاعلي مقابل التشغيل الصامت exec
نصل الآن للميزة الحصرية لـ CLI والتي تعجز عنها واجهة تطبيق سطح المكتب — التشغيل الصامت وغير التفاعلي بـ codex exec。
تركز الشرح في الأقسام السابقة على التشغيل «التفاعلي»: حيث تشغل codex وتدخل الواجهة وتبدأ في مراجعة وتعديل المهام مع الوكيل بالتفصيل. ولكن تتوفر مهام لا تتطلب متابعتك اللحظية — مثل «مراجعة التعديلات اليومية للمستودع تلقائيًا» أو «تشغيل الفحوصات في بيئة CI وإصلاح الأعطال ذاتيًا». وهذه المهام الصامتة يناسبها وضع التشغيل الصامت exec (أو الاختصار codex e).
تشبيه: تناول الطعام في المطعم مقابل طلب التوصيل (الدليفري). يشبه التشغيل التفاعلي تناول الطعام في المطعم — حيث تجلس وتتابع إعداد الوجبات وتقدم ملاحظاتك للطاهي فورًا للتصحيح. بينما يشبه التشغيل الصامت exec طلب توصيل الطعام للمنزل — حيث ترسل طلبك (التوجيه البرمجي)، ويقوم المطبخ بإعداد الوجبة وتوصيلها لك (تظهر المخرجات في سطر الطرفية stdout) دون حاجتك للتواجد أثناء الإعداد. فاختر التشغيل التفاعلي للمتابعة والتصحيح اللحظي، والتشغيل الصامت exec للمهام المؤتمتة والتشغيل البعيد。
الصيغة الأساسية للتشغيل الصامت:
codex exec "راجع التعديلات البرمجية الحالية، واعرض قائمة بالمشاكل المحتملة"سيقوم الوكيل بقراءة المجلد، تصميم خطة العمل، طباعة النتائج في الطرفية مباشرة، ثم الخروج فورًا — دون الدخول لواجهة TUI أو انتظار موافقتك.
خيارات مفيدة للتشغيل الصامت exec (حسب الوثائق الرسمية):
خيار exec | الوظيفة والإجراء |
|---|---|
--model / -m | لتحديد النموذج المستخدم للجلسة الحالية |
--json | لإخراج النتائج بصيغة JSON الموحدة (لتسهيل قراءتها ومعالجتها بالسكربتات) |
--output-last-message / -o | لحفظ الرسالة والمخرجات الأخيرة للوكيل في ملف محدد |
--skip-git-repo-check | للسماح بالتشغيل داخل مجلدات لا تخضع لإدارة Git |
--ephemeral | لتفادي حفظ سجلات هذه الجلسة في القرص محليًا |
ونوضح الفروق بين التشغيل التفاعلي والصامت في هذا الجدول:
| مقارنة الجوانب | التشغيل التفاعلي (codex) | التشغيل الصامت (codex exec) |
|---|---|---|
| سلوك النهاية | الدخول لواجهة TUI والانتظار لتوجيهاتك | طباعة المخرجات في الطرفية والخروج فورًا |
| المهام المناسبة | الاستكشاف، كتابة الأكواد، ومتابعة التفاصيل | الأتمتة، مسارات CI، التشغيل المجدول، والمهام الطويلة |
| تطلب التواجد | نعم، لمراجعة واعتماد كتل الأكواد | لا، يرسل التوجيه وينفذ صامتًا |
| طبيعة المخرجات | تفاعلية رسومية داخل واجهة TUI | نصية في الطرفية (stdout)، وتدعم صيغة JSON |
| أبرز سيناريو | «أضف ميزة تسجيل الدخول، وسأتابع معك التعديل» | «قم بتوليد سجل التغييرات changelog تلقائيًا» |
تفضيلاتي الشخصية: ألتزم بالتشغيل التفاعلي للمهام اليومية لمتابعة وتعديل التفاصيل البرمجية؛ وأعتمد على التشغيل الصامت في سكربتات مستقلة مثل codex exec --sandbox workspace-write للمهام الطويلة التي لا تتطلب متابعتي مثل تشغيل الفحوصات وإصلاح الأعطال. وتنصح الوثائق بتوليفة ممتازة للتشغيل في بيئات CI: دمج الخيارين --json و --output-last-message — ليمنحك الأول سجلات مفصلة للعمليات قابلة للقراءة من البرمجيات، ويمنحك الثاني تقريرًا ملخصًا باللغة الطبيعية للنتائج.
注意：
exec是为「无人值守」设计的，所以审批时机通常配never（没人在场点头）。这也意味着它默认更放得开，务必配合合适的沙箱策略，别在没隔离的环境里对着重要项目无脑exec。exec的脚本化、CI 集成是后面工程化章节的正题，本篇你先知道「有这么个非交互跑法、它和盯着干是两条路」就够了。
💡 الخلاصة في جملة واحدة: التشغيل التفاعلي يماثل تناول الطعام في المطعم (متابعة وتصحيح التفاصيل بالتفصيل)، والتشغيل الصامت
execيماثل التوصيل الفوري (إرسال التوجيه واستلام النتائج مباشرة)؛ واستخدم الأول للمراجعة والتحقق، والثاني للأتمتة والأعمال المجدولة ومسارات CI — وهو سر تميز CLI وتفوقه.
08 ملخص
ركز هذا المقال على شرح هيكلة وخيارات تشغيل أمر codex في الطرفية، ونلخص أهم النقاط في هذا الجدول:
| الهدف والإجراء | كيفية التنفيذ |
|---|---|
| الدخول لواجهة TUI التفاعلية | تشغيل أمر codex بمفرده (وكتابة التوجيه لبدء المعالجة فورًا) |
| تحديد النموذج / الصلاحيات عند البدء | استخدام الخيارات --model / --sandbox / --ask-for-approval |
| تحديد دليل العمل مباشرة | إضافة الخيار --cd <المسار> |
| إرفاق صورة مع التوجيه | إضافة المعامل -i <الصورة> |
| تعديل الإعدادات ومراجعة diff أثناء الجلسة | استخدام الأوامر المائلة /model و /status و /diff |
| تشغيل أمر محلي في الطرفية | كتابة الرمز ! في أول صندوق الإدخال |
| تحديث الواجهة عند التشوه البصري | الضغط على الاختصار Ctrl + L (دون فقد بيانات الجلسة) |
| كتابة توجيهات طويلة | استخدام الاختصار Ctrl + G لفتح المحرر الخارجي |
| التشغيل الصامت والخروج الفوري (الأتمتة) | تشغيل أمر codex exec "التوجيه" |
يجب أن تكون قادرًا الآن على: تفكيك أي أمر برمجي لـ codex لأجزائه الأربعة بسهولة، فهم نوافذ وأقسام واجهة TUI التفاعلية، استخدام الخيارات الثمانية الأساسية للتشغيل، تعديل الخيارات أثناء الجلسة بالأوامر المائلة واختصارات لوحة المفاتيح الهامة، والتمييز بين التشغيل التفاعلي والتشغيل الصامت exec واختيار الأنسب للمهمة.
ونذكرك بالقاعدة الذهبية: سطر الأوامر CLI ليس نسخة مبسطة لتطبيق سطح المكتب، بل هو الواجهة الأكثر شمولاً وقدرة والأسهل للدمج في برمجيات الأتمتة — وبمجرد تجاوز عقبة التخوف من سطر الأوامر، ستكتشف اتساع قدراته وإمكانياته الفائقة مقارنة بالواجهات الرسومية المحدودة.
المقال التالي 09 · إضافات IDE (VS Code وغيرها) — مع إتقان استخدام سطر الأوامر، يظل محرر الأكواد المفضل لديك هو بيئة العمل الأساسية للتطوير. سيوضح المقال القادم دمج Codex كإضافة داخل VS Code و Cursor وغيرها من البيئات — لتتسنى لك المحادثة مباشرة من شريط الأدوات الجانبي، ومراجعة الفروق diff في محررك المفضل، وكيفية استخدام ميزات سطر الأوامر بالكامل دون مغادرة بيئة التطوير.