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

نظرة عامة

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

إعداد سريع

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

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

التوافق

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

1. 1
   ثبّت Codex CLI

   ثبّت Codex CLI عالميا باستخدام npm.

   bash

   npm install -g @openai/codex

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

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

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

   toml

   # ~/.codex/config.toml
   model = "YOUR_MODEL_ID"
   
   [model_providers.custom]
   base_url = "https://api.unorouter.ai/v1"
   wire_api = "responses"

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

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

   اكتب مفتاح API الخاص بـ UnoRouter في `~/.codex/auth.json` حتى يصادق Codex كل طلب.

   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.ai/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

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

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

ملاحظات مهمة

• !إذا أبلغ Codex عن نقطة نهاية غير مدعومة، فتأكد من ضبط `wire_api` على `responses` وأن عنوان URL الأساسي ينتهي بـ `/v1`.
• !خطأ 401 يعني أن المفتاح في `~/.codex/auth.json` مفقود أو قديم. الصق مفتاحا جديدا من لوحة تحكم UnoRouter وأعد التشغيل.