استخدام Codex CLI مع نماذج مجانية
Codex CLI هو وكيل البرمجة مفتوح المصدر من OpenAI، ويعمل في الطرفية. يستطيع استخدام مزوّد نماذج مخصص. يوصل هذا الدليل Codex CLI بنماذج مجانية من مزوّدين آخرين عبر FreeLLMAPI. يتحدث Codex بلغة Responses API، ويقدّمها FreeLLMAPI على /v1/responses.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
كيف يعمل
يرسل Codex CLI الطلبات بصيغة OpenAI Responses. تذكر وثائق Codex أن responses هي القيمة الوحيدة المدعومة لـ wire_api. لذلك يجب أن يقدّم المزوّد لـ Codex المسار /v1/responses. يقدّم FreeLLMAPI هذه النقطة. يحوّل كل طلب ويرسله إلى نموذج مجاني، مثل Gemini أو GPT-OSS أو Qwen أو GLM.
- ما تحصل عليه: وكيل Codex CLI وأدواته وحلقة التعديل لديه، على نماذج مجانية.
- ما لا تحصل عليه: نماذج GPT الخاصة بـ OpenAI عبر خطة ChatGPT. تذهب الطلبات إلى المزوّدين المجانيين في مجموعة FreeLLMAPI لديك.
- القيد: إدخال الصور عبر
/v1/responsesغير مدعوم حتى الآن. استخدم مطالبات نصية.
الخطوة 1: ثبّت FreeLLMAPI وCodex CLI
ثبّت الاثنين
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexافتح http://localhost:3001. أضف مفتاحين مجانيين على الأقل من مزوّدين في صفحة Keys. انسخ مفتاحك الموحد من الصفحة نفسها. على macOS، يمكنك أيضاً تثبيت Codex باستخدام brew install --cask codex.
الخطوة 2: وصّل Codex CLI
يضيف أمر الإعداد مزوّداً إلى ~/.codex/config.toml. ينشئ نسخة احتياطية أولاً، ويدمج الكتلة الجديدة، فتبقى إعداداتك الأخرى كما هي.
أمر واحد
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexيكتب الأمر هذه الإعدادات، بقيم من الكتالوج الحي لديك. لا يوجد المفتاح في الملف. يقرأ Codex المفتاح من متغير البيئة FREELLMAPI_API_KEY، لذلك صدّر المتغير في كل صدفة تشغّل فيها Codex.
~/.codex/config.toml
model = "auto"
model_provider = "freellmapi"
model_context_window = 128000
model_auto_compact_token_limit = 115200
tool_output_token_limit = 20000
[model_providers.freellmapi]
name = "FreeLLMAPI"
base_url = "http://localhost:3001/v1"
wire_api = "responses"
env_key = "FREELLMAPI_API_KEY"
requires_openai_auth = false| المفتاح | وظيفته |
|---|---|
model_provider | يختار المزوّد من model_providers. القيمة الافتراضية هي openai. |
env_key | متغير البيئة الذي يحمل مفتاح API للمزوّد |
requires_openai_auth | false تعني أن Codex لا يطلب تسجيل الدخول إلى OpenAI |
model_context_window | رموز السياق للنموذج النشط. يأخذ الأمر القيمة من الكتالوج الحي لديك. |
model_auto_compact_token_limit | عدد الرموز الذي يبدأ عنده ضغط السجل التلقائي. يضبط الأمر القيمة على 90% من نافذة السياق. |
tool_output_token_limit | ميزانية الرموز لكل مخرج أداة يحتفظ به Codex في السجل |
لإبقاء المفتاح خارج الملفات وخارج ملف الصدفة لديك، استخدم المشغّل. يبدأ Codex والمفتاح موجود في بيئته فقط:
المشغّل بدون حفظ
npx freellmapi launch-codexللتأكد من وصول الطلبات إلى البوابة، شغّل npx freellmapi doctor. يفحص ترويسة Authorization الموجّهة، والكتالوج، ومسبار تشغيل حي. ثم يُظهر سجل الطلبات في لوحة التحكم كل استدعاء من Codex. تسمي ترويسة الاستجابة X-Routed-Via المزوّد والنموذج اللذين أجابا. إذا تحوّل طلب إلى احتياط، تسمي X-Fallback-Trail كل قفزة فاشلة والسبب.
[profiles.NAME] من config.toml. صارت الملفات الشخصية ملفات منفصلة، مثل ~/.codex/NAME.config.toml. استخدم الإعداد الافتراضي أعلاه مع إصدار Codex الحالي.أزل تحذير بيانات النموذج
يطبع Codex الرسالة "Model metadata for auto not found" في كل تشغيل. لا يعرف Codex معرّفات نماذج البوابة. لإعطائه بيانات حقيقية، مثل نافذة السياق ودعم الصور، أضف عنوان كتالوج النماذج إلى المزوّد:
أضِف إلى [model_providers.freellmapi]
model_catalog_url = "http://localhost:3001/v1/codex/models"يحتفظ الكتالوج بموجّه النظام الافتراضي لـ Codex وإعدادات أدواته. يتغير التحذير ونافذة السياق فقط.
اختر النماذج لـ Codex CLI
Codex وكيل. يشغّل أوامر الصدفة ويعدّل الملفات عبر استدعاءات الأدوات. استخدم نماذج تدعم استدعاء الأدوات ولديها نافذة سياق كبيرة. يعرض الجدول النماذج المجانية التي تحقق القاعدتين اليوم.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 طلب/دقيقة 1 req/min per model | نعم | لا |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 طلب/دقيقة 40 RPM | نعم | نعم |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | نعم | نعم |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | نعم | لا |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 طلب/دقيقة 50 طلب/يوم 50 req/day account-wide (1,000 after a $10 purchase) | نعم | نعم |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 طلب/دقيقة 50 طلب/يوم Shared rate limit | نعم | لا |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 طلب/دقيقة 250 طلب/يوم 70,000 رمز/دقيقة ~6M | نعم | نعم |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | نعم | نعم |
يعرض 12 من أصل 109 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
أبقِ model = "auto" ليختار الموجّه نموذجاً لكل طلب. لتثبيت نموذج واحد، شغّل npx freellmapi setup-codex --url http://localhost:3001 --model <id>. يمكنك أيضاً ضبط model = "auto:smart" أو model = "auto:fast" في config.toml.
للمستويات المجانية حدود في الدقيقة وفي اليوم. عندما يرسل مزوّد الخطأ 429، يرسل FreeLLMAPI الطلب إلى النموذج التالي في السلسلة. أضف مفاتيح من أربعة مزوّدين أو أكثر لجلسات Codex الطويلة. يضغط Codex سجله عندما يصل إلى model_auto_compact_token_limit. القيمة الأقل ترسل طلبات أصغر، وهذا يفيد في المستويات المجانية ذات حدود الرموز في الدقيقة المنخفضة.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
| يطلب منك Codex تسجيل الدخول بحساب ChatGPT | لم يُضبط model_provider، لذلك يستخدم Codex القيمة openai | اضبط model_provider = "freellmapi" |
401 "Invalid API key" | FREELLMAPI_API_KEY غير مضبوط في هذه الصدفة | صدّر المتغير، أو استخدم npx freellmapi launch-codex |
"Model metadata for auto not found" | لا يعرف Codex معرّفات نماذج البوابة | أضف model_catalog_url |
أخطاء مع wire_api = "chat" | يدعم Codex Responses API فقط | اضبط wire_api = "responses" |
| إعدادات الملف الشخصي تُتجاهل | يتجاهل Codex 0.134.0 وما بعده جداول [profiles.NAME] | استخدم إعداد المزوّد الافتراضي، أو ملف ملف شخصي منفصل |
| "بلغت كل النماذج حد المعدل بعد N محاولة" | بلغت كل المفاتيح حدها | أضف مفاتيح من مزوّدين أكثر، أو انتظر فترات التبريد |
الأسئلة الشائعة
هل أستطيع استخدام Codex CLI مجاناً؟
نعم. Codex CLI مفتوح المصدر. أضف FreeLLMAPI كمزوّد نموذج مخصص في config.toml. ترسل البوابة كل طلب إلى المستويات المجانية للمزوّدين، لذلك تكلفة الاستدلال 0 دولار.
هل يستطيع Codex CLI استخدام نماذج من مزوّدين آخرين؟
نعم. أضف كتلة [model_providers.
هل يدعم Codex CLI واجهة Chat Completions؟
لا. يذكر مرجع إعدادات Codex أن responses هي القيمة الوحيدة المدعومة لـ wire_api. يقدّم FreeLLMAPI المسار /v1/responses، لذلك يعمل كمزوّد لـ Codex.
ما أفضل نموذج مجاني لـ Codex CLI؟
استخدم نموذجاً يدعم استدعاء الأدوات ولديه سياق 128K على الأقل. يعرض الجدول في هذه الصفحة أقوى النماذج المجانية التي تحقق القاعدتين اليوم.
كيف أصلح رسالة «Model metadata for auto not found»؟
أضف model_catalog_url = "http://localhost:3001/v1/codex/models" إلى كتلة المزوّد في ~/.codex/config.toml. عندئذ يقرأ Codex بيانات حقيقية لنماذج البوابة.
أدلة ذات صلة
- كيف تستخدم Claude Code مجاناً
- استخدام OpenCode مع واجهة LLM مجانية
- استخدم Aider مع واجهة LLM مجانية
- أفضل واجهات نماذج البرمجة المجانية
- هل توجد واجهة GPT مجانية؟
المصادر
- Codex docs: config reference (تم التحقق 20 November 2026)
- Codex docs: advanced config and profiles (تم التحقق 20 November 2026)
- Codex CLI repository (تم التحقق 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (تم التحقق 20 November 2026)
- FreeLLMAPI CLI generators (تم التحقق 20 November 2026)