الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

استخدم هذا الدليل لتشغيل Codex CLI مع CometAPI كموفر model. المراجع الرسمية:
يجب أن يحتوي Codex على كلا الملفين مهيأين: ~/.codex/config.toml و ~/.codex/auth.json. لا تستخدم إعدادًا يعتمد على base URL فقط لهذا التكامل.

​
المتطلبات الأساسية

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

​
تثبيت Codex CLI

npm i -g @openai/codex
أو عبر Homebrew: 
brew install --cask codex
تحقق من التثبيت: 
codex --version

​
تهيئة CometAPI

أنشئ أو عدّل ~/.codex/config.toml باستخدام إعداد موفر الخدمة هذا: 
model_provider = "cometapi"
model = "gpt-5.5"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
requires_openai_auth = true
يجب أن تبقى مفاتيح model_provider و model في المستوى الأعلى من الملف. ويعرّف القسم [model_providers.cometapi] نقطة نهاية CometAPI.
إذا كنت تدير إعدادات Codex من خلال مستودع dotfiles، فأبقِ النسخة الموجودة في dotfiles متزامنة مع ~/.codex/config.toml. يقرأ Codex الملف من ~/.codex/config.toml.

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

أنشئ ~/.codex/auth.json: 
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
استبدل sk-your-cometapi-key بمفتاح CometAPI الفعلي الخاص بك.
هذا الملف إلزامي. يجب أن تكون قيمة auth_mode هي apikey، ويجب أن يحتوي OPENAI_API_KEY على مفتاح CometAPI الخاص بك.

​
بدء Codex

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

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

العرَضالحل
API key auth is missing a keyأصلح ~/.codex/auth.json. يجب أن يحتوي على "auth_mode": "apikey" و "OPENAI_API_KEY": "sk-..."
ظهور مطالبة تسجيل الدخول بشكل غير متوقعأعد إنشاء ~/.codex/auth.json مع تعيين auth_mode إلى apikey، ثم أعد تشغيل Codex
ما يزال Codex يستخدم موفر OpenAI الافتراضيأصلح ~/.codex/config.toml. يجب أن تكون قيمة model_provider هي cometapi
الطلبات لا تصل إلى CometAPIأصلح ~/.codex/config.toml. يجب أن يتضمن [model_providers.cometapi] القيمة requires_openai_auth = true
انتهاء مهلة الاتصال أو استخدام نقطة نهاية خاطئةأصلح ~/.codex/config.toml. يجب أن تكون قيمة base_url هي https://api.cometapi.com/v1
لم يتم العثور على modelتحقق من صفحة Models للاطلاع على النماذج المتاحة
مشكلات Windowsيتطلب Codex وجود WSL2 على Windows — ولا يدعم CMD/PowerShell الأصلي