البداية: لماذا نستخدم هذا الإعداد؟

يرغب العديد من المطورين في تجربة مساعد البرمجة في Codex Desktop، لكنهم يواجهون عوائق بسبب متطلبات الحساب، أو الوصول إلى الشبكة، أو إعداد واجهة API، أو قيود الدخول عبر الإضافات. الإعداد الموضح في المقالة المصدر هو: تثبيت Codex Desktop، وتشغيل Codex من خلال مشغّل التحسين الخارجي Codex++، ثم توصيل DeepSeek عبر وضع API الخالص.

الفكرة الأساسية ليست فتح قدرات نموذج مخفية. بل هي ربط تجربة Codex المكتبية بنموذج API تابع لجهة خارجية. بعد إتمام الإعداد، يمكنك استخدام نماذج محلية مثل DeepSeek داخل Codex والحصول على إكمال للكود، وبرمجة تفاعلية حوارية، وتفاعل بأسلوب الوكيل.

من المهم أن يكون الأمر واضحًا: Codex++ أداة تابعة لجهة خارجية. فهي تُشغّل Codex عبر مشغّل خارجي وتحقن نصوص تحسين في عملية العرض. وهي ليست جزءًا من منتج Codex الرسمي من OpenAI. قبل استخدامها، قيّم مخاطر الأمان والتوافق والصيانة الخاصة بها.

1. تنزيل Codex Desktop وتثبيته

الخطوة الأولى هي تثبيت Codex Desktop. زُر صفحة OpenAI Codex الرسمية ونزّل مثبّت سطح المكتب المناسب لنظام التشغيل لديك.

• المدخل الرسمي: Codex | OpenAI

• بعد التثبيت، أبقِ الحالة الافتراضية أولًا.

• لاحقًا، يكتشف Codex++ عمومًا معلومات Codex المحلية تلقائيًا، لذلك لا تحتاج عادةً إلى تعديل دليل تثبيت Codex الأصلي يدويًا.

بعد التثبيت، يُوصى بإبقاء Codex قيد التشغيل في الخلفية حتى لا يغلقه النظام بصمت ويتداخل مع اكتشاف Codex++ أو بدء تشغيله.

2. ثبّت مُشغّل التحسين Codex++

Codex++ هو مُشغّل تحسين خارجي لتطبيق Codex. لا يعديل ملفات تثبيت Codex الأصلية مباشرةً. بدلًا من ذلك، يشغّل Codex عبر مُشغّل خارجي ويحقن نصوص التحسين البرمجية في عملية العرض.

تشمل وظائفه الرئيسية ما يلي:

• فتح مدخل الإضافات: يسمح للإضافات بالعمل بشكل طبيعي في وضع مفتاح API.

• دعم حذف الجلسات: يعرض زر حذف في قائمة الجلسات.

• التكيّف مع وضع API: يجعل وظائف الإضافات أكثر اكتمالًا في وضع API الخالص.

مدخل التنزيل:

• مستودع CodexPlusPlus على GitHub

اختر الإصدار الموافق حسب النظام:

بعد التثبيت، يظهر عادةً عنصران على سطح المكتب:

للاستخدام اليومي، شغّل Codex عبر Codex++ بدلًا من فتح برنامج Codex الأصلي مباشرةً. وإلا فلن تدخل التحسينات حيّز التنفيذ.

التحقق بسيط: بعد تشغيل Codex عبر Codex++، إذا ظهر خيار Codex++ في شريط القائمة العلوي، فعادةً ما يكون الحقن قد نجح.

3. تكوين مزوّد: وضع API الخالص هو المفتاح

جوهر هذا الإعداد هو ربط DeepSeek أو واجهات API لنماذج محلية/طرف ثالث أخرى عبر وضع API الخالص، مع تجنّب الاعتماد على حساب Codex رسمي.

للدخول إلى صفحة التكوين:

1. افتح Codex++.

2. انتقل إلى الإعدادات.

3. ابحث عن إدارة المزوّدين.

ثم انقر على إضافة مزوّد وأدخل اسمًا سهل التعرّف عليه، مثل deepseek.

حقول التكوين الأساسية:

لا يدعم كل نموذج واجهة Responses API. إذا كان نموذجك يدعم Responses API، فيمكنك اختبار قدراته كوكيل. إذا لم تكن متأكدًا، فابدأ بـ Chat Completions لتقليل مخاطر التوافق.

4. مثال على إعداد DeepSeek

باستخدام DeepSeek كمثال، توفر المقالة الأصلية الإعداد المختبَر التالي:

الاسم       : deepseek
وضع الوصول: Pure API
نموذج الاختبار : deepseek-v4-pro
عنوان URL الأساسي   : https://api.deepseek.com
المفتاح        : مفتاح API الخاص بك
البروتوكول   : Chat Completions

الحقول الأكثر عرضة للأخطاء هي عنوان URL الأساسي، واسم النموذج، والبروتوكول.

• لا تكتب عنوان URL الأساسي من الذاكرة؛ انسخه من الوثائق الرسمية كلما أمكن ذلك.

• يجب أن يتطابق اسم النموذج تمامًا مع لوحة تحكم المزوّد أو الوثائق، بما في ذلك حالة الأحرف والواصلات.

• إذا كان DeepSeek يستخدم حاليًا واجهة متوافقة مع Chat Completions، فلا تختر Responses API عن طريق الخطأ.

بعد حفظ الإعداد، أعد تشغيل Codex عبر Codex++.

5. التحقق من أن الإعداد يعمل

بعد إعادة تشغيل Codex، يجب أن تعرض قائمة اختيار النماذج المزوّد والنموذج اللذين أضفتهما، على سبيل المثال:

deepseek / deepseek-v4-pro

يمكنك أيضًا التحقق من هذه الإشارات:

• ما إذا كانت القائمة العلوية لنافذة Codex تعرض Codex++.

• ما إذا كان إدخال الإضافة غير مقفل.

• ما إذا كان deepseek يظهر في قائمة النماذج.

• ما إذا كانت مهمة برمجة بسيطة تُرجع إكمالًا طبيعيًا أو مخرجات دردشة.

إذا عملت كل هذه العناصر، فهذا يعني أن السلسلة بين Codex Desktop وCodex++ وواجهة DeepSeek API متصلة.

6. تحسين السرعة واقتراحات الوكيل

تشير المقالة الأصلية إلى أن التشغيل الأول أو أول استدعاء للنموذج قد يكون بطيئًا بعض الشيء، خاصة لأن Codex قد يصل إلى بعض النطاقات ذات الصلة أثناء بدء التشغيل. إذا كانت شبكتك غير مستقرة، فقد تلاحظ أن التطبيق عالق على شاشة الشعار أو أن طلبات API تفشل.

الخطوات الموصى بها:

• فعّل وكيلًا واستخدم وضع الوكيل القائم على القواعد.

أضف api.deepseek.com إلى قواعد الوكيل، أو وجّهه بشكل صحيح وفقًا لشبكتك الفعلية.

• أضف النطاقات المرتبطة بـ Codex إلى قواعد الوكيل لتجنب فشل تحميل الموارد.

• لا تُضِف جميع نطاقات API عشوائيًا إلى قائمة التجاوز، لأن ذلك قد يتسبب في أخطاء 502 أو 404 أو فشل الاتصال.

إذا لم تقم بتفعيل وكيل مطلقًا، فقد يظل Codex عالقًا على شاشة الشعار. عادةً لا يكون هذا خطأ في إعدادات النموذج؛ بل غالبًا ما يكون مشكلة في مورد بدء التشغيل أو مسار الشبكة.

7. استكشاف الأخطاء الشائعة وإصلاحها

المشكلة 1: لا يظهر خيار النموذج بعد التهيئة

الأسباب المحتملة:

• بروتوكول المنبع غير صحيح.

• وجود /v1 إضافية في نهاية عنوان URL الأساسي.

• لم تتم إعادة تشغيل Codex بعد الحفظ.

• لم يتم إدخال اسم المزوّد أو اسم النموذج بشكل صحيح ونظيف.

الإصلاح المقترح:

1. تأكّد من تحديد Chat Completions.

2. تحقّق مما إذا كان عنوان URL الأساسي يطابق الوثائق الرسمية.

3. احفظ وأعد تشغيل Codex من خلال Codex++.

4. أعد فتح قائمة اختيار النموذج.

المشكلة 2: خطأ 502 أو 404

تشمل الأخطاء الشائعة ما يلي:

status 502 Bad Gateway
https://api.deepseek.com/ returned 404

السبب الشائع هو إعدادات الوكيل، وليس بالضرورة خطأ في مفتاح API. تحقّق من إعدادات تجاوز الوكيل لديك، وتأكد من أن النطاقات ذات الصلة لا يتم تجاوزها بشكل غير صحيح ولا يتم توجيهها عبر مسار غير متاح.

المشكلة 3: Codex عالق على شاشة الشعار

يحدث هذا عادةً أثناء بدء تشغيل Codex. قد يحتاج Codex إلى طلب موارد مرتبطة بـ ChatGPT أو OpenAI، لكن الشبكة الحالية لا يمكنها الوصول إليها.

الإصلاحات المحتملة:

• تأكّد من تفعيل الوكيل.

• أضف النطاقات المرتبطة بـ Codex إلى قواعد الوكيل.

• أغلق التطبيق وأعد تشغيله من خلال Codex++.

• إذا ظل عالقًا، فتحقّق أولًا مما إذا كان تطبيق Codex الأصلي يمكنه البدء بشكل طبيعي.

المشكلة 4: لم يتم فتح مدخل الإضافة

إذا قمت بتشغيل تطبيق Codex الأصلي مباشرةً بدلًا من استخدام Codex++، فلن يتم حقن سكربت التحسين، لذلك لن يظهر مدخل الإضافة.

الإصلاح:

• أغلق Codex.

• شغّله باستخدام أيقونة Codex++ على سطح المكتب.

• تحقّق مما إذا كان Codex++ يظهر في شريط القائمة العلوي.

8. لمن يناسب هذا الإعداد؟

هذا الإعداد مناسب لـ:

• المستخدمين الذين يرغبون في تجربة Codex Desktop ولكن ليس لديهم حاليًا حساب Codex رسمي.

• المطورين الذين يرغبون في توصيل DeepSeek أو Qwen أو نماذج محلية أخرى بمساعد برمجة.

• المستخدمين الذين يرغبون في الحفاظ على تفاعل Codex على سطح المكتب مع استخدام واجهة API مخصصة.

• سيناريوهات التعليم، أو تجارب الفرق الداخلية، أو بيئات التطوير الشخصية.

قد لا يكون مناسبًا لـ:

• بيئات الإنتاج الحساسة للغاية لأدوات الحقن التابعة لجهات خارجية.

• الفرق التي ترغب في استخدام المسارات المدعومة رسميًا من OpenAI فقط.

• المستخدمين الذين لا يرغبون في صيانة إعدادات الوكيل أو واجهة API أو اسم النموذج أو البروتوكول.

9. العلاقة بسير عمل محتوى We0 AI

هذا النوع من الشروحات مفيد للمطورين، ولكن عند نشره على موقع ويب أو مدونة أو قاعدة معرفة، يجب أن تكون الحدود الواقعية واضحة. Codex++ أداة تابعة لجهة خارجية، وقد تتغير أسماء نماذج واجهة DeepSeek API وقدرات البروتوكول بمرور الوقت. لذلك، لا ينبغي تقديم معرّف نموذج محدد أو حالة دعم بروتوكول أو مسار تكوين على أنه ثابت بشكل دائم.

إذا كان فريق يستخدم We0 AI لمواقع العرض، أو صفحات الحالات، أو محتوى SEO/GEO، فيمكن تنظيم هذا النوع من الشروحات التقنية في بنية أوضح: حالات الاستخدام، وخطوات التكوين، وملاحظات المخاطر، وقوائم التحقق لاستكشاف الأخطاء وإصلاحها. يساعد ذلك مستخدمي البحث على حل المشكلات بسرعة مع تقليل خطر تضليلهم عند تغيّر الإصدارات.

10. الخلاصة

من خلال الجمع بين Codex Desktop ومُشغّل التحسين Codex++ ووضع واجهة API الخالص من DeepSeek، يمكن للمطورين تجربة ربط النماذج المحلية بتجربة Codex على سطح المكتب دون الاعتماد على حساب Codex رسمي.

النقاط الأساسية هي:

1. شغّل Codex عبر Codex++، وليس مباشرةً من خلال تطبيق Codex الأصلي.

2. في إدارة المزوّدين، اختر وضع واجهة API الخالص واملأ Base URL وAPI Key واسم النموذج والبروتوكول بشكل صحيح.

3. إذا واجهت توقفًا عند شاشة الشعار، أو أخطاء 502 أو 404، أو نماذج مفقودة، فتحقق أولًا من قواعد الوكيل واختيار البروتوكول وBase URL.

هذا الإعداد مفيد للمطورين المحليين ومستخدمي التعليم والفرق التي تريد تخصيص نموذج الواجهة الخلفية وراء مساعد برمجة بالذكاء الاصطناعي. ما دامت حدود الحساب وحدود أدوات الطرف الثالث وحدود إعدادات واجهة API موضحة بوضوح، فهو مسار عملي لتوسيع تجربة Codex على سطح المكتب.

الأسئلة الشائعة باللغة الإنجليزية

هل Codex++ أداة رسمية من OpenAI؟

لا. Codex++ هو مُشغّل تحسين تابع لجهة خارجية. وهو ليس جزءًا من منتج Codex الرسمي من OpenAI. يقوم بتشغيل Codex عبر مُشغّل خارجي ويحقن سكربتات تحسين.

هل يتجنب هذا الإعداد حقًا الحاجة إلى حساب Codex رسمي؟

نهج المقالة المصدر هو استخدام وضع واجهة API الخالص في Codex++ لربط نموذج تابع لجهة خارجية، مما يتجنب الاعتماد على حساب Codex رسمي. قد يعتمد التوفر الفعلي على إصدار Codex وإصدار Codex++ والبيئة المحلية.

هل ينبغي أن يستخدم DeepSeek واجهة Responses API أم Chat Completions؟

إذا لم تكن متأكدًا مما إذا كان النموذج يدعم Responses API، فاختر Chat Completions أولًا. توصي المقالة المصدر أيضًا بـ Chat Completions للتوافق مع DeepSeek.

هل ينبغي أن ينتهي Base URL بـ /v1؟

اتبع وثائق المزوّد. تشير المقالة الأصلية تحديدًا إلى أن إضافة /v1 إضافية في بعض الإعدادات قد تؤدي إلى فقدان النماذج أو فشل الطلبات.

هل يعني التوقف عند شعار Codex أن إعدادات النموذج خاطئة؟

ليس بالضرورة. غالبًا ما تكون المشكلة متعلقة بالشبكة أو قواعد الوكيل. قد يحتاج Codex إلى الوصول إلى موارد ذات صلة أثناء بدء التشغيل، لذا تحقق أولًا من إعدادات الوكيل وقواعد النطاقات.

الأدوات ذات الصلة / 相关工具

• OpenAI Codex

• CodexPlusPlus

• منصة DeepSeek

• وثائق واجهة برمجة تطبيقات DeepSeek

• We0 AI

المقالات ذات الصلة / 相关文章

• إصدارات CodexPlusPlus

• OpenAI Codex

• واجهة برمجة تطبيقات DeepSeek

المصادر / 来源

• OpenAI Codex

• CodexPlusPlus GitHub

• واجهة برمجة تطبيقات DeepSeek