Codex CLI

قم بإعداد OpenAI Codex CLI مع CometAPI: اضبط openai_base_url أو موفّرًا مخصصًا في config.toml، وخزّن مفتاح API الخاص بك في auth.json، وابدأ البرمجة باستخدام model حديث.

استخدم هذا الدليل لتشغيل Codex CLI مع CometAPI كموفّر model.

المراجع الرسمية:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

يتغير توفّر النماذج بشكل متكرر. تستخدم الأمثلة أدناه your-model-id — استبدله بمعرّف model حديث مناسب للبرمجة من صفحة نماذج CometAPI.

​

المتطلبات المسبقة

المتطلب	التفاصيل
نظام التشغيل	macOS 12+، أو Linux ‏(Ubuntu 20.04+ / Debian 10+)، أو Windows 11 عبر WSL2
Node.js	22+ (يوصى بإصدار LTS)
Git	يوصى بالإصدار 2.23+
مفتاح CometAPI	احصل على واحد من لوحة تحكم CometAPI (يبدأ بـ sk-)

​

تثبيت Codex CLI

npm i -g @openai/codex

أو عبر Homebrew:

brew install --cask codex

تحقق من التثبيت:

codex --version

​

إعداد CometAPI

هناك طريقتان لتوجيه Codex إلى CometAPI. اختر ما يناسب سير عملك.

بسيط: openai_base_url

الخيار الأسهل — أعد توجيه موفّر OpenAI المدمج إلى CometAPI بسطر واحد. لا حاجة إلى تعريف موفّر مخصص.

أنشئ ~/.codex/config.toml:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

موفّر مسمّى

عرّف موفّر cometapi باسم محدد. يكون ذلك مفيدًا عندما تريد التبديل بين عدة موفّرين باستخدام --profile أو model_provider.

أنشئ ~/.codex/config.toml:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

يوضّح env_key أي متغير بيئة يحتوي على مفتاح API الخاص بك. يقرأ Codex قيمة OPENAI_API_KEY وقت التشغيل — وهذا ليس مفتاحك الفعلي.

​

تخزين مفتاح API الخاص بك

أنشئ ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

استبدل sk-your-cometapi-key بمفتاح CometAPI الفعلي الخاص بك.

هذا الملف إلزامي. من دون إدخال صالح لـ OPENAI_API_KEY في auth.json، سيخرج Codex مع الخطأ API key auth is missing a key.

​

بدء Codex

cd your-project
codex

عند التشغيل لأول مرة، سيطلب منك Codex اختيار سمة وتأكيد إعدادات الأمان.

​

تجاوز model لكل جلسة

بدّل إلى model مختلف لتشغيل واحد فقط من دون تعديل config.toml:

codex --model your-model-id

​

بديل: متغير البيئة

بدلًا من auth.json، صدّر المفتاح مباشرة:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

يؤدي هذا إلى تعيين المفتاح لجلسة الطرفية الحالية فقط. وللاحتفاظ به بشكل دائم، أضف سطر export إلى ~/.zshrc أو ~/.bashrc.

​

استكشاف الأخطاء وإصلاحها

العَرَض	الحل
API key auth is missing a key	تأكد من أن ~/.codex/auth.json يحتوي على "OPENAI_API_KEY": "sk-..."
ظهور مطالبة تسجيل الدخول بشكل غير متوقع	احذف ملف ~/.codex/auth.json القديم وأعد إنشاؤه باستخدام مفتاح CometAPI الخاص بك
لم يتم العثور على model	تحقق من صفحة النماذج لمعرفة النماذج المتاحة حاليًا
انتهاء مهلة الاتصال	تأكد من أن openai_base_url أو base_url هو https://api.cometapi.com/v1 في config.toml
مشكلات Windows	يتطلب Codex وجود WSL2 على Windows — لا يتم دعم CMD/PowerShell الأصلي