دليل إعداد OpenAI Codex CLI

نظرة عامة

Codex CLI هو وكيل البرمجة الطرفي من OpenAI. يقرأ الكود ويكتبه ويشغّله عبر تصحيحات معزولة قابلة للمراجعة. وجّه مزوّده المخصّص إلى الرابط الأساسي لـ UnoRouter لاستخدام أي نموذج في الكتالوج.

إعداد سريع

الصق هذه في العميل. يُملأ مفتاحك تلقائيًا عند تسجيل الدخول.

عنوان URL الأساسي: https://api.unorouter.com/v1
مفتاح API: YOUR_API_KEY

التوافق

الإعداد خطوة بخطوة

1. 1
   ثبّت Codex CLI

   ثبّت Codex CLI عالميًا عبر npm.

   bash

   npm install -g @openai/codex

   سجّل الدخول لتعبئة مفتاح API تلقائياً

2. 2
   اضبط موفر النموذج

   حرّر `~/.codex/config.toml`. اضبط معرّف نموذجك وأضف مزوّدًا مخصّصًا بالرابط الأساسي لـ UnoRouter باستخدام واجهة responses.

   toml

   # ~/.codex/config.toml
   model = "YOUR_MODEL_ID"
   model_provider = "unorouter"
   
   [model_providers.unorouter]
   name = "UnoRouter"
   base_url = "https://api.unorouter.com/v1"
   wire_api = "responses"

   سجّل الدخول لتعبئة مفتاح API تلقائياً

3. 3
   أضف مفتاح API

   اكتب مفتاح API الخاصّ بـ UnoRouter في `~/.codex/auth.json`.

   json

   // ~/.codex/auth.json
   {
     "OPENAI_API_KEY": "YOUR_API_KEY"
   }

   سجّل الدخول لتعبئة مفتاح API تلقائياً

4. 4
   ابدأ Codex

   شغّل `codex` في مجلّد مشروعك.

   bash

   codex

   سجّل الدخول لتعبئة مفتاح API تلقائياً

$env:OPENAI_BASE_URL="https://api.unorouter.com/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

النماذج الموصى بها

نماذج مجانية تعمل هنا. الصق أي معرّف نموذج في العميل.

ملاحظات مهمة

• !عند خطأ نقطة نهاية غير مدعومة، تأكّد أنّ `wire_api` هو `responses` وأنّ الرابط الأساسي ينتهي بـ `/v1`.
• !الخطأ 401 يعني أنّ المفتاح في `~/.codex/auth.json` مفقود أو قديم. الصق مفتاحًا جديدًا من لوحة تحكّم UnoRouter.
• !إن تجاهل Codex مزوّدك، فتحقّق من اسم الجدول في `config.toml`. معرّفات المزوّدين تسمح بالشرطة السفلية لا الواصلة (`model_providers.my_provider`، وليس `my-provider`). و`openai` محجوز ولا يمكن تجاوزه.