Endpoint
عند إعداد Codex API接入، أهم نقطة هي أن يكون Codex base_url متوافقًا مع
مسار REST المتوقع من الأداة. غالبًا ستحتاج إلى نقطة نهاية ثابتة، ومفتاح API صالح، وتأكد أن الخادم
يقبل طلبات Chat Completions أو ما يعادلها بصيغة قريبة من OpenAI.
معايير الاختيار
- التوافق البرمجي: يدعم نفس بنية الطلبات التي يفهمها Codex CLI.
- وضوح الأخطاء: رسائل مفهومة عند فشل المصادقة أو تجاوز الحدود.
- ثبات الشبكة: زمن استجابة معقول عند إرسال طلبات اختبار صغيرة.
- إدارة المفاتيح: فصل المفتاح عن ملفات الكود أو السجلّات العامة.
- الشفافية: مراجعة بنود الاستخدام وسياسات الاحتفاظ بالبيانات.
base_url،
نوع النموذج، وصحة ترويسات الطلب.
Headers
في أغلب السيناريوهات ستحتاج إلى ترويسات أساسية مثل:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
إذا كانت الأداة تسمح بتحديد المتغيرات البيئية، فاضبطها بحيث تشير إلى endpoint المتوافق.
في بعض البيئات يكفي تحديث OPENAI_BASE_URL بدل تغيير الكود نفسه.
Example
export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_BASE_URL="#/v1"
codex --model gpt-4.1-mini
الفكرة هنا أن Codex CLI يتعامل مع الخادم كما لو كان مزودًا قياسيًا، بينما يقوم الوسيط بإعادة توجيه الطلبات إلى البنية الصحيحة في الخلفية.