دمج Codex مع نماذج CodingPlanX المخصصة

قم بتكوين OpenAI Codex CLI باستخدام مفتاح API الخاص بـ CodingPlanX.ai.

دليل تكامل Codex

يدعم CodingPlanX.ai ليس فقط Claude Code ولكن أيضًا OpenAI Codex CLI. بمجرد شراء خطة، يتشارك Claude Code و Codex نفس حصة الخطة، مما يمنحك المرونة لاختيار الأداة التي تفضلها.

تثبيت Codex CLI

npm install -g @openai/codex

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

codex --version

أحدث إصدار: v0.114.0 (2026-03-11)، يتميز بنظام المهارات (Skills)، ومحرك الخطافات (Hooks engine)، والمزيد.

النماذج المتاحة

يمكنك الوصول إلى نماذج Codex/GPT التالية عبر CodingPlanX.ai:

تتشارك جميع النماذج حصة خطة CodingPlanX.ai الخاصة بك مع Claude Code.

نظرة عامة على التكوين

يتطلب Codex CLI ملفي تكوين:

• ~/.codex/config.toml - تكوين الخدمة
• ~/.codex/auth.json - تكوين المصادقة

---

تكوين Windows

الخطوة 1: إنشاء دليل التكوين

mkdir %HOMEPATH%\.codex

الخطوة 2: إنشاء config.toml

قم بإنشاء ملف التكوين في ~/.codex/config.toml:

model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

الخطوة 3: إنشاء auth.json

قم بإنشاء ملف المصادقة في ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}

استبدل cr_xxxxxxxxxx بـ مفتاح API لـ CodingPlanX.ai.

الخطوة 4: تعيين متغيرات البيئة (اختياري)

إذا كنت تفضل توفير مفتاحك عبر متغيرات البيئة:

# الإعداد المؤقت
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

# الإعداد الدائم
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)

ثم قم بتعيين OPENAI_API_KEY إلى null في ملف auth.json الخاص بك.

---

تكوين macOS

الخطوة 1: إنشاء دليل التكوين

mkdir -p ~/.codex

الخطوة 2: إنشاء config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

الخطوة 3: إنشاء auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

استبدل cr_xxxxxxxxxx بـ مفتاح API لـ CodingPlanX.ai.

الخطوة 4: تعيين متغيرات البيئة (اختياري)

إذا كنت تفضل توفير مفتاحك عبر متغيرات البيئة:

# الإعداد المؤقت
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# الإعداد الدائم
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

ثم قم بتعيين OPENAI_API_KEY إلى null في ملف auth.json الخاص بك.

---

تكوين Linux

الخطوة 1: إنشاء دليل التكوين

mkdir -p ~/.codex

الخطوة 2: إنشاء config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

الخطوة 3: إنشاء auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

استبدل cr_xxxxxxxxxx بـ مفتاح API لـ CodingPlanX.ai.

الخطوة 4: تعيين متغيرات البيئة (اختياري)

إذا كنت تفضل توفير مفتاحك عبر متغيرات البيئة:

# الإعداد المؤقت
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# الإعداد الدائم (Bash)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# الإعداد الدائم (Zsh)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

ثم قم بتعيين OPENAI_API_KEY إلى null في ملف auth.json الخاص بك.

---

التحقق من التكوين

بعد التكوين، قم بتشغيل Codex CLI للتحقق:

codex

مؤشرات النجاح

• يبدأ Codex بشكل طبيعي ويتصل بالخدمة.
• يمكنك إنشاء كود وتلقي استجابات الذكاء الاصطناعي.
• يتم توجيه طلبات الشبكة بشكل صحيح من خلال بروكسي CodingPlanX.ai.

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

لم يتم العثور على ملف التكوين

المشكلة: يطالب Codex بأنه لا يمكن العثور على ملف التكوين.

الحل:

1. تحقق مما إذا كان مسار التكوين صحيحًا.
2. تأكد من وجود دليل ~/.codex/.
3. تحقق من وجود كل من config.toml و auth.json.

فشلت مصادقة مفتاح API

المشكلة: متغير بيئة غير صالح أو مفتاح API غير صحيح.

الحل:

1. تحقق مما إذا كان متغير البيئة CRS_OAI_KEY قد تم تعيينه بشكل صحيح.
2. تحقق من تنسيق مفتاح API الخاص بك (يبدأ بـ cr_).
3. تأكد من عدم انتهاء صلاحية المفتاح عن طريق التحقق من وحدة التحكم (Console).

مشكلات الاتصال بالشبكة

المشكلة: تعذر الاتصال بخدمات CodingPlanX.ai.

الحل:

1. تحقق من اتصالك بالإنترنت.
2. تأكد من تعيين base_url بشكل صحيح إلى https://api.codingplanx.ai.