تشغيل Codex CLI بمفتاح API: الشرح الكامل

يعمل Codex CLI بمفتاح API بدلًا من تسجيل الدخول بحساب ChatGPT. فإذا كان مفتاحك من OpenAI، تسجّل الدخول بالأمر codex login --with-api-key. وإذا كان من خدمة متوافقة مع OpenAI مثل 5abeer، تضيف مزوّدًا فيه عنوان الأساس إلى ملف ~/.codex/config.toml، ويقرأ Codex مفتاحك من متغير البيئة KHABEER_API_KEY.

هل تستخدم باقة ChatGPT أم مفتاح API؟#

يعمل Codex بأيٍّ منهما. تذكر صفحة أسعار Codex من OpenAI أن Codex مشمول في باقات ChatGPT. وهذه باقات Plus وPro، مع تاريخ مراجعتنا لكل منها:

الباقة مبلغ ثابت كل شهر ولها حدود استخدام. أما المفتاح فيُحاسب بعدد التوكنات التي يرسلها كل طلب ويستقبلها، دون رسم شهري. ويناسبك المفتاح أكثر في هذه الحالات:

• تستخدم Codex من حين لآخر، والباقة الشهرية ستبقى أغلب الوقت دون استخدام.
• يعمل Codex داخل سكربت أو حاوية أو مهمة CI، حيث لا يستطيع أحد تسجيل الدخول من المتصفح.
• تريد حد إنفاق لكل مشروع بدلًا من حد واحد لكل شيء.

وإذا كنت تفضّل ألا تدفع لكل توكن، فباقة 5abeer التي تشمل Codex تشغّله دون مفتاح، كما في ما الذي تشغّله كل باقة.

للمفتاح قيد واحد يجب أن تعرفه. تذكر وثائق تسجيل الدخول من OpenAI أن تسجيل الدخول بمفتاح API يدعم العمل المحلي في Codex، وأن بعض الميزات التي تعتمد على مساحة عمل ChatGPT أو الخدمات السحابية محدودة أو غير متاحة. فإذا كنت تعتمد على هذه الميزات، فأبقِ تسجيل الدخول بحساب ChatGPT لها.

كم يكلّف Codex بمفتاح API؟#

يرسل وكيل البرمجة مدخلات كثيرة. فكل دورة تحمل طلبك ومعه الملفات ونتائج الأوامر والمحادثة التي يحتاجها Codex، لذلك تزيد توكنات الإدخال عادةً كثيرًا على توكنات الإخراج. وهذه أحدث نماذج GPT، بسعرنا لكل مليون توكن:

وهذا مثال لشهر من الجلسات المنتظمة في Codex، يرسل عشرين مليون توكن ويستقبل مليونًا، على النموذج gpt-5.6-sol:

اعتبر هذا الرقم حدًّا أعلى، لأنه يحسب كل توكن إدخال بالسعر الكامل، بينما يعيد Codex إرسال جزء كبير من السياق نفسه في كل دورة، وتحاسب OpenAI الإدخال المخزّن مؤقتًا بسعر أقل. أما أرقامك فتعتمد على حجم المستودع ومدة جلساتك. استخدم مفتاحًا واحدًا لـ Codex مدة أسبوع واقرأ استخدامه، كما في تتبّع استخدامك، قبل أن تختار بين المفتاح والباقة. والسعر الرسمي لكل نموذج بجوار سعرنا في صفحة OpenAI API.

كيف تسجّل الدخول إلى Codex بمفتاح من OpenAI؟#

إذا كان مفتاحك من OpenAI Platform، فإن Codex يستخدم مزوّد OpenAI المدمج فيه. احفظ المفتاح في متغير البيئة OPENAI_API_KEY، ثم مرّره إلى Codex:

printenv OPENAI_API_KEY | codex login --with-api-key

إذا كنت تستخدم PowerShell على Windows، فاستخدم هذا السطر بدلًا منه، لأن الأمر printenv غير موجود فيه:

$env:OPENAI_API_KEY | codex login --with-api-key

يحتاج الحساب الذي يتبعه المفتاح إلى رصيد API قبل أن يجري طلبات مدفوعة. وتجد مكان إنشاء المفتاح وطريقة الدفع في المنصات الرسمية في ما هو مفتاح API وكيف تحصل عليه.

كيف تشغّل Codex CLI بمفتاح من 5abeer؟#

تقدّم 5abeer نماذج GPT بصيغة Responses التي يستخدمها Codex، بسعرنا. ويقرأ Codex إعداداته من ملف ~/.codex/config.toml، فيكفي ملف واحد ومتغير بيئة واحد:

1. 1

   ثبّت Codex CLI#

   Terminalانسخ

   npm install -g @openai/codex

   يمكنك على macOS أيضًا التثبيت بالأمر brew install --cask codex.

2. 2

   أنشئ مفتاحًا لنماذج GPT#

   اشحن رصيدك بإحدى طرق الدفع، ثم أنشئ مفتاحًا لمزوّد OpenAI كما في إنشاء مفتاح. وسمّه باسم مثل codex ليسهل عليك أن تجد استخدامه.

3. 3

   أضف المزوّد إلى config.toml#

   ضع هذا الإعداد في ملف ~/.codex/config.toml، واحفظ مفتاحك في متغير البيئة KHABEER_API_KEY كما في احفظ المفتاح في متغير بيئة. خطوات الإعداد الكاملة لكل نظام في دليل Codex.

   config.tomlmacOS / LinuxWindows

   انسخ

   model = "gpt-6.1-sol"
   model_provider = "khabeer"
   
   [model_providers.khabeer]
   name = "5abeer"
   base_url = "https://api.5abeer.ai/v1"
   env_key = "KHABEER_API_KEY"
   wire_api = "responses"
   

   ~/.codex/config.toml

   لكي يبقى codex وحده على تسجيل الدخول بحساب ChatGPT، استخدم ملفًا شخصيًا كما في كيف تنتقل بين ChatGPT والمفتاح.

4. 4

   شغّل Codex#

   Terminalانسخ

   cd your-project
   codex

   اطلب شيئًا صغيرًا. إذا وصلك الرد، فالمفتاح وعنوان الأساس يعملان.

ما وظيفة كل سطر في config.toml؟#

• `model`: النموذج الذي يبدأ به Codex. انسخ أي معرّف نموذج من الجدول السابق.
• `model_provider`: كتلة المزوّد التي يستخدمها Codex. وهي هنا تشير إلى كتلة khabeer التي تليها.
• `base_url`: العنوان الذي يرسل إليه Codex طلباته. وفي 5abeer هو عنوان الأساس لصيغة OpenAI.
• `env_key`: اسم متغير البيئة الذي يحمل المفتاح. أما المفتاح نفسه فلا يُكتب في الملف أبدًا.
• `wire_api`: صيغة الطلبات. وقيمتها الوحيدة المدعومة هي "responses"، وهي الافتراضية.

لا تحتاج إلى codex login مع هذا المزوّد، لأن Codex يقرأ المفتاح من المتغير المذكور في env_key كلما بدأ.

كيف تنتقل بين ChatGPT والمفتاح؟#

لا يلزمك أن تختار مرة واحدة. يدعم Codex الملفات الشخصية (profiles): عندما تمرّر --profile profile-name، يحمّل ~/.codex/config.toml ثم يطبّق فوقه ~/.codex/profile-name.config.toml. وهناك طريقتان شائعتان:

• أبقِ جدول [model_providers.khabeer] في ملف الإعداد الرئيسي ~/.codex/config.toml، وانقل السطرين العلويين model وmodel_provider إلى ملف الإعداد الشخصي ~/.codex/khabeer.config.toml. عندها يبقى codex وحده على تسجيل الدخول بحساب ChatGPT، ويستخدم codex --profile khabeer المفتاح.
• غيّر إعدادًا واحدًا لتشغيل واحد بالخيار -c، مثلًا لتجربة نموذج آخر دون تعديل الملف.

يحفظ Codex إعداداته وحالته المحلية في ~/.codex، إلا إذا وجّهه المتغير CODEX_HOME إلى مكان آخر.

أي نموذج تختار في Codex؟#

يعرض الجدول السابق أحدث نماذج GPT. غيّر السطر model في الملف، أو اختر النموذج داخل الجلسة بالأمر /model. يناسب النموذج الأقوى التخطيط والتعديلات الكبيرة، ويناسب الأرخص التعديلات السريعة والأسئلة. وكل النماذج التي تعمل في Codex مذكورة في صفحة إعداد Codex CLI، والقائمة كاملة في صفحة النماذج.

الأخطاء الشائعة وحلولها#

• INVALID_API_KEY: المفتاح غير صحيح، أو المتغير KHABEER_API_KEY غير محفوظ في الطرفية التي شغّلت منها Codex.
• MODEL_PLATFORM_NOT_ALLOWED: المفتاح لمزوّد آخر غير GPT.
• INSUFFICIENT_BALANCE: الرصيد لا يكفي لهذا الطلب. اشحن رصيدك ثم أعد المحاولة.
• API_KEY_QUOTA_EXHAUSTED: وصل المفتاح إلى حد الإنفاق الذي حددته له.

كل الرموز ومعانيها في الأخطاء وحلولها.

أسئلة شائعة#

هل أحتاج إلى codex login مع مفتاح 5abeer؟#

لا. مع كتلة المزوّد في config.toml، يقرأ Codex المفتاح من KHABEER_API_KEY كلما بدأ. أما codex login --with-api-key فهو لمفاتيح OpenAI على المزوّد المدمج.

هل أستطيع تشغيل نماذج Claude في Codex؟#

لا. يغطي كل مفتاح في 5abeer نماذج مزوّد واحد، ويعمل Codex هنا على نماذج GPT. ولنماذج Claude استخدم Claude Code بمفتاح Claude، وراجع أرخص طريقة لاستخدام Claude Code.

هل يلغي إعداد المفتاح تسجيل دخولي بحساب ChatGPT؟#

لا. إذا نقلت السطرين model وmodel_provider إلى ملف شخصي، يبقى إعدادك الرئيسي على تسجيل الدخول بحساب ChatGPT، ولا يستخدم Codex المفتاح إلا حين تشغّله بذلك الملف.

لماذا يقول Codex إن المفتاح غير موجود؟#

لأن المتغير KHABEER_API_KEY غير مضبوط في الطرفية التي شغّلت منها Codex. اضبطه من جديد، أو افتح طرفية جديدة بعد حفظه بشكل دائم، ثم شغّل codex مرة أخرى.

هل أستطيع تحديد ما ينفقه Codex؟#

نعم. أنشئ مفتاحًا لـ Codex وحده، وحدد له حد إنفاق وتاريخ انتهاء كما في تحكّم في كل مفتاح. وعندما يصل إلى الحد، تعيد الطلبات الخطأ API_KEY_QUOTA_EXHAUSTED حتى ترفعه.

هل أستطيع الدفع من مصر؟#

نعم. طرق الدفع من مصر وخطواتها في كيف تدفع ثمن OpenAI أو Claude API من مصر، وتفاصيلها في صفحة الـ API في مصر.

هل أستطيع تشغيل Codex بباقة من 5abeer بدلًا من المفتاح؟#

نعم، إذا كانت باقتك تشمل Codex. يضبط تطبيق 5abeer AI برنامج Codex على باقتك دون مفتاح، كما في ما الذي تشغّله كل باقة. والباقات في صفحة الأسعار.

هل 5abeer جزء من OpenAI؟#

لا. 5abeer خدمة مستقلة لا تتبع OpenAI.

ابدأ#

قارن أسعار GPT في صفحة OpenAI API، أو أنشئ مفتاحًا لنماذج GPT وشغّل Codex به.