التوثيق ‹ تكاملات الوكلاء ‹ Codex

Codex

تقبل واجهة سطر أوامر Codex أي مزوّد متوافق مع OpenAI. نعرّف CloudZIR كمزوّد في ~/.codex/config.toml، فتصبح نماذج Mina متاحة كغيرها.

المتطلبات المسبقة#

  • Codex CLI مُثبَّتة (npm install -g @openai/codex).
  • مفتاح zir_ai_… ومحفظة مشحونة.

تعريف المزوّد#

في ~/.codex/config.toml :

model = "mina-full"
model_provider = "cloudzir"

[model_providers.cloudzir]
name = "CloudZIR AI"
base_url = "https://api.cloudzir.com/v1"
env_key = "CLOUDZIR_API_KEY"
wire_api = "responses"

ثم صدّروا المفتاح :

export CLOUDZIR_API_KEY="zir_ai_..."
codex
لم يعد Codex يقبل Chat Completions

منذ فبراير 2026 لم تعد واجهة سطر أوامر Codex تدعم سوى API Responses : المزوّد المعرَّف بـwire_api = "chat" ترفضه الإصدارات الحديثة (أُعلن الحذف في مستودع openai/codex، النقاش رقم 7782). تعرض CloudZIR API Responses (POST /v1/responses) : وهي التي ينبغي تعريفها.

هذه الواجهة بلا حالة على الخادم. يُرفَض store: true وprevious_response_id وعناصر input ذات النوع غير المعروف والأدوات المدمجة بالرمز 400 الذي يسمّي الحقل المعني : القائمة في دليل Responses.

تغيير النموذج فورًا#

codex --model mina-flash     # rapide et économique
codex --model mina-low       # équilibré
codex --model mina-full      # raisonnement, refactorings complexes

التحقق من التثبيت#

codex exec "affiche l'arborescence du projet et explique le rôle de chaque dossier"

يجب أن تظهر الطلبات في Usage تحت /v1/responses.

نصائح#

  • يعيد Codex كل سياق الجلسة في كل جولة : فضّلوا جلسات قصيرة ومركّزة للتحكم في التكلفة.
  • للاستخدام بالدُفعات (سكربتات، CI)، يكفي mina-flash في معظم الحالات ؛ خصّصوا mina-full لمهام الاستدلال.
  • احسبوا حساب مهلة لا تقل عن 120 ثانية في أدوات CI.

القيود المعروفة#

الإعدادات

التخصيص

استجابة API