استئناف جلسة Codex: أمر codex resume والمحدد والحلول
كيف تعيد فتح محادثة سابقة في Codex CLI باستخدام codex resume — منتقي الجلسات التفاعلي، والبحث أثناء الكتابة، وأمر codex resume --last — مع أماكن تخزين الجلسات وما تفعله عندما تظهر القائمة فارغة.
الخلاصة
- أنهِ الجلسة بـ Ctrl+C أو /quit، ثم شغّل codex resume من مجلد المشروع نفسه — سيعرض منتقي «Resume a previous session» كل المحادثات السابقة في ذلك المجلد.
- تنقّل بالأسهم واضغط Enter لإعادة فتح الجلسة؛ يُستعاد نص المحادثة كاملاً، بما في ذلك إجماليات التوكنات والسياق الأصلية.
- اكتب لتبحث: يصفّي المنتقي الجلسات حسب أول مطالبة، فكلمة «summ» تعزل المحادثة التي بدأت بـ «can you give me a brief summary».
- يتخطى codex resume --last المنتقي ويعيد فتح أحدث محادثة في المجلد الحالي؛ و--all يوسّع البحث إلى مجلدات أخرى (المرجع الرسمي للواجهة).
OpenAI Codex Tutorial #5 - CLI Commands & Resuming Sessions
القناة: Net Ninja6:28
CLI reference — official documentation
الوثائق الرسمية: developers.openai.com/codex
جميع الشاشات في هذه الصفحة مأخوذة من تسجيل Net Ninja — لقطة نظيفة لطرفية VS Code دون وجه في الكادر ودون ترجمة مدمجة في الصورة. تدفق المنتقي وسلوك البحث والجلسة المستعادة تم التحقق منها إطارًا بإطار؛ أما سلوك --last و--all وتنبيه اختلاف المجلد فمصدره المرجع الرسمي.
لقطات الشاشة ملك لأصحابها وترتبط بالطابع الزمني المقابل؛ ولا تُستخدم إطارات الوجه.
استئناف جلسة Codex CLI خطوة بخطوة
الجزء 1 — داخل الجلسة: أوامر الشرطة المائلة المدمجة
- 1
ابدأ جلسة واقرأ لافتة الترحيب
شغّل codex في مجلد مشروعك. يرحّب بك Codex (الإصدار v0.36.0 في التسجيل) بالنموذج النشط — gpt-5-codex، ويمكن تغييره بـ /model — وبمجلد العمل وبأربعة أوامر مقترحة: /init و/status و/approvals و/model.
تذكر لافتة الترحيب النموذج والمجلد قبل أن تكتب أي شيء.المشاهدة من 0:46 - 2
اكتب شرطة مائلة لعرض كل الأوامر
كل أوامر Codex تبدأ بشرطة مائلة مثل Claude Code. كتابة / تفتح القائمة الكاملة: /new يبدأ محادثة جديدة في منتصف الحوار، و /compact يلخّص السجل حمايةً لحد السياق، و /diff يعرض التغييرات، و /mention يرفق ملفًا، و /status يعرض إعداد الجلسة واستخدام التوكنات.
في قائمة الشرطة يسكن /new — النقيض لاستئناف جلسة قديمة.المشاهدة من 2:00 - 3
تحقق من معرف الجلسة الحالي بـ /status
يطبع /status مساحة العمل والحساب (بتسجيل الدخول عبر ChatGPT) والنموذج وإصدار الواجهة وكتلة Token Usage التي تتضمن معرف الجلسة الحالي — مفيد عند الحاجة إلى الإشارة إلى جلسة بعينها في مكان آخر.
يعرض Token Usage معرف الجلسة إلى جانب عدّادات الإدخال والإخراج.المشاهدة من 3:20 - 4
اختر النموذج ودرجة الاستدلال بـ /model
يفتح أمر /model منتقي «Select model and reasoning level»: خيارات gpt-5-codex وهي low وmedium (الحالي) وhigh، إضافة إلى gpt-5 من minimal إلى high. اضغط Enter للتأكيد أو Esc للرجوع.
ينطبق اختيار النموذج على هذه الجلسة وعلى جلسات Codex CLI القادمة.المشاهدة من 3:42 - 5
اضبط وضع الموافقات بـ /approvals
يغيّر /approvals ما يُسمح لـ Codex بفعله في هذا المشروع: Read Only (قراءة الملفات والإجابة عن الأسئلة مع طلب موافقة لكل ما عداها)، و Auto (الحالي — القراءة والتحرير وتشغيل الأوامر داخل مساحة العمل)، و Full Access (كل شيء مع وصول إلى الشبكة).
تحدد أوضاع الموافقات ما قد يفعله Codex دون سؤال.المشاهدة من 4:05
الجزء 2 — الخروج ثم تشغيل codex resume
- 6
أنهِ الجلسة بـ Ctrl+C أو /quit
يخرج Ctrl+C من جلسة جارية وينهي /quit إنها بشكل صريح — وفي الحالين تعود إلى الطرفية العادية، هنا مجلد المشروع في Git Bash على ويندوز. تنتهي الجلسات باستمرار؛ ولهذا تمامًا وُجد codex resume.
عودةً إلى موجه bash، وما زلت داخل مجلد عمل YumPair.المشاهدة من 5:10 - 7
اكتب codex resume واضغط Enter
من مجلد المشروع، شغّل codex resume — دون مطالبة مهمة، هاتان الكلمتان فقط. يفتح Codex منتقي جلسات هذا المجلد بدل بدء محادثة جديدة.
الأمر كاملًا، مكتوبًا في الموجه قبل ضغط Enter مباشرة.المشاهدة من 5:20 - 8
اختر جلسة من المنتقي
يسرد «Resume a previous session» كل محادثة سابقة بعمرها وأول مطالبة فيها — «1 hour ago · can you give me a brief summary of this project?» — مع تلميحات المفاتيح أسفلها: Enter للاستئناف، Esc لبدء جديدة، Ctrl+C للخروج، والسهمان للتنقل بين الصفحات.
تُحصر الجلسات في مجلد المشروع الذي شغّلت منه الأمر.المشاهدة من 5:22
الجزء 3 — البحث في المنتقي والعودة إلى المحادثة
- 9
اكتب لتبحث في القائمة
ابدأ الكتابة فحسب: «Search: su» يصفّي القائمة أصلًا إلى جلسة الملخص. يتم البحث في أوصاف الجلسات — مطالباتها الأولى — فتذكّر كلمة واحدة أسرع من التمرير.
بحرفين مكتوبين، لم يبق في القائمة سوى جلسة واحدة.المشاهدة من 5:40 - 10
دقّق باستعلام أطول
يعزل «Search: summ» محادثة «can you give me a brief summary of this project?» منذ ساعة. اضغط Enter ويعيد Codex فتح تلك المحادثة بعينها.
المنتقي بعد التصفية — Enter يستأنف الجلسة المظللة.المشاهدة من 5:48 - 11
واصل من حيث توقفت تمامًا
تستعيد الجلسة المستأنفة نص المحادثة كله: قائمة Next Steps، والعمل السابق على توكنات سِمة Flutter، وحتى /exit ووداع «Take care!» — مع بقاء الإجماليات الأصلية (120 ألف توكن مستخدم، و91% من السياق متبقٍ). أكمل البرمجة.
استعادة كاملة للسجل، جاهزًا للمطالبة التالية.المشاهدة من 5:52
لا يعرض codex resume شيئًا — حلول القائمة الفارغة والمجلد الخطأ
يُحصر المنتقي في المجلد الذي تشغّله منه، فمعظم حالات «لا توجد جلسات» سببها اختلاف مجلد العمل لا ضياع البيانات. تتبع القائمة:
- 1قائمة فارغة في المجلد الخطأ. لا يعرض المنتقي إلا الجلسات التي بدأت في مجلد العمل الحالي. عُد بـ cd إلى مجلد المشروع الأصلي ثم شغّل codex resume من جديد.
- 2جلسات من مشاريع أخرى. للبحث عبر المشاريع، يُضمّن codex resume --all الجلسات خارج المجلد الحالي (وينطبق الأمر نفسه على --last).
- 3سؤال المجلد عند الاستئناف. إذا اختلف مجلد العمل الحالي عن المجلد المحفوظ في الجلسة، سيسألك Codex أيّهما تستخدم. أجب عن التنبيه مرة، أو اضبط tui.resume_cwd على «current» أو «session» في config.toml لتسويته نهائيًا — وتتقدم قيمة --cd الصريحة على الخيارين.
- 4تخطَّ المنتقي كليًا. يعيد codex resume --last فتح أحدث محادثة من مجلد العمل الحالي دون أي قائمة — أقرب شيء إلى «متابعة الجلسة الأخيرة».
- 5جلسات ناقصة بلا واجهة. الجلسات التي ينشئها codex exec غير تفاعلية ولا تظهر في المنتقي افتراضيًا؛ أضف --include-non-interactive لتظهر في القائمة وفي --last.
- 6لا خيار حذف في المنتقي. يشير التسجيل إلى أنه لم تكن هناك طريقة مدمجة لحذف الجلسات القديمة وقتها — وما زال المنتقي بلا خيار حذف. تُحفظ الجلسات على القرص كملفات rollout بصيغة JSONL تحت ~/.codex/sessions مرتبة في مجلدات بالتاريخ، فالتنظيف يعني حذف الملفات من هناك بنفسك بعد إغلاق Codex.
تتطور واجهة Codex CLI سريعًا، وقد تتغير معاني الأعلام (flags) بين الإصدارات. عند الشك، فإن codex resume --help والمرجع الرسمي هما المرجع.