أداة Codex لا تعمل: إصلاح PATH وتسجيل الدخول وبدء التشغيل وأخطاء البث
قائمة إصلاحات لأداة OpenAI Codex مرتبة بترتيب التشخيص — "command not found" وخطأ "sh" في ويندوز، والبدء العالق عند التحميل، وحلقات تسجيل الدخول، و"stream disconnected before completion"، وتبديل /model الذي يعيد جلسات VS Code وCursor إلى الحياة — كل إصلاح معروض على تسجيل حقيقي.
شخّص بهذا الترتيب
- رسالة "codex is not recognized" أو "command not found" بعد التثبيت مباشرة؟ التثبيت غير موجود في PATH — وعلى ويندوز ثبّت أيضًا Git for Windows وأضف C:\Program Files\Git\bin إلى PATH، لأن Codex يستدعي sh عند بدء التشغيل.
- هل علق Codex عند "What should we work on?" أو يرفض البدء؟ حدّث أولًا إلى 0.162.1 أو أحدث — فقد أصلح هذا الإصدار حالات فشل البدء الناتجة عن اختلاف إعدادات الميزات مع الخادم الخلفي — ثم أعد ضبط الحالة المخزنة في مجلد .codex.
- حلقة تسجيل دخول أو "login not working"؟ أغلق Codex، واحذف ملف auth.json المخزَّن داخل مجلد .codex، وأعد التشغيل ثم نفّذ codex login لتسجيل الدخول عبر ChatGPT من جديد.
- خطأ "stream disconnected before completion"؟ تحقق من status.openai.com، وأوقف VPN أو البروكسي، ثم بدّل النموذج عبر /model وعد إليه — في التسجيل تعود الجلسة الميتة إلى الحياة خلال ثوانٍ.
- تعطّل داخل VS Code أو Cursor؟ الإضافة تقود الـ CLI نفسه — أغلق الطرفية وأعد فتحها، واستخدم منتقي /model عندما يتجمد نموذج في منتصف البث.
How To Fix Codex Stuck On Loading
القناة: GUMY Art1:25
OpenAI Codex docs — install, auth & troubleshooting
الوثائق: developers.openai.com/codex
الإطارات مأخوذة من تسجيلَي شاشة نظيفَين: إصلاح علوق التحميل في ويندوز أعلاه (GUMY Art)، وإصلاح انقطاع البث داخل VS Code (w_ntLum92GY بقلم Shivesh). أربعة فيديوهات أخرى — إصلاح "sh" من hUndefined (ey8XJeloUWY)، وإعادة ضبط الإعداد بعد التحديث من ZEROBRENE (FzR7ZoET0Qg)، وفحوصات التحميل والحالة من PurpleCircuit (Fk70XxkTHfg وYEMPT7eBka0) — وفّرت الحقائق لكنها استُبعدت كمصادر إطارات بسبب كاميرا الوجه أو الترجمات المحروقة. كل خطوة تربط بالثانية الدقيقة من المصدر.
تبقى إطارات الفيديو ملكًا لأصحابها، وهي مدمجة هنا كوثائق خطوة بخطوة مع نسب المصدر وروابط الطوابع الزمنية.
خط سير الإصلاح
التثبيت و PATH — مرحلة "غير معروف"
- 1
ابدأ من إطلاق سليم
افتح مشروعك في VS Code، وافتح الطرفية المدمجة واكتب codex. البداية السليمة تطبع لافتة OpenAI Codex مع سطر النموذج ودليل مشروعك، مثل التسجيل. إذا ردّ ويندوز بـ "codex is not recognized" أو قال macOS بـ "command not found" فتخطَّ إلى الأمام: التثبيت غير موجود في PATH، وليس معطوبًا.
أمر codex مكتوبًا عند محث bash في طرفية VS Codeشاهد عند 0:28 - 2
إصلاح خطأ "sh is not recognized" في ويندوز
يستدعي Codex الأداة sh عند بدء التشغيل، وفي ويندوز تأتي sh داخل Git for Windows — ثبّتها من git-scm.com/downloads بالخيارات الافتراضية. ثم اضغط مفتاح ويندوز واكتب environment، وافتح "تحرير متغيرات النظام البيئية"، وانقر زر متغيرات البيئة، وانقر نقرًا مزدوجًا على Path، وأضف مدخلًا جديدًا C:\Program Files\Git\bin وأكّد. أغلق موجه الأوامر إغلاقًا كاملًا وأعد فتحه — تغييرات PATH تصل إلى الطرفيات الجديدة فقط — وسيعمل codex.
إخفاقات البدء والعلوق عند التحميل — مرحلة 0.162.1
- 3
تعرف على حالة العلوق عند التحميل
يفتح تطبيق سطح المكتب صفحة "What should we work on?" ولا ينهيها أبدًا — حقل الإدخال يظل رماديًا ولا تُرسل المهام، رغم أن باقتك معروضة بفخر في الزاوية. هذه هي الحالة العالقة من التسجيل: مصدرها الحالة المخزنة في مجلد .codex، لا خوادم OpenAI، ولهذا لا يعالجها إعادة تثبيت التطبيق وحدها أبدًا.
تطبيق ChatGPT Codex متجمدًا على صفحته الرئيسية What should we work on?شاهد عند 0:00 - 4
حدّث إلى 0.162.1 قبل أي شيء
أصلح الإصدار المستقر 0.162.1 (9 أكتوبر 2026) "حالات فشل بدء التشغيل الناتجة عن اختلافات بين إعدادات ميزات خادم خلفي عامل وقيم CLI الافتراضية" — فأصبحت فحوصات التوافق تنطبق فقط على التجاوزات الصريحة في سطر الأوامر — كما أصلح انهيار TUI عند الأسئلة غير المتزامنة متعددة الأسطر. نفّذ codex --version؛ وإذا رأيت لافتة "Update available!" مثل 0.114.0 -> 0.116.0 في التسجيل، فأعد التثبيت بـ curl -fsSL https://chatgpt.com/codex/install.sh | sh (أو npm install -g @openai/codex) وحاول مجددًا.
تسجيل الدخول والمصادقة — إعادة ضبط بيانات الاعتماد المخزنة
- 5
أغلق كل شيء ثم افتح هذا الكمبيوتر
اخرج من Codex وتأكد أنه لا يعمل في الخلفية — أغلق VS Code أيضًا إن كانت الإضافة موصولة. في مستكشف الملفات سِر إلى This PC → Local Disk (C:) → Users، مثل الإطار. على macOS يقع المجلد نفسه في ~/.codex (فايندر: انتقال → الانتقال إلى المجلد).
مستكشف الملفات عند القرص المحلي (C:) ومجلد Users في المرأىشاهد عند 0:26 - 6
افتح مجلد .codex الخاص بك
داخل Users افتح مجلد حسابك (يُظهر التسجيل ryanc)، ثم .codex. هذا هو بيت Codex: auth.json يحتفظ ببيانات اعتماد ChatGPT المخزنة، وconfig.toml بإعداداتك، وsessions بمحاضراتك، وملفات sqlite بسجلاتك وتاريخك. عندما يتجمد Codex عند الإقلاع، فأحد ملفات الحالة هذه — عادة auth.json — هو السبب.
داخل .codex: auth.json وconfig.toml وsessions وسجلات sqliteشاهد عند 0:36 - 7
احذف auth.json لإعادة ضبط تسجيل الدخول
انقر auth.json — يجب أن تقرأ شريط الحالة "تم تحديد عنصر واحد" — ثم احذفه. ملف بيانات الاعتماد هو بالضبط ما يدور حوله "codex login not working": ملف auth.json مبتور أو نصف مُحدَّث يُبقي التطبيق عالقًا عند الإقلاع أو يقذفك مرة أخرى إلى شاشة الدخول. حذفه آمن؛ سيطلب منك Codex ببساطة تسجيل الدخول من جديد.
auth.json محددًا في مجلد .codex، جاهزًا للحذفشاهد عند 0:40 - 8
أعد التشغيل وسجّل الدخول عبر ChatGPT مجددًا
تعرض القائمة الآن 36 عنصرًا بدل 37 — اختفى auth.json بينما نجا config.toml وsessions. شغّل Codex من جديد، واختر Sign in with ChatGPT، ونفّذ codex login status في الطرفية؛ يجب أن يبلّغ "Logged in using ChatGPT". إذا بقي التطبيق متجمدًا فأعد تشغيل الحاسوب مرة — احتاج ذلك مؤلف التسجيل على ويندوز.
قائمة .codex عند 36 عنصرًا بعد إعادة ضبط auth.jsonشاهد عند 0:46
أخطاء الشبكة — "stream disconnected before completion"
- 9
اقرأ خطأ انقطاع البث قراءة صحيحة
عندما يموت طلب في منتصف البث، يطبع Codex "Falling back from WebSockets to HTTPS transport. stream disconnected before completion. An error occurred while processing your request" مع معرّف طلب — يظهر في الإطار داخل المحرر وداخل TUI في آنٍ واحد. عادةً يكون عابرًا: تحقق من status.openai.com بشأن عطل، وافصل VPN أو بروكسي قد يقطع البث، ثم أعد المحاولة ببساطة.
خطأ stream disconnected before completion ملصقًا لكي يصلحه Codexشاهد عند 3:00
في VS Code و Cursor — تبديل /model
- 10
بدّل النماذج عبر /model
إذا استمرت المحاولات في الفشل، افتح منتقي /model في واجهة Codex الطرفية — يسرد التسجيل gpt-5.4 وgpt-5.4-mini وgpt-5.3-codex وgpt-5.2-codex وتنويعات gpt-5.1. اختر أي نموذج آخر (ينتقل التسجيل من gpt-5.4 إلى gpt-5.2-codex). المنتقي نفسه يعمل في طرفيتي VS Code وCursor، ما يجعله أسرع إصلاح لبلاغات "Codex لا يعمل في VS Code".
منتقي /model مفتوحًا في Codex v0.114.0 داخل VS Codeشاهد عند 2:20 - 11
أعد السؤال ثم عد بالتبديل
يؤكد TUI رسالة "Model changed to gpt-5.2-codex medium" ويعرض سطر الحالة gpt-5.2-codex medium · 100% left. أرسل مطالبتك من جديد — عادت جلسة التسجيل إلى البث الطبيعي بعدها مباشرة — وبعد اكتمال الطلب يمكنك العودة عبر /model إلى نموذجك المفضل. هذا "الابتعاد والعودة" هو علاج المجتمع لأخطاء البث المتقطعة.
"Model changed to gpt-5.2-codex medium" مؤكدة في TUIشاهد عند 2:24
فحوصات سريعة لويندوز وماك
- 12
فحوصات سريعة لويندوز وماك
على ويندوز، أبقِ Git for Windows مثبتًا (أساس إصلاح sh)، وإذا رفض Codex العمل بعد تحديث فأصلح حزمة Microsoft Visual C++ القابلة لإعادة التوزيع — كلاهما إصلاحان موثّقان لويندوز. على macOS وLinux، نفّذ codex --version في طرفية جديدة للتأكد من PATH، وأعد التثبيت بالسكربت الرسمي عند الشك. وعلى المنصتين: عندما تشتعل "أداة codex لا تعمل اليوم"، يخبرك status.openai.com خلال ثوانٍ إن كانت المشكلة عندك أم عند OpenAI.
ما زال معطوبًا؟ قائمة ما بعد التحديث
معظم بلاغات "codex لا يعمل بعد التحديث" تقع في واحدة من هذه السلات. عالجها بالترتيب — تبدأ بملفات الحالة التي عرضتها هذه الصفحة وتنتهي بملاحظات الإصدار الجديرة بالقراءة.
- 1إعداد فاسد من تحديث: ملف config.toml كُتب أثناء تحديث فاشل يكسر كل إقلاع. أغلق Codex ثم احذف (أو أعِد تسمية) %USERPROFILE%\.codex\config.toml في PowerShell بصلاحيات المسؤول — يكتب Codex ملفًا جديدًا عند البدء التالي. نص الخطأ الأحمر لأمر جرى سابقًا غير ضار.
- 2إخفاقات بدء التشغيل قبل 0.162.1: قبل هذا الإصدار المستقر (9 أكتوبر 2026)، كان Codex قد يرفض البدء عندما تختلف إعدادات ميزات خادم خلفي عامل عن قيم CLI الافتراضية. جاء الإصلاح مع 0.162.1 — "أصبحت فحوصات التوافق تنطبق فقط على التجاوزات الصريحة في سطر الأوامر" (#52648) — فالعلاج هو التحديث لا تحرير الإعداد.
- 3انهيار TUI متعدد الأسطر: أصلح 0.162.1 أيضًا "انهيار TUI عندما تحتوي الأسئلة غير المتزامنة على عدة أسطر، مع الحفاظ على فواصل الأسطر ووجهات الروابط الكاملة" (#51866). إذا كان Codex ينهار على المطالبات متعددة الأسطر الملصوقة، فإنهى 0.162.1 ذلك.
- 4عطل أم محلي: "codex لا يعمل اليوم" أو "لا يعمل الآن" تعني عادةً OpenAI لا أنت — لافتة صفحة الحالة تسرد أعطال Codex صراحةً، وصفحة الحالة الخضراء بالكامل هي صورة "تم الإصلاح".
- 5لافتة تحديث مُهملة: يطبع TUI "Update available! 0.114.0 -> 0.116.0" مع رابط ملاحظات الإصدار — إصدار بهذا القدم فاتته أشهر من إصلاحات البث وتسجيل الدخول. أعد التثبيت من رابط اللافتة أو سكربت التثبيت.
- 6لا شيء بعد: احفظ ناتج codex --version وأحدث ملف في ~/.codex/log (ويندوز: %USERPROFILE%\.codex\log)، وأرفق معرّف الطلب من خطأ البث، وعند فتح issue على github.com/openai/codex أضف محضر الجلسة من ~/.codex/sessions.
معالجةً بالترتيب — تحديث، إعادة ضبط الحالة، إعادة ضبط الدخول، إعادة محاولة البث، تبديل النموذج — تغطي هذه البنود تقريبًا كل بلاغات "codex not working" هذا الشهر. وعندما لا ينفع شيء، يكون معرّف الطلب وأحدث ملف سجل هما ما يطلبه المشرفون أولًا.