أدوات البرمجة
Codex CLI
إعداد OpenAI Codex CLI لاستخدام TokenLab API
اسمح للعميل (Agent) الخاص بي بإعداد هذا
انسخ هذه المهمة إلى عميل يعمل بالفعل على جهاز الكمبيوتر الخاص بك:
Read this guide and help me connect Codex CLI to TokenLab:
https://tokenlab.sh/docs/ar/integrations/codex-cli
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.نظرة عامة
يمكن لـ Codex CLI الاتصال بـ TokenLab من خلال /v1/responses. يجب أن يسرد النموذج المحدد openai_responses ضمن tokenlab.accepted_request_formats؛ وقد تختلف الميزات حسب النموذج.
يستخدم الضغط (compaction) عن بُعد POST /v1/responses/compact. يرسل Codex نموذج الجلسة الحالي في body.model، لذا يجب أن يدعم ذلك النموذج أيضاً Responses. لا تقم بتهيئة /v1/compact.
متطلبات النظام
استخدم دليل التثبيت الرسمي لـ CLI لنظام macOS أو Linux أو Windows. بيئات Windows الأصلية و WSL هي بيئات منفصلة؛ اتبع دليل Windows. أمر npm أدناه هو خيار تثبيت واحد، وليس مطلباً للملفات التنفيذية الأصلية.
التثبيت
npm install -g @openai/codex@0.163.0تحقق من التثبيت:
codex --versionالإعداد
الخطوة 1: تعيين مفتاح API
استخدم تعليمات الطرفية (terminal) في دليل البدء السريع لنظام macOS أو Linux أو WSL أو Windows PowerShell لتعيين TOKENLAB_API_KEY دون وضع المفتاح في سجل الأوامر. قم بتشغيل Codex من تلك الطرفية. للاستخدام الدائم، استخدم مدير الأسرار (secret manager) المحلي الخاص بك؛ لا تقم بإلحاق مفتاح بنص عادي (plaintext) في ملف تعريف الصدفة (shell profile) الخاص بك.
الخطوة 2: تهيئة tokenlab.config.toml
استخدم ملف tokenlab.config.toml منفصلاً في مجلد CODEX_HOME النشط الخاص بك (عادةً ~/.codex) مع إصدار Codex 0.163.0 (تم الاختبار بتاريخ 2026-10-18). أنشئه فقط إذا كان الاسم غير مستخدم، أو قم بنسخه احتياطياً قبل تعديل ملف تعريف TokenLab موجود. يتم تحميل ملف التعريف أدناه صراحةً باستخدام codex --profile tokenlab؛ وهو يترك الملفات الافتراضية config.toml و auth.json والحسابات وسياسات الأذونات دون تغيير. لا تستخدم جدول [profiles.tokenlab] القديم. ابدأ بدون ملف التعريف للعودة إلى إعداداتك العادية. راجع تهيئة ملف التعريف الرسمية.
model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
[model_providers.tokenlab]
env_key = "TOKENLAB_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000وضع WebSocket هذا هو جسر Responses-over-WebSocket لعملاء Codex. وهو يقبل فقط أحداث response.create الرسمية؛ حيث يكون stream ضمنياً، و background و response.cancel غير متاحين في وسيلة النقل هذه. هذا ليس OpenAI Realtime API ولا يقبل session.update أو conversation.item.* أو input_audio_buffer.* أو الصوت الثنائي (binary audio) أو مظاريف response.create.response المتداخلة لـ Realtime.
أنشئ ملف الإعداد المختار إذا لم يكن موجوداً. بعد تعديله، ابدأ جلسة جديدة باستخدام الأمر المطابق أدناه.
يستخدم إصدار Codex الحالي wire_api = "responses". لا تقم بتهيئة chat/completions. اجعل requires_openai_auth غير معين أو false لهذا المزود المخصص بحيث يتم استخدام env_key.
طلبات Responses لا يتم تحويلها إلى Chat Completions. تعتمد الحقول الاختيارية والمستقبلية على النموذج المختار.
الاستخدام الأساسي
بدء الوضع التفاعلي:
codex --profile tokenlabأمر مباشر:
codex --profile tokenlab "Fix the bug in main.py line 42"تحديد نموذج:
codex --profile tokenlab -m gpt-5.6-sol "Build a REST API server"اختيار نموذج
استخدم نموذجاً يسرد حالياً openai_responses في tokenlab.accepted_request_formats. قارن بين المرشحين في مهام البرمجة الخاصة بك وتحقق من الأسعار الحالية على صفحة النماذج.
الأوامر التفاعلية
| الأمر | الوصف |
|---|---|
/help | عرض المساعدة |
/exit أو Ctrl+C | الخروج |
/clear | مسح المحادثة |
/status | عرض النموذج النشط والأذونات واستخدام التوكن |
/model <name> | تبديل النموذج |
التحقق من الإعداد
تحقق مما إذا كان متغير البيئة معيناً دون طباعة قيمته. هذا الفحص لا يتحقق من صحة المفتاح:
if [ -n "${TOKENLAB_API_KEY:-}" ]; then
printf '%s\n' 'TOKENLAB_API_KEY is set'
else
printf '%s\n' 'TOKENLAB_API_KEY is not set'
fiابدأ تشغيل Codex وقم بتنفيذ /status للتحقق من النموذج النشط والأذونات. إذا كنت تستخدم ملف تعريف، فابدأ باستخدام نفس ملف التعريف هذا. راجع أمر الحالة الرسمي.
عندما تكون مستعداً لإجراء طلب حقيقي، قم بتنفيذ الأمر أدناه. يستخدم هذا الأمر رصيد TokenLab الخاص بك. تحقق من الرد والسجل المطابق في Requests؛ فمجرد فحص البيئة أو بدء التشغيل الناجح لا يثبت نجاح الطلب.
codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."حالات الاستخدام الشائعة
مراجعة الكود:
git diff | codex --profile tokenlab "Review these code changes"إنشاء رسائل الالتزام (commit messages):
git diff --staged | codex --profile tokenlab "Generate a commit message for these changes"إصلاح الأخطاء:
codex --profile tokenlab "Fix the TypeScript errors in src/components/"شرح الكود:
cat main.py | codex --profile tokenlab "Explain what this code does"إنشاء صور وفيديوهات في نفس العميل
يمكن لـ Codex أيضاً إنشاء صور وفيديوهات قصيرة باستخدام خادم TokenLab MCP. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab. قم بتشغيل هذا في الطرفية حيث تم تعيين 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يقوم الأمر بإضافة الخادم إلى ملف config.toml الأساسي الخاص بك. يقوم Codex بتحميل ذلك الملف تحت ملف التعريف tokenlab.config.toml أيضاً، لذا تعمل الأدوات مع أو بدون --profile tokenlab. قم بتشغيل codex mcp list وتحقق من إدراج tokenlab. ثم جرب:
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 معرف مهمة (task ID). يستدعي العميل get_task_status حتى يصبح الفيديو جاهزاً.