📋 خطوات تحضيرية
قبل البدء، يرجى التأكد مما يلي:
- إنشاء حساب Koze وتسجيل الدخول
- إنشاء مفتاح API من صفحة إدارة API
- تثبيت Codex CLI (
npm install -g @openai/codex)
🚀 الخطوة 1: تهيئة ملف تهيئة Codex
أضف التهيئة التالية إلى بداية ملف ~/.codex/config.toml:
model_provider = "koze"
model = "gpt-4.1"
model_reasoning_effort = "high"
disable_response_storage = صحيح
preferred_auth_method = "apikey"
[model_providers.koze]
name = "koze"
base_url = "https://api.kozeai.com/v1"
wire_api = "responses"
requires_openai_auth = صحيح
💡 نصيحة: استبدل `
https://api.kozeai.com/v1` بعنوان وكيل Koze الخاص بك. يمكنك اختيار نماذج مختلفة حسب خطتك من حقل `model`.
🔑 الخطوة الثانية: إعداد مفتاح API
أضف مفتاح API الخاص بك في الملف ~/.codex/auth.json:
{
'OPENAI_API_KEY': 'مفتاح Koze API الخاص بك'
}
🎯 الخطوة الثالثة: تشغيل Codex
بعد الإعداد، شغّله مباشرةً من سطر الأوامر:
codexسيستخدم Codex CLI تلقائيًا وكيل Koze لطلبات API.
📌 النماذج المتاحة
يمكنك استخدام النماذج التالية في حقل `model` في ملف الإعدادات (حسب خطة Koze الخاصة بك):
| اسم النموذج | الوصف |
|---|---|
gpt-5.3-codex |
gpt-5.3-codex، مناسب لمهام البرمجة اليومية |
gpt-5.4-mini |
GPT-4.1 Mini، قيمة أفضل مقابل المال |
gpt-5.4 |
GPT-5.4 Multimodal النموذج |
⚠️ الأسئلة الشائعة
| المشكلة | الحل |
|---|---|
| نصيحة: "فشل المصادقة" | تحقق من صحة مفتاح API في auth.json |
config.toml لا يعمل |
تأكد من كتابة الإعدادات في بداية الملف وأن اسم model_provider مطابق [model_providers.xxx] |
| فشل استخدام خاصية "مضاد النموذج الأولي" في Nginx. | أضف السطر `underscores_in_headers on;` إلى كتلة ` |