الرئيسية / الأدلة / استخدام Codex CLI مع نماذج مجانية

استخدام 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_authfalse تعني أن 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 كل قفزة فاشلة والسبب.

الملفات الشخصية: تذكر وثائق Codex أن الإصدار 0.134.0 وما بعده لم يعد يقرأ جداول [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 وكيل. يشغّل أوامر الصدفة ويعدّل الملفات عبر استدعاءات الأدوات. استخدم نماذج تدعم استدعاء الأدوات ولديها نافذة سياق كبيرة. يعرض الجدول النماذج المجانية التي تحقق القاعدتين اليوم.

نماذج مجانية لـ Codex CLI: استدعاء الأدوات وسياق 128K+
النموذجمجاني علىالسياقالحدود المجانية (أفضل عرض)الأدواتالرؤية
GLM 5.3UnoRouter1M1 طلب/دقيقة
1 req/min per model
نعملا
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 طلب/دقيقة
40 RPM
نعمنعم
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaنعمنعم
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceنعملا
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditنعمنعم
Gemini 3.7 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditنعمنعم
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 طلب/دقيقة
50 طلب/يوم
50 req/day account-wide (1,000 after a $10 purchase)
نعمنعم
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 طلب/دقيقة
50 طلب/يوم
Shared rate limit
نعملا
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 طلب/دقيقة
250 طلب/يوم
70,000 رمز/دقيقة
~6M
نعمنعم
Gemini 3.6 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Qwen 3.8 27BCloudflare Workers AI262KShared 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 محاولة"بلغت كل المفاتيح حدهاأضف مفاتيح من مزوّدين أكثر، أو انتظر فترات التبريد
استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

الأسئلة الشائعة

هل أستطيع استخدام Codex CLI مجاناً؟

نعم. Codex CLI مفتوح المصدر. أضف FreeLLMAPI كمزوّد نموذج مخصص في config.toml. ترسل البوابة كل طلب إلى المستويات المجانية للمزوّدين، لذلك تكلفة الاستدلال 0 دولار.

هل يستطيع Codex CLI استخدام نماذج من مزوّدين آخرين؟

نعم. أضف كتلة [model_providers.] مع base_url وenv_key وwire_api = "responses"، ثم اضبط model_provider. يجب أن يقدّم المزوّد Responses API.

هل يدعم 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 بيانات حقيقية لنماذج البوابة.

أدلة ذات صلة

المصادر

كل الأدلة · تصفح كل النماذج المجانية