Skip to main content

​
دع وكيلي يتولى إعداد هذا

انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهاز الكمبيوتر الخاص بك:

​
كيف يعمل الاتصال

يُعد OpenCodex بروكسي محلياً بين Codex و APIs الخاصة بالنماذج. يستخدم هذا الدليل OpenCodex 2.73.0 و Codex CLI 0.149.0. تم إطلاق تكامل Chat Completions الخاص بالإعداد المسبق لـ TokenLab والتحقق منه بالكامل في الإصدار 2.72.0. يحتفظ الإصدار 2.73.0 بهذا التكامل ويضيف توجيهاً مخصصاً لكل نموذج لـ Responses و Anthropic Messages. تم فحص المسارات المدرجة أدناه مع TokenLab باستخدام النصوص المتدفقة ودورات استدعاء الدوال/النتائج (function-call/result round trips). يرسل Codex طلبات Responses إلى بروكسي OpenCodex المحلي. ثم يقوم OpenCodex بإرسال طلب النموذج المحدد إلى TokenLab. لا يعني طلب Responses على الاتصال المحلي أنه يتم استدعاء النموذج عبر Responses API الخاصة بـ TokenLab. إن Base URL الخاص بالإعداد المسبق هو https://api.tokenlab.sh/v1. اتركه دون تغيير: يقوم OpenCodex بإنشاء عنوان URL المطابق لـ Messages أو Responses بنفسه. تستخدم النماذج الخارجة عن الإعدادات الافتراضية لـ Responses وتوجيه Claude المدرجة محول Chat الخاص بالإعداد المسبق. يدعم TokenLab واجهة API الأصلية لـ Gemini للنماذج التي تصرح بذلك، ولكن الإعداد المسبق لـ TokenLab في OpenCodex 2.73.0 يستدعي Gemini عبر Chat Completions. لا تقم بتغيير المزود بالكامل إلى Responses أو Gemini؛ لأن ذلك سيؤدي أيضاً إلى تغيير الطلبات للنماذج التي لا تقبل هذا التنسيق.

​
التثبيت أو التحديث

استخدم Node.js 18 أو إصداراً أحدث للتثبيت عبر npm:
يجب أيضاً تثبيت Codex. يوفر OpenCodex تعليمات التثبيت وتعليمات الاتصال بـ Codex. يحتوي كل من Windows الأصلي و WSL على تكوينات منفصلة؛ قم بتشغيل الإعداد و Codex في نفس البيئة.

​
إضافة TokenLab

قم بإنشاء مفتاح في مفاتيح TokenLab API. للإعداد عبر الطرفية، اتبع البدء السريع لتعيين TOKENLAB_API_KEY دون وضع قيمته في سجل الأوامر. ابدأ تشغيل OpenCodex من تلك الطرفية؛ حيث تحتاج خدمة الخلفية إلى المتغير في بيئة التشغيل الخاصة بها. بالنسبة إلى تثبيت OpenCodex جديد، شغّل ocx init، واختر TokenLab، ثم أدخل المفتاح محلياً أو استخدم مرجع متغير البيئة الحرفي ${TOKENLAB_API_KEY}. راجع خيارات الاتصال بـ Codex والتشغيل التلقائي في معالج الإعداد قبل تطبيقها. بالنسبة إلى تثبيت حالي، أضف الإعداد المسبق دون استبدال المزودين الآخرين:
تحفظ علامات الاقتباس المفردة مرجعاً لمتغير البيئة، وليس قيمة المفتاح. يعمل هذا الأمر أيضاً في PowerShell. إذا كان tokenlab موجوداً بالفعل، فقم بتعديل ذلك المزود في لوحة التحكم بدلاً من الكتابة فوقه باستخدام --force. يمكنك أيضاً اختيار TokenLab من قائمة Add provider في لوحة التحكم وإدخال المفتاح هناك. يحفظ OpenCodex تكوينه تحت المسار $OPENCODEX_HOME/config.json، وعادةً ما يكون ~/.opencodex/config.json. ابدأ تشغيل البروكسي إذا لم يكن قيد التشغيل بالفعل، ثم افتح لوحة التحكم الخاصة به:
في صفحة المزود، تحقق من Base URL والنماذج المكتشفة. يكتشف الإعداد المسبق GET /v1/models?category=chat ويحتفظ بالنماذج التي تمتلك قدرة tool-use. يتم استبعاد نماذج الصور والفيديو والصوت والـ embeddings ونماذج اتخاذ القرار. يعكس الاكتشاف باستخدام المفتاح أذونات النماذج وسياسة التسليم الخاصة بذلك المفتاح. شغّل ocx sync للاتصال بـ Codex وتحديث كتالوج النماذج الخاص به، ثم ابدأ جلسة Codex جديدة. يؤدي هذا إلى تغيير اتصال البروكسي والكتالوج الخاص بـ Codex؛ راجع إعدادات المزود المخصص الحالية واحتفظ بنسخة احتياطية قبل المزامنة. لا يتطلب هذا استبدال حسابك أو سياسة الأذونات الخاصة بك.

​
تحديد نموذج والتحقق من الطلب

اختر الإدخال tokenlab/<model-id> في أداة اختيار النماذج بـ Codex، أو حدده لتشغيل CLI لمرة واحدة:
يستخدم OpenCodex بادئة tokenlab/ لتحديد المزود؛ ومعرّف النموذج المرسل إلى TokenLab هو gpt-6.1-sol. اختر معرّفاً دقيقاً ومتاحاً حالياً من النماذج. لإجراء فحص اتصال سريع، أرسل:
يستهلك هذا الطلب من رصيد TokenLab الخاص بك. تحقق من الرد والنموذج المطابق والوقت والحالة في الطلبات. لا يؤكد اكتشاف المزود والتشغيل الناجح وحدهما إمكانية الوصول إلى الاستدلال. يعمل البث واستدعاء الدوال على المسارات الموضحة في الجدول. تعتمد مدخلات الصور وعناصر التحكم في التفكير على النموذج المحدد: تحقق من إمكانياته، واستخدم فقط خيارات الجهد التي يقدمها OpenCodex لذلك النموذج. تم التحقق من مدخلات الصور وطلبات التفكير على نماذج تمثيلية لمسارات Responses و Messages؛ كما تم التحقق من إدخال صور Gemini على مسار Chat الخاص به. النموذج الذي يدعم التفكير لا يعرض بالضرورة نص التفكير أو يدعم كل مستوى من مستويات الجهد.

​
الإبقاء على نموذج Responses على Chat Completions

لاستخدام مسار Chat لأحد نماذج Responses المدرجة، ادمج إدخال modelAdapters في كائن providers.tokenlab الحالي في تكوين OpenCodex. يُبقي هذا المثال gpt-6-astra على Chat لـ Codex:
هذا مثال لحقل المزود وليس بديلاً للتكوين الكامل. احتفظ بالتجاوزات الأخرى للنماذج، وبيانات الاعتماد، والمزودين، ثم أعد تشغيل البروكسي وافتح جلسة Codex جديدة. تؤدي إزالة إدخال هذا النموذج فقط إلى استعادة الوضع الافتراضي الخاص به كـ Responses. يرتبط توجيه Messages الخاص بـ Claude بنقطة نهاية TokenLab الأساسية. ينطبق تجاوز Chat الموضح أعلاه على الإعدادات الافتراضية لـ Responses؛ ولا يحوّل Claude إلى Chat. بالنسبة لعميل يعتمد على Chat أصلاً، تستخدم نماذج Responses المدرجة بالفعل Chat دون هذا التجاوز. راجع توجيه مزود OpenCodex.

​
سياسة التسليم وأدوات TokenLab الأخرى

لا يفرض الإعداد المسبق ترويسة X-TokenLab-Delivery-Policy. يستخدم TokenLab الإعداد الافتراضي لسياسة التسليم الخاصة بمفتاح API الخاص بك. يُعد اختيار Chat أو Responses أو Messages أمراً منفصلاً عن اختيار سياسة التسليم؛ راجع إعدادات مزود TokenLab. أضف خادم TokenLab MCP لأدوات API الأخرى، أو مهارات TokenLab للحصول على تعليمات التكامل. لا تؤدي هذه الإضافات إلى تغيير مزود النموذج الرئيسي أو تنسيق API الخاص به. تستخدم ميزة JEV Auto في OpenCodex 2.73.0 الواجهة الخلفية لاتخاذ القرار من TypeSafe. وهي لا توفر TokenLab كواجهة خلفية لتلك العملية. يُعد استدعاء System One API الخاصة بـ TokenLab عبر MCP عملية منفصلة؛ لا تضع مفتاح TokenLab في حقل بيانات اعتماد TypeSafe.

​
استكشاف الأخطاء وإصلاحها واستعادة الإعداد الخاص بك

  • TokenLab غير موجود في أداة الاختيار: تحقق من ocx --version؛ يستهدف هذا الدليل الإصدار 2.73.0. قم بتحديث الكتالوج باستخدام ocx sync وابدأ جلسة Codex جديدة.
  • خطأ 401 أو بيانات اعتماد مفقودة: تحقق من أن المفتاح نشط ومتاح للعملية التي تشغل OpenCodex. لا يؤدي تعيين متغير بيئة في نافذة طرفية مختلفة إلى تحديث خدمة قيد التشغيل بالفعل.
  • النموذج غير موجود: تحقق من المعرّف الدقيق، وأذونات مفتاحك، والتوافر الحالي. لا يتضمن هذا الإعداد المسبق النماذج غير المخصصة للمحادثة ونماذج المحادثة التي لا تدعم tool-use.
  • طلب غير مدعوم أو نقطة نهاية غير صحيحة: قارن النموذج المحدد بجدول التوجيه وافحص تجاوزات المحول المحفوظة. التنسيق المطلوب هو tokenlab.accepted_request_formats في تفاصيل النموذج؛ ولا تعتبر قائمة النماذج بديلاً لحقل التفاصيل هذا. يجب عدم إرسال طلبات Claude و Gemini إلى Responses لمجرد أن Codex يستخدم Responses محلياً.
  • فشل الأدوات أو إدخال الصور: احتفظ بالخطأ الأصلي ومعرّف الطلب. تحقق من إمكانيات النموذج ومسار OpenCodex النشط قبل تغيير الإعدادات؛ لا تحذف سجل المحادثة أو نتائج الأدوات لإخفاء الخطأ.
لإيقاف توجيه Codex عبر البروكسي، استخدم ocx stop؛ حيث يوقف OpenCodex البروكسي ويعيد اتصال Codex الأصلي. يعيد الأمر ocx restore الاتصال الأصلي مع إبقاء البروكسي قيد التشغيل للعملاء الآخرين. راجع مرجع OpenCodex CLI قبل تغيير تثبيت مشترك مع عملاء آخرين.