أدوات البرمجة
Codex CLI
تكوين OpenAI Codex CLI لاستخدام TokenLab API
دع وكيلي يتولى الإعداد
انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهازك:
اقرأ هذا الدليل وساعدني في ربط Codex CLI بـ TokenLab:
https://tokenlab.sh/docs/ar/integrations/codex-cli
تحقق أولًا من الإصدار المثبت لديّ والإعدادات الفعّالة.
احتفظ بالحسابات ومزوّدي الخدمة والأذونات والإعدادات الأخرى الموجودة.
انسخ الملفات المحلية احتياطيًا واعرض التغييرات المقترحة.
دعني أُدخل أي مفتاح API مطلوب محليًا؛ لا تطلبه أو تعرضه أو تلصقه في المحادثة.
تحقق أولًا من إمكانية تحميل الإعدادات.
اشرح تكلفة أي اختبار يتضمن طلبًا مدفوعًا بشكل منفصل قبل تشغيله.نظرة عامة
يمكن لـ Codex CLI الاتصال بـ TokenLab عبر /v1/responses. يجب أن يتضمن tokenlab.accepted_request_formats للنموذج المختار القيمة openai_responses؛ وقد تختلف الميزات حسب النموذج.
يدعم Codex CLI الضغط البعيد عبر POST /v1/responses/compact. يرسل Codex قيمة model الخاصة بالجلسة الحالية في body.model عند استخدام /compact والضغط التلقائي، لذلك يجب أن يكون النموذج الذي تريد استخدامه للضغط متاحا على مسار Responses. لا تقم بضبط /v1/compact.
متطلبات النظام
اتبع دليل CLI الرسمي لنظام macOS أو Linux أو Windows. Windows الأصلي وWSL بيئتان منفصلتان؛ راجع دليل Windows. npm خيار تثبيت وليس شرطًا للملفات التنفيذية الأصلية.
التثبيت
npm install -g @openai/codex@0.149.0التحقق من التثبيت:
codex --versionالتكوين
الخطوة 1: تعيين مفتاح API
اتبع خطوات الطرفية في البدء السريع لنظام macOS أو Linux أو WSL أو Windows PowerShell لتعيين TOKENLAB_API_KEY دون كتابة المفتاح في سجل الأوامر. شغّل Codex من الطرفية نفسها. للاستخدام الدائم، استخدم مدير أسرار محليًا ولا تُضف المفتاح كنص صريح إلى ملف إعدادات الصدفة.
الخطوة 2: تكوين tokenlab.config.toml
استخدم ملف tokenlab.config.toml مستقلًا داخل CODEX_HOME النشط (عادةً ~/.codex) مع Codex 0.149.0. أنشئه فقط إن لم يكن الاسم مستخدمًا، أو انسخه احتياطيًا قبل تعديل ملف 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.* أو الصوت الثنائي أو أغلفة Realtime المتداخلة response.create.response.
أنشئ ملف الإعداد المختار إذا لم يكن موجودًا. بعد تعديله، ابدأ جلسة جديدة باستخدام الأمر المطابق أدناه.
يستخدم 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"اختيار نموذج
اختر نموذجًا تتضمن قائمة tokenlab.accepted_request_formats الحالية له القيمة openai_responses. قارن النماذج في مهامك وتحقق من الأسعار الحالية في صفحة النماذج.
الأوامر التفاعلية
| الأمر | الوصف |
|---|---|
/help | عرض المساعدة |
/exit or 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. تحقق من الرد والسجل المطابق في الطلبات. تعيين المتغير أو نجاح بدء التشغيل وحده لا يثبت نجاح الطلب.
codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."حالات استخدام شائعة
مراجعة الشيفرة:
git diff | codex --profile tokenlab "Review these code changes"توليد رسائل الالتزام:
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"