أدوات البرمجة

OpenCodex

ربط Codex بـ TokenLab عبر OpenCodex مع توجيه API خاص بكل نموذج

دع الوكيل الخاص بي يقوم بالإعداد

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

Read https://tokenlab.sh/docs/ar/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.

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

OpenCodex هو وكيل محلي (proxy) بين Codex وواجهات برمجة تطبيقات النماذج (model APIs). يستخدم هذا الدليل OpenCodex 2.73.0 و Codex CLI 0.149.0.

تم إصدار تكامل Chat Completions الخاص بـ TokenLab والتحقق منه بالكامل في الإصدار 2.72.0. يحافظ الإصدار 2.73.0 على هذا التكامل ويضيف توجيهاً خاصاً بالنماذج لـ Responses و Anthropic Messages. تم فحص المسارات المدرجة أدناه مقابل TokenLab مع النصوص المتدفقة (streamed text) وجولات استدعاء الدوال/النتائج.

يرسل Codex طلبات Responses إلى وكيل OpenCodex المحلي. ثم يرسل OpenCodex طلب النموذج المحدد إلى TokenLab. طلب Responses على الاتصال المحلي لا يعني أن النموذج يتم استدعاؤه عبر واجهة برمجة تطبيقات Responses الخاصة بـ TokenLab.

النماذج المحددة في CodexOpenCodex → TokenLab
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3Responses: POST /v1/responses
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1Anthropic Messages: POST /v1/messages
gemini-3.8-flashChat Completions: POST /v1/chat/completions

عنوان URL الأساسي (Base URL) للإعداد المسبق هو https://api.tokenlab.sh/v1. اتركه دون تغيير: يقوم OpenCodex بإنشاء عنوان URL المطابق لـ Messages أو Responses بنفسه. النماذج التي تقع خارج إعدادات Responses الافتراضية وتوجيه Claude تستخدم محول Chat الخاص بالإعداد المسبق.

يدعم TokenLab واجهة برمجة تطبيقات Gemini الأصلية للنماذج التي تعلن عنها، ولكن إعداد TokenLab المسبق في OpenCodex 2.73.0 يستدعي Gemini عبر Chat Completions. لا تقم بتغيير المزود بالكامل إلى Responses أو Gemini؛ لأن ذلك سيؤدي أيضاً إلى تغيير الطلبات للنماذج التي لا تقبل هذا التنسيق.

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

استخدم Node.js 18 أو أحدث لتثبيت npm:

npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --version

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

إضافة TokenLab

أنشئ مفتاحاً في مفاتيح API الخاصة بـ TokenLab. لإعداد الجهاز الطرفي (terminal)، اتبع دليل البدء السريع لتعيين TOKENLAB_API_KEY دون وضع قيمته في سجل الأوامر. ابدأ تشغيل OpenCodex من ذلك الجهاز الطرفي؛ تحتاج الخدمة الخلفية إلى المتغير في بيئة التشغيل الخاصة بها.

بالنسبة لـ تثبيت OpenCodex جديد، قم بتشغيل ocx init ، وحدد TokenLab، وأدخل المفتاح محلياً أو استخدم مرجع البيئة الحرفي ${TOKENLAB_API_KEY}. راجع خيارات اتصال Codex والتشغيل التلقائي الخاصة بالمعالج قبل تطبيقها.

بالنسبة لـ تثبيت موجود، أضف الإعداد المسبق دون استبدال المزودين الآخرين:

ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'

تحفظ علامات الاقتباس المفردة مرجع متغير البيئة، وليس قيمة المفتاح. يعمل هذا الأمر أيضاً في PowerShell. إذا كان tokenlab موجوداً بالفعل، فقم بتحرير ذلك المزود في لوحة التحكم بدلاً من استبداله بـ --force.

يمكنك أيضاً اختيار TokenLab في قائمة إضافة مزود في لوحة التحكم وإدخال المفتاح هناك. يحفظ OpenCodex تكوينه تحت $OPENCODEX_HOME/config.json ، وعادة ما يكون ~/.opencodex/config.json.

ابدأ تشغيل الوكيل إذا لم يكن يعمل بالفعل، ثم افتح لوحة التحكم الخاصة به:

ocx start
ocx status
ocx gui

في صفحة المزود، تحقق من عنوان URL الأساسي والنماذج المكتشفة. يكتشف الإعداد المسبق GET /v1/models?category=chat ويحتفظ بالنماذج التي تتمتع بقدرة tool-use. يتم استبعاد نماذج الصور والفيديو والصوت والتضمينات (embeddings) ونماذج اتخاذ القرار. يعكس الاكتشاف باستخدام مفتاح ما أذونات النموذج وسياسة التسليم الخاصة بذلك المفتاح.

قم بتشغيل ocx sync لربط Codex وتحديث كتالوج النماذج الخاص به، ثم ابدأ جلسة Codex جديدة. يؤدي هذا إلى تغيير اتصال الوكيل الخاص بـ Codex والكتالوج؛ راجع إعدادات المزود المخصص الحالية واحتفظ بنسخة احتياطية قبل المزامنة. لا يتطلب ذلك استبدال حسابك أو سياسة الأذونات الخاصة بك.

اختيار نموذج والتحقق من طلب

اختر إدخال tokenlab/<model-id> في منتقي النماذج في Codex، أو حدده لتشغيل CLI واحد:

codex -m "tokenlab/gpt-6.1-sol"

يستخدم OpenCodex tokenlab/ لاختيار المزود؛ معرف النموذج المرسل إلى TokenLab هو gpt-6.1-sol. اختر معرفاً دقيقاً متاحاً حالياً من النماذج.

للتحقق من الاتصال بشكل بسيط، أرسل:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

يستخدم هذا الطلب رصيد TokenLab الخاص بك. تحقق من الرد والنموذج المطابق له، والوقت، والحالة في الطلبات. اكتشاف المزود والبدء الناجح وحدهما لا يتحققان من الوصول إلى الاستدلال (inference).

يعمل البث (Streaming) واستدعاء الدوال على المسارات الموجودة في الجدول. تعتمد مدخلات الصور وعناصر التحكم في التفكير على النموذج المحدد: تحقق من قدراته، واستخدم فقط خيارات الجهد التي يقدمها OpenCodex لهذا النموذج. تم فحص مدخلات الصور وطلبات التفكير على نماذج تمثيلية لمسارات Responses و Messages؛ تم فحص مدخلات صور Gemini على مسار Chat الخاص به. النموذج الذي يدعم التفكير لا يكشف بالضرورة عن نص التفكير أو يدعم كل مستوى جهد.

الاحتفاظ بنموذج Responses على Chat Completions

لاستخدام مسار Chat لأحد نماذج Responses المدرجة، ادمج إدخال modelAdapters في كائن providers.tokenlab الموجود في تكوين OpenCodex. هذا المثال يبقي gpt-6-astra على Chat لـ Codex:

{
  "modelAdapters": {
    "gpt-6-astra": "openai-chat"
  }
}

هذا مثال لحقل مزود، وليس بديلاً للتكوين الكامل. احتفظ بتجاوزات النماذج الأخرى، وبيانات الاعتماد، والمزودين، ثم أعد تشغيل الوكيل وافتح جلسة 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 تعليمات التكامل. وهي لا تغير مزود النموذج الرئيسي أو تنسيق API.

يستخدم JEV Auto في OpenCodex 2.73.0 واجهة اتخاذ القرار الخاصة بـ TypeSafe. وهو لا يقدم TokenLab كواجهة خلفية لذلك. استدعاء System One API الخاص بـ TokenLab عبر MCP هو عملية منفصلة؛ لا تضع مفتاح TokenLab في حقل بيانات اعتماد TypeSafe.

إنشاء صور وفيديو في نفس الوكيل

يمكن لـ Codex أيضاً إنشاء صور ومقاطع فيديو قصيرة باستخدام خادم MCP الخاص بـ TokenLab. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab. يقوم OpenCodex بتوجيه طلبات النماذج فقط، ويقوم Codex نفسه ببدء تشغيل خوادم MCP. أضف الخادم إلى Codex في الجهاز الطرفي حيث تم تعيين TOKENLAB_API_KEY:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

لا يغير MCP مزود النموذج الرئيسي أو تنسيق API. قم بتشغيل codex mcp list وتحقق من إدراج tokenlab. ثم جرب في جلسة Codex جديدة:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

يعيد create_video معرف مهمة. يستدعي الوكيل get_task_status حتى يصبح الفيديو جاهزاً.

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

  • 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 باستعادة الاتصال الأصلي مع إبقاء الوكيل يعمل للعملاء الآخرين. راجع مرجع CLI الخاص بـ OpenCodex قبل تغيير تثبيت مشترك بين عملاء آخرين.

في هذه الصفحة